Appearance
Guides - Staff
Progress Edu. is built around Tools. Tools are modular feature panels that are assigned to staff members by administrators/supervisors. The guides below detail the tools available in the application and how to use them.
Tool Access and Permissions
Access to tools is managed dynamically by your school's supervisors:
- Access Levels: Staff can be granted Read access (viewing data and directory profiles) or Write access (enabling creation, modification, and deletion of records).
- Scope Type: Permissions can be set to All (applies across the entire school) or restricted to specific Classes, Subjects, or Individuals (e.g., a teacher only sees subclasses they teach, or a Dean only sees forms in their assigned year group).
1. Mark Book
The Mark Book tool is the primary gradebook interface for teaching staff to manage student assessments and grades.
- Assigned Subclasses: Upon opening the tool, you will see a list of subclasses you teach in the open academic session. Subclasses and academic terms are automatically arranged in reverse chronological order (newest first).
- Assessments Management:
- Click on a subclass, then go to the Assessments tab.
- Click Add Assessment to create a new evaluation. You must specify the Title, Assessment Type, Max Mark, and Due Date.
- You can edit or delete existing assessments from this view.
- Entering Marks:
- Click into a subclass to open the grading grid.
- Student Avatars & Lightbox: Student avatar photos are displayed next to student names in the grading grid for quick identification. Click or tap any avatar to open an interactive zoomable lightbox image viewer.
- Enter student scores directly in the mark input fields.
- Teacher Comments: Enter subject comments with expanded character limits (up to 100/120 characters) for each student outcome.
- Status Flags: For students who did not complete the assessment under standard conditions, you can mark their status as Absent or Disqualified.
- Averages & Benchmarks: The system automatically calculates student averages and subject class outcomes based on the entered marks. The class average is benchmarked against the broader cohort average directly on the desktop toolbar.
2. Roll Call
The Roll Call tool is used by teachers and form staff to take daily and period-by-period student attendance.
- Select Form/Class: Select from your assigned home classes (forms) or subject classes for the open academic session.
- Automatic AM/PM Slot Detection: Roll Call automatically detects the current time of day and preselects the appropriate session slot (AM in the morning, PM in the afternoon) based on your school's attendance schedule primitives, saving manual clicks.
- School Timezone & VPN Alignment: All date selections, morning/afternoon slot determinations, and attendance cutoff audits are anchored to the school's local timezone (Atlantic Standard Time, UTC-4). Staff accessing Progress Edu. via VPN or traveling across timezones are guaranteed identical, accurate school day scheduling.
- Mobile-Responsive Card View: When taking attendance on a smartphone or tablet (screen width < 600px), the view automatically adapts into compact, touch-friendly student cards with prominent avatars, rapid status cycling, and a dedicated mobile action bar.
- Granular Attendance Register:
- Visual Identification: Student photo avatars appear beside each student name in the roster, allowing teachers to quickly verify student identities. Tap any avatar to view the full-size image in a zoomable lightbox.
- Click-to-Change Status Cycling: Tap or click directly on a student's status badge to cycle sequentially through statuses: Present → Late → Absent → Present.
- Interactive Live Tally Filters: The summary tally chips at the top (All, All Absents, Unexcused Absents, Excused Absents, Late, Present) serve as interactive filters. Tapping any chip immediately filters the roster to show only students matching that status.
- Excuses & Categories: When marking a student as Excused, select an approved Excuse Category:
- Medical / Doctor’s Note
- Parental / Guardian Note
- School Representation / Sports
- Bereavement / Family Emergency
- Other Approved Reason
- Add custom excuse notes to provide additional administrative context.
- Late Arrival Reasons: Record specific notes or reasons when students arrive late to class.
- Total Absents Calculation: Total absences accurately tally both unexcused and excused absences, ensuring attendance reporting reflects all missed classroom time.
- Submit Roll Lifecycle: Once attendance is marked, click Submit Roll to finalize the register. A green Roll Submitted badge will display, verifying compliance for administrators and attendance officers.
- Single-Request Batch Roll Submission: Attendance rolls are submitted in a single atomic transaction. A modal progress indicator displays while processing to confirm all records are saved reliably without partial submissions.
- Weekend & Non-School Day Confirmation: If roll call is opened on a weekend or non-instructional day, a confirmation dialog verifies your intent before submitting to prevent accidental entries.
- Cross-Date Backfill Synchronization: Easily select past dates using the date picker. Existing submissions and roster states synchronize cleanly across dates, making historical backfilling accurate and dependable.
- Instant Synchronization: All attendance entries are recorded in real time and automatically synchronize with school-wide attendance metrics and student report cards.
- Session Totals & Manual Overrides: Switch to the Session Totals tab to review cumulative term attendance totals (digital tallies for lates and absences) for each student. When paper registers or administrative dispensations require adjusting authoritative session figures, enable the Manual Override toggle for a student and enter the adjusted Final Lates, Final Absents, and an optional Override Reason. Edits auto-save continuously on blur, enter, or typing. Toggling the override switch OFF immediately resets authoritative totals back to continuous digital tallies, clears adjustments to zero, and removes the override reason.
3. Session Review
Typically used by Deans, Form Supervisors, or Session Reviewers, the Session Review tool is used to finalize student report cards.
- Reviewing Metrics: Select an assigned academic session and home class/form to view the list of students, their session averages, lates, absents, conduct, and deportment scores. When a student has an assessment marked Absent,
ABSis displayed in the Average slot (across the student roster, student detail view, printed PDF report cards, and CSV exports) instead of0, and Place in Class is omitted. When sorting the student roster by Average,ABSaverages are grouped cleanly below numeric averages. Sessions are listed in reverse chronological order (newest first). The student details layout is fully unified and scrollable, detailing overall metrics, student portrait avatars (with zoomable lightbox support), subject performance lists (with explicit session types like End of Term or Progress), and historical averages. - Edit Student Outcomes: Click on any subject outcome in the student's detail view to open the results editor. Reviewers with appropriate write access can modify subject marks and directly edit the Teacher Comments field.
- Dean's Comments: Click on an individual student to open their detailed report card draft and add/edit the final Dean's Comments.
- Subject Allocation (Years 4 & 5): For Year 3 End-of-Term sessions, reviewers can assign upper-school subjects to students by clicking the Subject Allocation action icon in the student detail header and selecting assigned subject choices.
- Release Report Books & Privacy Isolation: In-progress term marks, comments, and averages remain strictly isolated and hidden from students and parents until formally released. Once reviews are complete, click Release Results for your year groups. A confirmation dialog prompts you to confirm the release with an option to notify guardians via email (Notify guardians via email, unchecked by default). When confirmed, this toggles the Released status, publishing the report card to student and guardian Report Books, and dispatches email notifications to registered guardians if selected.
4. Subject Review
Used by Heads of Department (HODs) and subject leads to monitor academic metrics.
- View Subject Statistics: Analyze average marks, letter grade distributions, and performance trends across different year groups and classes for specific subjects.
- Compare Classes & Benchmarks: Compare grade results between class sections to ensure evaluation standards are consistent, and view class averages benchmarked against overall cohort averages.
- Teacher History: View historical subjects taught by teachers across previous terms and academic sessions.
- Drill Down to Class & Student Details: Click on any class in the stats table to view a dedicated class performance page. This page displays class-specific metrics (marked count, pass rate, excel rate, and teacher name) along with a detailed list of all enrolled students, including their overall mark, completion status (Finalized/Pending), attendance history (lates/absents), and specific teacher comments.
5. Student Manager
The Student Manager tool is used by administrators and deans to manage the student enrollment directory. Active teaching staff are also granted read-only access to view student profiles and attendance records.
- Directory Search & Past Students: Search active student profiles by name, class, or email. Switch to the Past Students filter chip to search un-enrolled/historical student records by name.
- Student Photos & Lightbox: Upload personal portrait photos for students (supports JPEG, PNG, and WebP formats up to 5 MB). Users with Write access to the Student Manager tool can click the camera icon badge on the avatar to Change Photo or Remove Photo (reverting to default initials). Uploads are processed securely by Progress Edu. backend functions verifying database tool privileges. Student photos are viewable by all school staff, guardians for their linked children, and students for their own profile. Tap any student avatar to open an interactive zoomable lightbox image viewer supporting pan and pinch-to-zoom.
- Onboarding Students: Click Create Student to add a new student profile.
- Student Profiles & Email Updates: Edit student details—including updating registered email addresses with automatic whitespace trimming and normalization—and manage Guardian Details (relations, contact phone, and emails).
- Attendance & Absence History: Access a dedicated view-only attendance history section on student profile detail views. Review high-level KPI cards (Total Days Present, Lates, Excused Absences, Unexcused Absences), subject-level attendance breakdowns, and a chronological daily roll history log.
- Student Records & Incidents: Log behavioral incidents and student record notes with precise date and time-of-day selection. Creator details (
setBy) are stored automatically. - Academic History: View previous session reports, historical grades, averages, and past performance, organized in reverse chronological order (most recent terms first).
- Class Assignments: Manage home class and subject class enrollments.
- Release/Delete: Release students from active sessions or delete outdated/incorrect student profiles.
6. Staff Manager
Used by school administrators to manage user accounts for teachers and school staff.
- Create Staff Profiles: Add new staff members with their name, email, and honorific. Staff emails are automatically normalized to ensure consistent sign-in.
- Account Status (Active / Inactive): Toggle staff account status between Active and Inactive. Deactivated staff are visually tagged with an "Inactive" status badge. Filter the directory using the Active and Inactive filter chips.
- Reactivation & Credential Provisioning: When reactivating an inactive staff member, administrators are prompted to enter a new password, immediately provisioning their account and authentication credentials.
- Teaching Status: Toggle the Teaching flag. Turning this on enables the staff member to be assigned as a teacher for subject classes and roll calls.
- Supervision Relief Eligibility: Manage whether a teacher is eligible for relief supervision cover duty assignments. By default, all teaching staff are eligible. Administrators can uncheck Eligible for Supervision Relief Duties to exempt school leadership (e.g. Principal, Vice Principal) or specialized personnel (e.g. Guidance Counselors). Exempt teachers are tagged with an Exempt badge in the directory and automatically excluded from standard relief candidate recommendations.
- Credential Management: Reset passwords or manage credentials for staff login.
- Reliable Save Progress Indicators: A full-width Material 3 progress bar displays across profile edit and password dialogs to give clear, real-time feedback during credential updates and prevent premature dismissal.
- Bulk Inactive Teacher Deactivation (CLI): Administrators can audit and batch-deactivate teachers who do not have an assigned class or timetable slot in an open session using the Progress Edu. CLI:bash
# 1. Preview candidate teachers without modifying data (dry-run mode) pedu staff deactivate # 2. Target a specific session or academic term pedu staff deactivate --session <hashid|id> pedu staff deactivate --year 2026 --term 1 # 3. Commit deactivation: revokes tools, disables Firebase Auth, and sets status to INACTIVE pedu staff deactivate --commit- Built-in Safety Protections: By default, non-teaching staff (
--teachers-only), staff holding administrative tools (--protect-admins), and Form Teachers taking daily roll call (--protect-form-teachers) are automatically preserved from deactivation to prevent accidental administrative lockouts. - Database Connection Configuration: The CLI connects to PostgreSQL using environment variables (
PEDU_DB_HOST,PEDU_DB_PORT,PEDU_DB_NAME,PEDU_DB_USER,PEDU_DB_PASSWORD) or explicit command flags (--db-host,--db-port,--db-name,--db-user,--db-password). When targeting staging or production, run the Cloud SQL Auth Proxy (e.g.cloud-sql-proxy progress-edu-staging:us-central1:pedu-instance --port 5432) and provide the corresponding database parameters.
- Built-in Safety Protections: By default, non-teaching staff (
- User Custom Claims & Charges Synchronization (CLI): Administrators can audit and synchronize the
charges: string[]custom claim in Firebase Auth for all enrolled students and linked guardians:bashThis ensures students and guardians hold edge-verifiable security tokens to view student photo assets in Cloud Storage.# 1. Preview claims synchronization without modifying Firebase Auth (dry-run mode) pedu users sync-charges # 2. Commit claims updates directly to Firebase Auth pedu users sync-charges --commit
7. Session Manager
The central administration tool to set up and manage academic terms and school calendars.
- Create Sessions: Configure new academic terms (inputting Year, Term, Evaluation number, start/end dates, and session type like Progress or EOT).
- Manage Sessions: Set session status to Open, Closed, or Pending. Academic sessions are listed in reverse chronological order (newest first).
- Class & Subject Mapping: Set up home classes, subjects, and map teachers to subject classes for the term.
- Subject Class Teacher Reassignment: Assign or reassign teachers to subject classes on the fly:
- In the Subject Classes view (
/session-manager/subject-classes), click the teacher assignment button to open the Teacher Selection Dialog. - Search teachers in real time by name or email, choose an instructor from the active teaching staff list, or unassign as needed.
- Automated administrative assignment can also be performed via the CLI:
pedu session assign-teacher --session <id> --class <id> --teacher <id>. - Automatic Timetable Slot Synchronization: Whenever a teacher is reassigned, all corresponding
timetable_slotrecords for that class are automatically synchronized in PostgreSQL and DataConnect. This ensures the new instructor's daily schedule, weekly teaching load calculations, and relief/supervision coverage immediately reflect the reassignment. - Automated administrative assignment can also be performed via the CLI:
pedu session assign-teacher --session <id> --class <id> --teacher <id>, which synchronizes timetable slots and audits for potential timetable conflicts.
- In the Subject Classes view (
- Add Subject Class & Timetable Scheduling: Administrators can directly create missing or new subject classes from the Subject Classes view (
/session-manager/subject-classes):- Click Add Class to open the creation dialog.
- Select the Subject, Year Group (e.g. Form 1–5, Lower 6, Upper 6; the active academic session, academic level, and grade system are automatically resolved), Class Group (1–6), Teacher (filtered to teaching staff), and designated Room.
- Interactively select teaching timetable slots using the 5-day × 8-period schedule grid, complete with real-time selection counts and a clear-all action.
- Creating a class atomically sets up the subject class, baseline term assessment configuration, and associated timetable slots in PostgreSQL and DataConnect.
- Multi-Dimension Filtering (Subject Classes): Quickly isolate and audit subject classes using live filters:
- Live Search: Filter across class names, subjects, teacher names, and teacher emails simultaneously.
- Dynamic Subject Dropdown: Select from all subjects taught in the active session.
- Session Selector: Easily change sessions when viewing historical or upcoming terms.
- Year Group Choice Chips: Filter by All Forms, Forms 1–5, Lower 6, or Upper 6.
- Teacher Assignment Status: Filter between All Teachers, Assigned, or Unassigned to immediately locate unstaffed classes.
- Filter Counter & Clear: A badge indicates active filter counts and provides a one-click reset.
- Calendar Manager: Manage official school calendar events across terms and academic years (
/session-manager/calendar):- Add, edit, and delete school events with custom event titles, dates, start/end times, locations, and descriptions.
- Categorize events (Academic, Holiday, Sports, Meeting, Extracurricular, Examination, Administrative, or Other).
- Export and import calendar schedules directly in CSV or JSON formats for rapid bulk configuration.
- Session Rollover: Perform the academic rollover utility to advance terms or promote cohorts to new year groups (
/session-manager/rollover):- Intra-Year Term Rollover (Terms 1 → 2 → 3): When advancing between terms or evaluation cycles within the same school year, Progress Edu. automatically clones and preserves all
timetable_slotrecords, room assignments, and teacher schedules in the new session. This ensures that the Supervisions and Supervision Manager tools remain operational on Day 1 of the new term without requiring manual timetable re-ingestion. - New Academic Year Rollover: Advances student cohorts to subsequent year groups, ingests incoming Year 1 students, resets markbooks, and prepares a fresh
PENDINGsession awaiting the new master timetable export. - On-Demand Timetable Slot Synchronization: Administrators can manually synchronize or re-align timetable slots between sessions at any time using the CLI utility:bash
# Clone and validate timetable slots from Term 1 to Term 2 dart run cli/bin/pedu.dart timetable sync-slots --from-session 118 --target-term 2 --commit - Student Session Enrollment & Re-Enrollment: Administrators can enroll or re-enroll continuing or returning students into any academic session at any time using the CLI utility:bashThis preserves the student's existing
# Re-enroll a student into a home class (using explicit Home Class ID or HashID) dart run cli/bin/pedu.dart session enroll --enrolled 3890 --class-id 21 --commit dart run cli/bin/pedu.dart session re-enroll --enrolled student@school.fatima.edu.tt --class-id 21 --commit # Bulk enrollment via JSON or TSV batch file dart run cli/bin/pedu.dart session enroll --file backdoor/assets/year6_late_additions.json --commitenrolledrecord, links them to the session, and generates their primary key and Sqid hashid.
- Intra-Year Term Rollover (Terms 1 → 2 → 3): When advancing between terms or evaluation cycles within the same school year, Progress Edu. automatically clones and preserves all
8. Supervisions
Used to log and coordinate class coverage and supervision duties.
- Supervision Assignments: View schedules and classes requiring coverage.
- Duty Logs: Track active supervisions and log coverage sessions.
9. Tool Manager
Used by school supervisors to control tool access across the staff directory.
- Manage Tool Settings: Add or configure tool definitions.
- Assign Tools to Staff: Assign specific tools (including Export Center, Mark Book, Student Manager, Attendance Manager, Roll Call, Session Review, and Subject Review) to staff profiles, defining the precise Access Level (Read/Write) and Scope (which classes or subjects they can access).
- Unified Staff Selector Dialog: Easily manage assignments using a modernized, unified staff picker across all tool views:
- Multi-Field Search: Search for staff members by either name or email address in real time.
- Email Subtitles: View verified email addresses directly underneath staff names to easily disambiguate colleagues.
- Bulk Selection: Use Select All or Clear All to rapidly assign or revoke access for multiple staff members at once.
- All Active Staff Support: Select from all active staff across the entire directory (or automatically filter to teaching staff when assigning teacher-specific tools).
10. Student List
The Student List tool allows staff to generate, filter, and export custom student rosters for administrative use or school events.
- Roster Selection: Select students by Home Class, Subject Class, or perform a custom name search across all open sessions.
- CSV Export: Click the download icon in the top toolbar to export selected student rosters directly as a CSV spreadsheet.
11. Attendance Manager
The Attendance Manager tool (/attendance-manager) provides school administrators, deans, and attendance officers with comprehensive attendance tracking and schedule compliance tools across the school. The dashboard is organized into four dedicated operational tabs:
1. Home Class Operations:
- High-Priority Statutory Attendance: Focuses on morning (AM) and afternoon (PM) statutory roll submissions across all Form classes.
- Daily Absence Reconciliation & Central 1-Click Dispatch: Positioned prominently at the top of the workflow for rapid administrative action.
- Central Trigger Architecture: Classroom teachers submitting attendance in Roll Call do not trigger outbound parent emails directly, providing students arriving slightly after the bell or lunch period an appropriate grace period buffer before notifications are dispatched.
- Administrative Reconciliation Console: Attendance officers and deans review unexcused absentees for the selected session (AM or PM).
- Inline Grace Period Actions: Staff can click Mark Late (recording an arrival note) or Excuse (selecting an approved excuse category such as Medical or Parental Note) for students who arrive late or submit verified excuses during the morning/afternoon buffer. Reconciled students are immediately removed from the unexcused dispatch queue.
- 1-Click Central Email Dispatch: Once reconciliation is complete, clicking Dispatch Absence Emails prompts a confirmation dialog summarizing pending unnotified absentees. Confirming dispatches branded email alerts to all registered guardians in a single batch operation.
- Audit Badges & Timestamps: Dispatched records display a green Notified badge with the precise dispatch timestamp, preventing redundant email dispatches.
- Smart PM Suppression: If a student was marked absent and notified during the AM session, the PM dispatch automatically suppresses sending a second email for the afternoon roll, preventing duplicate alerts for full-day absences.
- Unified Home Class Roll Status Table:
- Displays all Form classes in a single, comprehensive table sorted by Year Group and Class Group, eliminating fragmented views.
- Smart Time-of-Day Slot Defaulting: Automatically defaults to the AM slot during morning hours so afternoon PM rows do not clutter the screen. Automatically switches to PM during afternoon hours. Staff can manually toggle between AM, PM, or All Slots at any time.
- Single Status Column with 4 Badges:
PENDING: The roll has not yet been submitted, but the cutoff deadline has not passed.OVERDUE: The roll has not been submitted, and the cutoff deadline has passed.SUBMITTED: The roll was submitted on or before the cutoff time.LATE: The roll was submitted after the scheduled cutoff time.
- Quick Status Filter Chips: Filter the table view by
All,Missing(Pending + Overdue),Overdue,Pending,Submitted, orLate. - Instant Class Search: Search by class name (e.g., "1A", "Form 5") in real time.
2. Subject & Truancy Audit:
- Mid-Day Truancy Audit:
- Subject period absences are tracked internally and do not trigger automated emails to parents.
- Automatically cross-references students marked Present or Late in morning Home Room roll call who are subsequently marked Absent in one or more subject periods throughout the day.
- Displays affected students, their home class, and the specific missed subject periods (e.g. Period 3 English, Period 5 Mathematics), providing deans with actionable insights into mid-day cutting or unauthorized departures.
- Dedicated Subject Class Roll Submissions Table:
- Keeps secondary subject submissions clearly separated from statutory Home Class rolls.
- Filterable by specific timetable periods (Period 1–8) and searchable by subject or teacher name.
- Mid-Day Truancy Audit:
3. Attendance & Punctuality Watchlist:
- Identifies students requiring academic or pastoral intervention for both chronic absenteeism and frequent tardiness.
- Chronic Absentees: Flags students with 3+ unexcused absences or 5+ total absences (
Critical (Dean Review)). - Chronic & Frequent Lates: Flags students with 5+ tardies (
Chronic Lates (Dean Review)) or 3–4 tardies (Frequent Lates). - Pastoral Notes & Actions: Direct access to guardian contacts, excuse histories, and intervention notes.
4. Settings & Calendar Overrides:
- Configure school-wide attendance primitives: AM/PM roll start times, tardy cutoffs, and roll submission deadlines.
- Manage Day Overrides on the school calendar to designate non-standard days such as No School (Holiday / Closure), Early Dismissal (No PM Roll), Special Event (Sports Day / Rally), or Excluded Periods.
- Maintain timetable Period Definitions (period names, start times, and end times) stored directly in the database.
- Absence Email Notification Configuration & Validation:
- Enable Toggle: Turn automated guardian absence emails on or off across the school.
- School Office Contact: Set official Contact Phone and Contact Email (defaults to
(868) 622-2692andattendance@fatima.edu.tt). - Custom Message Template: Customize the notification body using dynamic placeholders:
,,,,,, and. - Real-Time Token Validation: The system verifies entered placeholder tokens in real time. If invalid tokens (such as
or) are entered, a prominent alert banner displays and the settings form blocks saving until corrected.
12. Export Center
The Export Center tool (/export-center) provides administrators, deans, and supervisors with a dedicated reporting suite to calculate academic rankings, identify prize-giving honorees, and export comprehensive school broadsheets.
- Session Selection: The session selector filters exclusively for End of Term sessions (
EOTandPROGRESS_EOT), excluding mid-term progress evaluations. Sessions are grouped by academic term and year (arranged reverse-chronologically), displaying the academic year, term, and included year groups (e.g.2025 Term 3 (Forms 1-4, 6)or2025 Term 2 (Form 5)). This allows staff to view and export comprehensive reports across all year groups completing their end of term, while accurately accommodating cohorts with off-cycle external exams. Selecting a term recalculates all student rankings and aggregates automatically. - Top Performers (Class Rankings):
- Standard Competition Ranking: Ranks students within their home class using the standard competition ranking model (
1224). Tied students share the exact same rank position with a Tied chip indicator, and following ranks skip appropriately. - Class Average Benchmarks: Displays the class overall average at the top of each home class card for benchmark comparison.
- Customizable Limits: Switch between Top 3, Top 5, Top 10, Top 20, or All students using the interactive limit selector.
- Filtering: Narrow results by specific Year Group (Forms 1–6) and individual Home Class.
- Standard Competition Ranking: Ranks students within their home class using the standard competition ranking model (
- Prize Giving (Awards & Honors):
- Year Group Overall Champions: Highlights the top three academic champions (1st, 2nd, and 3rd place) in each Form based on overall session average.
- Subject Excellence Champions: Identifies the top-performing student in each subject within each Form. Displays top mark, winning student(s), class, and teacher. If multiple students share the highest mark, a Joint 1st badge is displayed.
- Minimum Score Threshold: Filter subject winners by minimum score (60%, 70%, 75%, or 80%) to ensure only students exceeding award-level achievement qualify.
- Academic Broadsheet:
- Consolidated Grade Grid: Renders a full academic broadsheet displaying all students in the selected Form or class.
- Comprehensive Columns: Summarizes class, student name, overall session average, total absences, total lates, and scores across every subject in the curriculum.
- Instant CSV Export:
- Click Export CSV in the top toolbar to immediately download the active report view (Top Performers, Prize Giving, or Broadsheet) formatted cleanly for spreadsheets.
- Permissions & Assignment:
- School supervisors can assign Export Center access (Read/Write) and restrict scopes in Tool Manager (
/tool-manager/export-center).
- School supervisors can assign Export Center access (Read/Write) and restrict scopes in Tool Manager (
13. Supervisions
The Supervisions tool (/supervisions) provides every active teacher with a dedicated self-service portal to manage relief duties and personal absences:
- Personal Duty Dashboard: View upcoming and active cover duties assigned to you for the day and term. Each duty card displays the date, period number, subject class name, room location, and the name of the absent colleague you are covering.
- School Timezone Anchoring: Absence declarations, relief duty calendars, and pending duty alerts are synchronized against the school's local timezone (Atlantic Standard Time, UTC-4), ensuring duty schedules remain consistent regardless of individual device clock settings or VPN usage.
- Teacher Instructions: Review instructions and lesson activities left by the absent teacher directly on the duty card so classroom learning continues without disruption.
- Automated "Seen" Status Stamping: Viewing active supervisions on either the staff Home screen dashboard (
/) or within the Supervisions tool (/supervisions) automatically records aSeenstatus timestamp (seenAt), giving relief coordinators instant visibility that the schedule was viewed without requiring any manual clicks. - 1-Tap Daily Schedule Confirmation: When assigned relief duties, teachers confirm their entire day's schedule with a single action. Rather than checking off individual periods, a prominent Today's Supervision Schedule confirmation banner appears at the top of the screen. Clicking Acknowledge Today's Schedule confirms all assigned periods at once, timestamps receipt (
acknowledgedAt), updates the banner to Today's Schedule Confirmed, and immediately sends a confirmation notification to the school relief coordinators. - Consolidated Duty Notifications: When the daily relief roster is published, covering teachers receive a single consolidated email detailing all assigned periods, classes, rooms, and instructions for the day, along with a direct deep link to
/supervisionsto acknowledge the schedule. - Report Personal Absence:
- Submit planned or emergency absences in advance.
- Choose between All Day absence or specify individual periods (e.g. Periods 3 and 4 for a medical appointment).
- Select standard absence reasons: Illness, Medical Appointment, School Business, Bereavement, Personal, or Other.
- Add optional notes or relief instructions for substitute colleagues.
- Submitting an absence automatically notifies all designated school relief managers via email, logs the absence in the Supervision Manager, and generates unassigned relief cover slots for the teacher's scheduled timetable periods.
- My Reported Absences & View Toggle:
- Use the top segmented view control to toggle between My Cover Duties and My Reported Absences.
- Review all active and past absences from the last 7 days and all upcoming dates.
- Each absence record displays date, coverage scope (all day or period-specific), reason, substitute instructions, submission timestamp, and status.
- Cancel Absence (Teacher Attending School):
- If plans change and a teacher is now able to attend school, they can select Cancel Absence from the absence card options.
- Cancelling marks the absence as
CANCELLED, automatically releases any assigned substitute teachers so they immediately become available for other relief duties in those periods, and preserves an audit trail of the cancellation.
- Delete Record (Immediate Mistake):
- If an absence was submitted accidentally or with incorrect parameters, teachers can select Delete Record.
- Deleting permanently purges the absence and its associated relief cover slots from the database without cluttering the cancellation audit history.
14. Supervision Manager
The Supervision Manager tool (/supervision-manager) is an administrative suite for Vice Principals, Deans, and designated Relief Coordinators to manage teacher coverage equitably and communicate assignments reliably:
- Consolidated "Publish" Model:
- To eliminate email fatigue and false alarms from intermediate edits or accidental assignments, all coordinator actions (assigning substitutes, swapping teachers, editing instructions, cancelling duties, or logging phone-in absences) remain unpublished Drafts.
- No notification emails are dispatched while the coordinator builds, adjusts, and finalizes the relief schedule.
- Live Draft Tracking & Publish Schedule Workflow:
- The top app bar displays a real-time count of pending modifications (e.g. Publish Supervisions (N) or Publish Updates (N)), and the date navigation bar shows an orange Unpublished Drafts chip.
- Clicking the publish button opens a confirmation modal detailing the release.
- Upon confirming, the system finalizes the roster, sets
published = true, stampspublishedAt = NOW(), and dispatches consolidated notification emails:- Covering Teachers: Receive a single consolidated email listing all periods, rooms, classes, and lesson instructions for the day with an acknowledgment deep link.
- Absent Teachers: Receive a consolidated summary informing them which colleagues are covering each of their classes.
- Republishing & Targeted Delta-Notifications:
- When schedule modifications occur after initial publication (such as late morning phone-ins, period swaps, or duty cancellations), coordinators click Publish Updates (N).
- The system isolates exact modifications and dispatches emails strictly to impacted teachers:
- Newly assigned or modified substitute teachers receive an updated schedule email and are prompted to re-acknowledge.
- Substitute teachers relieved of a duty receive a cancellation notice.
- Absent teachers with altered coverage receive an updated coverage summary.
- Unaffected teachers receive zero emails, and their existing acknowledgment timestamp is preserved.
- Granular Status Badges:
- The Class Cover Schedule Matrix displays real-time badges indicating the state of each duty:
- Needs Relief Cover: Amber chip; period currently has no assigned substitute teacher.
- Draft (Unpublished): Orange chip; substitute teacher assigned by coordinator, pending publication.
- Published • Unread: Neutral chip; published schedule has not yet been viewed by the covering teacher.
- Seen at [time] • Pending Ack: Indigo chip; teacher opened Home or Supervisions, viewing their assigned duties.
- Acknowledged at [time]: Green chip; teacher completed the 1-tap confirmation for their daily schedule.
- The Class Cover Schedule Matrix displays real-time badges indicating the state of each duty:
- Staff Room Notice Board Print View:
- Coordinators can click Print Schedule in the top app bar to generate an official 8.5" x 11" landscape notice board document (
supervision_schedule_YYYY-MM-DD.pdf). - Built with the institutional school crest, date, summary metrics, absent teachers, timetable periods, classes, rooms, covering teachers, and instructions.
- Includes a dedicated Staff Sign-Off / Initials column for physical verification on the staff room notice board, serving as a dependable offline backup to email notifications.
- Coordinators can click Print Schedule in the top app bar to generate an official 8.5" x 11" landscape notice board document (
- Absence Console & Phone-In Logging:
- View all teacher absences for the selected date with real-time status chips (REPORTED, APPROVED, CANCELLED).
- When a teacher calls in by phone to report an absence, relief coordinators can log the absence on behalf of the teacher with full audit tracking. Phone-in absences generate draft relief slots without sending immediate notifications until published.
- Coordinators can Cancel an absence if the instructor attends school, which immediately revokes the relief slots, releases covering teachers back to the available candidate pool, and clears the period matrix.
- Coordinators can Delete erroneous or duplicate entries permanently to maintain a clean database.
- Schedule Sync & Slot Timetable:
- Timetable period definitions and slot assignments are synchronized directly from EduPage exports.
- Missing or vacant periods are automatically mapped against the master schedule to show precisely which classes and rooms require cover.
- Equity-Based Candidate Ranking:
- When assigning a relief teacher for a period, the system evaluates all active teaching staff and excludes those who are teaching regular classes, already covering another duty in that period, or marked absent.
- Exempt Staff Filtering: Teachers marked as non-eligible for supervisions (
eligibleForSupervision = false) in Staff Manager are filtered out of standard candidate rankings, preventing school leadership (e.g. Principal, Vice Principal) from floating to the top of duty recommendations. - Eligible teachers are ranked by an Equity Score designed to distribute relief work fairly across the faculty:
- Prioritizes teachers who have done the fewest covers this term.
- Heavily penalizes teachers who have already been assigned a supervision today.
- Considers timetable gaps and free period availability.
- Coordinators can view a transparent breakdown of each candidate's score (today's duty count, term duties, and availability score) before assigning.
- Emergency Override (Show Exempt Staff): In rare high-absence emergency scenarios where all regular free teachers are exhausted, coordinators can expand the Show Exempt Staff [Emergency Override] panel at the bottom of the candidate drawer to view and assign free exempt staff tagged with an amber EXEMPT chip.
- Access Delegation in Tool Manager:
- Relief manager permissions are administered via Tool Manager (
/tool-manager/supervision-manager), allowing administrators to grant or revoke coordinator access securely.
- Relief manager permissions are administered via Tool Manager (
15. System Status Alerts (System Settings)
Supervisors with administrative capabilities (users with access to the Tool Manager) can manage global system announcements:
- Configure Alerts: Go to the Settings screen (accessible via the user profile menu/global navigation).
- Toggle Banner: Check or uncheck Enable Status Alert Banner to turn the banner on or off.
- Set Message: Edit the Alert Message text field to describe current scheduled maintenance, outages, or important school-wide notices.
- Save: Click Save Alert Settings. Once saved, the alert banner will display immediately at the top of the Sign-In screen and the Home screen for all users.
16. Upcoming Events (Home Screen)
All staff members have direct access to the Upcoming Events card on the Home Screen dashboard:
- Upcoming Calendar: Review upcoming school events, exam periods, assemblies, staff meetings, and official holidays.
- Dynamic Grouping: View events quickly for today, tomorrow, this week, or future dates.
- Event Details: Each event card displays the event category, date/time, location, and relevant descriptions.
17. In-App Application Updates
Progress Edu. includes seamless background version detection:
- Automatic Update Detection: The application routinely checks for newly deployed versions in the background.
- Responsive Alerts: When an update is ready, a banner appears at the top of the screen on mobile devices, or an update notification icon appears in the navigation rail on desktop screens.
- One-Click Refresh: Click Update Now to instantly reload the app and run the latest release.
Need Help?
If you have questions, need technical assistance, or want to report a bug while performing administrative tasks, click the floating Help & Support icon (represented by the contact support icon) in the bottom-right corner of any screen. You can submit a support ticket directly to the Progress Edu. team. The system will automatically bundle details about your account, app version, and device environment to assist in troubleshooting.
