# kanhaiya-js/campuscare architecture

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

- Interactive diagram: https://gitdiagram.com/kanhaiya-js/campuscare
- Repository: https://github.com/kanhaiya-js/campuscare

## Overview

SmartCampus is a campus infrastructure issue-resolution platform. Students and faculty report facility problems through a guided flow or room QR scan; issues are checked, prioritized, ticketed, and assigned, then staff and administrators track resolution. The map, campus directories, transport, clubs, and printable QR placards are parallel product capabilities. The README documents these capabilities; sampled route excerpts establish several issue-creation calls. Other API and page internals were not sampled, so their detailed wiring is omitted.

Main entry points: [`app/api/issues/route.ts`](https://github.com/kanhaiya-js/campuscare/blob/main/app/api/issues/route.ts) (Issue API), [`app/admin/page.tsx`](https://github.com/kanhaiya-js/campuscare/blob/main/app/admin/page.tsx) (Admin Console), [`app/issues/report/page.tsx`](https://github.com/kanhaiya-js/campuscare/blob/main/app/issues/report/page.tsx) (Report Wizard), [`app/scan/page.tsx`](https://github.com/kanhaiya-js/campuscare/blob/main/app/scan/page.tsx) (Room QR Scanner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_reporting["Issue Reporting"]
  node_report_wizard["Report Wizard<br/>[page.tsx]"]
  node_qr_scan["Room QR Scanner<br/>[page.tsx]"]
  node_issue_api["Issue API<br/>[route.ts]"]
  node_duplicate_check["Duplicate Detection"]
  node_upload_service["Evidence Uploads<br/>[upload.ts]"]
end

subgraph group_operations["Issue Operations"]
  node_priority_engine["Priority Engine<br/>[priority-engine.ts]"]
  node_assignment_engine["Assignment Engine"]
  node_ticket_ids["Ticket ID Generator<br/>[issue-id.ts]"]
  node_issue_tracking["Issue Tracking<br/>[page.tsx]"]
  node_issue_detail["Issue Details<br/>[page.tsx]"]
  node_staff_workspace["Staff Workspace<br/>[page.tsx]"]
  node_notifications["Notifications<br/>[notification.ts]"]
end

subgraph group_campus["Campus Services"]
  node_campus_map["Campus Map"]
  node_facilities["Facilities Directory<br/>[page.tsx]"]
  node_transport["Campus Transport<br/>[page.tsx]"]
  node_clubs["Clubs Directory<br/>[page.tsx]"]
  node_qr_placards["QR Placards<br/>[page.tsx]"]
end

subgraph group_admin["Administration"]
  node_admin_console["Admin Console<br/>[page.tsx]"]
  node_admin_issues["Issue Administration<br/>[page.tsx]"]
  node_analytics["Analytics &amp; Reports<br/>[page.tsx]"]
  node_audit_logs["Audit Logs<br/>[page.tsx]"]
end

subgraph group_platform["Shared Platform"]
  node_session_auth["Session &amp; Access<br/>[session.ts]"]
  node_database[("Campus Database<br/>[prisma.ts]")]
  node_audit_service["Audit Service<br/>[audit.ts]"]
end

node_campus_users(("Students &amp; Faculty"))

node_campus_users -->|"report problems"| node_report_wizard
node_campus_users -->|"scan room codes"| node_qr_scan
node_report_wizard -.->|"submit reports"| node_issue_api
node_qr_scan -.->|"start reporting"| node_report_wizard
node_issue_api -.->|"check duplicates"| node_duplicate_check
node_issue_api -->|"calculate priority"| node_priority_engine
node_issue_api -->|"generate ticket ID"| node_ticket_ids
node_issue_api -->|"find staff"| node_assignment_engine
node_issue_api -->|"create issue"| node_database
node_issue_api -->|"send notifications"| node_notifications
node_report_wizard -.->|"attach evidence"| node_upload_service
node_issue_tracking -.->|"retrieve tickets"| node_issue_api
node_issue_detail -.->|"view and update"| node_issue_api
node_staff_workspace -.->|"manage assigned work"| node_issue_api
node_campus_users -->|"explore hotspots"| node_campus_map
node_campus_users -->|"browse facilities"| node_facilities
node_campus_users -->|"view bus routes"| node_transport
node_campus_users -->|"browse societies"| node_clubs
node_admin_console -.->|"manage issues"| node_admin_issues
node_admin_console -.->|"review operations"| node_analytics
node_admin_console -.->|"review activity"| node_audit_logs
node_admin_console -->|"prepare placards"| node_qr_placards
node_issue_api -->|"get session"| node_session_auth
node_issue_api -.->|"record activity"| node_audit_service
node_audit_service -->|"write audit log"| node_database

click node_report_wizard "https://github.com/kanhaiya-js/campuscare/blob/main/app/issues/report/page.tsx"
click node_qr_scan "https://github.com/kanhaiya-js/campuscare/blob/main/app/scan/page.tsx"
click node_issue_api "https://github.com/kanhaiya-js/campuscare/blob/main/app/api/issues/route.ts"
click node_duplicate_check "https://github.com/kanhaiya-js/campuscare/blob/main/lib/services/duplicate-detector.ts"
click node_upload_service "https://github.com/kanhaiya-js/campuscare/blob/main/lib/storage/upload.ts"
click node_priority_engine "https://github.com/kanhaiya-js/campuscare/blob/main/lib/services/priority-engine.ts"
click node_assignment_engine "https://github.com/kanhaiya-js/campuscare/blob/main/lib/services/assignment-engine.ts"
click node_ticket_ids "https://github.com/kanhaiya-js/campuscare/blob/main/lib/services/issue-id.ts"
click node_issue_tracking "https://github.com/kanhaiya-js/campuscare/blob/main/app/issues/page.tsx"
click node_issue_detail "https://github.com/kanhaiya-js/campuscare/blob/main/app/issues/%5Bid%5D/page.tsx"
click node_staff_workspace "https://github.com/kanhaiya-js/campuscare/blob/main/app/staff/page.tsx"
click node_notifications "https://github.com/kanhaiya-js/campuscare/blob/main/lib/services/notification.ts"
click node_campus_map "https://github.com/kanhaiya-js/campuscare/blob/main/components/maps/campus-map-inner.tsx"
click node_facilities "https://github.com/kanhaiya-js/campuscare/blob/main/app/facilities/page.tsx"
click node_transport "https://github.com/kanhaiya-js/campuscare/blob/main/app/transport/page.tsx"
click node_clubs "https://github.com/kanhaiya-js/campuscare/blob/main/app/clubs/page.tsx"
click node_qr_placards "https://github.com/kanhaiya-js/campuscare/blob/main/app/admin/qr-codes/page.tsx"
click node_admin_console "https://github.com/kanhaiya-js/campuscare/blob/main/app/admin/page.tsx"
click node_admin_issues "https://github.com/kanhaiya-js/campuscare/blob/main/app/admin/issues/page.tsx"
click node_analytics "https://github.com/kanhaiya-js/campuscare/blob/main/app/admin/analytics/page.tsx"
click node_audit_logs "https://github.com/kanhaiya-js/campuscare/blob/main/app/admin/audit-logs/page.tsx"
click node_session_auth "https://github.com/kanhaiya-js/campuscare/blob/main/lib/auth/session.ts"
click node_database "https://github.com/kanhaiya-js/campuscare/blob/main/lib/db/prisma.ts"
click node_audit_service "https://github.com/kanhaiya-js/campuscare/blob/main/lib/services/audit.ts"

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_report_wizard,node_qr_scan,node_issue_api,node_duplicate_check,node_upload_service toneBlue
class node_priority_engine,node_assignment_engine,node_ticket_ids,node_issue_tracking,node_issue_detail,node_staff_workspace,node_notifications toneAmber
class node_campus_map,node_facilities,node_transport,node_clubs,node_qr_placards toneMint
class node_admin_console,node_admin_issues,node_analytics,node_audit_logs toneRose
class node_session_auth,node_database,node_audit_service,node_campus_users toneIndigo
```

## Components

### Issue Reporting

- [Report Wizard](https://github.com/kanhaiya-js/campuscare/blob/main/app/issues/report/page.tsx): `app/issues/report/page.tsx`
- [Room QR Scanner](https://github.com/kanhaiya-js/campuscare/blob/main/app/scan/page.tsx): `app/scan/page.tsx`
- [Issue API](https://github.com/kanhaiya-js/campuscare/blob/main/app/api/issues/route.ts): `app/api/issues/route.ts`
- [Duplicate Detection](https://github.com/kanhaiya-js/campuscare/blob/main/lib/services/duplicate-detector.ts): `lib/services/duplicate-detector.ts`
- [Evidence Uploads](https://github.com/kanhaiya-js/campuscare/blob/main/lib/storage/upload.ts): `lib/storage/upload.ts`

### Issue Operations

- [Priority Engine](https://github.com/kanhaiya-js/campuscare/blob/main/lib/services/priority-engine.ts): `lib/services/priority-engine.ts`
- [Assignment Engine](https://github.com/kanhaiya-js/campuscare/blob/main/lib/services/assignment-engine.ts): `lib/services/assignment-engine.ts`
- [Ticket ID Generator](https://github.com/kanhaiya-js/campuscare/blob/main/lib/services/issue-id.ts): `lib/services/issue-id.ts`
- [Issue Tracking](https://github.com/kanhaiya-js/campuscare/blob/main/app/issues/page.tsx): `app/issues/page.tsx`
- [Issue Details](https://github.com/kanhaiya-js/campuscare/blob/main/app/issues/%5Bid%5D/page.tsx): `app/issues/[id]/page.tsx`
- [Staff Workspace](https://github.com/kanhaiya-js/campuscare/blob/main/app/staff/page.tsx): `app/staff/page.tsx`
- [Notifications](https://github.com/kanhaiya-js/campuscare/blob/main/lib/services/notification.ts): `lib/services/notification.ts`

### Campus Services

- [Campus Map](https://github.com/kanhaiya-js/campuscare/blob/main/components/maps/campus-map-inner.tsx): `components/maps/campus-map-inner.tsx`
- [Facilities Directory](https://github.com/kanhaiya-js/campuscare/blob/main/app/facilities/page.tsx): `app/facilities/page.tsx`
- [Campus Transport](https://github.com/kanhaiya-js/campuscare/blob/main/app/transport/page.tsx): `app/transport/page.tsx`
- [Clubs Directory](https://github.com/kanhaiya-js/campuscare/blob/main/app/clubs/page.tsx): `app/clubs/page.tsx`
- [QR Placards](https://github.com/kanhaiya-js/campuscare/blob/main/app/admin/qr-codes/page.tsx): `app/admin/qr-codes/page.tsx`

### Administration

- [Admin Console](https://github.com/kanhaiya-js/campuscare/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Issue Administration](https://github.com/kanhaiya-js/campuscare/blob/main/app/admin/issues/page.tsx): `app/admin/issues/page.tsx`
- [Analytics & Reports](https://github.com/kanhaiya-js/campuscare/blob/main/app/admin/analytics/page.tsx): `app/admin/analytics/page.tsx`
- [Audit Logs](https://github.com/kanhaiya-js/campuscare/blob/main/app/admin/audit-logs/page.tsx): `app/admin/audit-logs/page.tsx`

### Shared Platform

- [Session & Access](https://github.com/kanhaiya-js/campuscare/blob/main/lib/auth/session.ts): `lib/auth/session.ts`
- [Campus Database](https://github.com/kanhaiya-js/campuscare/blob/main/lib/db/prisma.ts): `lib/db/prisma.ts`
- [Audit Service](https://github.com/kanhaiya-js/campuscare/blob/main/lib/services/audit.ts): `lib/services/audit.ts`

### Other components

- **Students & Faculty**

## Connections

- Students & Faculty → Report Wizard: report problems
- Students & Faculty → Room QR Scanner: scan room codes
- Report Wizard → Issue API: submit reports
- Room QR Scanner → Report Wizard: start reporting
- Issue API → Duplicate Detection: check duplicates
- Issue API → Priority Engine: calculate priority (evidence: `app/api/issues/route.ts`)
- Issue API → Ticket ID Generator: generate ticket ID (evidence: `app/api/issues/route.ts`)
- Issue API → Assignment Engine: find staff (evidence: `app/api/issues/route.ts`)
- Issue API → Campus Database: create issue (evidence: `app/api/issues/route.ts`)
- Issue API → Notifications: send notifications (evidence: `app/api/issues/route.ts`)
- Report Wizard → Evidence Uploads: attach evidence
- Issue Tracking → Issue API: retrieve tickets
- Issue Details → Issue API: view and update
- Staff Workspace → Issue API: manage assigned work
- Students & Faculty → Campus Map: explore hotspots
- Students & Faculty → Facilities Directory: browse facilities
- Students & Faculty → Campus Transport: view bus routes
- Students & Faculty → Clubs Directory: browse societies
- Admin Console → Issue Administration: manage issues
- Admin Console → Analytics & Reports: review operations
- Admin Console → Audit Logs: review activity
- Admin Console → QR Placards: prepare placards
- Issue API → Session & Access: get session (evidence: `app/api/issues/route.ts`)
- Issue API → Audit Service: record activity (evidence: `app/api/issues/route.ts`)
- Audit Service → Campus Database: write audit log (evidence: `lib/services/audit.ts`)
