# kaditya2006/smart-campus-quickfix architecture

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

- Interactive diagram: https://gitdiagram.com/kaditya2006/smart-campus-quickfix
- Repository: https://github.com/kaditya2006/smart-campus-quickfix

## Overview

Smart Campus QuickFix is a mobile issue-reporting and maintenance workflow: campus users register, verify identity, and authenticate; report and track issues; authorities triage, prioritize, and resolve them; and users receive updates. The mobile app calls an Express API, whose controllers coordinate issue, user, OTP, and notification records plus verification and email services. Analytics, dashboards, profiles, and notifications are additional product branches. Some screen and route implementations were not sampled; those capabilities and links are included only where documented or indexed.

Main entry points: [`server/src/controllers/authController.ts`](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/controllers/authController.ts) (OTP and registration), [`server/src/controllers/issueController.ts`](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/controllers/issueController.ts) (User issue operations), [`mobile/src/navigation/RootNavigation.tsx`](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/src/navigation/RootNavigation.tsx) (Role navigation), [`server/src/app.ts`](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/app.ts) (API routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile app"]
  node_app["App shell<br/>[App.tsx]"]
  node_root_nav["Role navigation<br/>[RootNavigation.tsx]"]
  node_auth_screens["Sign-in and registration"]
  node_user_screens["User dashboard and tracking"]
  node_report_screen["Issue reporting"]
  node_authority_screens["Authority queue and details"]
  node_api_client["API client<br/>[apiClient.ts]"]
end

subgraph group_auth["Identity and access"]
  node_auth_context["Session context<br/>[AuthContext.tsx]"]
  node_pending["Verification status"]
  node_auth_controller["OTP and registration<br/>[authController.ts]"]
  node_identity_service["Identity verification"]
  node_auth_middleware["JWT and role checks<br/>[auth.ts]"]
  node_upload_middleware["Document and photo uploads<br/>[upload.ts]"]
  node_user_model[("User records<br/>[User.ts]")]
  node_otp_model[("OTP records<br/>[Otp.ts]")]
end

subgraph group_issues["Issue workflow"]
  node_issue_controller["User issue operations<br/>[issueController.ts]"]
  node_authority_controller["Authority issue operations"]
  node_transition_service["Status transition rules"]
  node_issue_model[("Issue records<br/>[Issue.ts]")]
end

subgraph group_updates["Updates and insights"]
  node_notification_controller["Notification operations"]
  node_notification_service["Notification creation"]
  node_notification_model[("Notification records<br/>[Notification.ts]")]
  node_analytics_controller["Analytics"]
  node_email_service["Email delivery<br/>[emailService.ts]"]
  node_smtp["SMTP service"]
end

subgraph group_backend["API and data"]
  node_auth_routes["Authentication routes<br/>[authRoutes.ts]"]
  node_issue_routes["Issue routes<br/>[issueRoutes.ts]"]
  node_notification_routes["Notification routes"]
  node_api_app["API routing<br/>[app.ts]"]
  node_mongodb[("MongoDB")]
end

node_campus_user(("Campus user"))
node_authority_user(("Authority"))

node_campus_user -->|"uses"| node_app
node_authority_user -->|"uses"| node_app
node_app -->|"provides session"| node_auth_context
node_app -->|"renders"| node_root_nav
node_root_nav -->|"routes to"| node_auth_screens
node_root_nav -->|"routes to"| node_pending
node_root_nav -->|"routes to"| node_user_screens
node_root_nav -->|"routes to"| node_authority_screens
node_auth_screens -->|"calls"| node_api_client
node_auth_screens -->|"sets session"| node_auth_context
node_report_screen -->|"submits report"| node_api_client
node_authority_screens -->|"loads and updates"| node_api_client
node_user_screens -.->|"calls"| node_api_client
node_api_client -->|"sends API requests"| node_api_app
node_api_app -->|"mounts"| node_auth_routes
node_api_app -->|"mounts"| node_issue_routes
node_api_app -->|"mounts"| node_notification_routes
node_api_app -->|"mounts analytics routes"| node_analytics_controller
node_auth_routes -->|"dispatches to"| node_auth_controller
node_auth_routes -->|"accepts ID upload"| node_upload_middleware
node_auth_routes -->|"protects routes"| node_auth_middleware
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"creates and verifies"| node_otp_model
node_auth_controller -->|"starts verification"| node_identity_service
node_auth_controller -->|"sends OTP email"| node_email_service
node_auth_middleware -->|"loads account"| node_user_model
node_issue_routes -->|"dispatches to"| node_issue_controller
node_issue_routes -->|"protects routes"| node_auth_middleware
node_issue_routes -->|"accepts evidence"| node_upload_middleware
node_issue_controller -->|"reads and writes"| node_issue_model
node_issue_controller -->|"loads authorities and reporter"| node_user_model
node_issue_controller -->|"notifies authorities"| node_notification_service
node_issue_controller -->|"emails reporter"| node_email_service
node_authority_controller -->|"reads and updates"| node_issue_model
node_authority_controller -->|"validates status"| node_transition_service
node_authority_controller -->|"creates update notices"| node_notification_service
node_authority_controller -->|"emails reporter"| node_email_service
node_notification_routes -->|"dispatches to"| node_notification_controller
node_notification_controller -->|"reads notifications"| node_notification_model
node_notification_service -->|"creates records"| node_notification_model
node_notification_service -->|"loads issue data"| node_issue_model
node_auth_controller -.->|"persists account and OTP data"| node_mongodb
node_issue_controller -.->|"persists issues"| node_mongodb
node_email_service -->|"delivers mail"| node_smtp
node_analytics_controller -.->|"queries analytics data"| node_mongodb

click node_app "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/App.tsx"
click node_root_nav "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/src/navigation/RootNavigation.tsx"
click node_auth_screens "https://github.com/kaditya2006/smart-campus-quickfix/tree/main/mobile/src/screens/auth"
click node_auth_context "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/src/context/AuthContext.tsx"
click node_pending "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/src/screens/verification/VerificationPendingScreen.tsx"
click node_user_screens "https://github.com/kaditya2006/smart-campus-quickfix/tree/main/mobile/src/screens/user"
click node_report_screen "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/src/screens/user/ReportIssueScreen.tsx"
click node_authority_screens "https://github.com/kaditya2006/smart-campus-quickfix/tree/main/mobile/src/screens/authority"
click node_api_client "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/src/services/apiClient.ts"
click node_auth_routes "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/routes/authRoutes.ts"
click node_auth_controller "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/controllers/authController.ts"
click node_identity_service "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/services/identityVerificationService.ts"
click node_auth_middleware "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/middleware/auth.ts"
click node_upload_middleware "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/middleware/upload.ts"
click node_issue_routes "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/routes/issueRoutes.ts"
click node_issue_controller "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/controllers/issueController.ts"
click node_authority_controller "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/controllers/authorityController.ts"
click node_transition_service "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/services/statusTransitionService.ts"
click node_issue_model "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/models/Issue.ts"
click node_user_model "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/models/User.ts"
click node_otp_model "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/models/Otp.ts"
click node_notification_routes "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/routes/notificationRoutes.ts"
click node_notification_controller "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/controllers/notificationController.ts"
click node_notification_service "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/services/notificationService.ts"
click node_notification_model "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/models/Notification.ts"
click node_analytics_controller "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/controllers/analyticsController.ts"
click node_email_service "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/services/emailService.ts"
click node_api_app "https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/app.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_app,node_root_nav,node_auth_screens,node_user_screens,node_report_screen,node_authority_screens,node_api_client,node_campus_user toneBlue
class node_auth_context,node_pending,node_auth_controller,node_identity_service,node_auth_middleware,node_upload_middleware,node_user_model,node_otp_model toneAmber
class node_issue_controller,node_authority_controller,node_transition_service,node_issue_model toneMint
class node_notification_controller,node_notification_service,node_notification_model,node_analytics_controller,node_email_service,node_smtp toneRose
class node_auth_routes,node_issue_routes,node_notification_routes,node_api_app,node_mongodb,node_authority_user toneIndigo
```

## Components

### Mobile app

- [App shell](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/App.tsx): `mobile/App.tsx`
- [Role navigation](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/src/navigation/RootNavigation.tsx): `mobile/src/navigation/RootNavigation.tsx`
- [Sign-in and registration](https://github.com/kaditya2006/smart-campus-quickfix/tree/main/mobile/src/screens/auth): `mobile/src/screens/auth`
- [User dashboard and tracking](https://github.com/kaditya2006/smart-campus-quickfix/tree/main/mobile/src/screens/user): `mobile/src/screens/user`
- [Issue reporting](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/src/screens/user/ReportIssueScreen.tsx): `mobile/src/screens/user/ReportIssueScreen.tsx`
- [Authority queue and details](https://github.com/kaditya2006/smart-campus-quickfix/tree/main/mobile/src/screens/authority): `mobile/src/screens/authority`
- [API client](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/src/services/apiClient.ts): `mobile/src/services/apiClient.ts`

### Identity and access

- [Session context](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/src/context/AuthContext.tsx): `mobile/src/context/AuthContext.tsx`
- [Verification status](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/mobile/src/screens/verification/VerificationPendingScreen.tsx): `mobile/src/screens/verification/VerificationPendingScreen.tsx`
- [OTP and registration](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/controllers/authController.ts): `server/src/controllers/authController.ts`
- [Identity verification](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/services/identityVerificationService.ts): `server/src/services/identityVerificationService.ts`
- [JWT and role checks](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/middleware/auth.ts): `server/src/middleware/auth.ts`
- [Document and photo uploads](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/middleware/upload.ts): `server/src/middleware/upload.ts`
- [User records](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/models/User.ts): `server/src/models/User.ts`
- [OTP records](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/models/Otp.ts): `server/src/models/Otp.ts`

### Issue workflow

- [User issue operations](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/controllers/issueController.ts): `server/src/controllers/issueController.ts`
- [Authority issue operations](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/controllers/authorityController.ts): `server/src/controllers/authorityController.ts`
- [Status transition rules](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/services/statusTransitionService.ts): `server/src/services/statusTransitionService.ts`
- [Issue records](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/models/Issue.ts): `server/src/models/Issue.ts`

### Updates and insights

- [Notification operations](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/controllers/notificationController.ts): `server/src/controllers/notificationController.ts`
- [Notification creation](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/services/notificationService.ts): `server/src/services/notificationService.ts`
- [Notification records](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/models/Notification.ts): `server/src/models/Notification.ts`
- [Analytics](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/controllers/analyticsController.ts): `server/src/controllers/analyticsController.ts`
- [Email delivery](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/services/emailService.ts): `server/src/services/emailService.ts`
- **SMTP service**

### API and data

- [Authentication routes](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/routes/authRoutes.ts): `server/src/routes/authRoutes.ts`
- [Issue routes](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/routes/issueRoutes.ts): `server/src/routes/issueRoutes.ts`
- [Notification routes](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/routes/notificationRoutes.ts): `server/src/routes/notificationRoutes.ts`
- [API routing](https://github.com/kaditya2006/smart-campus-quickfix/blob/main/server/src/app.ts): `server/src/app.ts`
- **MongoDB**

### Other components

- **Campus user**
- **Authority**

## Connections

- Campus user → App shell: uses (evidence: `README.md`)
- Authority → App shell: uses (evidence: `README.md`)
- App shell → Session context: provides session (evidence: `mobile/App.tsx`)
- App shell → Role navigation: renders (evidence: `mobile/App.tsx`)
- Role navigation → Sign-in and registration: routes to
- Role navigation → Verification status: routes to (evidence: `mobile/src/navigation/RootNavigation.tsx`)
- Role navigation → User dashboard and tracking: routes to (evidence: `mobile/src/navigation/RootNavigation.tsx`)
- Role navigation → Authority queue and details: routes to (evidence: `mobile/src/navigation/RootNavigation.tsx`)
- Sign-in and registration → API client: calls (evidence: `mobile/src/screens/auth/LoginScreen.tsx`)
- Sign-in and registration → Session context: sets session (evidence: `mobile/src/screens/auth/OtpVerificationScreen.tsx`)
- Issue reporting → API client: submits report (evidence: `mobile/src/screens/user/ReportIssueScreen.tsx`)
- Authority queue and details → API client: loads and updates (evidence: `mobile/src/screens/authority/AuthorityIssueDetailsScreen.tsx`)
- User dashboard and tracking → API client: calls (evidence: `mobile/src/screens/user/ReportIssueScreen.tsx`)
- API client → API routing: sends API requests (evidence: `mobile/src/services/apiClient.ts`)
- API routing → Authentication routes: mounts (evidence: `server/src/app.ts`)
- API routing → Issue routes: mounts (evidence: `server/src/app.ts`)
- API routing → Notification routes: mounts (evidence: `server/src/app.ts`)
- API routing → Analytics: mounts analytics routes (evidence: `server/src/app.ts`)
- Authentication routes → OTP and registration: dispatches to (evidence: `server/src/routes/authRoutes.ts`)
- Authentication routes → Document and photo uploads: accepts ID upload (evidence: `server/src/routes/authRoutes.ts`)
- Authentication routes → JWT and role checks: protects routes (evidence: `server/src/routes/authRoutes.ts`)
- OTP and registration → User records: reads and writes (evidence: `server/src/controllers/authController.ts`)
- OTP and registration → OTP records: creates and verifies (evidence: `server/src/controllers/authController.ts`)
- OTP and registration → Identity verification: starts verification (evidence: `server/src/controllers/authController.ts`)
- OTP and registration → Email delivery: sends OTP email (evidence: `server/src/controllers/authController.ts`)
- JWT and role checks → User records: loads account (evidence: `server/src/middleware/auth.ts`)
- Issue routes → User issue operations: dispatches to (evidence: `server/src/routes/issueRoutes.ts`)
- Issue routes → JWT and role checks: protects routes (evidence: `server/src/routes/issueRoutes.ts`)
- Issue routes → Document and photo uploads: accepts evidence (evidence: `server/src/routes/issueRoutes.ts`)
- User issue operations → Issue records: reads and writes (evidence: `server/src/controllers/issueController.ts`)
- User issue operations → User records: loads authorities and reporter (evidence: `server/src/controllers/issueController.ts`)
- User issue operations → Notification creation: notifies authorities (evidence: `server/src/controllers/issueController.ts`)
- User issue operations → Email delivery: emails reporter (evidence: `server/src/controllers/issueController.ts`)
- Authority issue operations → Issue records: reads and updates (evidence: `server/src/controllers/authorityController.ts`)
- Authority issue operations → Status transition rules: validates status (evidence: `server/src/controllers/authorityController.ts`)
- Authority issue operations → Notification creation: creates update notices (evidence: `server/src/controllers/authorityController.ts`)
- Authority issue operations → Email delivery: emails reporter (evidence: `server/src/controllers/authorityController.ts`)
- Notification routes → Notification operations: dispatches to (evidence: `server/src/routes/notificationRoutes.ts`)
- Notification operations → Notification records: reads notifications (evidence: `server/src/controllers/notificationController.ts`)
- Notification creation → Notification records: creates records (evidence: `server/src/services/notificationService.ts`)
- Notification creation → Issue records: loads issue data (evidence: `server/src/services/notificationService.ts`)
- OTP and registration → MongoDB: persists account and OTP data
- User issue operations → MongoDB: persists issues
- Email delivery → SMTP service: delivers mail (evidence: `README.md`)
- Analytics → MongoDB: queries analytics data
