# mahfuj-7/cuet-ai-campus architecture

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

- Interactive diagram: https://gitdiagram.com/mahfuj-7/cuet-ai-campus
- Repository: https://github.com/mahfuj-7/cuet-ai-campus

## Overview

CUET AI Campus API is an Express backend for student and campus operations. Clients enter through the versioned API, whose routes cover authentication, academic records, schedules, announcements, learning resources, and staff administration. The sampled schedule workflows include routine proposals and overrides; AI endpoints build context from routine, exam, and update data. Routes use shared authorization and domain services, then read or mutate Mongoose models. The README is empty; route coverage follows app.js, and links to unsampled route internals are omitted where their call paths are not evidenced.

Main entry points: [`cuet-ai-campus-api/src/app.js`](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/app.js) (Express API), [`cuet-ai-campus-api/src/routes/ai.routes.js`](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/ai.routes.js) (AI assistance), [`cuet-ai-campus-api/src/routes/overrides.routes.js`](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/overrides.routes.js) (Schedule overrides), [`cuet-ai-campus-api/src/routes/coordinator.routes.js`](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/coordinator.routes.js) (Coordinator tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_app["Express API<br/>[app.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication<br/>[auth.routes.js]"]
  node_users["User profiles<br/>[users.routes.js]"]
  node_authmw["Token protection<br/>[auth.js]"]
  node_access["Access rules<br/>[access.js]"]
end

subgraph group_campus["Campus operations"]
  node_academics["Academic records"]
  node_routine["Routine schedules<br/>[routine.routes.js]"]
  node_overrides["Schedule overrides"]
  node_proposals["Routine proposals"]
  node_routinepdf["Routine PDFs"]
  node_calendar["Campus calendar<br/>[calendar.routes.js]"]
  node_attendance["Attendance"]
  node_coordinator["Coordinator tools"]
  node_admin["Administration<br/>[admin.routes.js]"]
  node_updates["Announcements<br/>[updates.routes.js]"]
  node_serializer["Routine serialization"]
  node_update_service["Update workflows<br/>[updates.js]"]
end

subgraph group_learning["Student services"]
  node_assignments["Assignments"]
  node_exams["Exams<br/>[exams.routes.js]"]
  node_ai["AI assistance<br/>[ai.routes.js]"]
  node_materials["Study materials"]
  node_chat["Campus chat<br/>[chat.routes.js]"]
  node_notifications["Notifications"]
  node_feedback["Feedback<br/>[feedback.routes.js]"]
  node_sharedfiles["Shared files"]
end

subgraph group_data["Domain data"]
  node_academicmodels["Academic models<br/>[Academic.js]"]
  node_routinemodels["Routine models<br/>[Routine.js]"]
  node_user_model["User model<br/>[User.js]"]
  node_studentmodels["Student content models<br/>[StudentContent.js]"]
  node_schedulemodels["Schedule models<br/>[Schedule.js]"]
  node_operationsmodels["Operations models<br/>[Operations.js]"]
  node_updatesmodel["Update model<br/>[Update.js]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"routes auth"| node_auth
node_app -->|"routes users"| node_users
node_app -->|"routes academics"| node_academics
node_app -->|"routes routine"| node_routine
node_app -->|"routes updates"| node_updates
node_app -->|"routes assignments"| node_assignments
node_app -->|"routes exams"| node_exams
node_app -->|"routes AI"| node_ai
node_app -->|"routes coordinator"| node_coordinator
node_app -->|"routes admin"| node_admin
node_app -->|"routes notifications"| node_notifications
node_app -->|"routes materials"| node_materials
node_app -->|"routes feedback"| node_feedback
node_app -->|"routes shared files"| node_sharedfiles
node_app -->|"routes chat"| node_chat
node_app -->|"routes PDF"| node_routinepdf
node_app -->|"routes calendar"| node_calendar
node_app -->|"routes overrides"| node_overrides
node_app -->|"routes proposals"| node_proposals
node_app -->|"routes attendance"| node_attendance
node_authmw -->|"loads user"| node_user_model
node_authmw -->|"uses profile query"| node_access
node_access -->|"checks sections"| node_academicmodels
node_routine -->|"reads schedules"| node_routinemodels
node_routine -->|"serializes entries"| node_serializer
node_overrides -->|"stores overrides"| node_schedulemodels
node_overrides -->|"creates announcements"| node_updatesmodel
node_overrides -->|"resolves batch"| node_update_service
node_proposals -->|"replaces routine"| node_routinemodels
node_proposals -->|"checks scope"| node_access
node_ai -->|"reads routine"| node_routinemodels
node_ai -->|"reads exams"| node_studentmodels
node_ai -->|"serializes context"| node_serializer
node_ai -->|"lists updates"| node_update_service
node_coordinator -->|"manages assignments"| node_operationsmodels
node_coordinator -->|"checks scope"| node_access
node_coordinator -->|"resolves audience"| node_update_service
node_updates -->|"manages announcements"| node_update_service
node_academics -->|"queries records"| node_academicmodels
node_auth -->|"manages accounts"| node_user_model
node_users -->|"updates profiles"| node_user_model

click node_app "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/app.js"
click node_auth "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/auth.routes.js"
click node_users "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/users.routes.js"
click node_authmw "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/middleware/auth.js"
click node_academics "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/academics.routes.js"
click node_routine "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/routine.routes.js"
click node_overrides "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/overrides.routes.js"
click node_proposals "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/routineProposal.routes.js"
click node_routinepdf "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/routinePdf.routes.js"
click node_calendar "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/calendar.routes.js"
click node_attendance "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/attendance.routes.js"
click node_coordinator "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/coordinator.routes.js"
click node_admin "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/admin.routes.js"
click node_updates "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/updates.routes.js"
click node_assignments "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/assignments.routes.js"
click node_exams "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/exams.routes.js"
click node_ai "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/ai.routes.js"
click node_materials "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/studyMaterials.routes.js"
click node_chat "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/chat.routes.js"
click node_notifications "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/notifications.routes.js"
click node_feedback "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/feedback.routes.js"
click node_sharedfiles "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/sharedFiles.routes.js"
click node_academicmodels "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/Academic.js"
click node_routinemodels "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/Routine.js"
click node_user_model "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/User.js"
click node_studentmodels "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/StudentContent.js"
click node_schedulemodels "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/Schedule.js"
click node_operationsmodels "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/Operations.js"
click node_updatesmodel "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/Update.js"
click node_access "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/services/access.js"
click node_serializer "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/services/routineSerializer.js"
click node_update_service "https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/services/updates.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_client toneBlue
class node_auth,node_users,node_authmw,node_access toneAmber
class node_academics,node_routine,node_overrides,node_proposals,node_routinepdf,node_calendar,node_attendance,node_coordinator,node_admin,node_updates,node_serializer,node_update_service toneMint
class node_assignments,node_exams,node_ai,node_materials,node_chat,node_notifications,node_feedback,node_sharedfiles toneRose
class node_academicmodels,node_routinemodels,node_user_model,node_studentmodels,node_schedulemodels,node_operationsmodels,node_updatesmodel toneIndigo
```

## Components

### API entry

- [Express API](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/app.js): `cuet-ai-campus-api/src/app.js`

### Identity and access

- [Authentication](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/auth.routes.js): `cuet-ai-campus-api/src/routes/auth.routes.js`
- [User profiles](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/users.routes.js): `cuet-ai-campus-api/src/routes/users.routes.js`
- [Token protection](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/middleware/auth.js): `cuet-ai-campus-api/src/middleware/auth.js`
- [Access rules](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/services/access.js): `cuet-ai-campus-api/src/services/access.js`

### Campus operations

- [Academic records](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/academics.routes.js): `cuet-ai-campus-api/src/routes/academics.routes.js`
- [Routine schedules](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/routine.routes.js): `cuet-ai-campus-api/src/routes/routine.routes.js`
- [Schedule overrides](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/overrides.routes.js): `cuet-ai-campus-api/src/routes/overrides.routes.js`
- [Routine proposals](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/routineProposal.routes.js): `cuet-ai-campus-api/src/routes/routineProposal.routes.js`
- [Routine PDFs](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/routinePdf.routes.js): `cuet-ai-campus-api/src/routes/routinePdf.routes.js`
- [Campus calendar](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/calendar.routes.js): `cuet-ai-campus-api/src/routes/calendar.routes.js`
- [Attendance](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/attendance.routes.js): `cuet-ai-campus-api/src/routes/attendance.routes.js`
- [Coordinator tools](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/coordinator.routes.js): `cuet-ai-campus-api/src/routes/coordinator.routes.js`
- [Administration](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/admin.routes.js): `cuet-ai-campus-api/src/routes/admin.routes.js`
- [Announcements](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/updates.routes.js): `cuet-ai-campus-api/src/routes/updates.routes.js`
- [Routine serialization](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/services/routineSerializer.js): `cuet-ai-campus-api/src/services/routineSerializer.js`
- [Update workflows](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/services/updates.js): `cuet-ai-campus-api/src/services/updates.js`

### Student services

- [Assignments](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/assignments.routes.js): `cuet-ai-campus-api/src/routes/assignments.routes.js`
- [Exams](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/exams.routes.js): `cuet-ai-campus-api/src/routes/exams.routes.js`
- [AI assistance](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/ai.routes.js): `cuet-ai-campus-api/src/routes/ai.routes.js`
- [Study materials](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/studyMaterials.routes.js): `cuet-ai-campus-api/src/routes/studyMaterials.routes.js`
- [Campus chat](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/chat.routes.js): `cuet-ai-campus-api/src/routes/chat.routes.js`
- [Notifications](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/notifications.routes.js): `cuet-ai-campus-api/src/routes/notifications.routes.js`
- [Feedback](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/feedback.routes.js): `cuet-ai-campus-api/src/routes/feedback.routes.js`
- [Shared files](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/routes/sharedFiles.routes.js): `cuet-ai-campus-api/src/routes/sharedFiles.routes.js`

### Domain data

- [Academic models](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/Academic.js): `cuet-ai-campus-api/src/models/Academic.js`
- [Routine models](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/Routine.js): `cuet-ai-campus-api/src/models/Routine.js`
- [User model](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/User.js): `cuet-ai-campus-api/src/models/User.js`
- [Student content models](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/StudentContent.js): `cuet-ai-campus-api/src/models/StudentContent.js`
- [Schedule models](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/Schedule.js): `cuet-ai-campus-api/src/models/Schedule.js`
- [Operations models](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/Operations.js): `cuet-ai-campus-api/src/models/Operations.js`
- [Update model](https://github.com/mahfuj-7/cuet-ai-campus/blob/main/cuet-ai-campus-api/src/models/Update.js): `cuet-ai-campus-api/src/models/Update.js`

### Other components

- **API client**

## Connections

- API client → Express API: sends requests (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Authentication: routes auth (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → User profiles: routes users (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Academic records: routes academics (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Routine schedules: routes routine (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Announcements: routes updates (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Assignments: routes assignments (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Exams: routes exams (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → AI assistance: routes AI (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Coordinator tools: routes coordinator (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Administration: routes admin (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Notifications: routes notifications (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Study materials: routes materials (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Feedback: routes feedback (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Shared files: routes shared files (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Campus chat: routes chat (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Routine PDFs: routes PDF (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Campus calendar: routes calendar (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Schedule overrides: routes overrides (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Routine proposals: routes proposals (evidence: `cuet-ai-campus-api/src/app.js`)
- Express API → Attendance: routes attendance (evidence: `cuet-ai-campus-api/src/app.js`)
- Token protection → User model: loads user (evidence: `cuet-ai-campus-api/src/middleware/auth.js`)
- Token protection → Access rules: uses profile query (evidence: `cuet-ai-campus-api/src/middleware/auth.js`)
- Access rules → Academic models: checks sections (evidence: `cuet-ai-campus-api/src/services/access.js`)
- Routine schedules → Routine models: reads schedules (evidence: `cuet-ai-campus-api/src/routes/routine.routes.js`)
- Routine schedules → Routine serialization: serializes entries (evidence: `cuet-ai-campus-api/src/routes/routine.routes.js`)
- Schedule overrides → Schedule models: stores overrides (evidence: `cuet-ai-campus-api/src/routes/overrides.routes.js`)
- Schedule overrides → Update model: creates announcements (evidence: `cuet-ai-campus-api/src/routes/overrides.routes.js`)
- Schedule overrides → Update workflows: resolves batch (evidence: `cuet-ai-campus-api/src/routes/overrides.routes.js`)
- Routine proposals → Routine models: replaces routine (evidence: `cuet-ai-campus-api/src/routes/routineProposal.routes.js`)
- Routine proposals → Access rules: checks scope (evidence: `cuet-ai-campus-api/src/routes/routineProposal.routes.js`)
- AI assistance → Routine models: reads routine (evidence: `cuet-ai-campus-api/src/routes/ai.routes.js`)
- AI assistance → Student content models: reads exams (evidence: `cuet-ai-campus-api/src/routes/ai.routes.js`)
- AI assistance → Routine serialization: serializes context (evidence: `cuet-ai-campus-api/src/routes/ai.routes.js`)
- AI assistance → Update workflows: lists updates (evidence: `cuet-ai-campus-api/src/routes/ai.routes.js`)
- Coordinator tools → Operations models: manages assignments (evidence: `cuet-ai-campus-api/src/routes/coordinator.routes.js`)
- Coordinator tools → Access rules: checks scope (evidence: `cuet-ai-campus-api/src/routes/coordinator.routes.js`)
- Coordinator tools → Update workflows: resolves audience (evidence: `cuet-ai-campus-api/src/routes/coordinator.routes.js`)
- Announcements → Update workflows: manages announcements (evidence: `cuet-ai-campus-api/src/services/updates.js`)
- Academic records → Academic models: queries records (evidence: `cuet-ai-campus-api/src/routes/academics.routes.js`)
- Authentication → User model: manages accounts (evidence: `cuet-ai-campus-api/src/routes/auth.routes.js`)
- User profiles → User model: updates profiles (evidence: `cuet-ai-campus-api/src/routes/users.routes.js`)
