# crissdavid484/nexo360 architecture

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

- Interactive diagram: https://gitdiagram.com/crissdavid484/nexo360
- Repository: https://github.com/crissdavid484/nexo360

## Overview

Nexo360 is a PAEDIS-focused institutional portal: students authenticate, access support and academic resources, and can practice course enrollment in the Toma de Ramos simulator; staff manage student cases, early-warning interventions, and academic catalogs. The graph includes the documented SAT, PAEDIS, accessibility, and catalog branches. Backend routes and controller/service calls are evidenced by excerpts or the SOURCE INDEX; several frontend features are documented in the README but their component wiring was not sampled, so uncertain links are omitted.

Main entry points: [`backend/controllers/adminController.js`](https://github.com/crissdavid484/nexo360/blob/main/backend/controllers/adminController.js) (Admin operations), [`backend/services/courseService.js`](https://github.com/crissdavid484/nexo360/blob/main/backend/services/courseService.js) (Course service), [`frontend/src/services/api.js`](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/services/api.js) (API client), [`frontend/src/components/views/AdminPanelView.jsx`](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/views/AdminPanelView.jsx) (Admin panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student["Student experience"]
  node_login["Login<br/>[LoginForm.jsx]"]
  node_dashboard["Dashboard<br/>[DashboardPage.jsx]"]
  node_modules["Support modules<br/>[duocModulesData.js]"]
  node_simulator["Course simulator"]
  node_library["Institutional library<br/>[BibliotecaView.jsx]"]
end

subgraph group_backend["API and identity"]
  node_api["API client<br/>[api.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authcontroller["Auth controller<br/>[authController.js]"]
  node_authservice["Auth service<br/>[authService.js]"]
  node_authmiddleware["JWT and roles<br/>[authMiddleware.js]"]
  node_users[("User profiles<br/>[UserProfile.js]")]
  node_modulesroute["Module routes<br/>[moduleRoutes.js]"]
  node_modulecontroller["Module controller"]
end

subgraph group_academic["Academic catalog"]
  node_coursesroute["Course routes<br/>[courseRoutes.js]"]
  node_courseservice["Course service<br/>[courseService.js]"]
  node_courseparser["Catalog importer"]
  node_offerings[("Course offerings<br/>[CourseOffering.js]")]
  node_scheduleutils["Schedule normalization"]
  node_catalogadmin["Course administration"]
end

subgraph group_operations["PAEDIS operations"]
  node_adminroutes["Admin routes<br/>[adminRoutes.js]"]
  node_admincontroller["Admin operations<br/>[adminController.js]"]
  node_sat["Early warning SAT<br/>[satAlertService.js]"]
  node_risk["Predictive risk"]
  node_catalog["Career and campus catalogs<br/>[catalogService.js]"]
  node_adminui["PAEDIS case management"]
  node_satui["SAT administration"]
  node_adminview["Admin panel<br/>[AdminPanelView.jsx]"]
end

subgraph group_accessibility["Accessibility"]
  node_accessctx["Accessibility preferences"]
  node_speech["Speech service<br/>[speechService.js]"]
end

node_student(("Student"))

node_student -->|"signs in"| node_login
node_login -.->|"submits credentials"| node_api
node_api -.->|"requests API"| node_authroutes
node_authroutes -->|"routes to"| node_authcontroller
node_authcontroller -->|"delegates to"| node_authservice
node_authservice -->|"reads and updates"| node_users
node_authroutes -->|"applies guards"| node_authmiddleware
node_student -->|"opens portal"| node_dashboard
node_dashboard -->|"presents resources"| node_modules
node_dashboard -->|"opens library"| node_library
node_modulesroute -->|"routes to"| node_modulecontroller
node_student -->|"practices enrollment"| node_simulator
node_simulator -->|"fetches catalog"| node_api
node_coursesroute -->|"requests course data"| node_courseservice
node_courseservice -->|"reads and writes"| node_offerings
node_courseservice -->|"parses uploads"| node_courseparser
node_courseservice -->|"normalizes schedules"| node_scheduleutils
node_adminroutes -->|"routes admin actions"| node_admincontroller
node_adminroutes -->|"requires roles"| node_authmiddleware
node_admincontroller -->|"manages offerings"| node_courseservice
node_admincontroller -->|"requests alerts"| node_sat
node_admincontroller -->|"calculates risk"| node_risk
node_admincontroller -.->|"manages catalogs"| node_catalog
node_adminview -.->|"hosts case tools"| node_adminui
node_adminview -.->|"hosts SAT tools"| node_satui
node_adminview -.->|"hosts catalog tools"| node_catalogadmin
node_simulator -->|"records usage"| node_users
node_accessctx -->|"speaks announcements"| node_speech
node_accessctx -.->|"persists preferences"| node_api
node_accessctx -->|"stores preferences"| node_users

click node_login "https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/auth/LoginForm.jsx"
click node_dashboard "https://github.com/crissdavid484/nexo360/blob/main/frontend/src/pages/DashboardPage.jsx"
click node_modules "https://github.com/crissdavid484/nexo360/blob/main/frontend/src/data/duocModulesData.js"
click node_simulator "https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/simulation/TomaRamosSimulator.jsx"
click node_api "https://github.com/crissdavid484/nexo360/blob/main/frontend/src/services/api.js"
click node_authroutes "https://github.com/crissdavid484/nexo360/blob/main/backend/routes/authRoutes.js"
click node_authcontroller "https://github.com/crissdavid484/nexo360/blob/main/backend/controllers/authController.js"
click node_authservice "https://github.com/crissdavid484/nexo360/blob/main/backend/services/authService.js"
click node_authmiddleware "https://github.com/crissdavid484/nexo360/blob/main/backend/middleware/authMiddleware.js"
click node_users "https://github.com/crissdavid484/nexo360/blob/main/backend/models/UserProfile.js"
click node_modulesroute "https://github.com/crissdavid484/nexo360/blob/main/backend/routes/moduleRoutes.js"
click node_modulecontroller "https://github.com/crissdavid484/nexo360/blob/main/backend/controllers/moduleController.js"
click node_coursesroute "https://github.com/crissdavid484/nexo360/blob/main/backend/routes/courseRoutes.js"
click node_courseservice "https://github.com/crissdavid484/nexo360/blob/main/backend/services/courseService.js"
click node_courseparser "https://github.com/crissdavid484/nexo360/blob/main/backend/services/excelParserService.js"
click node_offerings "https://github.com/crissdavid484/nexo360/blob/main/backend/models/CourseOffering.js"
click node_scheduleutils "https://github.com/crissdavid484/nexo360/blob/main/backend/utils/courseScheduleUtils.js"
click node_adminroutes "https://github.com/crissdavid484/nexo360/blob/main/backend/routes/adminRoutes.js"
click node_admincontroller "https://github.com/crissdavid484/nexo360/blob/main/backend/controllers/adminController.js"
click node_sat "https://github.com/crissdavid484/nexo360/blob/main/backend/services/satAlertService.js"
click node_risk "https://github.com/crissdavid484/nexo360/blob/main/backend/services/predictiveRiskService.js"
click node_catalog "https://github.com/crissdavid484/nexo360/blob/main/backend/services/catalogService.js"
click node_accessctx "https://github.com/crissdavid484/nexo360/blob/main/frontend/src/context/AccessibilityContext.jsx"
click node_speech "https://github.com/crissdavid484/nexo360/blob/main/frontend/src/utils/speechService.js"
click node_adminui "https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/admin/PaedisCaseManagementSection.jsx"
click node_satui "https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/admin/EarlyWarningSatSection.jsx"
click node_adminview "https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/views/AdminPanelView.jsx"
click node_library "https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/views/BibliotecaView.jsx"
click node_catalogadmin "https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/admin/CoursesAdminSection.jsx"

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_login,node_dashboard,node_modules,node_simulator,node_library toneBlue
class node_api,node_authroutes,node_authcontroller,node_authservice,node_authmiddleware,node_users,node_modulesroute,node_modulecontroller toneAmber
class node_coursesroute,node_courseservice,node_courseparser,node_offerings,node_scheduleutils,node_catalogadmin toneMint
class node_adminroutes,node_admincontroller,node_sat,node_risk,node_catalog,node_adminui,node_satui,node_adminview toneRose
class node_accessctx,node_speech,node_student toneIndigo
```

## Components

### Student experience

- [Login](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/auth/LoginForm.jsx): `frontend/src/components/auth/LoginForm.jsx`
- [Dashboard](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/pages/DashboardPage.jsx): `frontend/src/pages/DashboardPage.jsx`
- [Support modules](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/data/duocModulesData.js): `frontend/src/data/duocModulesData.js`
- [Course simulator](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/simulation/TomaRamosSimulator.jsx): `frontend/src/components/simulation/TomaRamosSimulator.jsx`
- [Institutional library](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/views/BibliotecaView.jsx): `frontend/src/components/views/BibliotecaView.jsx`

### API and identity

- [API client](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Auth routes](https://github.com/crissdavid484/nexo360/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Auth controller](https://github.com/crissdavid484/nexo360/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Auth service](https://github.com/crissdavid484/nexo360/blob/main/backend/services/authService.js): `backend/services/authService.js`
- [JWT and roles](https://github.com/crissdavid484/nexo360/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [User profiles](https://github.com/crissdavid484/nexo360/blob/main/backend/models/UserProfile.js): `backend/models/UserProfile.js`
- [Module routes](https://github.com/crissdavid484/nexo360/blob/main/backend/routes/moduleRoutes.js): `backend/routes/moduleRoutes.js`
- [Module controller](https://github.com/crissdavid484/nexo360/blob/main/backend/controllers/moduleController.js): `backend/controllers/moduleController.js`

### Academic catalog

- [Course routes](https://github.com/crissdavid484/nexo360/blob/main/backend/routes/courseRoutes.js): `backend/routes/courseRoutes.js`
- [Course service](https://github.com/crissdavid484/nexo360/blob/main/backend/services/courseService.js): `backend/services/courseService.js`
- [Catalog importer](https://github.com/crissdavid484/nexo360/blob/main/backend/services/excelParserService.js): `backend/services/excelParserService.js`
- [Course offerings](https://github.com/crissdavid484/nexo360/blob/main/backend/models/CourseOffering.js): `backend/models/CourseOffering.js`
- [Schedule normalization](https://github.com/crissdavid484/nexo360/blob/main/backend/utils/courseScheduleUtils.js): `backend/utils/courseScheduleUtils.js`
- [Course administration](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/admin/CoursesAdminSection.jsx): `frontend/src/components/admin/CoursesAdminSection.jsx`

### PAEDIS operations

- [Admin routes](https://github.com/crissdavid484/nexo360/blob/main/backend/routes/adminRoutes.js): `backend/routes/adminRoutes.js`
- [Admin operations](https://github.com/crissdavid484/nexo360/blob/main/backend/controllers/adminController.js): `backend/controllers/adminController.js`
- [Early warning SAT](https://github.com/crissdavid484/nexo360/blob/main/backend/services/satAlertService.js): `backend/services/satAlertService.js`
- [Predictive risk](https://github.com/crissdavid484/nexo360/blob/main/backend/services/predictiveRiskService.js): `backend/services/predictiveRiskService.js`
- [Career and campus catalogs](https://github.com/crissdavid484/nexo360/blob/main/backend/services/catalogService.js): `backend/services/catalogService.js`
- [PAEDIS case management](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/admin/PaedisCaseManagementSection.jsx): `frontend/src/components/admin/PaedisCaseManagementSection.jsx`
- [SAT administration](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/admin/EarlyWarningSatSection.jsx): `frontend/src/components/admin/EarlyWarningSatSection.jsx`
- [Admin panel](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/components/views/AdminPanelView.jsx): `frontend/src/components/views/AdminPanelView.jsx`

### Accessibility

- [Accessibility preferences](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/context/AccessibilityContext.jsx): `frontend/src/context/AccessibilityContext.jsx`
- [Speech service](https://github.com/crissdavid484/nexo360/blob/main/frontend/src/utils/speechService.js): `frontend/src/utils/speechService.js`

### Other components

- **Student**

## Connections

- Student → Login: signs in (evidence: `README.md`)
- Login → API client: submits credentials
- API client → Auth routes: requests API
- Auth routes → Auth controller: routes to (evidence: `backend/routes/authRoutes.js`)
- Auth controller → Auth service: delegates to (evidence: `backend/controllers/authController.js`)
- Auth service → User profiles: reads and updates (evidence: `backend/services/authService.js`)
- Auth routes → JWT and roles: applies guards (evidence: `backend/routes/authRoutes.js`)
- Student → Dashboard: opens portal (evidence: `README.md`)
- Dashboard → Support modules: presents resources (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Dashboard → Institutional library: opens library (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Module routes → Module controller: routes to (evidence: `backend/routes/moduleRoutes.js`)
- Student → Course simulator: practices enrollment (evidence: `README.md`)
- Course simulator → API client: fetches catalog (evidence: `frontend/src/components/simulation/TomaRamosSimulator.jsx`)
- Course routes → Course service: requests course data (evidence: `backend/routes/courseRoutes.js`)
- Course service → Course offerings: reads and writes (evidence: `backend/services/courseService.js`)
- Course service → Catalog importer: parses uploads (evidence: `backend/services/courseService.js`)
- Course service → Schedule normalization: normalizes schedules (evidence: `backend/services/courseService.js`)
- Admin routes → Admin operations: routes admin actions (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → JWT and roles: requires roles (evidence: `backend/routes/adminRoutes.js`)
- Admin operations → Course service: manages offerings (evidence: `backend/controllers/adminController.js`)
- Admin operations → Early warning SAT: requests alerts (evidence: `backend/controllers/adminController.js`)
- Admin operations → Predictive risk: calculates risk (evidence: `backend/controllers/adminController.js`)
- Admin operations → Career and campus catalogs: manages catalogs (evidence: `backend/controllers/adminController.js`)
- Admin panel → PAEDIS case management: hosts case tools
- Admin panel → SAT administration: hosts SAT tools
- Admin panel → Course administration: hosts catalog tools
- Course simulator → User profiles: records usage
- Accessibility preferences → Speech service: speaks announcements (evidence: `frontend/src/context/AccessibilityContext.jsx`)
- Accessibility preferences → API client: persists preferences (evidence: `frontend/src/context/AccessibilityContext.jsx`)
- Accessibility preferences → User profiles: stores preferences
