# josephamuasi001/camp-sec-system architecture

> Architecture diagram of the GitHub repository josephamuasi001/camp-sec-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/josephamuasi001/camp-sec-system
- Repository: https://github.com/josephamuasi001/camp-sec-system

## Overview

Camp-Sec is a campus security incident reporting and case-management application for students and security staff. Users enter through a React interface, register or log in, and can report incidents, review their own reports, and edit incident details. Security staff have separate account flows, a dashboard, and tools to review cases and change their statuses. The FastAPI backend handles these operations and uses Supabase for persistence. The shown source supports the frontend routing, selected API calls, and backend storage access; other frontend-to-backend links are shown as unverified HTTP interactions.

Main entry points: [`frontend/src/App.jsx`](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/App.jsx) (Application router), [`frontend/src/services/api.js`](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/services/api.js) (HTTP API client), [`frontend/src/pages/Dashboard.jsx`](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/Dashboard.jsx) (Student dashboard), [`frontend/src/pages/SecurityDashboard.jsx`](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/SecurityDashboard.jsx) (Security dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Application router<br/>[App.jsx]"]
  node_navbar["Role navigation<br/>[Navbar.jsx]"]
  node_api["HTTP API client<br/>[api.js]"]
end

subgraph group_student["Student workflows"]
  node_student_auth["Student accounts<br/>[Login.jsx]"]
  node_student_registration["Student registration<br/>[Register.jsx]"]
  node_student_dashboard["Student dashboard<br/>[Dashboard.jsx]"]
  node_incident_card["Incident card<br/>[IncidentCard.jsx]"]
  node_report["Incident reporting<br/>[ReportIncident.jsx]"]
  node_details["Incident details"]
  node_edit["Edit incident<br/>[EditIncident.jsx]"]
end

subgraph group_security["Security workflows"]
  node_security_auth["Security accounts<br/>[AdminLogin.jsx]"]
  node_security_registration["Security registration<br/>[AdminRegister.jsx]"]
  node_security_dashboard["Security dashboard"]
  node_manage["Case management<br/>[ManageIncident.jsx]"]
end

subgraph group_backend["Backend and storage"]
  node_backend_api["Incident and account API<br/>[main.py]"]
  node_database_client["Supabase client<br/>[database.py]"]
  node_supabase[("Supabase data store")]
end

node_user(("Campus users"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_student_auth
node_app -->|"routes to"| node_student_registration
node_app -->|"routes to"| node_student_dashboard
node_app -->|"routes to"| node_report
node_app -->|"routes to"| node_details
node_app -->|"routes to"| node_edit
node_app -->|"routes to"| node_security_auth
node_app -->|"routes to"| node_security_registration
node_app -->|"routes to"| node_security_dashboard
node_app -->|"routes to"| node_manage
node_student_auth -->|"calls"| node_api
node_student_registration -->|"calls"| node_api
node_student_dashboard -->|"loads reports"| node_api
node_student_dashboard -->|"renders"| node_incident_card
node_report -.->|"submits reports"| node_api
node_details -->|"loads and updates"| node_api
node_edit -->|"loads and updates"| node_api
node_security_auth -->|"calls"| node_api
node_security_registration -->|"calls"| node_api
node_security_dashboard -.->|"loads cases"| node_api
node_security_dashboard -->|"renders"| node_incident_card
node_manage -->|"loads and updates status"| node_api
node_api -.->|"sends HTTP requests"| node_backend_api
node_backend_api -->|"imports client"| node_database_client
node_database_client -->|"connects"| node_supabase
node_backend_api -->|"reads and writes"| node_supabase

click node_app "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/App.jsx"
click node_navbar "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/components/Navbar.jsx"
click node_student_auth "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/Login.jsx"
click node_student_registration "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/Register.jsx"
click node_student_dashboard "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/Dashboard.jsx"
click node_incident_card "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/components/IncidentCard.jsx"
click node_report "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/ReportIncident.jsx"
click node_details "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/IncidentDetails.jsx"
click node_edit "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/EditIncident.jsx"
click node_security_auth "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/AdminLogin.jsx"
click node_security_registration "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/AdminRegister.jsx"
click node_security_dashboard "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/SecurityDashboard.jsx"
click node_manage "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/ManageIncident.jsx"
click node_api "https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/services/api.js"
click node_backend_api "https://github.com/josephamuasi001/camp-sec-system/blob/main/backend/app/main.py"
click node_database_client "https://github.com/josephamuasi001/camp-sec-system/blob/main/backend/app/database.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_navbar,node_api,node_user toneBlue
class node_student_auth,node_student_registration,node_student_dashboard,node_incident_card,node_report,node_details,node_edit toneAmber
class node_security_auth,node_security_registration,node_security_dashboard,node_manage toneMint
class node_backend_api,node_database_client,node_supabase toneRose
```

## Components

### Web application

- [Application router](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Role navigation](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/components/Navbar.jsx): `frontend/src/components/Navbar.jsx`
- [HTTP API client](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Student workflows

- [Student accounts](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Student registration](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/Register.jsx): `frontend/src/pages/Register.jsx`
- [Student dashboard](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Incident card](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/components/IncidentCard.jsx): `frontend/src/components/IncidentCard.jsx`
- [Incident reporting](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/ReportIncident.jsx): `frontend/src/pages/ReportIncident.jsx`
- [Incident details](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/IncidentDetails.jsx): `frontend/src/pages/IncidentDetails.jsx`
- [Edit incident](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/EditIncident.jsx): `frontend/src/pages/EditIncident.jsx`

### Security workflows

- [Security accounts](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/AdminLogin.jsx): `frontend/src/pages/AdminLogin.jsx`
- [Security registration](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/AdminRegister.jsx): `frontend/src/pages/AdminRegister.jsx`
- [Security dashboard](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/SecurityDashboard.jsx): `frontend/src/pages/SecurityDashboard.jsx`
- [Case management](https://github.com/josephamuasi001/camp-sec-system/blob/main/frontend/src/pages/ManageIncident.jsx): `frontend/src/pages/ManageIncident.jsx`

### Backend and storage

- [Incident and account API](https://github.com/josephamuasi001/camp-sec-system/blob/main/backend/app/main.py): `backend/app/main.py`
- [Supabase client](https://github.com/josephamuasi001/camp-sec-system/blob/main/backend/app/database.py): `backend/app/database.py`
- **Supabase data store**

### Other components

- **Campus users**

## Connections

- Campus users → Application router: uses
- Application router → Role navigation: renders (evidence: `frontend/src/App.jsx`)
- Application router → Student accounts: routes to (evidence: `frontend/src/App.jsx`)
- Application router → Student registration: routes to (evidence: `frontend/src/App.jsx`)
- Application router → Student dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Application router → Incident reporting: routes to (evidence: `frontend/src/App.jsx`)
- Application router → Incident details: routes to (evidence: `frontend/src/App.jsx`)
- Application router → Edit incident: routes to (evidence: `frontend/src/App.jsx`)
- Application router → Security accounts: routes to (evidence: `frontend/src/App.jsx`)
- Application router → Security registration: routes to (evidence: `frontend/src/App.jsx`)
- Application router → Security dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Application router → Case management: routes to (evidence: `frontend/src/App.jsx`)
- Student accounts → HTTP API client: calls (evidence: `frontend/src/pages/Login.jsx`)
- Student registration → HTTP API client: calls (evidence: `frontend/src/pages/Register.jsx`)
- Student dashboard → HTTP API client: loads reports (evidence: `frontend/src/pages/Dashboard.jsx`)
- Student dashboard → Incident card: renders (evidence: `frontend/src/pages/Dashboard.jsx`)
- Incident reporting → HTTP API client: submits reports (evidence: `frontend/src/pages/ReportIncident.jsx`)
- Incident details → HTTP API client: loads and updates (evidence: `frontend/src/pages/IncidentDetails.jsx`)
- Edit incident → HTTP API client: loads and updates (evidence: `frontend/src/pages/EditIncident.jsx`)
- Security accounts → HTTP API client: calls (evidence: `frontend/src/pages/AdminLogin.jsx`)
- Security registration → HTTP API client: calls (evidence: `frontend/src/pages/AdminRegister.jsx`)
- Security dashboard → HTTP API client: loads cases (evidence: `frontend/src/pages/SecurityDashboard.jsx`)
- Security dashboard → Incident card: renders (evidence: `frontend/src/pages/SecurityDashboard.jsx`)
- Case management → HTTP API client: loads and updates status (evidence: `frontend/src/pages/ManageIncident.jsx`)
- HTTP API client → Incident and account API: sends HTTP requests
- Incident and account API → Supabase client: imports client (evidence: `backend/app/main.py`)
- Supabase client → Supabase data store: connects (evidence: `backend/app/database.py`)
- Incident and account API → Supabase data store: reads and writes (evidence: `backend/app/main.py`)
