How to Use Student Score Management System

Super Admin Tasks

• Dashboard: View school-level usage summary and key system numbers.
• Add School: Create school profile and school-admin login in one flow.
• View Schools: Edit school profile, update admin account, and toggle school operations ON/OFF.
• Reports: Review issue reports from schools and users.

Access & Login

School Admin Handbook

Role summary: The school admin manages one school tenant. They handle setup, people, academics, communication, monitoring, and recovery for that school.

Can Do

• Manage students, teachers, parents, subjects, timetable, and school settings.
• Publish results, approve or reject submissions, and correct result records where allowed.
• Send messages to students and teachers.
• Review disputes, data requests, audits, analytics, and system health.
• Run backups, restore checks, and disaster recovery drills.
• Control school-specific operations and access state.

Cannot Do

• Manage other schools.
• Use super-admin-only global controls.
• Bypass access restrictions or locked-school states.
• Edit platform-wide settings for every tenant.

Main Menu Guide

• Dashboard: School overview, alerts, and shortcuts.
• Student: View Students, Add Students, Reset Requests, Subject Requests, Parent records, Parent Contacts.
• Teachers: Teacher List, Assign Teacher, Teacher Workload.
• Academics: Publish Results, Class Subjects, CBT, Timetable, Term Programs, New Term Wizard, Promote Students.
• Monitoring: Analytics, Data Integrity, Score Audit Log, Attendance Integrity, Attendance Summary, Timetable Coverage, Result Disputes, Reports, Promotion Audit.
• Communication: Messages, SMS Health, SMS Logs.
• System: School Settings, Bulk/Backup, Security Logs, Action Audit, System Health, Recovery Drill.
• Support: Report Issue, Data Requests, Help, Change Password, Logout.

Recommended Setup Order

• Open School Profile and Academic Settings to confirm school details, term/year, and access state.
• Configure Class Subjects and Timetable.
• Add Teachers and assign class/subject roles.
• Add Students and confirm class placement.
• Test Messages and then review Analytics/Data Integrity.
• Take a Backup before major changes.

Teacher Tasks

• Allocate Stream: For stream-based SS classes, assign stream before scoring.
• Enter Scores: Use score page per student with strict max validation.
• Upload CSV: Upload class score updates using in-app template only.
• Submit for Approval: Class teacher submits only when all assigned subjects are complete.
• Signature Required: Only class teacher submission for approval requires teacher signature.

CSV Upload (Critical Rules)

• Use Template First: Always download the in-app CSV template before editing.
• Required Columns: Student ID and Subject must exist and must match existing student records.
• Class Access Check: Teacher can upload only for classes currently assigned to that teacher.
• Published Lock: If a class is already published for the current term/year, upload is blocked.
• Exam Mode Strictness: Combined mode accepts only Exam Score. Separate mode accepts only Objective and Theory.
• Score Validation: Every test/exam value is validated against school limits (no negative scores, no values above maximum).
• Atomic Save: Upload is all-or-nothing. If one row fails, no row is saved.
• Blank Value Behavior: If a score field is blank, the system keeps current value for that student/subject field.
• Summary Screen: After upload, check processed rows, updated students, and exact failure reason.
• Error Rows Download: On failure, use "Download Error Rows CSV" to fix and retry quickly.

Results & Visibility

• Publish Gate: Students/parents can view only approved and published class results.
• Approval Stage: Teacher submission is reviewed by school admin before publication.
• Term Navigation: Student and admin views can switch among published terms.
• Operations Toggle: School-wide operation switches affect visibility/editing behavior.
• View Tracking: Published result views are counted for monitoring.

Ranking & Positions

Ranking is automatic based on average marks and school configuration:

• Class ranking supports SS stream-separated or together mode (as configured).
• Tie handling uses same-score position behavior.
• Per-subject positions are also calculated in published results.
• Any score edit requires re-publish before students can see updated result.

Reporting Issues

• Use the "Report Issue" page to submit technical problems.
• Include role, page, action, and exact error message for faster fix.
• Super admin reviews reports from the in-app report viewer page.
• For CSV problems, attach the row details and validation message.