# yumesenseii/cnhs-centralized-school-data-system architecture

> Architecture diagram of the GitHub repository yumesenseii/cnhs-centralized-school-data-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yumesenseii/cnhs-centralized-school-data-system
- Repository: https://github.com/yumesenseii/cnhs-centralized-school-data-system

## Overview

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: [`app/(teacher)`](https://github.com/yumesenseii/cnhs-centralized-school-data-system/tree/main/app/(teacher)) (Teacher portal), [`lib/services/recommendation/randomForestEngine.js`](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/services/recommendation/randomForestEngine.js) (Risk recommendations), [`app/api/recommendations/predict-batch/route.js`](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/app/api/recommendations/predict-batch/route.js) (Prediction gateway), [`hooks/teacher/useMonitoring.js`](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/hooks/teacher/useMonitoring.js) (Learner monitoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["Role Portals"]
  node_admin["Admin portal"]
  node_teacher["Teacher portal"]
  node_student["Student portal"]
  node_auth["Authentication<br/>[useAuth.js]"]
end

subgraph group_records["Academic Records"]
  node_classrecords["Class records"]
  node_gradebook["Gradebook &amp; ECR<br/>[useEcrRecord.js]"]
  node_attendance["Attendance"]
  node_lessonplans["Lesson plans<br/>[lessonPlans.js]"]
  node_roster["Roster &amp; classes<br/>[myClasses.js]"]
end

subgraph group_monitoring["Monitoring &amp; Support"]
  node_monitoring["Learner monitoring<br/>[useMonitoring.js]"]
  node_aral["ARAL interventions<br/>[aralProgram.js]"]
  node_recommendations["Risk recommendations"]
  node_featureeng["Grade features<br/>[features.js]"]
  node_inference["Inference client<br/>[inferenceClient.js]"]
  node_fallback["Local fallback<br/>[localEnsemble.js]"]
end

subgraph group_platform["Data &amp; Services"]
  node_gateway["Prediction gateway<br/>[route.js]"]
  node_database[("Supabase<br/>[client.js]")]
  node_mlservice["ML inference service<br/>[main.py]"]
end

subgraph group_insights["Insights &amp; Reporting"]
  node_reports["Reports &amp; exports<br/>[reports.js]"]
  node_academicrecords["Admin academic records"]
  node_notifications["Notifications<br/>[notifications.js]"]
end

node_teacher_actor(("Teacher"))
node_admin_actor(("Administrator"))
node_student_actor(("Student"))

node_teacher_actor -->|"uses"| node_teacher
node_admin_actor -->|"uses"| node_admin
node_student_actor -->|"uses"| node_student
node_teacher -.->|"authenticates with"| node_auth
node_admin -.->|"authenticates with"| node_auth
node_student -.->|"authenticates with"| node_auth
node_teacher -.->|"imports records"| node_classrecords
node_classrecords -.->|"provides parsed grades"| node_gradebook
node_gradebook -->|"reads and writes"| node_database
node_teacher -.->|"records attendance"| node_attendance
node_teacher -.->|"submits plans"| node_lessonplans
node_teacher -->|"loads classes"| node_roster
node_teacher -.->|"reviews learners"| node_monitoring
node_monitoring -->|"loads roster"| node_roster
node_monitoring -->|"loads approvals"| node_aral
node_monitoring -->|"repredicts grades"| node_recommendations
node_recommendations -->|"builds features"| node_featureeng
node_recommendations -->|"requests batch predictions"| node_gateway
node_recommendations -->|"requests inference"| node_inference
node_recommendations -->|"uses fallback"| node_fallback
node_gateway -->|"checks session and role"| node_database
node_gateway -->|"builds features"| node_featureeng
node_gateway -->|"requests batch inference"| node_inference
node_gateway -->|"uses fallback"| node_fallback
node_inference -->|"falls back locally"| node_fallback
node_inference -->|"calls inference API"| node_mlservice
node_admin -->|"browses records"| node_academicrecords
node_academicrecords -->|"loads report bundle"| node_reports
node_academicrecords -->|"builds monitoring roster"| node_roster
node_student -->|"loads portal data"| node_database
node_teacher -.->|"views notifications"| node_notifications

click node_admin "https://github.com/yumesenseii/cnhs-centralized-school-data-system/tree/main/app/(admin)"
click node_teacher "https://github.com/yumesenseii/cnhs-centralized-school-data-system/tree/main/app/(teacher)"
click node_student "https://github.com/yumesenseii/cnhs-centralized-school-data-system/tree/main/app/(student)"
click node_auth "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/hooks/useAuth.js"
click node_classrecords "https://github.com/yumesenseii/cnhs-centralized-school-data-system/tree/main/lib/eclass"
click node_gradebook "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/hooks/teacher/useEcrRecord.js"
click node_attendance "https://github.com/yumesenseii/cnhs-centralized-school-data-system/tree/main/lib/attendance"
click node_lessonplans "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/supabase/queries/lessonPlans.js"
click node_roster "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/supabase/queries/myClasses.js"
click node_monitoring "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/hooks/teacher/useMonitoring.js"
click node_aral "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/supabase/queries/aralProgram.js"
click node_recommendations "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/services/recommendation/randomForestEngine.js"
click node_featureeng "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/services/recommendation/features.js"
click node_inference "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/services/recommendation/inferenceClient.js"
click node_fallback "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/services/recommendation/localEnsemble.js"
click node_gateway "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/app/api/recommendations/predict-batch/route.js"
click node_database "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/supabase/client.js"
click node_mlservice "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/ml-service/app/main.py"
click node_reports "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/supabase/queries/reports.js"
click node_academicrecords "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/hooks/admin/useAcademicRecords.js"
click node_notifications "https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/supabase/queries/notifications.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_admin,node_teacher,node_student,node_auth toneBlue
class node_classrecords,node_gradebook,node_attendance,node_lessonplans,node_roster toneAmber
class node_monitoring,node_aral,node_recommendations,node_featureeng,node_inference,node_fallback toneMint
class node_gateway,node_database,node_mlservice toneRose
class node_reports,node_academicrecords,node_notifications,node_teacher_actor,node_admin_actor,node_student_actor toneIndigo
```

## Components

### Role Portals

- [Admin portal](https://github.com/yumesenseii/cnhs-centralized-school-data-system/tree/main/app/(admin)): `app/(admin)`
- [Teacher portal](https://github.com/yumesenseii/cnhs-centralized-school-data-system/tree/main/app/(teacher)): `app/(teacher)`
- [Student portal](https://github.com/yumesenseii/cnhs-centralized-school-data-system/tree/main/app/(student)): `app/(student)`
- [Authentication](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/hooks/useAuth.js): `hooks/useAuth.js`

### Academic Records

- [Class records](https://github.com/yumesenseii/cnhs-centralized-school-data-system/tree/main/lib/eclass): `lib/eclass`
- [Gradebook & ECR](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/hooks/teacher/useEcrRecord.js): `hooks/teacher/useEcrRecord.js`
- [Attendance](https://github.com/yumesenseii/cnhs-centralized-school-data-system/tree/main/lib/attendance): `lib/attendance`
- [Lesson plans](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/supabase/queries/lessonPlans.js): `lib/supabase/queries/lessonPlans.js`
- [Roster & classes](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/supabase/queries/myClasses.js): `lib/supabase/queries/myClasses.js`

### Monitoring & Support

- [Learner monitoring](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/hooks/teacher/useMonitoring.js): `hooks/teacher/useMonitoring.js`
- [ARAL interventions](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/supabase/queries/aralProgram.js): `lib/supabase/queries/aralProgram.js`
- [Risk recommendations](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/services/recommendation/randomForestEngine.js): `lib/services/recommendation/randomForestEngine.js`
- [Grade features](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/services/recommendation/features.js): `lib/services/recommendation/features.js`
- [Inference client](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/services/recommendation/inferenceClient.js): `lib/services/recommendation/inferenceClient.js`
- [Local fallback](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/services/recommendation/localEnsemble.js): `lib/services/recommendation/localEnsemble.js`

### Data & Services

- [Prediction gateway](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/app/api/recommendations/predict-batch/route.js): `app/api/recommendations/predict-batch/route.js`
- [Supabase](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/supabase/client.js): `lib/supabase/client.js`
- [ML inference service](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/ml-service/app/main.py): `ml-service/app/main.py`

### Insights & Reporting

- [Reports & exports](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/supabase/queries/reports.js): `lib/supabase/queries/reports.js`
- [Admin academic records](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/hooks/admin/useAcademicRecords.js): `hooks/admin/useAcademicRecords.js`
- [Notifications](https://github.com/yumesenseii/cnhs-centralized-school-data-system/blob/main/lib/supabase/queries/notifications.js): `lib/supabase/queries/notifications.js`

### Other components

- **Teacher**
- **Administrator**
- **Student**

## Connections

- 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 (evidence: `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 (evidence: `hooks/teacher/useMonitoring.js`)
- Learner monitoring → ARAL interventions: loads approvals (evidence: `hooks/teacher/useMonitoring.js`)
- Learner monitoring → Risk recommendations: repredicts grades (evidence: `hooks/teacher/useMonitoring.js`)
- Risk recommendations → Grade features: builds features (evidence: `lib/services/recommendation/randomForestEngine.js`)
- Risk recommendations → Prediction gateway: requests batch predictions (evidence: `lib/services/recommendation/randomForestEngine.js`)
- Risk recommendations → Inference client: requests inference (evidence: `lib/services/recommendation/randomForestEngine.js`)
- Risk recommendations → Local fallback: uses fallback (evidence: `lib/services/recommendation/randomForestEngine.js`)
- Prediction gateway → Supabase: checks session and role (evidence: `app/api/recommendations/predict-batch/route.js`)
- Prediction gateway → Grade features: builds features (evidence: `app/api/recommendations/predict-batch/route.js`)
- Prediction gateway → Inference client: requests batch inference (evidence: `app/api/recommendations/predict-batch/route.js`)
- Prediction gateway → Local fallback: uses fallback (evidence: `app/api/recommendations/predict-batch/route.js`)
- Inference client → Local fallback: falls back locally (evidence: `lib/services/recommendation/inferenceClient.js`)
- Inference client → ML inference service: calls inference API (evidence: `lib/services/recommendation/inferenceClient.js`)
- Admin portal → Admin academic records: browses records (evidence: `hooks/admin/useAcademicRecords.js`)
- Admin academic records → Reports & exports: loads report bundle (evidence: `hooks/admin/useAcademicRecords.js`)
- Admin academic records → Roster & classes: builds monitoring roster (evidence: `hooks/admin/useAcademicRecords.js`)
- Student portal → Supabase: loads portal data
- Teacher portal → Notifications: views notifications
