How yumesenseii/cnhs-centralized-school-data-system works
CNHS LEARN is a school academic-management portal for administrators, teachers, and students. Its central workflow is importing class records, organizing grades and rosters, monitoring learner progress, and presenting risk recommendations and reports; attendance, lesson plans, interventions, and student self-service are additional product branches. The graph uses the supplied excerpts and SOURCE INDEX references; unsampled page and subsystem internals are represented at directory level, and their unshown connections are omitted.
Main entry points: (teacher) Teacher portal · randomForestEngine.js Risk recommendations · route.js Prediction gateway · useMonitoring.js Learner monitoring
Components 24
Role Portals
- Admin portal
app/(admin) - Teacher portal
app/(teacher) - Student portal
app/(student) - Authentication
hooks/useAuth.js
Academic Records
- Class records
lib/eclass - Gradebook & ECR
hooks/teacher/useEcrRecord.js - Attendance
lib/attendance - Lesson plans
lib/supabase/queries/lessonPlans.js - Roster & classes
lib/supabase/queries/myClasses.js
Monitoring & Support
- Learner monitoring
hooks/teacher/useMonitoring.js - ARAL interventions
lib/supabase/queries/aralProgram.js - Risk recommendations
lib/services/recommendation/randomForestEngine.js - Grade features
lib/services/recommendation/features.js - Inference client
lib/services/recommendation/inferenceClient.js - Local fallback
lib/services/recommendation/localEnsemble.js
Data & Services
- Prediction gateway
app/api/recommendations/predict-batch/route.js - Supabase
lib/supabase/client.js - ML inference service
ml-service/app/main.py
Insights & Reporting
- Reports & exports
lib/supabase/queries/reports.js - Admin academic records
hooks/admin/useAcademicRecords.js - Notifications
lib/supabase/queries/notifications.js
Other components
- Teacher
- Administrator
- Student
Connections 31
- Teacher → Teacher portal: uses
- Administrator → Admin portal: uses
- Student → Student portal: uses
- Teacher portal → Authentication: authenticates with
- Admin portal → Authentication: authenticates with
- Student portal → Authentication: authenticates with
- Teacher portal → Class records: imports records
- Class records → Gradebook & ECR: provides parsed grades
- Gradebook & ECR → Supabase: reads and writes
hooks/teacher/useEcrRecord.js - Teacher portal → Attendance: records attendance
- Teacher portal → Lesson plans: submits plans
- Teacher portal → Roster & classes: loads classes
- Teacher portal → Learner monitoring: reviews learners
- Learner monitoring → Roster & classes: loads roster
hooks/teacher/useMonitoring.js - Learner monitoring → ARAL interventions: loads approvals
hooks/teacher/useMonitoring.js - Learner monitoring → Risk recommendations: repredicts grades
hooks/teacher/useMonitoring.js - Risk recommendations → Grade features: builds features
lib/services/recommendation/randomForestEngine.js - Risk recommendations → Prediction gateway: requests batch predictions
lib/services/recommendation/randomForestEngine.js - Risk recommendations → Inference client: requests inference
lib/services/recommendation/randomForestEngine.js - Risk recommendations → Local fallback: uses fallback
lib/services/recommendation/randomForestEngine.js - Prediction gateway → Supabase: checks session and role
app/api/recommendations/predict-batch/route.js - Prediction gateway → Grade features: builds features
app/api/recommendations/predict-batch/route.js - Prediction gateway → Inference client: requests batch inference
app/api/recommendations/predict-batch/route.js - Prediction gateway → Local fallback: uses fallback
app/api/recommendations/predict-batch/route.js - Inference client → Local fallback: falls back locally
lib/services/recommendation/inferenceClient.js - Inference client → ML inference service: calls inference API
lib/services/recommendation/inferenceClient.js - Admin portal → Admin academic records: browses records
hooks/admin/useAcademicRecords.js - Admin academic records → Reports & exports: loads report bundle
hooks/admin/useAcademicRecords.js - Admin academic records → Roster & classes: builds monitoring roster
hooks/admin/useAcademicRecords.js - Student portal → Supabase: loads portal data
- Teacher portal → Notifications: views notifications