# ishansirf-ai/smart-campus-complaint-portal architecture

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

- Interactive diagram: https://gitdiagram.com/ishansirf-ai/smart-campus-complaint-portal
- Repository: https://github.com/ishansirf-ai/smart-campus-complaint-portal

## Overview

This is a Smart College Portal for campus issue reporting and resolution. Students authenticate, submit and track complaints with evidence; department staff accept, assign and update work; administrators oversee complaints, users, categories and reports. Notices, notifications, audit history, email-based password resets, and overdue escalation support that workflow. The excerpts establish route ownership and several internal calls; the README is empty and frontend behavior was not sampled, so frontend/API wiring is shown as unverified rather than asserted.

Main entry points: [`server.js`](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server.js) (HTTP API), [`server/routes/complaintRoutes.js`](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/complaintRoutes.js) (Complaint reporting and tracking), [`server/routes/departmentRoutes.js`](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/departmentRoutes.js) (Department work queue), [`server/routes/adminRoutes.js`](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/adminRoutes.js) (Admin operations and reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Portal entry"]
  node_webui["Portal interface<br/>[app.js]"]
  node_webpage["Portal pages<br/>[index.html]"]
  node_http["HTTP API<br/>[server.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication<br/>[authRoutes.js]"]
  node_users[("User accounts<br/>[User.js]")]
  node_access["Session authorization<br/>[auth.js]"]
  node_email["Password reset email<br/>[emailService.js]"]
end

subgraph group_complaints["Complaint operations"]
  node_complaintapi["Complaint reporting and tracking<br/>[complaintRoutes.js]"]
  node_complaintsdata[("Complaint records<br/>[Complaint.js]")]
  node_departments["Department work queue"]
  node_overdue["Overdue escalation<br/>[overdueJob.js]"]
end

subgraph group_admin["Administration"]
  node_adminapi["Admin operations and reports<br/>[adminRoutes.js]"]
  node_portalconfig["Portal categories and rules<br/>[portal.js]"]
  node_notices["Campus notices<br/>[noticeRoutes.js]"]
end

subgraph group_platform["Platform services"]
  node_notifications["Notifications<br/>[notifications.js]"]
  node_notificationapi["Notification inbox"]
  node_audit["Audit history<br/>[audit.js]"]
  node_uploads["Secure attachments<br/>[secureUploads.js]"]
  node_database["MongoDB connection<br/>[db.js]"]
end

node_student(("Student"))
node_staff(("Department staff"))
node_administrator(("Administrator"))

node_student -.->|"uses"| node_webui
node_staff -.->|"uses"| node_webui
node_administrator -.->|"uses"| node_webui
node_webpage -.->|"hosts interface"| node_webui
node_webui -.->|"calls API"| node_http
node_http -->|"mounts routes"| node_auth
node_http -->|"mounts routes"| node_complaintapi
node_http -->|"mounts routes"| node_departments
node_http -->|"mounts routes"| node_adminapi
node_http -->|"mounts routes"| node_notices
node_http -->|"mounts routes"| node_notificationapi
node_http -->|"connects database"| node_database
node_auth -->|"reads and updates"| node_users
node_auth -->|"uses protection"| node_access
node_auth -->|"sends reset email"| node_email
node_access -->|"loads session user"| node_users
node_complaintapi -->|"creates and queries"| node_complaintsdata
node_complaintapi -->|"protects routes"| node_access
node_complaintapi -->|"creates alerts"| node_notifications
node_complaintapi -->|"records actions"| node_audit
node_complaintapi -->|"serves attachments"| node_uploads
node_departments -->|"updates assigned work"| node_complaintsdata
node_departments -->|"queries staff"| node_users
node_departments -->|"creates alerts"| node_notifications
node_departments -->|"records actions"| node_audit
node_departments -->|"serves attachments"| node_uploads
node_adminapi -->|"manages complaints"| node_complaintsdata
node_adminapi -->|"manages accounts"| node_users
node_adminapi -->|"creates alerts"| node_notifications
node_adminapi -->|"records actions"| node_audit
node_adminapi -->|"handles attachments"| node_uploads
node_overdue -->|"checks due complaints"| node_complaintsdata
node_overdue -->|"sends escalation alerts"| node_notifications
node_notices -->|"protects routes"| node_access
node_notificationapi -->|"protects routes"| node_access
node_notifications -->|"finds recipients"| node_users
node_notifications -->|"persists inbox items"| node_notificationapi
node_audit -.->|"persists audit entries"| node_database
node_http -->|"starts job"| node_overdue
node_http -.->|"bootstraps portal data"| node_portalconfig

click node_webui "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/assets/js/app.js"
click node_webpage "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/index.html"
click node_http "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server.js"
click node_auth "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/authRoutes.js"
click node_users "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/models/User.js"
click node_access "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/middleware/auth.js"
click node_email "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/services/emailService.js"
click node_complaintapi "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/complaintRoutes.js"
click node_complaintsdata "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/models/Complaint.js"
click node_departments "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/departmentRoutes.js"
click node_overdue "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/jobs/overdueJob.js"
click node_adminapi "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/adminRoutes.js"
click node_portalconfig "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/config/portal.js"
click node_notices "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/noticeRoutes.js"
click node_notifications "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/utils/notifications.js"
click node_notificationapi "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/notificationRoutes.js"
click node_audit "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/utils/audit.js"
click node_uploads "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/utils/secureUploads.js"
click node_database "https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/config/db.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_webui,node_webpage,node_http toneBlue
class node_auth,node_users,node_access,node_email toneAmber
class node_complaintapi,node_complaintsdata,node_departments,node_overdue toneMint
class node_adminapi,node_portalconfig,node_notices toneRose
class node_notifications,node_notificationapi,node_audit,node_uploads,node_database,node_student,node_staff,node_administrator toneIndigo
```

## Components

### Portal entry

- [Portal interface](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/assets/js/app.js): `assets/js/app.js`
- [Portal pages](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/index.html): `index.html`
- [HTTP API](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server.js): `server.js`

### Identity and access

- [Authentication](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [User accounts](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/models/User.js): `server/models/User.js`
- [Session authorization](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/middleware/auth.js): `server/middleware/auth.js`
- [Password reset email](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/services/emailService.js): `server/services/emailService.js`

### Complaint operations

- [Complaint reporting and tracking](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/complaintRoutes.js): `server/routes/complaintRoutes.js`
- [Complaint records](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/models/Complaint.js): `server/models/Complaint.js`
- [Department work queue](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/departmentRoutes.js): `server/routes/departmentRoutes.js`
- [Overdue escalation](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/jobs/overdueJob.js): `server/jobs/overdueJob.js`

### Administration

- [Admin operations and reports](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/adminRoutes.js): `server/routes/adminRoutes.js`
- [Portal categories and rules](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/config/portal.js): `server/config/portal.js`
- [Campus notices](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/noticeRoutes.js): `server/routes/noticeRoutes.js`

### Platform services

- [Notifications](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/utils/notifications.js): `server/utils/notifications.js`
- [Notification inbox](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/routes/notificationRoutes.js): `server/routes/notificationRoutes.js`
- [Audit history](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/utils/audit.js): `server/utils/audit.js`
- [Secure attachments](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/utils/secureUploads.js): `server/utils/secureUploads.js`
- [MongoDB connection](https://github.com/ishansirf-ai/smart-campus-complaint-portal/blob/main/server/config/db.js): `server/config/db.js`

### Other components

- **Student**
- **Department staff**
- **Administrator**

## Connections

- Student → Portal interface: uses
- Department staff → Portal interface: uses
- Administrator → Portal interface: uses
- Portal pages → Portal interface: hosts interface
- Portal interface → HTTP API: calls API
- HTTP API → Authentication: mounts routes (evidence: `server.js`)
- HTTP API → Complaint reporting and tracking: mounts routes (evidence: `server.js`)
- HTTP API → Department work queue: mounts routes (evidence: `server.js`)
- HTTP API → Admin operations and reports: mounts routes (evidence: `server.js`)
- HTTP API → Campus notices: mounts routes (evidence: `server.js`)
- HTTP API → Notification inbox: mounts routes (evidence: `server.js`)
- HTTP API → MongoDB connection: connects database (evidence: `server.js`)
- Authentication → User accounts: reads and updates (evidence: `server/routes/authRoutes.js`)
- Authentication → Session authorization: uses protection (evidence: `server/routes/authRoutes.js`)
- Authentication → Password reset email: sends reset email (evidence: `server/routes/authRoutes.js`)
- Session authorization → User accounts: loads session user (evidence: `server/middleware/auth.js`)
- Complaint reporting and tracking → Complaint records: creates and queries (evidence: `server/routes/complaintRoutes.js`)
- Complaint reporting and tracking → Session authorization: protects routes (evidence: `server/routes/complaintRoutes.js`)
- Complaint reporting and tracking → Notifications: creates alerts (evidence: `server/routes/complaintRoutes.js`)
- Complaint reporting and tracking → Audit history: records actions (evidence: `server/routes/complaintRoutes.js`)
- Complaint reporting and tracking → Secure attachments: serves attachments (evidence: `server/routes/complaintRoutes.js`)
- Department work queue → Complaint records: updates assigned work (evidence: `server/routes/departmentRoutes.js`)
- Department work queue → User accounts: queries staff (evidence: `server/routes/departmentRoutes.js`)
- Department work queue → Notifications: creates alerts (evidence: `server/routes/departmentRoutes.js`)
- Department work queue → Audit history: records actions (evidence: `server/routes/departmentRoutes.js`)
- Department work queue → Secure attachments: serves attachments (evidence: `server/routes/departmentRoutes.js`)
- Admin operations and reports → Complaint records: manages complaints (evidence: `server/routes/adminRoutes.js`)
- Admin operations and reports → User accounts: manages accounts (evidence: `server/routes/adminRoutes.js`)
- Admin operations and reports → Notifications: creates alerts (evidence: `server/routes/adminRoutes.js`)
- Admin operations and reports → Audit history: records actions (evidence: `server/routes/adminRoutes.js`)
- Admin operations and reports → Secure attachments: handles attachments (evidence: `server/routes/adminRoutes.js`)
- Overdue escalation → Complaint records: checks due complaints (evidence: `server/jobs/overdueJob.js`)
- Overdue escalation → Notifications: sends escalation alerts (evidence: `server/jobs/overdueJob.js`)
- Campus notices → Session authorization: protects routes (evidence: `server/routes/noticeRoutes.js`)
- Notification inbox → Session authorization: protects routes (evidence: `server/routes/notificationRoutes.js`)
- Notifications → User accounts: finds recipients (evidence: `server/utils/notifications.js`)
- Notifications → Notification inbox: persists inbox items (evidence: `server/utils/notifications.js`)
- Audit history → MongoDB connection: persists audit entries
- HTTP API → Overdue escalation: starts job (evidence: `server.js`)
- HTTP API → Portal categories and rules: bootstraps portal data
