{"success":true,"message":"School Management System API","version":"1.0.0","environment":"production","timestamp":"2026-10-31T17:08:57.873Z","endpoints":{"health":[{"method":"GET","path":"/health","description":"Check API and database health"}],"auth":[{"method":"POST","path":"/api/auth/login","description":"Log in"}],"platformOwner":[{"method":"POST","path":"/api/platform-owner/login","description":"Platform owner log in"},{"method":"PATCH","path":"/api/platform-owner/school-access","description":"Block or unblock this school's system access"}],"staff":[{"method":"POST","path":"/api/staff","description":"Create a staff member"},{"method":"GET","path":"/api/staff","description":"List staff members"},{"method":"GET","path":"/api/staff/section/:sectionId","description":"List staff by section"},{"method":"GET","path":"/api/staff/summary","description":"Get the staff summary"},{"method":"GET","path":"/api/staff/:id/subjects","description":"Get subjects assigned to a staff member"},{"method":"GET","path":"/api/staff/:id","description":"Get a staff member by ID"},{"method":"PUT","path":"/api/staff/:id","description":"Update a staff member"},{"method":"DELETE","path":"/api/staff/:id","description":"Delete a staff member"}],"students":[{"method":"POST","path":"/api/students","description":"Create a student"},{"method":"GET","path":"/api/students","description":"List students"},{"method":"GET","path":"/api/students/summary","description":"Get the student summary"},{"method":"GET","path":"/api/students/overall-summary","description":"Get the overall student summary"},{"method":"GET","path":"/api/students/me","description":"Get the current student's profile"},{"method":"GET","path":"/api/students/generate-admission-number","description":"Generate an admission number"},{"method":"GET","path":"/api/students/current-year","description":"List students in the current academic year"},{"method":"GET","path":"/api/students/class/:class_id","description":"List students by class"},{"method":"GET","path":"/api/students/:id/details","description":"Get student details"},{"method":"GET","path":"/api/students/:id","description":"Get a student by ID"},{"method":"PATCH","path":"/api/students/change-status","description":"Change student status"},{"method":"PATCH","path":"/api/students/change-class","description":"Change a student's class"},{"method":"PUT","path":"/api/students/:id","description":"Update a student"},{"method":"DELETE","path":"/api/students/:id","description":"Delete a student"}],"parents":[{"method":"POST","path":"/api/parents","description":"Create a parent"},{"method":"GET","path":"/api/parents","description":"List parents"},{"method":"GET","path":"/api/parents/me","description":"Get the current parent's profile"},{"method":"GET","path":"/api/parents/me/children","description":"List the current parent's children"},{"method":"GET","path":"/api/parents/me/children/:childId","description":"Get a child's profile"},{"method":"GET","path":"/api/parents/:id","description":"Get a parent by ID"},{"method":"PUT","path":"/api/parents/:id","description":"Update a parent"},{"method":"DELETE","path":"/api/parents/:id","description":"Delete a parent"}],"academicYears":[{"method":"POST","path":"/api/academic-years","description":"Create an academic year"},{"method":"GET","path":"/api/academic-years/summary","description":"Get the academic-year summary"},{"method":"GET","path":"/api/academic-years","description":"List academic years"},{"method":"GET","path":"/api/academic-years/:id","description":"Get an academic year by ID"},{"method":"PUT","path":"/api/academic-years/:id","description":"Update an academic year"},{"method":"PATCH","path":"/api/academic-years/:id/activate","description":"Activate an academic year"},{"method":"DELETE","path":"/api/academic-years/:id","description":"Delete an academic year"}],"terms":[{"method":"POST","path":"/api/terms","description":"Create a term"},{"method":"GET","path":"/api/terms","description":"List terms"},{"method":"GET","path":"/api/terms/current-academic-year","description":"List terms for the current academic year"},{"method":"GET","path":"/api/terms/academic-year/:id","description":"List terms by academic year"},{"method":"GET","path":"/api/terms/:id","description":"Get a term by ID"},{"method":"PUT","path":"/api/terms/:id","description":"Update a term"},{"method":"PATCH","path":"/api/terms/:id/activate","description":"Activate a term"},{"method":"DELETE","path":"/api/terms/:id","description":"Delete a term"}],"sections":[{"method":"POST","path":"/api/sections","description":"Create a section"},{"method":"GET","path":"/api/sections","description":"List sections"},{"method":"GET","path":"/api/sections/:id/summary","description":"Get a section summary"},{"method":"GET","path":"/api/sections/:id","description":"Get a section by ID"},{"method":"PUT","path":"/api/sections/:id","description":"Update a section"},{"method":"DELETE","path":"/api/sections/:id","description":"Delete a section"}],"classes":[{"method":"POST","path":"/api/classes","description":"Create a class"},{"method":"GET","path":"/api/classes/section/:sectionId","description":"List classes by section"},{"method":"GET","path":"/api/classes","description":"List classes"},{"method":"GET","path":"/api/classes/:id/summary","description":"Get a class summary"},{"method":"GET","path":"/api/classes/:id","description":"Get a class by ID"},{"method":"PUT","path":"/api/classes/:id","description":"Update a class"},{"method":"DELETE","path":"/api/classes/:id","description":"Delete a class"}],"subjects":[{"method":"POST","path":"/api/subjects","description":"Create a subject"},{"method":"GET","path":"/api/subjects","description":"List subjects"},{"method":"GET","path":"/api/subjects/section/:section_id","description":"List subjects by section"},{"method":"GET","path":"/api/subjects/:id","description":"Get a subject by ID"},{"method":"PUT","path":"/api/subjects/:id","description":"Update a subject"},{"method":"DELETE","path":"/api/subjects/:id","description":"Delete a subject"}],"classSubjects":[{"method":"POST","path":"/api/class-subjects","description":"Create a class-subject record"},{"method":"GET","path":"/api/class-subjects","description":"List class-subject records"},{"method":"GET","path":"/api/class-subjects/:id","description":"Get a class-subject record by ID"},{"method":"PUT","path":"/api/class-subjects/:id","description":"Update a class-subject record"},{"method":"DELETE","path":"/api/class-subjects/:id","description":"Delete a class-subject record"}],"classAssignSubjects":[{"method":"POST","path":"/api/class-assign-subjects","description":"Create a class-subject assignment"},{"method":"GET","path":"/api/class-assign-subjects/class/:classId","description":"List subject assignments by class"},{"method":"GET","path":"/api/class-assign-subjects","description":"List class-subject assignments"},{"method":"GET","path":"/api/class-assign-subjects/:id","description":"Get an assignment by ID"},{"method":"PUT","path":"/api/class-assign-subjects/:id","description":"Update a class-subject assignment"},{"method":"DELETE","path":"/api/class-assign-subjects/:id","description":"Delete a class-subject assignment"}],"guardians":[{"method":"POST","path":"/api/guardians","description":"Create a guardian"},{"method":"GET","path":"/api/guardians","description":"List guardians"},{"method":"GET","path":"/api/guardians/search","description":"Search guardians by phone"},{"method":"GET","path":"/api/guardians/:id","description":"Get a guardian by ID"},{"method":"PUT","path":"/api/guardians/:id","description":"Update a guardian"},{"method":"DELETE","path":"/api/guardians/:id","description":"Delete a guardian"}],"studentProfiles":[{"method":"POST","path":"/api/student-profiles","description":"Create a student profile"},{"method":"GET","path":"/api/student-profiles","description":"List student profiles"},{"method":"GET","path":"/api/student-profiles/:id","description":"Get a student profile by ID"},{"method":"PUT","path":"/api/student-profiles/:id","description":"Update a student profile"},{"method":"DELETE","path":"/api/student-profiles/:id","description":"Delete a student profile"}],"studentHealthRecords":[{"method":"POST","path":"/api/student-health-records","description":"Create a student health record"},{"method":"GET","path":"/api/student-health-records","description":"List student health records"},{"method":"GET","path":"/api/student-health-records/:id","description":"Get a student health record by ID"},{"method":"PUT","path":"/api/student-health-records/:id","description":"Update a student health record"},{"method":"DELETE","path":"/api/student-health-records/:id","description":"Delete a student health record"}],"studentDocuments":[{"method":"POST","path":"/api/student-documents","description":"Create a student document"},{"method":"GET","path":"/api/student-documents","description":"List student documents"},{"method":"GET","path":"/api/student-documents/:id","description":"Get a student document by ID"},{"method":"PUT","path":"/api/student-documents/:id","description":"Update a student document"},{"method":"DELETE","path":"/api/student-documents/:id","description":"Delete a student document"}],"gradingSystem":[{"method":"POST","path":"/api/grading-system","description":"Create a grading schema"},{"method":"GET","path":"/api/grading-system","description":"List grading schemas"},{"method":"GET","path":"/api/grading-system/:id","description":"Get a grading schema by ID"},{"method":"PUT","path":"/api/grading-system/:id","description":"Update a grading schema"},{"method":"DELETE","path":"/api/grading-system/:id","description":"Delete a grading schema"}],"studentExamRecords":[{"method":"POST","path":"/api/student-exam-records/bulk-store","description":"Store exam records in bulk"},{"method":"GET","path":"/api/student-exam-records/filter","description":"Filter exam records by class, subject, and year"},{"method":"GET","path":"/api/student-exam-records/exam-and-position","description":"Get exam and position records"}],"studentClassHistories":[{"method":"GET","path":"/api/student-class-histories","description":"List student class histories"},{"method":"GET","path":"/api/student-class-histories/current-year","description":"List students in the current academic year"},{"method":"GET","path":"/api/student-class-histories/class/:class_id","description":"List students by class"},{"method":"GET","path":"/api/student-class-histories/student/:student_id","description":"Get a student's class history"},{"method":"GET","path":"/api/student-class-histories/summary","description":"Get the student summary"},{"method":"GET","path":"/api/student-class-histories/overall-summary","description":"Get the overall student summary"},{"method":"GET","path":"/api/student-class-histories/get-students-for-promotion/:class_id","description":"Get students eligible for promotion by class"},{"method":"PATCH","path":"/api/student-class-histories/status","description":"Update student status"},{"method":"POST","path":"/api/student-class-histories/enroll","description":"Enroll a student"}],"examLockStatus":[{"method":"POST","path":"/api/exam-lock-status","description":"Create an exam-lock status"},{"method":"GET","path":"/api/exam-lock-status","description":"List exam-lock statuses"},{"method":"GET","path":"/api/exam-lock-status/:id","description":"Get an exam-lock status by ID"},{"method":"PUT","path":"/api/exam-lock-status/:id","description":"Update an exam-lock status"},{"method":"DELETE","path":"/api/exam-lock-status/:id","description":"Delete an exam-lock status"}],"roles":[{"method":"POST","path":"/api/roles","description":"Create a role"},{"method":"PUT","path":"/api/roles/:id","description":"Update a role"},{"method":"GET","path":"/api/roles","description":"List roles"},{"method":"GET","path":"/api/roles/:id","description":"Get a role by ID"},{"method":"DELETE","path":"/api/roles/:id","description":"Delete a role"}],"pdf":[{"method":"GET","path":"/api/pdf/test","description":"Generate a test PDF"},{"method":"POST","path":"/api/pdf/generate","description":"Generate a PDF from request data"},{"method":"POST","path":"/api/pdf/generate-scoresheet","description":"Generate a scoresheet"},{"method":"POST","path":"/api/pdf/generate-single-scoresheet","description":"Generate a single-student scoresheet"},{"method":"POST","path":"/api/pdf/generate-broadsheet","description":"Generate a broadsheet"}],"dashboard":[{"method":"GET","path":"/api/dashboard/academic-progress","description":"Get academic progress"},{"method":"GET","path":"/api/dashboard/summary","description":"Get the dashboard summary"},{"method":"GET","path":"/api/dashboard/student-gender-summary","description":"Get the student gender summary"},{"method":"GET","path":"/api/dashboard/section-student-summary","description":"Get the section student summary"},{"method":"GET","path":"/api/dashboard/current-session","description":"Get the current session"},{"method":"GET","path":"/api/dashboard/staff/:staffId/assignment-summary","description":"Get a staff member's assignment summary"}]}}