# kurarensu16/sage architecture

> Architecture diagram of the GitHub repository kurarensu16/sage, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kurarensu16/sage
- Repository: https://github.com/kurarensu16/sage

## Overview

ASPIRE is a role-based academic portal spanning administration, faculty grading, dean oversight, and student advising. Its central workflow runs from class and roster setup, through score entry and grade computation/posting, into risk analysis and student-facing guidance, with dean-level monitoring and exports. Supabase-backed classroom services and shared grading/risk logic form key internal layers. The README describes additional evaluation and scheduling features, but their implementation and wiring were not sampled; those capabilities are represented only where the tree supports a relevant portal area.

Main entry points: [`src/App.jsx`](https://github.com/kurarensu16/sage/blob/main/src/App.jsx) (Route application), [`src/lib/classRoomService.js`](https://github.com/kurarensu16/sage/blob/main/src/lib/classRoomService.js) (Classroom service), [`src/lib/gradingMath.js`](https://github.com/kurarensu16/sage/blob/main/src/lib/gradingMath.js) (Grading calculations), [`src/pages/faculty/GradeComputationPreview.jsx`](https://github.com/kurarensu16/sage/blob/main/src/pages/faculty/GradeComputationPreview.jsx) (Grade computation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and Shell"]
  node_app["Route application<br/>[App.jsx]"]
  node_auth["Authentication context<br/>[AuthContext.jsx]"]
  node_login["Public login<br/>[Login.jsx]"]
end

subgraph group_admin["Administration"]
  node_admin["Admin portal"]
  node_audit["Audit ledger<br/>[AuditLog.jsx]"]
end

subgraph group_grading["Teaching and Grading"]
  node_faculty["Faculty portal"]
  node_enroll["Enrollment requests"]
  node_gradepreview["Grade computation"]
  node_export["Grade export preview"]
end

subgraph group_insights["Risk and Advising"]
  node_dean["Dean oversight"]
  node_student["Student portal"]
  node_riskpages["Risk monitoring<br/>[AtRiskStudents.jsx]"]
  node_advising["Academic advising<br/>[advisingEngine.js]"]
  node_riskengine["Risk and tentative grades<br/>[riskEngine.js]"]
end

subgraph group_platform["Data and Services"]
  node_classrooms["Classroom service"]
  node_math["Grading calculations<br/>[gradingMath.js]"]
  node_supabase["Supabase client<br/>[supabase.js]"]
  node_database[("Supabase data")]
  node_openrouter["AI service integration<br/>[openrouter.js]"]
end

node_user(("Portal users"))

node_user -->|"opens portal"| node_app
node_app -->|"provides session"| node_auth
node_app -->|"routes unauthenticated"| node_login
node_app -->|"routes by role"| node_admin
node_app -->|"routes by role"| node_dean
node_app -->|"routes by role"| node_faculty
node_app -->|"routes by role"| node_student
node_faculty -->|"opens requests"| node_enroll
node_enroll -->|"loads and resolves"| node_classrooms
node_enroll -->|"queries classes"| node_supabase
node_gradepreview -->|"resolves formulas"| node_math
node_gradepreview -->|"logs grade posting"| node_audit
node_gradepreview -->|"opens preview"| node_export
node_export -->|"calculates grades"| node_math
node_classrooms -->|"reads and writes"| node_supabase
node_classrooms -->|"calculates roster risk"| node_riskengine
node_classrooms -->|"computes grades"| node_math
node_riskengine -->|"uses grading logic"| node_math
node_supabase -->|"accesses records"| node_database
node_dean -->|"reviews risk"| node_riskpages
node_student -.->|"advising capability"| node_advising
node_riskpages -.->|"risk capability"| node_riskengine
node_advising -.->|"AI integration"| node_openrouter

click node_app "https://github.com/kurarensu16/sage/blob/main/src/App.jsx"
click node_auth "https://github.com/kurarensu16/sage/blob/main/src/lib/AuthContext.jsx"
click node_login "https://github.com/kurarensu16/sage/blob/main/src/pages/public/Login.jsx"
click node_admin "https://github.com/kurarensu16/sage/tree/main/src/pages/admin"
click node_audit "https://github.com/kurarensu16/sage/blob/main/src/pages/admin/AuditLog.jsx"
click node_dean "https://github.com/kurarensu16/sage/tree/main/src/pages/dean"
click node_faculty "https://github.com/kurarensu16/sage/tree/main/src/pages/faculty"
click node_enroll "https://github.com/kurarensu16/sage/blob/main/src/pages/faculty/EnrollmentRequests.jsx"
click node_gradepreview "https://github.com/kurarensu16/sage/blob/main/src/pages/faculty/GradeComputationPreview.jsx"
click node_export "https://github.com/kurarensu16/sage/blob/main/src/components/ExportPreviewModal.jsx"
click node_student "https://github.com/kurarensu16/sage/tree/main/src/pages/student"
click node_riskpages "https://github.com/kurarensu16/sage/blob/main/src/pages/dean/AtRiskStudents.jsx"
click node_advising "https://github.com/kurarensu16/sage/blob/main/src/lib/advisingEngine.js"
click node_riskengine "https://github.com/kurarensu16/sage/blob/main/src/lib/riskEngine.js"
click node_classrooms "https://github.com/kurarensu16/sage/blob/main/src/lib/classRoomService.js"
click node_math "https://github.com/kurarensu16/sage/blob/main/src/lib/gradingMath.js"
click node_supabase "https://github.com/kurarensu16/sage/blob/main/src/lib/supabase.js"
click node_openrouter "https://github.com/kurarensu16/sage/blob/main/src/lib/openrouter.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_app,node_auth,node_login,node_user toneBlue
class node_admin,node_audit toneAmber
class node_faculty,node_enroll,node_gradepreview,node_export toneMint
class node_dean,node_student,node_riskpages,node_advising,node_riskengine toneRose
class node_classrooms,node_math,node_supabase,node_database,node_openrouter toneIndigo
```

## Components

### Access and Shell

- [Route application](https://github.com/kurarensu16/sage/blob/main/src/App.jsx): `src/App.jsx`
- [Authentication context](https://github.com/kurarensu16/sage/blob/main/src/lib/AuthContext.jsx): `src/lib/AuthContext.jsx`
- [Public login](https://github.com/kurarensu16/sage/blob/main/src/pages/public/Login.jsx): `src/pages/public/Login.jsx`

### Administration

- [Admin portal](https://github.com/kurarensu16/sage/tree/main/src/pages/admin): `src/pages/admin`
- [Audit ledger](https://github.com/kurarensu16/sage/blob/main/src/pages/admin/AuditLog.jsx): `src/pages/admin/AuditLog.jsx`

### Teaching and Grading

- [Faculty portal](https://github.com/kurarensu16/sage/tree/main/src/pages/faculty): `src/pages/faculty`
- [Enrollment requests](https://github.com/kurarensu16/sage/blob/main/src/pages/faculty/EnrollmentRequests.jsx): `src/pages/faculty/EnrollmentRequests.jsx`
- [Grade computation](https://github.com/kurarensu16/sage/blob/main/src/pages/faculty/GradeComputationPreview.jsx): `src/pages/faculty/GradeComputationPreview.jsx`
- [Grade export preview](https://github.com/kurarensu16/sage/blob/main/src/components/ExportPreviewModal.jsx): `src/components/ExportPreviewModal.jsx`

### Risk and Advising

- [Dean oversight](https://github.com/kurarensu16/sage/tree/main/src/pages/dean): `src/pages/dean`
- [Student portal](https://github.com/kurarensu16/sage/tree/main/src/pages/student): `src/pages/student`
- [Risk monitoring](https://github.com/kurarensu16/sage/blob/main/src/pages/dean/AtRiskStudents.jsx): `src/pages/dean/AtRiskStudents.jsx`
- [Academic advising](https://github.com/kurarensu16/sage/blob/main/src/lib/advisingEngine.js): `src/lib/advisingEngine.js`
- [Risk and tentative grades](https://github.com/kurarensu16/sage/blob/main/src/lib/riskEngine.js): `src/lib/riskEngine.js`

### Data and Services

- [Classroom service](https://github.com/kurarensu16/sage/blob/main/src/lib/classRoomService.js): `src/lib/classRoomService.js`
- [Grading calculations](https://github.com/kurarensu16/sage/blob/main/src/lib/gradingMath.js): `src/lib/gradingMath.js`
- [Supabase client](https://github.com/kurarensu16/sage/blob/main/src/lib/supabase.js): `src/lib/supabase.js`
- **Supabase data**
- [AI service integration](https://github.com/kurarensu16/sage/blob/main/src/lib/openrouter.js): `src/lib/openrouter.js`

### Other components

- **Portal users**

## Connections

- Portal users → Route application: opens portal
- Route application → Authentication context: provides session
- Route application → Public login: routes unauthenticated
- Route application → Admin portal: routes by role
- Route application → Dean oversight: routes by role
- Route application → Faculty portal: routes by role
- Route application → Student portal: routes by role
- Faculty portal → Enrollment requests: opens requests
- Enrollment requests → Classroom service: loads and resolves
- Enrollment requests → Supabase client: queries classes
- Grade computation → Grading calculations: resolves formulas
- Grade computation → Audit ledger: logs grade posting
- Grade computation → Grade export preview: opens preview
- Grade export preview → Grading calculations: calculates grades
- Classroom service → Supabase client: reads and writes
- Classroom service → Risk and tentative grades: calculates roster risk
- Classroom service → Grading calculations: computes grades
- Risk and tentative grades → Grading calculations: uses grading logic
- Supabase client → Supabase data: accesses records
- Dean oversight → Risk monitoring: reviews risk
- Student portal → Academic advising: advising capability
- Risk monitoring → Risk and tentative grades: risk capability
- Academic advising → AI service integration: AI integration
