📚 Frappe Education Extension

Junior School is a custom Frappe application that extends the core Frappe Education. It provides comprehensive tools for scheduling, attendance tracking, assessment management, and automated student lifecycle processes, specifically designed for multi-school environments.

---

Table of Contents

• 📚 Frappe Education Extension Customization
• 🚀 Project Overview
• Key Features
  • 1. 🗓️ School Timetable Page
  • 2. ⚙️ Auto-Generation of Timetable
  • 3. 🧑🏽‍🎓 Enhanced Student Attendance
  • 4. 🗂️ Subject Scheduling Tool
  • 5. 🧾 Student Report Generation Tool
  • 6. 👨🏽‍💻 Student ID-Based Email and User Auto-Creation
  • 7. 🏫 School as Company
  • 8. 📊 Assessment Plan Status
  • 9. 🎓 Academic Year Setup & Automated Student Promotion System
  • 10. 🚪 Student Auto-Deactivation
  • 11. 📅 Academic Term Update
• 🛠️ Installation
  • ✅ Dependencies
  • ☁️ Managed Hosting Frappe Cloud
  • 🧑🏿‍💻 Self Hosting
• Key DocTypes
• Reports
• Dashboards

---

🚀 Project Overview

This extension was built to address the unique needs of junior school management, providing sophisticated tools for educational institutions that require multi-campus support, flexible scheduling, and automated administrative processes. The system maintains compatibility with standard Frappe Education while adding specialized functionality for enhanced school operations.

---

🔄 System Workflows

Core Process Flows

graph TD
    A[Student Registration] --> B[Auto ID/Email Creation]
    B --> C[Class Enrollment]
    C --> D[Attendance Tracking]
    D --> E[Assessments]
    E --> F[Report Generation]
    F --> G[Year-End Promotion]
    G --> H[Auto-Deactivation if Leaving]

    I[Timetable Setup] --> J[Define Subjects/Rules]
    J --> K[Assign Teachers/Rooms]
    K --> L[Generate Timetable]
    L --> M[Calendar View/Edits]

    N[Academic Year] --> O[Auto-Create Year]
    O --> P[Update Terms]
    P --> Q[Close Assessments]

Loading

---

Key Features

1. 🗓️ School Timetable Page

The School Timetable View is a read-only interactive calendar. Open it by typing Timetable in the search bar and click on first suggestion Open Timetable.

Calendar

• Built on FullCalendar 6 — timeGridWeek (default), timeGridDay, and list/agenda views.
• Clicking any event shows a read-only popup with: course, date, time, class, teacher, and room.

Filters

Filter	Behaviour
Academic Term	Jumps the calendar to the term's start date and narrows the data fetch
Class (Stream)	Narrows to that class's lessons; can be combined with the Teacher filter
Teacher	Narrows to that teacher's lessons; can be combined with the Class filter
Clear	Resets all filters

All three filters are independent and can be active at the same time. For example, selecting both a stream and a teacher shows only that teacher's lessons within that specific class — useful for checking a teacher's workload in a particular grade.

Print

The Print button generates a printable A4 landscape table for exactly what is currently displayed:

• Week view → Mon–Fri table with actual dates in each row header.
• Day view → single-day table.
• Each time-slot cell can contain multiple classes (parallel sessions are stacked and separated by a dashed line).

The print range is derived from calendar.view.currentStart / currentEnd

---

2. ⚙️ Auto-Generation of Timetable

The timetable generator is a Single Doctype (Timetable Generator) that schedules a full academic term automatically.

Configuration tabs

Details — Academic Year, Academic Term (the term whose Student Groups will be scheduled), School, default lesson hours, and default period duration.

Subject — one row per subject with frequency per week, allow double lessons, and max double lessons per week.

Slot & Breaks

• Time Slots: periods with start time and duration. end_time is read-only and calculated automatically (start_time + duration). New rows default the duration to the document's Default Time Slot value.
• Breaks: select from the Break master. start_time, end_time, and duration are all read-only and auto-populated from the selected break record.

Teachers — one row per teacher–subject–stream combination with max periods per day/week and optional preferred days.

Teaching Rooms — assign a room to each subject–stream combination.

Smart link filters

To reduce configuration errors, all link dropdowns are pre-filtered:

Dropdown	Filtered to
Teachers → Subject	Subjects already in the Subject Rules tab
Teachers → Stream	Student Groups belonging to the selected Academic Term
Teaching Rooms → Subject	Subjects already in the Subject Rules tab
Teaching Rooms → Stream	Streams already configured in the Teachers tab AND in the selected Academic Term

Backend validation on save

The document validates on every save and blocks saving with a clear error if any of these fail:

1. Duplicate subjects — each subject may appear only once in Subject Rules.
2. Teacher subject consistency — every subject in the Teachers tab must exist in Subject Rules.
3. Room subject/stream consistency — subjects and streams in Teaching Rooms must already be in Subject Rules and Teachers respectively.
4. Academic Term stream validation — every stream must be a Student Group linked to the selected Academic Term. A stream from a different term would be silently skipped during generation; this check surfaces that error at save time.
5. Time slot alignment — the first slot must start exactly at Lesson Starts; the last slot must end exactly at Lesson Ends; no slot may overlap any configured break.

Scheduling algorithm

Generates a base weekly template then replicates it across every week in the term. Subjects are spread evenly across Mon–Fri based on frequency (e.g. 3×/week → Mon/Wed/Fri) rather than front-loaded onto Monday.

Pass	Room	Preferred days	Workload
1	Subject+stream specific	Respected	Daily + weekly
2	Any available	Ignored	Daily + weekly
3 (fallback)	Force-assign	Ignored	Daily only

Each run produces a different valid timetable through shuffled teacher order, randomized target-day rotation, and random ordering within same-priority subjects.

Scoped generation

Clicking Generate Timetable opens a dialog that groups streams by grade. The user selects which classes to (re-)generate; all other grades are left untouched.

• Clearing is scoped: only the selected streams' existing schedules are deleted before new ones are created.
• This allows generating Grade 6 first, then Grade 7, each run building on the previous without overwriting other classes.

At least one stream must be selected; clicking Generate with nothing checked shows a warning and keeps the dialog open.

Cross-stream conflict prevention

Before scheduling begins, existing Course Schedule records and Assessment Plan supervisor assignments for other streams are loaded into the scheduling engine's lookup table. This prevents the algorithm from assigning a teacher or room that is already occupied by another grade's confirmed schedule.

Debug Info

Before running generation, click Debug Info to verify the configuration without creating any records. It returns a read-only summary including:

• Term date range and total school weeks
• Period slots per day and lesson limits
• Teacher, subject, classroom, and student group counts
• Items to schedule per week and across the full term
• Per-subject frequencies and per-stream subject assignments

Use this to confirm everything is wired up correctly (right term, right streams, right subjects) before committing to a full generation run.

Error handling

• Every failed save is logged to Frappe Error Log with course, student group, instructor, date, time, room, and full Python traceback.
• Assessment Plan conflicts (teacher is a supervisor at that time) are detected, counted separately, and logged with guidance — they do not count as hard failures.
• A consolidated summary log groups all unique errors by frequency for quick pattern identification.

Timetable Generation Result

After generation, a Timetable Generation Result document is created with:

• Status: Complete (zero failures, zero unscheduled), Partial (some issues), or Failed.
• Scheduled count, unscheduled count, saved count, failed count.
• Detailed JSON notes covering unscheduled items, diagnosis, save errors, and overlap skips.

View Timetable — opens a full-width interactive grid with four view modes:

Mode	Shows	Colour by
Whole School	All streams simultaneously	Subject
By Class	One student group's full week	Subject
By Teacher	All classes a teacher takes	Student group
By Subject	All streams doing a subject	Student group

The filter updates the grid client-side with no extra API calls.

Two print formats are available:

• Color Print — full-colour A4 landscape with a legend.
• Standard Print — clean black-and-white layout with abbreviated subject names, period numbers, and two-letter day abbreviations (classic school timetable style).

Diagnose Unscheduled — when any items could not be placed, a Diagnose button appears on the result. It explains for each subject–stream group exactly why it failed:

1. No teacher assigned to this subject for this stream.
2. Teacher hit their weekly/daily period cap.
3. No room configured for this subject.
4. Resource contention — teacher, room, and stream were simultaneously occupied in every remaining period.

Each entry includes a suggested fix and a teacher workload table with colour-coded status badges.

---

3. 🧑🏽‍🎓 Enhanced Student Attendance

To support multi-shift attendance (e.g., morning & evening), the following has been introduced:

• New Doctype: Enhanced Student Attendance Tool

  • Based on Student Attendance Tool with additional fields:

    • Shift (Linked to HR shift types)

    • Start Time, End Time

• Student Attendance Doctype Changes:

  • New field: Shift

  • Override on the default duplicate attendance validation logic:

    • Allows multiple attendance entries per day based on shift.

    • Ensures no overlapping shifts.

4. 🗂️ Subject Scheduling Tool

Creating course schedules with consistent time across days was limiting. To address this:

• Created a new Doctype: Subject Scheduling Tool

  • Replicates the Course Scheduling Tool with improvements.

  • Child Table: Subject Time

    • Allows scheduling different times for different days.

    • Example:

      • Monday: 8:00–9:00 AM

      • Wednesday: 10:00–11:00 AM

    • Checkbox Reschedule for when you are rescheduling an already scheduled subject.

This tool improves flexibility and real-world scheduling accuracy.

---

5. 🧾 Student Report Generation Tool

A new feature has been added to the Student Report Generation Tool to support customizable report card printing.

• Field Added: Custom Print Report Card (Checkbox)

  • When checked, the system prints a report card using a custom template, designed to align with the institution's branding and reporting preferences.

  • This template reflects the layout and styling shown in the sample below:

  

• Group Filter Removed:
  To enhance flexibility during events like half-term breaks, the group filter was removed. This enables users to:

  • Generate report cards for any assessment group.

  • Allow students to take their report cards home during half-term or early departures without restriction.

  ---

6. 👨🏽‍💻 Student ID-Based Email and User Auto-Creation

🛠️ Key Features:

• Custom Student ID Format:

  • Student ID is auto-generated based on the selected School.

  • The ID format follows a prefix derived from the school abbreviation, followed by a numeric sequence.

  • Example: For a school with abbreviation JNS, the Student ID might be JNS-0001.

  • ⚠️ This logic is customizable depending on the use case or naming convention required.

• Auto-Generated Student Email:

  • Since younger students may not have emails, the system synthesizes one using the format:

    <student_id>@gmail.com

    Example: JNS0001@gmail.com

• Username = Cleaned Student ID:

  • The username is set to the Student ID with all non-alphanumeric characters removed (e.g., no slashes or symbols).

    safe_username = re.sub(r"\W+", "", self.custom_student_id)

• Password = Student ID:

  • The password for the student account is set as their Student ID (including special characters, if any).

• Login Behavior:

  • Students log in using their username, which is their cleaned-up Student ID.

  • They use their Student ID (original) as the password.

  • This approach is enabled by adjusting System Settings to allow username-based login.

Backend Override

The default Frappe logic for user creation has been overridden via a custom controller, ModifiedStudent, where the user account is generated upon saving a new Student document.

7. 🏫 School as Company

To support multi-school or multi-campus setups within one ERPNext instance, we introduced a structural change: each School is now treated as a Company. This lets users leverage native ERPNext features like permissions, chart of accounts, assets, and HR, scoped to a school.

✅ Key Benefits

• Enables multi-school management under a single ERPNext instance.

• Uses ERPNext's built-in Company logic to segment data per school.

• Allows clear scoping for:

  • Financial

  • Student data

  • Assessments

  • Attendance

  • Reporting

  • Instructor and program tracking

• Filters are applied across key doctypes (e.g., Course Schedule) to restrict selection to records relevant to the selected school:

• You can only select streams, student groups, or instructors that belong to the specified school.

• Ensures clean data separation and avoids cross-school data mixing.

Once this is implemented:

• You can apply User Permissions for Company to restrict access to specific school data.

• Customize dashboards, reports, and queries by filtering on company.

---

8. 📊 Assessment Plan Status

To improve filtering and tracking of assessments, we introduced a status field to the Assessment Plan doctype.

✅ Key Purpose

• Distinguish between active (open) and completed (closed) assessment plans.

• Make it easier to filter only "Open" plans in tools like the Assessment Result Tool.

• Enable automation to close assessment plans once the academic term ends.

⚙️ Scheduler for Auto-Closure

We added a scheduler job that:

• Monitors assessment plans.

• Checks the term end date linked to each plan.

• Automatically updates status from Open → Closed once the term ends.

This ensures accurate status without requiring manual updates.

9. 🎓 Academic Year Setup & Automated Student Promotion System

📌 Overview

This system is designed to automatically:

• Create a new Academic Year at the beginning of each calendar year.

• Promote students to their next grade or stream using rules defined per school.

---

🕐 Scheduled Jobs

1. Academic Year Creation

• Trigger Time: Every year on January 1st at 12:00 AM.

• Function: create_academic_year()

• Description: Automatically creates a new Academic Year document with:

  • year_start_date = YYYY-01-01

  • year_end_date = YYYY-12-31

  • academic_year_name = "YYYY Academic Year"

  ---

2. Auto Enrollment into New Year

• Trigger Time: Immediately after academic year creation.

• Function: update_enrolment_tool()

• Description: Uses the Automated Program Enrollment Tool to:

  • Load student enrollments from the previous academic year.

  • Apply promotion rules (per class and stream).

  • Enroll promoted students into the new academic year and term.

Promotion Rules Engine

Each school can configure promotion rules via the Automated Program Enrollment Tool:

Fields Explained:

• Get Students From: Source of existing enrollments (e.g., Class Enrollment).

• Academic Year / Term: Current (source) academic year and term.

• Enrollment Date: Date to apply the new enrollment (typically start of next year).

🔄 Promotion Rules:

Field	Description
Current Class	e.g., Grade 4
Current Stream	e.g., Grade 4 Blue
New Class	e.g., Grade 5
New Stream	e.g., Grade 5 Blue

Each row defines how students will move from their current level to the next.

Enrollment Details:

• New Academic Year: Target year for promotion (e.g., 2026 Academic Year).

• New Academic Term: Typically Term 1 of the new year.

• Enroll Students Button: Executes the promotion based on defined rules.

✅ Result

By running the above process:

• Each school seamlessly transitions into the new year.

• All eligible students are promoted and re-enrolled automatically.

• No manual intervention is required at the start of each year.

10. 🚪 Student Auto-Deactivation

When a student's Date of Leaving is entered, the system automatically updates their status and removes related records to keep the database clean and consistent.

Actions Taken:

• Custom Status is set to "Left"
• The student record is disabled (enabled = 0)
• The student is removed from their assigned stream (Student Group Student)
• Any active Class Enrollment linked to the student is cancelled

This ensures that the student no longer appears in active lists or reports after their departure.

Similarity to Employee Deactivation

This logic mirrors the behavior for employees:

• When an End Date is entered for an employee, they are automatically marked as inactive.
• The system adjusts the active employee count and deactivates any related links.

This approach helps maintain data integrity and simplifies status tracking across both students and employees.

11. 📅 Academic Term Update

Update ensures that all Student Groups(Streams) reflect the correct Academic Term based on the current date.

Weekly scheduler which:

• Checks today's date and determines the academic year (e.g., 2025 Academic Year).
• Finds the academic term that includes today's date.
• Updates each Student Group in the academic year to use the correct academic term.

Helps: Keeping the Academic Term field up-to-date ensures accurate reporting, filtering, and planning based on term-specific data.

---

REPORTS

1. Average Performance per Stream

This report calculates and visualizes the average academic performance per student group (stream) based on assessment results.

🔍 Features

• Filters:

  • School (Company) ✅ (Required)
  • Academic Year ✅ (Required)
  • Academic Term (Optional) – allows filtering by a specific term or viewing data for the entire year.

• Metrics Displayed:

  • Stream (Student Group)
  • Average Percentage Score (%), calculated as:

    (total_score / maximum_score) * 100
    

📊 Chart

• A bar chart summarizing average performance across streams.
• Enables quick visual comparison of student performance by stream within a selected academic year or term.
• Streams are sorted from highest to lowest average performance for better insights

2. Analysis Report

This report provides a breakdown of learners' grade distribution across different subjects within a selected school, academic year, and optionally a student group.

🔍 Features

• Filters:

  • School (Company) ✅ (Required)
  • Academic Year ✅ (Required)
  • Student Group (Optional)

• Metrics Displayed:

  • Grade (e.g., A, B, C, etc.)
  • Number of learners per grade per subject
  • Total number of learners per grade

• Dynamic Columns:

  • Each subject becomes a column.
  • Subject names are retrieved dynamically based on available data.

📘 How It Works

For each grade, the report:

• Counts the number of assessment records (learners) achieving that grade in each subject.
• Displays a total count of learners who received that grade across all subjects.

This helps analyze how grades are distributed subject-wise and overall, making it easier to identify performance trends or challenges by subject or grade.

3. Annual Performance Comparison

This report compares the average academic performance of student groups (streams) between two academic years, helping educators and administrators track progress or decline over time.

🔍 Features

• Filters:

  • School (Company) ✅ (Required)
  • Current Year ✅ (Required)
  • Compare Year ✅ (Required)
  • Academic Term (Optional) – to narrow down the comparison within a specific term.

• Metrics Displayed:

  • Stream (Student Group)
  • Average Score for each year
  • Deviation – the difference between the current year and comparison year scores.

🎨 Visual Enhancements

• Color-coded Deviation:

  • Green for positive deviation (performance improvement)
  • Red for negative deviation (performance decline)

• School Mean Row:

  • A summary row showing the overall average score for the school in both years and their deviation.

🧠 Use Case

Use this report to:

• Identify which streams have improved or declined in academic performance.
• Support data-driven decision-making for curriculum or teaching adjustments.
• Quickly visualize progress using intuitive formatting and mean calculations.

4. Departmental Analysis Report

The Departmental Analysis Report provides a detailed breakdown of average scores across all courses for each stream (student group), with corresponding overall means and grade rubrics. It helps departments understand performance variations across subjects and student groups in a given academic period.

🔍 Features

• Filters:

  • School (Company) ✅ (Required)
  • Academic Year ✅ (Required)
  • Academic Term ✅ (Required)
  • Grading Scale ✅ (Required) – used to convert numeric means into letter/rubric grades.

• Metrics Displayed:

  • Stream (Student Group)
  • Course-wise Average Scores per Stream
  • Mean Score per Stream
  • Grade (Rubric) per Stream – based on selected grading scale

• Summary Rows (automatically added):

  • TOTAL: Sum of average scores per course across all streams
  • MEAN: Mean of average scores per course across all streams
  • MAX/MIN: Highest and lowest average score per course across streams
  • Rubric: Letter grade for each course average using grading scale

🧠 Use Case

This report enables:

• Department heads and academic leads to identify high-performing or struggling subjects.
• Comparative analysis of performance across streams and departments.
• Insights into grading trends using rubric conversion based on average scores.

5. Assessment Group Analysis

The Assessment Group Analysis Report provides a comparative overview of key performance metrics across all subjects for a selected academic period. This report is useful for analyzing how a specific student group or stream is performing in each course.

🔍 Features

• Filters:

  • School (Company) ✅ (Required)
  • Academic Year ✅ (Required)
  • Academic Term (Optional) – allows narrowing results to a specific term.
  • Student Group (Optional) – filter performance data by stream.

• Metrics Displayed: The report generates rows based on core metrics, and columns dynamically based on subjects (courses) within the filtered scope:

  • Total Score – Total marks accumulated by students in a subject.
  • Mean Score – Average score per subject.
  • Grade – The assigned grade code (if applicable).
  • Max Score – Highest score achieved in each subject.
  • Min Score – Lowest score recorded for each subject.

• Dynamic Column Generation:

  • Columns are created dynamically based on all unique courses available in the filtered dataset, making the report flexible across different institutions or terms.

🧠 Use Case

Use this report to:

• Monitor subject-level performance within a specific stream or academic setting.
• Compare performance across subjects using different metrics (mean, max, min, grade).
• Quickly identify strengths and weaknesses in subject delivery or student understanding.

6. Most Improved Students

The Most Improved Students Report is designed to help academic institutions highlight students who have demonstrated the greatest improvement across two academic terms. By comparing average assessment scores between a “comparison term” and the “current term,” this report identifies and displays the top improver in each student group.

🔍 Features

• Filters:

  • School (Company) ✅ (Required) – the institution to scope the data to.
  • Academic Year ✅ (Required) – defines the academic period in focus.
  • Current Term ✅ (Required) – the term whose performance will be analyzed.
  • Comparison Term ✅ (Required) – the prior term to compare against.
  • Student Group (Optional) – narrow results to a specific stream or class.

• Metrics Displayed:

  • Average (Current Term) – mean score for each student in the selected current term.
  • Average (Comparison Term) – mean score for the same student in the comparison term.
  • Deviation – difference between the current and previous term averages.
  • Student Name – the name of the top improved student per stream.
  • Student Group – the class or stream they belong to.

• Highlighting:

  • Color-coded deviation values:
    • 🟢 Green for improvement (positive deviation)
    • 🔴 Red for decline (negative deviation)

🧠 Use Case

Use this report to:

• Identify students who have made significant academic gains.
• Recognize and reward improvement efforts across academic terms.
• Track academic progress at a group or stream level.
• Gain insight into the effectiveness of interventions or teaching strategies.

7. Academic Performance Summary Report

The Academic Performance Summary Report provides schools with a comprehensive overview of student academic performance across a selected academic term. It aggregates total and average scores, assigns letter grades based on a defined grading scale, and includes a visual breakdown of grade distribution for quick insights.

---

🔍 Features

• Filters:

  • School (Company) ✅ (Required) – the institution whose data is being analyzed.
  • Academic Year ✅ (Required) – the academic year in context.
  • Academic Term ✅ (Required) – the term to evaluate.
  • Student Group (Optional) – filter data by stream or class.
  • Grading Scale ✅ (Required) – define how numerical scores are translated to letter grades.

• Metrics Displayed:

  • Total Score – total marks accumulated by each student.
  • Average Score – the mean score across assessments.
  • Grade – letter grade assigned based on configured grading thresholds.
  • Student Group – class or stream affiliation.
  • Student Name – the learner whose performance is being reviewed.

• Highlighting & Visualization:

  • Grade Highlighting – letter grades appear in bold for visual emphasis.
  • Grade Distribution Pie Chart – dynamically generated pie chart showing the spread of grades.

---

🧠 Use Case

Use this report to:

• Monitor overall academic performance of students within a specific term or stream.
• Identify top-performing students or those needing additional support.
• Visualize grade distribution across the entire student population.
• Track consistency of grading across multiple subjects or streams.

---

8. Stream Wise Performance Report

The Stream Wise Performance Report provides a comprehensive, per-student breakdown of scores across all enrolled courses within a specific stream (student group). It highlights individual performance totals, averages, and final grades—enabling detailed comparisons among students in a given academic setting.

🔍 Features

• Filters:

  • School (Company) ✅ (Required)
  • Academic Year ✅ (Required)
  • Academic Term ✅ (Required)
  • Class (Program) ✅ (Required)
  • Stream (Student Group) ✅ (Required)
  • Grading Scale ✅ (Required) – used to assign a grade to each student's average score

• Metrics Displayed:

  • Student ID and Name
  • Course-wise Total Scores per Student
  • Total: Sum of scores across all courses for each student
  • Average: Mean score for each student across all courses
  • Grade: Letter grade assigned to average using the selected grading scale

• Formatting Enhancements:

  • Bold styling applied to total, average, and grade columns for improved readability
  • Automatically sorts students in descending order by average to emphasize top performers

🧠 Use Case

This report enables:

• Class teachers to view detailed student performance within a stream across all subjects
• Academic administrators to identify top-performing and struggling students at a glance
• Use of grading rubrics to standardize evaluations across different academic terms and programs

---

DashBoards

1. Students Overview

The Student Overview Dashboard provides a high-level summary of key student enrollment metrics, offering quick insights into school population, gender distribution, and class trends over time.

🔍 Features

• Number Cards:

  • Total Members per School: Displays the total number of registered students for each school, helping track overall enrollment.
  • Gender Distribution: Visualizes the count of male and female students, enabling quick assessment of gender balance.

• Trend Chart:

  • Class Enrollment Trend (Line Graph): Shows how enrollment numbers have changed over time, allowing users to spot growth patterns or declines in class-level student registration.

---

🛠️ Installation

✅ Dependencies

• Frappe Framework
• ERPNext
• ERPNext Education Module
• Frappe HR

☁️ Managed Hosting Frappe Cloud

1. Login to your Frappe Cloud account
2. Navigate to Sites/Bench Groups dashboard
3. Go to Apps tab and select + Install APP / + Add APP
4. Select Add from Github and add repository URL
5. Install Application or Fetch Branches

🧑🏿‍💻 Self Hosting

1. Ensure you have a working Frappe and ERPNext instance with Education module
2. Clone this repository into your Frappe bench apps directory:

bench get-app https://github.com/navariltd/Junior-School.git

3. Install the app into your site:

bench --site [your-site-name] install-app nl_school

4. Reload and restart the bench:

bench restart

---

Key DocTypes

Timetable Generator

Central configuration doctype for automated timetable generation with subject rules, time slots, teacher preferences, and room assignments.

Enhanced Student Attendance Tool

Extended attendance tool supporting multi-shift tracking with shift-specific time ranges and validation.

Subject Scheduling Tool

Flexible scheduling tool enabling different time allocations per day for improved real-world scheduling accuracy.

Automated Program Enrollment Tool

Comprehensive student promotion management with configurable rules for academic year transitions.

---