# mathlaalw/crimemanagementsystem architecture

> Architecture diagram of the GitHub repository mathlaalw/crimemanagementsystem, 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/mathlaalw/crimemanagementsystem
- Repository: https://github.com/mathlaalw/crimemanagementsystem

## Overview

This is an ASP.NET Core crime-management API for citizens, officers, investigators, and administrators. A citizen can submit and track a crime report; authorized staff can turn reports into cases, assign officers, and manage participants, evidence, and comments. The API also supports user and role administration, citizen alert subscriptions, and community email alerts. The README documents these capabilities and workflows; sampled service and context code confirms some case and evidence persistence, but many controller-to-service and notification implementation details were not inspected.

Main entry points: [`Controllers/CaseController.cs`](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/CaseController.cs) (Case management), [`Servises/NotificationService.cs`](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Servises/NotificationService.cs) (Notifications), [`Controllers/CrimeReportsController.cs`](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/CrimeReportsController.cs) (Crime reports), [`Servises/CaseService.cs`](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Servises/CaseService.cs) (Case service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Reporting and cases"]
  node_reports["Crime reports"]
  node_report_service["Report service"]
  node_cases["Case management<br/>[CaseController.cs]"]
  node_case_service["Case service<br/>[CaseService.cs]"]
end

subgraph group_investigation["Case operations"]
  node_assignments["Officer assignments"]
  node_participants["Case participants"]
  node_evidence["Evidence"]
  node_evidence_service["Evidence service<br/>[EvidenceService.cs]"]
  node_comments["Case comments"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication<br/>[AuthController.cs]"]
  node_users["User administration<br/>[UserController.cs]"]
end

subgraph group_alerts["Citizen alerts"]
  node_subscriptions["Alert subscriptions"]
  node_community_alerts["Community alerts"]
  node_notifications["Notifications"]
  node_citizen_api["Citizen directory API"]
  node_citizen_service["Citizen service<br/>[CitizenService.cs]"]
end

subgraph group_persistence["Persistence"]
  node_citizen_store[("Citizen database")]
  node_crime_store[("Crime database<br/>[CrimeDbContext.cs]")]
end

node_citizen(("Citizen"))
node_staff(("Staff roles"))
node_email{{"Email service"}}

node_citizen -->|"submits reports"| node_reports
node_reports -.->|"handles reports"| node_report_service
node_citizen -->|"tracks status"| node_cases
node_staff -->|"logs in"| node_auth
node_staff -->|"manages cases"| node_cases
node_cases -->|"delegates cases"| node_case_service
node_case_service -->|"reads and writes"| node_crime_store
node_staff -->|"assigns officers"| node_assignments
node_staff -->|"manages participants"| node_participants
node_staff -->|"manages evidence"| node_evidence
node_evidence -->|"delegates evidence"| node_evidence_service
node_evidence_service -->|"reads and writes"| node_crime_store
node_staff -->|"posts comments"| node_comments
node_staff -->|"administers users"| node_users
node_citizen -->|"subscribes to alerts"| node_subscriptions
node_staff -->|"sends broadcasts"| node_community_alerts
node_community_alerts -.->|"sends email"| node_notifications
node_notifications -->|"delivers alerts"| node_email
node_staff -->|"receives report alerts"| node_notifications
node_citizen -.->|"registers details"| node_citizen_api
node_citizen_api -->|"delegates directory"| node_citizen_service
node_citizen_service -.->|"stores citizens"| node_citizen_store

click node_reports "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/CrimeReportsController.cs"
click node_report_service "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Servises/CrimeReportService.cs"
click node_cases "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/CaseController.cs"
click node_case_service "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Servises/CaseService.cs"
click node_assignments "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/CaseAssigneesController.cs"
click node_participants "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/ParticipantsController.cs"
click node_evidence "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/EvidenceController.cs"
click node_evidence_service "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Servises/EvidenceService.cs"
click node_comments "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/CaseCommentsController.cs"
click node_auth "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/AuthController.cs"
click node_users "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/UserController.cs"
click node_subscriptions "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/CitizenSubscriptionsController.cs"
click node_community_alerts "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/AlertsController.cs"
click node_notifications "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Servises/NotificationService.cs"
click node_citizen_api "https://github.com/mathlaalw/crimemanagementsystem/blob/master/CitizenManagementSystem/Controllers/CitizenController.cs"
click node_citizen_service "https://github.com/mathlaalw/crimemanagementsystem/blob/master/CitizenManagementSystem/Services/CitizenService.cs"
click node_citizen_store "https://github.com/mathlaalw/crimemanagementsystem/blob/master/CitizenManagementSystem/Data/CitizenDbContext.cs"
click node_crime_store "https://github.com/mathlaalw/crimemanagementsystem/blob/master/Data/CrimeDbContext.cs"

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_reports,node_report_service,node_cases,node_case_service toneBlue
class node_assignments,node_participants,node_evidence,node_evidence_service,node_comments toneAmber
class node_auth,node_users toneMint
class node_subscriptions,node_community_alerts,node_notifications,node_citizen_api,node_citizen_service toneRose
class node_citizen_store,node_crime_store,node_citizen,node_staff,node_email toneIndigo
```

## Components

### Reporting and cases

- [Crime reports](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/CrimeReportsController.cs): `Controllers/CrimeReportsController.cs`
- [Report service](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Servises/CrimeReportService.cs): `Servises/CrimeReportService.cs`
- [Case management](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/CaseController.cs): `Controllers/CaseController.cs`
- [Case service](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Servises/CaseService.cs): `Servises/CaseService.cs`

### Case operations

- [Officer assignments](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/CaseAssigneesController.cs): `Controllers/CaseAssigneesController.cs`
- [Case participants](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/ParticipantsController.cs): `Controllers/ParticipantsController.cs`
- [Evidence](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/EvidenceController.cs): `Controllers/EvidenceController.cs`
- [Evidence service](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Servises/EvidenceService.cs): `Servises/EvidenceService.cs`
- [Case comments](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/CaseCommentsController.cs): `Controllers/CaseCommentsController.cs`

### Identity and access

- [Authentication](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/AuthController.cs): `Controllers/AuthController.cs`
- [User administration](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/UserController.cs): `Controllers/UserController.cs`

### Citizen alerts

- [Alert subscriptions](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/CitizenSubscriptionsController.cs): `Controllers/CitizenSubscriptionsController.cs`
- [Community alerts](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Controllers/AlertsController.cs): `Controllers/AlertsController.cs`
- [Notifications](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Servises/NotificationService.cs): `Servises/NotificationService.cs`
- [Citizen directory API](https://github.com/mathlaalw/crimemanagementsystem/blob/master/CitizenManagementSystem/Controllers/CitizenController.cs): `CitizenManagementSystem/Controllers/CitizenController.cs`
- [Citizen service](https://github.com/mathlaalw/crimemanagementsystem/blob/master/CitizenManagementSystem/Services/CitizenService.cs): `CitizenManagementSystem/Services/CitizenService.cs`

### Persistence

- [Citizen database](https://github.com/mathlaalw/crimemanagementsystem/blob/master/CitizenManagementSystem/Data/CitizenDbContext.cs): `CitizenManagementSystem/Data/CitizenDbContext.cs`
- [Crime database](https://github.com/mathlaalw/crimemanagementsystem/blob/master/Data/CrimeDbContext.cs): `Data/CrimeDbContext.cs`

### Other components

- **Citizen**
- **Staff roles**
- **Email service**

## Connections

- Citizen → Crime reports: submits reports (evidence: `README.md`)
- Crime reports → Report service: handles reports
- Citizen → Case management: tracks status (evidence: `README.md`)
- Staff roles → Authentication: logs in (evidence: `README.md`)
- Staff roles → Case management: manages cases (evidence: `README.md`)
- Case management → Case service: delegates cases (evidence: `Controllers/CaseController.cs`)
- Case service → Crime database: reads and writes (evidence: `Servises/CaseService.cs`)
- Staff roles → Officer assignments: assigns officers (evidence: `README.md`)
- Staff roles → Case participants: manages participants (evidence: `README.md`)
- Staff roles → Evidence: manages evidence (evidence: `README.md`)
- Evidence → Evidence service: delegates evidence (evidence: `Controllers/EvidenceController.cs`)
- Evidence service → Crime database: reads and writes (evidence: `Servises/EvidenceService.cs`)
- Staff roles → Case comments: posts comments (evidence: `README.md`)
- Staff roles → User administration: administers users (evidence: `README.md`)
- Citizen → Alert subscriptions: subscribes to alerts (evidence: `README.md`)
- Staff roles → Community alerts: sends broadcasts (evidence: `README.md`)
- Community alerts → Notifications: sends email
- Notifications → Email service: delivers alerts (evidence: `README.md`)
- Staff roles → Notifications: receives report alerts (evidence: `README.md`)
- Citizen → Citizen directory API: registers details
- Citizen directory API → Citizen service: delegates directory (evidence: `CitizenManagementSystem/Controllers/CitizenController.cs`)
- Citizen service → Citizen database: stores citizens
