# iamarun3/campus-care architecture

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

- Interactive diagram: https://gitdiagram.com/iamarun3/campus-care
- Repository: https://github.com/iamarun3/campus-care

## Overview

CampusCare Hub is a role-based campus grievance and maintenance portal. Users submit and track complaints; admins manage complaints, workers, inventory, QR entry points, activity, and maintenance schedules; workers handle assigned tasks. Complaint classification and portal guidance are additional AI-assisted capabilities. The graph emphasizes the documented workflow and operational areas. Several pages and hooks are unsampled, so their internal calls are not asserted; dashed edges mark documented integrations whose invoking code was not shown.

Main entry points: [`campus-care-hub-main/src/App.tsx`](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/App.tsx) (Role-based routes), [`campus-care-hub-main/src/integrations/supabase/client.ts`](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/integrations/supabase/client.ts) (Supabase client), [`campus-care-hub-main/src/pages/worker/WorkerDashboard.tsx`](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/worker/WorkerDashboard.tsx) (Worker task handling), [`campus-care-hub-main/src/contexts/AuthContext.tsx`](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/contexts/AuthContext.tsx) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application access"]
  node_entry["React entry<br/>[main.tsx]"]
  node_routes["Role-based routes<br/>[App.tsx]"]
  node_auth["Authentication<br/>[AuthContext.tsx]"]
end

subgraph group_complaints["Complaint workflow"]
  node_userpages["User dashboards"]
  node_raise["Complaint submission"]
  node_usercomplaints["Complaint tracking"]
  node_admincomplaints["Complaint operations"]
  node_workerpage["Worker task handling"]
  node_classification["Complaint classification<br/>[index.ts]"]
  node_assignment["Worker assignment"]
end

subgraph group_operations["Campus operations"]
  node_adminhome["Admin dashboard<br/>[AdminDashboard.tsx]"]
  node_workeradmin["Worker management"]
  node_inventory["Inventory management"]
  node_scheduling["Maintenance scheduling"]
  node_qr["QR entry points<br/>[AdminQRPage.tsx]"]
  node_activity["Activity logs"]
end

subgraph group_insights["Analytics and assistance"]
  node_analytics["Operational analytics"]
  node_assistant["AI help assistant"]
  node_chatfunction["Assistant service<br/>[index.ts]"]
  node_voice["Voice input<br/>[useSpeechToText.ts]"]
end

subgraph group_platform["Data and services"]
  node_supabase["Supabase client<br/>[client.ts]"]
  node_database[("Supabase database")]
  node_supabaseauth["Supabase Auth"]
end

node_users(("Campus users"))
node_admins(("Administrators"))
node_workers(("Maintenance workers"))

node_entry -->|"renders"| node_routes
node_routes -->|"provides auth"| node_auth
node_routes -->|"routes users"| node_userpages
node_routes -->|"routes users"| node_raise
node_routes -->|"routes users"| node_usercomplaints
node_routes -->|"routes admins"| node_adminhome
node_routes -->|"routes admins"| node_admincomplaints
node_routes -->|"routes admins"| node_workeradmin
node_routes -->|"routes workers"| node_workerpage
node_users -.->|"sign in"| node_auth
node_admins -.->|"sign in"| node_auth
node_workers -.->|"sign in"| node_auth
node_users -.->|"submit complaint"| node_raise
node_users -.->|"track complaints"| node_usercomplaints
node_admins -.->|"manage complaints"| node_admincomplaints
node_workers -.->|"handle tasks"| node_workerpage
node_raise -.->|"classify text"| node_classification
node_admincomplaints -.->|"assign worker"| node_assignment
node_workerpage -->|"uploads evidence"| node_supabase
node_workerpage -->|"notifies user"| node_workeradmin
node_workerpage -.->|"updates tasks"| node_supabase
node_admins -.->|"view operations"| node_adminhome
node_admins -.->|"manage stock"| node_inventory
node_admins -.->|"schedule work"| node_scheduling
node_admins -.->|"manage QR codes"| node_qr
node_admins -.->|"review activity"| node_activity
node_adminhome -.->|"shows analytics"| node_analytics
node_assistant -.->|"requests guidance"| node_chatfunction
node_assistant -->|"uses speech input"| node_voice
node_classification -.->|"uses backend"| node_supabase
node_chatfunction -.->|"uses backend"| node_supabase
node_supabase -.->|"reads and writes"| node_database
node_auth -.->|"authenticates"| node_supabaseauth
node_workeradmin -->|"loads workers"| node_supabase
node_assignment -->|"assigns complaint"| node_supabase

click node_entry "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/main.tsx"
click node_routes "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/App.tsx"
click node_auth "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/contexts/AuthContext.tsx"
click node_userpages "https://github.com/iamarun3/campus-care/tree/main/campus-care-hub-main/src/pages/user"
click node_raise "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/user/RaiseComplaintPage.tsx"
click node_usercomplaints "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/user/UserComplaintsPage.tsx"
click node_admincomplaints "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/AdminComplaintsPage.tsx"
click node_workerpage "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/worker/WorkerDashboard.tsx"
click node_classification "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/supabase/functions/classify-complaint/index.ts"
click node_assignment "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/lib/auto-assign-worker.ts"
click node_adminhome "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/AdminDashboard.tsx"
click node_workeradmin "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/AdminWorkersPage.tsx"
click node_inventory "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/AdminInventoryPage.tsx"
click node_scheduling "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/MaintenanceSchedulerPage.tsx"
click node_qr "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/AdminQRPage.tsx"
click node_activity "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/AdminActivityPage.tsx"
click node_analytics "https://github.com/iamarun3/campus-care/tree/main/campus-care-hub-main/src/components/dashboard"
click node_assistant "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/components/chatbot/FloatingChatbot.tsx"
click node_chatfunction "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/supabase/functions/chat-assistant/index.ts"
click node_voice "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/hooks/useSpeechToText.ts"
click node_supabase "https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/integrations/supabase/client.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_entry,node_routes,node_auth,node_users toneBlue
class node_userpages,node_raise,node_usercomplaints,node_admincomplaints,node_workerpage,node_classification,node_assignment toneAmber
class node_adminhome,node_workeradmin,node_inventory,node_scheduling,node_qr,node_activity toneMint
class node_analytics,node_assistant,node_chatfunction,node_voice,node_workers toneRose
class node_supabase,node_database,node_supabaseauth,node_admins toneIndigo
```

## Components

### Application access

- [React entry](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/main.tsx): `campus-care-hub-main/src/main.tsx`
- [Role-based routes](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/App.tsx): `campus-care-hub-main/src/App.tsx`
- [Authentication](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/contexts/AuthContext.tsx): `campus-care-hub-main/src/contexts/AuthContext.tsx`

### Complaint workflow

- [User dashboards](https://github.com/iamarun3/campus-care/tree/main/campus-care-hub-main/src/pages/user): `campus-care-hub-main/src/pages/user`
- [Complaint submission](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/user/RaiseComplaintPage.tsx): `campus-care-hub-main/src/pages/user/RaiseComplaintPage.tsx`
- [Complaint tracking](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/user/UserComplaintsPage.tsx): `campus-care-hub-main/src/pages/user/UserComplaintsPage.tsx`
- [Complaint operations](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/AdminComplaintsPage.tsx): `campus-care-hub-main/src/pages/admin/AdminComplaintsPage.tsx`
- [Worker task handling](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/worker/WorkerDashboard.tsx): `campus-care-hub-main/src/pages/worker/WorkerDashboard.tsx`
- [Complaint classification](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/supabase/functions/classify-complaint/index.ts): `campus-care-hub-main/supabase/functions/classify-complaint/index.ts`
- [Worker assignment](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/lib/auto-assign-worker.ts): `campus-care-hub-main/src/lib/auto-assign-worker.ts`

### Campus operations

- [Admin dashboard](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/AdminDashboard.tsx): `campus-care-hub-main/src/pages/admin/AdminDashboard.tsx`
- [Worker management](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/AdminWorkersPage.tsx): `campus-care-hub-main/src/pages/admin/AdminWorkersPage.tsx`
- [Inventory management](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/AdminInventoryPage.tsx): `campus-care-hub-main/src/pages/admin/AdminInventoryPage.tsx`
- [Maintenance scheduling](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/MaintenanceSchedulerPage.tsx): `campus-care-hub-main/src/pages/admin/MaintenanceSchedulerPage.tsx`
- [QR entry points](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/AdminQRPage.tsx): `campus-care-hub-main/src/pages/admin/AdminQRPage.tsx`
- [Activity logs](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/pages/admin/AdminActivityPage.tsx): `campus-care-hub-main/src/pages/admin/AdminActivityPage.tsx`

### Analytics and assistance

- [Operational analytics](https://github.com/iamarun3/campus-care/tree/main/campus-care-hub-main/src/components/dashboard): `campus-care-hub-main/src/components/dashboard`
- [AI help assistant](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/components/chatbot/FloatingChatbot.tsx): `campus-care-hub-main/src/components/chatbot/FloatingChatbot.tsx`
- [Assistant service](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/supabase/functions/chat-assistant/index.ts): `campus-care-hub-main/supabase/functions/chat-assistant/index.ts`
- [Voice input](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/hooks/useSpeechToText.ts): `campus-care-hub-main/src/hooks/useSpeechToText.ts`

### Data and services

- [Supabase client](https://github.com/iamarun3/campus-care/blob/main/campus-care-hub-main/src/integrations/supabase/client.ts): `campus-care-hub-main/src/integrations/supabase/client.ts`
- **Supabase database**
- **Supabase Auth**

### Other components

- **Campus users**
- **Administrators**
- **Maintenance workers**

## Connections

- React entry → Role-based routes: renders (evidence: `campus-care-hub-main/src/main.tsx`)
- Role-based routes → Authentication: provides auth (evidence: `campus-care-hub-main/src/App.tsx`)
- Role-based routes → User dashboards: routes users (evidence: `campus-care-hub-main/src/App.tsx`)
- Role-based routes → Complaint submission: routes users (evidence: `campus-care-hub-main/src/App.tsx`)
- Role-based routes → Complaint tracking: routes users (evidence: `campus-care-hub-main/src/App.tsx`)
- Role-based routes → Admin dashboard: routes admins (evidence: `campus-care-hub-main/src/App.tsx`)
- Role-based routes → Complaint operations: routes admins (evidence: `campus-care-hub-main/src/App.tsx`)
- Role-based routes → Worker management: routes admins (evidence: `campus-care-hub-main/src/App.tsx`)
- Role-based routes → Worker task handling: routes workers (evidence: `campus-care-hub-main/src/App.tsx`)
- Campus users → Authentication: sign in
- Administrators → Authentication: sign in
- Maintenance workers → Authentication: sign in
- Campus users → Complaint submission: submit complaint
- Campus users → Complaint tracking: track complaints
- Administrators → Complaint operations: manage complaints
- Maintenance workers → Worker task handling: handle tasks
- Complaint submission → Complaint classification: classify text
- Complaint operations → Worker assignment: assign worker (evidence: `campus-care-hub-main/src/lib/auto-assign-worker.ts`)
- Worker task handling → Supabase client: uploads evidence (evidence: `campus-care-hub-main/src/pages/worker/WorkerDashboard.tsx`)
- Worker task handling → Worker management: notifies user (evidence: `campus-care-hub-main/src/pages/worker/WorkerDashboard.tsx`)
- Worker task handling → Supabase client: updates tasks
- Administrators → Admin dashboard: view operations
- Administrators → Inventory management: manage stock
- Administrators → Maintenance scheduling: schedule work
- Administrators → QR entry points: manage QR codes
- Administrators → Activity logs: review activity
- Admin dashboard → Operational analytics: shows analytics
- AI help assistant → Assistant service: requests guidance
- AI help assistant → Voice input: uses speech input (evidence: `campus-care-hub-main/src/components/chatbot/FloatingChatbot.tsx`)
- Complaint classification → Supabase client: uses backend
- Assistant service → Supabase client: uses backend
- Supabase client → Supabase database: reads and writes
- Authentication → Supabase Auth: authenticates
- Worker management → Supabase client: loads workers
- Worker assignment → Supabase client: assigns complaint (evidence: `campus-care-hub-main/src/lib/auto-assign-worker.ts`)
