# abhinavkumar-07/crimeai architecture

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

- Interactive diagram: https://gitdiagram.com/abhinavkumar-07/crimeai
- Repository: https://github.com/abhinavkumar-07/crimeai

## Overview

CrimeAI is a law-enforcement analytics platform. Officers use the React application to review crime intelligence and alerts, while police and analysts can process FIRs, optimize patrols, and run intervention simulations. Requests enter the FastAPI API and are handled by domain services, repositories, and analytical modules; background Celery tasks support longer-running work. The README documents the product capabilities and technology, and excerpts establish selected service, worker, and routing relationships; links for unsampled feature implementations are omitted where their wiring is not shown.

Main entry points: [`crimeai/backend/app/api/v1/endpoints`](https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/backend/app/api/v1/endpoints) (Versioned API endpoints), [`crimeai/frontend/src/App.tsx`](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/frontend/src/App.tsx) (React application), [`crimeai/backend/app/services/ml_service.py`](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/services/ml_service.py) (ML orchestration), [`crimeai/backend/app/repositories/crime_repository.py`](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/repositories/crime_repository.py) (Crime repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Officer application"]
  node_webapp["React application<br/>[App.tsx]"]
  node_crimepages["Crime and dashboard pages"]
  node_featurepages["FIR, patrol, simulation"]
  node_alertpage["Alerts page<br/>[AlertsPage.tsx]"]
  node_clients["Frontend API clients"]
end

subgraph group_api["API and domain services"]
  node_apiapp["FastAPI application<br/>[main.py]"]
  node_endpoints["Versioned API endpoints"]
  node_auth["Authentication and access<br/>[auth.py]"]
  node_crime_service["Crime service<br/>[crime_service.py]"]
  node_repo["Crime repository"]
  node_websocket["WebSocket endpoints<br/>[websockets.py]"]
end

subgraph group_analysis["Intelligence analysis"]
  node_mlservice["ML orchestration<br/>[ml_service.py]"]
  node_mlmodules["Prediction and similarity"]
  node_graphservice["Graph service<br/>[graph_service.py]"]
  node_graphmodules["Route and simulation algorithms"]
  node_nlpservice["NLP service and FIR pipeline<br/>[nlp_service.py]"]
  node_nlpmodules["FIR parsing and extraction"]
end

subgraph group_platform["Persistence and tasks"]
  node_database[("PostgreSQL and PostGIS<br/>[database.py]")]
  node_redis[("Redis cache and broker<br/>[redis.py]")]
  node_workers["Celery task workers"]
  node_alerts["Alert processing<br/>[alert_tasks.py]"]
end

node_officer(("Officer or analyst"))

node_officer -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_crimepages
node_webapp -->|"routes to"| node_featurepages
node_webapp -->|"routes to"| node_alertpage
node_webapp -.->|"requests data"| node_clients
node_clients -.->|"calls API"| node_endpoints
node_apiapp -->|"mounts routes"| node_endpoints
node_endpoints -.->|"handles crime requests"| node_crime_service
node_endpoints -.->|"authenticates"| node_auth
node_crime_service -->|"queries and updates"| node_repo
node_repo -.->|"reads and writes"| node_database
node_endpoints -.->|"requests analysis"| node_mlservice
node_mlservice -->|"delegates analysis"| node_mlmodules
node_mlservice -->|"loads and updates crimes"| node_repo
node_mlservice -->|"caches results"| node_redis
node_endpoints -.->|"requests graph analysis"| node_graphservice
node_graphservice -->|"invokes algorithms"| node_graphmodules
node_graphservice -->|"loads crime data"| node_repo
node_endpoints -.->|"requests FIR processing"| node_nlpservice
node_nlpservice -.->|"processes FIR text"| node_nlpmodules
node_workers -->|"runs ML tasks"| node_mlservice
node_workers -.->|"dispatches alert tasks"| node_alerts
node_alerts -.->|"uses cache or broker"| node_redis
node_webapp -.->|"receives live updates"| node_websocket

click node_webapp "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/frontend/src/App.tsx"
click node_crimepages "https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/frontend/src/pages"
click node_featurepages "https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/frontend/src/pages"
click node_alertpage "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/frontend/src/pages/alerts/AlertsPage.tsx"
click node_clients "https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/frontend/src/services"
click node_apiapp "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/main.py"
click node_endpoints "https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/backend/app/api/v1/endpoints"
click node_auth "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/api/v1/endpoints/auth.py"
click node_crime_service "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/services/crime_service.py"
click node_repo "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/repositories/crime_repository.py"
click node_mlservice "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/services/ml_service.py"
click node_mlmodules "https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/backend/app/ml"
click node_graphservice "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/services/graph_service.py"
click node_graphmodules "https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/backend/app/graph/algorithms"
click node_nlpservice "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/services/nlp_service.py"
click node_nlpmodules "https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/backend/app/nlp/parsers"
click node_database "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/db/database.py"
click node_redis "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/db/redis.py"
click node_workers "https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/backend/app/workers/tasks"
click node_alerts "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/workers/tasks/alert_tasks.py"
click node_websocket "https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/api/v1/endpoints/websockets.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_webapp,node_crimepages,node_featurepages,node_alertpage,node_clients toneBlue
class node_apiapp,node_endpoints,node_auth,node_crime_service,node_repo,node_websocket toneAmber
class node_mlservice,node_mlmodules,node_graphservice,node_graphmodules,node_nlpservice,node_nlpmodules toneMint
class node_database,node_redis,node_workers,node_alerts toneRose
class node_officer toneIndigo
```

## Components

### Officer application

- [React application](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/frontend/src/App.tsx): `crimeai/frontend/src/App.tsx`
- [Crime and dashboard pages](https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/frontend/src/pages): `crimeai/frontend/src/pages`
- [FIR, patrol, simulation](https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/frontend/src/pages): `crimeai/frontend/src/pages`
- [Alerts page](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/frontend/src/pages/alerts/AlertsPage.tsx): `crimeai/frontend/src/pages/alerts/AlertsPage.tsx`
- [Frontend API clients](https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/frontend/src/services): `crimeai/frontend/src/services`

### API and domain services

- [FastAPI application](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/main.py): `crimeai/backend/app/main.py`
- [Versioned API endpoints](https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/backend/app/api/v1/endpoints): `crimeai/backend/app/api/v1/endpoints`
- [Authentication and access](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/api/v1/endpoints/auth.py): `crimeai/backend/app/api/v1/endpoints/auth.py`
- [Crime service](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/services/crime_service.py): `crimeai/backend/app/services/crime_service.py`
- [Crime repository](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/repositories/crime_repository.py): `crimeai/backend/app/repositories/crime_repository.py`
- [WebSocket endpoints](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/api/v1/endpoints/websockets.py): `crimeai/backend/app/api/v1/endpoints/websockets.py`

### Intelligence analysis

- [ML orchestration](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/services/ml_service.py): `crimeai/backend/app/services/ml_service.py`
- [Prediction and similarity](https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/backend/app/ml): `crimeai/backend/app/ml`
- [Graph service](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/services/graph_service.py): `crimeai/backend/app/services/graph_service.py`
- [Route and simulation algorithms](https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/backend/app/graph/algorithms): `crimeai/backend/app/graph/algorithms`
- [NLP service and FIR pipeline](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/services/nlp_service.py): `crimeai/backend/app/services/nlp_service.py`
- [FIR parsing and extraction](https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/backend/app/nlp/parsers): `crimeai/backend/app/nlp/parsers`

### Persistence and tasks

- [PostgreSQL and PostGIS](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/db/database.py): `crimeai/backend/app/db/database.py`
- [Redis cache and broker](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/db/redis.py): `crimeai/backend/app/db/redis.py`
- [Celery task workers](https://github.com/abhinavkumar-07/crimeai/tree/main/crimeai/backend/app/workers/tasks): `crimeai/backend/app/workers/tasks`
- [Alert processing](https://github.com/abhinavkumar-07/crimeai/blob/main/crimeai/backend/app/workers/tasks/alert_tasks.py): `crimeai/backend/app/workers/tasks/alert_tasks.py`

### Other components

- **Officer or analyst**

## Connections

- Officer or analyst → React application: uses
- React application → Crime and dashboard pages: routes to (evidence: `crimeai/frontend/src/App.tsx`)
- React application → FIR, patrol, simulation: routes to (evidence: `crimeai/frontend/src/App.tsx`)
- React application → Alerts page: routes to (evidence: `crimeai/frontend/src/App.tsx`)
- React application → Frontend API clients: requests data
- Frontend API clients → Versioned API endpoints: calls API
- FastAPI application → Versioned API endpoints: mounts routes
- Versioned API endpoints → Crime service: handles crime requests
- Versioned API endpoints → Authentication and access: authenticates
- Crime service → Crime repository: queries and updates (evidence: `crimeai/backend/app/services/crime_service.py`)
- Crime repository → PostgreSQL and PostGIS: reads and writes
- Versioned API endpoints → ML orchestration: requests analysis
- ML orchestration → Prediction and similarity: delegates analysis (evidence: `crimeai/backend/app/services/ml_service.py`)
- ML orchestration → Crime repository: loads and updates crimes (evidence: `crimeai/backend/app/services/ml_service.py`)
- ML orchestration → Redis cache and broker: caches results (evidence: `crimeai/backend/app/services/ml_service.py`)
- Versioned API endpoints → Graph service: requests graph analysis
- Graph service → Route and simulation algorithms: invokes algorithms (evidence: `crimeai/backend/app/services/graph_service.py`)
- Graph service → Crime repository: loads crime data (evidence: `crimeai/backend/app/services/graph_service.py`)
- Versioned API endpoints → NLP service and FIR pipeline: requests FIR processing
- NLP service and FIR pipeline → FIR parsing and extraction: processes FIR text
- Celery task workers → ML orchestration: runs ML tasks (evidence: `crimeai/backend/app/workers/tasks/ml_tasks.py`)
- Celery task workers → Alert processing: dispatches alert tasks
- Alert processing → Redis cache and broker: uses cache or broker (evidence: `crimeai/backend/app/workers/tasks/alert_tasks.py`)
- React application → WebSocket endpoints: receives live updates
