# imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system... architecture

> Architecture diagram of the GitHub repository imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system..., 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/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system...
- Repository: https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system...

## Overview

This is a synthetic-data criminal-network investigation prototype. Investigators submit FIRs and examine linked call and transfer evidence; the backend extracts and resolves identities, builds an evidence graph, computes network and risk measures, and detects alerts. The React dashboard presents people, alerts, stations, maps and live updates, with chat and PDF reports as additional investigation paths. The README documents the main analysis stages; the source excerpts and index support the named internal modules and selected call relationships. Some unsampled route wiring is therefore left unasserted.

Main entry points: [`backend/main.py`](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/main.py) (Backend API), [`frontend/src/App.jsx`](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/App.jsx) (Dashboard app), [`backend/analysis.py`](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/analysis.py) (Analysis orchestration), [`backend/graph.py`](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/graph.py) (Evidence graph)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Evidence analysis"]
  node_ingest["Data ingestion<br/>[ingest.py]"]
  node_extract["FIR extraction<br/>[extract.py]"]
  node_resolve["Identity resolution<br/>[resolve.py]"]
  node_analysis_orchestrator["Analysis orchestration<br/>[analysis.py]"]
  node_graph["Evidence graph<br/>[graph.py]"]
  node_patterns["Alert detection<br/>[patterns.py]"]
  node_risk["Risk scoring<br/>[risk.py]"]
end

subgraph group_services["Investigation services"]
  node_api_server["Backend API<br/>[main.py]"]
  node_chat["Investigator chat<br/>[chat.py]"]
  node_llm["Optional language model<br/>[llm.py]"]
  node_geoapi["Map and station API<br/>[geoapi.py]"]
  node_geospatial["Geospatial services<br/>[geo.py]"]
  node_live["Live case services<br/>[live.py]"]
  node_report["PDF reports<br/>[report.py]"]
end

subgraph group_client["Investigator dashboard"]
  node_webapp["Dashboard app<br/>[App.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_live_hook["Live updates<br/>[useLive.js]"]
end

subgraph group_presentation["Views and guidance"]
  node_graph_view["Network view<br/>[GraphView.jsx]"]
  node_map_view["Map view<br/>[MapView.jsx]"]
  node_pages["Case pages<br/>[Pages.jsx]"]
  node_entity_slip["Entity details<br/>[Slip.jsx]"]
  node_legacy_help["Guide and glossary<br/>[Help.jsx]"]
  node_legacy_components["Legacy UI components<br/>[components.jsx]"]
end

node_investigator(("Investigator"))
node_complaint["FIR records<br/>[fir.json]"]
node_calls["Call records<br/>[cdr.csv]"]
node_transfers["Transfer records<br/>[transactions.csv]"]
node_external_llm["LAN language model"]
node_map_tiles["OpenFreeMap tiles"]

node_investigator -->|"investigates with"| node_webapp
node_complaint -->|"extracts mentions"| node_extract
node_calls -.->|"loads evidence"| node_ingest
node_transfers -.->|"loads evidence"| node_ingest
node_ingest -.->|"supplies data"| node_analysis_orchestrator
node_extract -->|"matches mentions"| node_resolve
node_resolve -->|"links identities"| node_graph
node_analysis_orchestrator -->|"uses extraction"| node_extract
node_analysis_orchestrator -->|"uses matching"| node_resolve
node_analysis_orchestrator -->|"uses ingestion"| node_ingest
node_graph -->|"provides graph"| node_patterns
node_graph -->|"provides metrics"| node_risk
node_api_server -->|"serves analysis"| node_analysis_orchestrator
node_api_server -->|"builds graph"| node_graph
node_api_server -->|"runs detectors"| node_patterns
node_api_server -->|"serves risk"| node_risk
node_api_server -->|"routes questions"| node_chat
node_api_server -->|"serves map routes"| node_geoapi
node_api_server -->|"serves reports"| node_report
node_chat -->|"queries metrics"| node_graph
node_chat -->|"requests wording"| node_llm
node_llm -->|"calls optionally"| node_external_llm
node_geoapi -->|"uses geo services"| node_geospatial
node_geoapi -->|"uses live services"| node_live
node_webapp -->|"loads data"| node_api_client
node_webapp -->|"renders network"| node_graph_view
node_webapp -->|"renders map"| node_map_view
node_webapp -->|"renders pages"| node_pages
node_webapp -->|"renders details"| node_entity_slip
node_webapp -->|"subscribes updates"| node_live_hook
node_api_client -.->|"requests endpoints"| node_api_server
node_live_hook -->|"opens stream URL"| node_api_client
node_map_view -->|"loads map data"| node_api_client
node_map_view -.->|"loads basemap"| node_map_tiles
node_legacy_components -->|"uses help"| node_legacy_help

click node_complaint "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/data/fir.json"
click node_calls "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/data/cdr.csv"
click node_transfers "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/data/transactions.csv"
click node_ingest "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/ingest.py"
click node_extract "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/extract.py"
click node_resolve "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/resolve.py"
click node_analysis_orchestrator "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/analysis.py"
click node_graph "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/graph.py"
click node_patterns "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/patterns.py"
click node_risk "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/risk.py"
click node_api_server "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/main.py"
click node_chat "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/chat.py"
click node_llm "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/llm.py"
click node_geoapi "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/geoapi.py"
click node_geospatial "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/geo.py"
click node_live "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/live.py"
click node_report "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/report.py"
click node_webapp "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/App.jsx"
click node_api_client "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/api.js"
click node_live_hook "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/useLive.js"
click node_graph_view "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/GraphView.jsx"
click node_map_view "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/MapView.jsx"
click node_pages "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/Pages.jsx"
click node_entity_slip "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/Slip.jsx"
click node_legacy_help "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/legacy/Help.jsx"
click node_legacy_components "https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/legacy/components.jsx"

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_ingest,node_extract,node_resolve,node_analysis_orchestrator,node_graph,node_patterns,node_risk toneBlue
class node_api_server,node_chat,node_llm,node_geoapi,node_geospatial,node_live,node_report toneAmber
class node_webapp,node_api_client,node_live_hook toneMint
class node_graph_view,node_map_view,node_pages,node_entity_slip,node_legacy_help,node_legacy_components toneRose
class node_investigator,node_external_llm,node_map_tiles toneIndigo
class node_complaint,node_calls,node_transfers toneTeal
```

## Components

### Evidence analysis

- [Data ingestion](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/ingest.py): `backend/ingest.py`
- [FIR extraction](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/extract.py): `backend/extract.py`
- [Identity resolution](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/resolve.py): `backend/resolve.py`
- [Analysis orchestration](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/analysis.py): `backend/analysis.py`
- [Evidence graph](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/graph.py): `backend/graph.py`
- [Alert detection](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/patterns.py): `backend/patterns.py`
- [Risk scoring](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/risk.py): `backend/risk.py`

### Investigation services

- [Backend API](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/main.py): `backend/main.py`
- [Investigator chat](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/chat.py): `backend/chat.py`
- [Optional language model](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/llm.py): `backend/llm.py`
- [Map and station API](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/geoapi.py): `backend/geoapi.py`
- [Geospatial services](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/geo.py): `backend/geo.py`
- [Live case services](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/live.py): `backend/live.py`
- [PDF reports](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/report.py): `backend/report.py`

### Investigator dashboard

- [Dashboard app](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API client](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/api.js): `frontend/src/api.js`
- [Live updates](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/useLive.js): `frontend/src/useLive.js`

### Views and guidance

- [Network view](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/GraphView.jsx): `frontend/src/GraphView.jsx`
- [Map view](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/MapView.jsx): `frontend/src/MapView.jsx`
- [Case pages](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/Pages.jsx): `frontend/src/Pages.jsx`
- [Entity details](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/Slip.jsx): `frontend/src/Slip.jsx`
- [Guide and glossary](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/legacy/Help.jsx): `frontend/src/legacy/Help.jsx`
- [Legacy UI components](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/frontend/src/legacy/components.jsx): `frontend/src/legacy/components.jsx`

### Other components

- **Investigator**
- [FIR records](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/data/fir.json): `backend/data/fir.json`
- [Call records](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/data/cdr.csv): `backend/data/cdr.csv`
- [Transfer records](https://github.com/imatomic7407/fir-call-directory-log-and-bank-statement-log-monitor-crime-analysing-system.../blob/main/backend/data/transactions.csv): `backend/data/transactions.csv`
- **LAN language model**
- **OpenFreeMap tiles**

## Connections

- Investigator → Dashboard app: investigates with (evidence: `README.md`)
- FIR records → FIR extraction: extracts mentions (evidence: `README.md`)
- Call records → Data ingestion: loads evidence
- Transfer records → Data ingestion: loads evidence
- Data ingestion → Analysis orchestration: supplies data (evidence: `backend/analysis.py`)
- FIR extraction → Identity resolution: matches mentions (evidence: `README.md`)
- Identity resolution → Evidence graph: links identities (evidence: `README.md`)
- Analysis orchestration → FIR extraction: uses extraction (evidence: `backend/analysis.py`)
- Analysis orchestration → Identity resolution: uses matching (evidence: `backend/analysis.py`)
- Analysis orchestration → Data ingestion: uses ingestion (evidence: `backend/analysis.py`)
- Evidence graph → Alert detection: provides graph (evidence: `README.md`)
- Evidence graph → Risk scoring: provides metrics (evidence: `README.md`)
- Backend API → Analysis orchestration: serves analysis (evidence: `backend/main.py`)
- Backend API → Evidence graph: builds graph (evidence: `backend/main.py`)
- Backend API → Alert detection: runs detectors (evidence: `backend/main.py`)
- Backend API → Risk scoring: serves risk (evidence: `backend/main.py`)
- Backend API → Investigator chat: routes questions (evidence: `backend/main.py`)
- Backend API → Map and station API: serves map routes (evidence: `backend/main.py`)
- Backend API → PDF reports: serves reports (evidence: `backend/main.py`)
- Investigator chat → Evidence graph: queries metrics (evidence: `backend/chat.py`)
- Investigator chat → Optional language model: requests wording (evidence: `backend/chat.py`)
- Optional language model → LAN language model: calls optionally (evidence: `backend/llm.py`)
- Map and station API → Geospatial services: uses geo services (evidence: `backend/geoapi.py`)
- Map and station API → Live case services: uses live services (evidence: `backend/geoapi.py`)
- Dashboard app → API client: loads data (evidence: `frontend/src/App.jsx`)
- Dashboard app → Network view: renders network (evidence: `frontend/src/App.jsx`)
- Dashboard app → Map view: renders map (evidence: `frontend/src/App.jsx`)
- Dashboard app → Case pages: renders pages (evidence: `frontend/src/App.jsx`)
- Dashboard app → Entity details: renders details (evidence: `frontend/src/App.jsx`)
- Dashboard app → Live updates: subscribes updates (evidence: `frontend/src/App.jsx`)
- API client → Backend API: requests endpoints
- Live updates → API client: opens stream URL (evidence: `frontend/src/useLive.js`)
- Map view → API client: loads map data (evidence: `frontend/src/MapView.jsx`)
- Map view → OpenFreeMap tiles: loads basemap (evidence: `README.md`)
- Legacy UI components → Guide and glossary: uses help (evidence: `frontend/src/legacy/components.jsx`)
