# takshchauhan/campus-complaint-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/takshchauhan/campus-complaint-management-system
- Repository: https://github.com/takshchauhan/campus-complaint-management-system

## Overview

CCMS is a campus complaint reporting system. Its main student workflow is account registration or sign-in, browsing departments and optional keyword suggestions, choosing a department, submitting a complaint, and viewing a receipt or private complaint history. The frontend communicates with a FastAPI backend, which applies authentication and domain services before using SQLAlchemy persistence. Google sign-in is an optional, disabled-by-default capability; staff and admin dashboards appear in the UI, but the README identifies complaint-processing workflows as future work. Edges use README statements or source-index references; unsampled implementation details are not assumed.

Main entry points: [`frontend/src/App.tsx`](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/App.tsx) (App navigation), [`backend/app/api/v1/router.py`](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/router.py) (API router), [`backend/app/api/v1/endpoints/auth.py`](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/endpoints/auth.py) (Authentication routes), [`backend/app/api/v1/endpoints/complaints.py`](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/endpoints/complaints.py) (Complaint routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_app["App navigation<br/>[App.tsx]"]
  node_auth_ui["Authentication UI<br/>[AuthPage.tsx]"]
  node_auth_state["Auth context<br/>[AuthContext.tsx]"]
  node_complaint_form["Complaint form"]
  node_receipt["Complaint receipt"]
  node_history["Complaint history"]
  node_staff_ui["Staff dashboard<br/>[StaffDashboard.tsx]"]
  node_admin_ui["Admin dashboard<br/>[AdminDashboard.tsx]"]
  node_api_client["HTTP client<br/>[client.ts]"]
  node_auth_api["Auth API client<br/>[auth.ts]"]
  node_complaints_api["Complaints API client<br/>[complaints.ts]"]
  node_departments_api["Departments API client<br/>[departments.ts]"]
end

subgraph group_backend["Backend API"]
  node_router["API router<br/>[router.py]"]
  node_auth_routes["Authentication routes<br/>[auth.py]"]
  node_complaint_routes["Complaint routes<br/>[complaints.py]"]
  node_department_routes["Department routes<br/>[departments.py]"]
  node_user_routes["Profile routes<br/>[users.py]"]
  node_auth_schemas["Auth contracts<br/>[auth.py]"]
  node_complaint_schemas["Complaint contracts<br/>[complaint.py]"]
  node_department_schemas["Department contracts<br/>[department.py]"]
  node_user_schemas["User contracts<br/>[user.py]"]
end

subgraph group_domain["Domain Services"]
  node_auth_service["Account service<br/>[auth_service.py]"]
  node_google_service["Google auth service"]
  node_complaint_service["Complaint service"]
  node_department_service["Department service"]
  node_suggestion_service["Keyword suggestions"]
end

subgraph group_persistence["Persistence"]
  node_session["DB sessions<br/>[session.py]"]
  node_users_model[("User records<br/>[user.py]")]
  node_complaints_model[("Complaint records<br/>[complaint.py]")]
  node_departments_model[("Department records<br/>[department.py]")]
  node_oauth_model[("OAuth state records<br/>[oauth.py]")]
end

node_student(("Student"))
node_google(("Google OAuth"))
node_database[("SQL database")]

node_student -->|"uses"| node_app
node_app -->|"renders"| node_auth_ui
node_app -->|"renders"| node_complaint_form
node_app -->|"renders"| node_receipt
node_app -->|"renders"| node_history
node_app -->|"renders"| node_staff_ui
node_app -->|"renders"| node_admin_ui
node_app -->|"provides auth"| node_auth_state
node_auth_ui -->|"uses"| node_auth_state
node_auth_state -->|"calls"| node_auth_api
node_auth_state -->|"clears token"| node_api_client
node_complaint_form -->|"loads departments"| node_departments_api
node_complaint_form -->|"submits complaint"| node_complaints_api
node_history -->|"fetches history"| node_complaints_api
node_auth_api -->|"sends requests"| node_api_client
node_complaints_api -->|"sends requests"| node_api_client
node_departments_api -->|"sends requests"| node_api_client
node_api_client -->|"HTTP requests"| node_router
node_router -->|"registers"| node_auth_routes
node_router -->|"registers"| node_complaint_routes
node_router -->|"registers"| node_department_routes
node_router -->|"registers"| node_user_routes
node_auth_routes -->|"calls"| node_auth_service
node_auth_routes -->|"calls"| node_google_service
node_complaint_routes -->|"calls"| node_complaint_service
node_complaint_routes -->|"requests suggestions"| node_suggestion_service
node_department_routes -->|"calls"| node_department_service
node_department_routes -->|"requests suggestions"| node_suggestion_service
node_google_service -.->|"exchanges tokens"| node_google
node_auth_routes -->|"uses database session"| node_session
node_complaint_routes -->|"uses database session"| node_session
node_department_routes -->|"uses database session"| node_session
node_auth_service -->|"reads and writes"| node_users_model
node_complaint_service -->|"reads and writes"| node_complaints_model
node_complaint_service -->|"reads"| node_departments_model
node_department_service -->|"reads"| node_departments_model
node_suggestion_service -->|"reads active departments"| node_departments_model
node_google_service -->|"stores OAuth state"| node_oauth_model
node_google_service -->|"resolves account"| node_users_model
node_session -->|"connects"| node_database
node_users_model -->|"references"| node_departments_model
node_users_model -->|"owns complaints"| node_complaints_model
node_users_model -->|"owns identities"| node_oauth_model
node_complaints_model -->|"references"| node_departments_model
node_auth_routes -->|"validates requests"| node_auth_schemas
node_complaint_routes -->|"uses contracts"| node_complaint_schemas
node_department_routes -->|"uses contracts"| node_department_schemas
node_auth_service -->|"returns profile"| node_user_schemas

click node_app "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/App.tsx"
click node_auth_ui "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/components/AuthPage.tsx"
click node_auth_state "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/context/AuthContext.tsx"
click node_complaint_form "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/components/SubmitComplaintForm.tsx"
click node_receipt "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/components/ComplaintReceipt.tsx"
click node_history "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/components/MyComplaintsList.tsx"
click node_staff_ui "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/components/StaffDashboard.tsx"
click node_admin_ui "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/components/AdminDashboard.tsx"
click node_api_client "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/api/client.ts"
click node_auth_api "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/api/auth.ts"
click node_complaints_api "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/api/complaints.ts"
click node_departments_api "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/api/departments.ts"
click node_router "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/router.py"
click node_auth_routes "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/endpoints/auth.py"
click node_complaint_routes "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/endpoints/complaints.py"
click node_department_routes "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/endpoints/departments.py"
click node_user_routes "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/endpoints/users.py"
click node_auth_service "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/services/auth_service.py"
click node_google_service "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/services/google_auth_service.py"
click node_complaint_service "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/services/complaint_service.py"
click node_department_service "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/services/department_service.py"
click node_suggestion_service "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/services/suggestion_service.py"
click node_session "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/db/session.py"
click node_users_model "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/models/user.py"
click node_complaints_model "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/models/complaint.py"
click node_departments_model "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/models/department.py"
click node_oauth_model "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/models/oauth.py"
click node_auth_schemas "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/schemas/auth.py"
click node_complaint_schemas "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/schemas/complaint.py"
click node_department_schemas "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/schemas/department.py"
click node_user_schemas "https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/schemas/user.py"

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_auth_ui,node_auth_state,node_complaint_form,node_receipt,node_history,node_staff_ui,node_admin_ui,node_api_client,node_auth_api,node_complaints_api,node_departments_api toneBlue
class node_router,node_auth_routes,node_complaint_routes,node_department_routes,node_user_routes,node_auth_schemas,node_complaint_schemas,node_department_schemas,node_user_schemas,node_database toneAmber
class node_auth_service,node_google_service,node_complaint_service,node_department_service,node_suggestion_service toneMint
class node_session,node_users_model,node_complaints_model,node_departments_model,node_oauth_model toneRose
class node_student,node_google toneIndigo
```

## Components

### Frontend

- [App navigation](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Authentication UI](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/components/AuthPage.tsx): `frontend/src/components/AuthPage.tsx`
- [Auth context](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Complaint form](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/components/SubmitComplaintForm.tsx): `frontend/src/components/SubmitComplaintForm.tsx`
- [Complaint receipt](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/components/ComplaintReceipt.tsx): `frontend/src/components/ComplaintReceipt.tsx`
- [Complaint history](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/components/MyComplaintsList.tsx): `frontend/src/components/MyComplaintsList.tsx`
- [Staff dashboard](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/components/StaffDashboard.tsx): `frontend/src/components/StaffDashboard.tsx`
- [Admin dashboard](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/components/AdminDashboard.tsx): `frontend/src/components/AdminDashboard.tsx`
- [HTTP client](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Auth API client](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/api/auth.ts): `frontend/src/api/auth.ts`
- [Complaints API client](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/api/complaints.ts): `frontend/src/api/complaints.ts`
- [Departments API client](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/frontend/src/api/departments.ts): `frontend/src/api/departments.ts`

### Backend API

- [API router](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/router.py): `backend/app/api/v1/router.py`
- [Authentication routes](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/endpoints/auth.py): `backend/app/api/v1/endpoints/auth.py`
- [Complaint routes](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/endpoints/complaints.py): `backend/app/api/v1/endpoints/complaints.py`
- [Department routes](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/endpoints/departments.py): `backend/app/api/v1/endpoints/departments.py`
- [Profile routes](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/api/v1/endpoints/users.py): `backend/app/api/v1/endpoints/users.py`
- [Auth contracts](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/schemas/auth.py): `backend/app/schemas/auth.py`
- [Complaint contracts](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/schemas/complaint.py): `backend/app/schemas/complaint.py`
- [Department contracts](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/schemas/department.py): `backend/app/schemas/department.py`
- [User contracts](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/schemas/user.py): `backend/app/schemas/user.py`

### Domain Services

- [Account service](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/services/auth_service.py): `backend/app/services/auth_service.py`
- [Google auth service](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/services/google_auth_service.py): `backend/app/services/google_auth_service.py`
- [Complaint service](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/services/complaint_service.py): `backend/app/services/complaint_service.py`
- [Department service](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/services/department_service.py): `backend/app/services/department_service.py`
- [Keyword suggestions](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/services/suggestion_service.py): `backend/app/services/suggestion_service.py`

### Persistence

- [DB sessions](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/db/session.py): `backend/app/db/session.py`
- [User records](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/models/user.py): `backend/app/models/user.py`
- [Complaint records](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/models/complaint.py): `backend/app/models/complaint.py`
- [Department records](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/models/department.py): `backend/app/models/department.py`
- [OAuth state records](https://github.com/takshchauhan/campus-complaint-management-system/blob/main/backend/app/models/oauth.py): `backend/app/models/oauth.py`

### Other components

- **Student**
- **Google OAuth**
- **SQL database**

## Connections

- Student → App navigation: uses (evidence: `README.md`)
- App navigation → Authentication UI: renders (evidence: `frontend/src/App.tsx`)
- App navigation → Complaint form: renders (evidence: `frontend/src/App.tsx`)
- App navigation → Complaint receipt: renders (evidence: `frontend/src/App.tsx`)
- App navigation → Complaint history: renders (evidence: `frontend/src/App.tsx`)
- App navigation → Staff dashboard: renders (evidence: `frontend/src/App.tsx`)
- App navigation → Admin dashboard: renders (evidence: `frontend/src/App.tsx`)
- App navigation → Auth context: provides auth (evidence: `frontend/src/App.tsx`)
- Authentication UI → Auth context: uses (evidence: `frontend/src/components/AuthPage.tsx`)
- Auth context → Auth API client: calls (evidence: `frontend/src/context/AuthContext.tsx`)
- Auth context → HTTP client: clears token (evidence: `frontend/src/context/AuthContext.tsx`)
- Complaint form → Departments API client: loads departments (evidence: `frontend/src/components/SubmitComplaintForm.tsx`)
- Complaint form → Complaints API client: submits complaint (evidence: `frontend/src/components/SubmitComplaintForm.tsx`)
- Complaint history → Complaints API client: fetches history (evidence: `frontend/src/components/MyComplaintsList.tsx`)
- Auth API client → HTTP client: sends requests (evidence: `frontend/src/api/auth.ts`)
- Complaints API client → HTTP client: sends requests (evidence: `frontend/src/api/complaints.ts`)
- Departments API client → HTTP client: sends requests (evidence: `frontend/src/api/departments.ts`)
- HTTP client → API router: HTTP requests (evidence: `README.md`)
- API router → Authentication routes: registers (evidence: `backend/app/api/v1/router.py`)
- API router → Complaint routes: registers (evidence: `backend/app/api/v1/router.py`)
- API router → Department routes: registers (evidence: `backend/app/api/v1/router.py`)
- API router → Profile routes: registers (evidence: `backend/app/api/v1/router.py`)
- Authentication routes → Account service: calls (evidence: `backend/app/api/v1/endpoints/auth.py`)
- Authentication routes → Google auth service: calls (evidence: `backend/app/api/v1/endpoints/auth.py`)
- Complaint routes → Complaint service: calls (evidence: `backend/app/api/v1/endpoints/complaints.py`)
- Complaint routes → Keyword suggestions: requests suggestions (evidence: `backend/app/api/v1/endpoints/complaints.py`)
- Department routes → Department service: calls (evidence: `backend/app/api/v1/endpoints/departments.py`)
- Department routes → Keyword suggestions: requests suggestions (evidence: `backend/app/api/v1/endpoints/departments.py`)
- Google auth service → Google OAuth: exchanges tokens (evidence: `README.md`)
- Authentication routes → DB sessions: uses database session (evidence: `backend/app/api/v1/endpoints/auth.py`)
- Complaint routes → DB sessions: uses database session (evidence: `backend/app/api/v1/endpoints/complaints.py`)
- Department routes → DB sessions: uses database session (evidence: `backend/app/api/v1/endpoints/departments.py`)
- Account service → User records: reads and writes (evidence: `backend/app/services/auth_service.py`)
- Complaint service → Complaint records: reads and writes (evidence: `backend/app/services/complaint_service.py`)
- Complaint service → Department records: reads (evidence: `backend/app/services/complaint_service.py`)
- Department service → Department records: reads (evidence: `backend/app/services/department_service.py`)
- Keyword suggestions → Department records: reads active departments (evidence: `backend/app/services/suggestion_service.py`)
- Google auth service → OAuth state records: stores OAuth state (evidence: `backend/app/services/google_auth_service.py`)
- Google auth service → User records: resolves account (evidence: `backend/app/services/google_auth_service.py`)
- DB sessions → SQL database: connects (evidence: `backend/app/db/session.py`)
- User records → Department records: references (evidence: `backend/app/models/user.py`)
- User records → Complaint records: owns complaints (evidence: `backend/app/models/user.py`)
- User records → OAuth state records: owns identities (evidence: `backend/app/models/user.py`)
- Complaint records → Department records: references (evidence: `backend/app/models/complaint.py`)
- Authentication routes → Auth contracts: validates requests (evidence: `backend/app/api/v1/endpoints/auth.py`)
- Complaint routes → Complaint contracts: uses contracts (evidence: `backend/app/api/v1/endpoints/complaints.py`)
- Department routes → Department contracts: uses contracts (evidence: `backend/app/api/v1/endpoints/departments.py`)
- Account service → User contracts: returns profile (evidence: `backend/app/services/auth_service.py`)
