# harshparmar2004/void-hack-hackathon-36h architecture

> Architecture diagram of the GitHub repository harshparmar2004/void-hack-hackathon-36h, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harshparmar2004/void-hack-hackathon-36h
- Repository: https://github.com/harshparmar2004/void-hack-hackathon-36h

## Overview

Abhedya-Chakra is a cyber-forensics platform for tracing suspected fraud proceeds through mule-account networks and supporting investigators with case records and legal documents. The main workflow is statement intake, account and transaction analysis, multi-hop victim tracing, then evidence-backed freeze notices and case diaries. The React interface uses a FastAPI gateway; the forensic engine and legal-document layer provide the core domain processing. The README documents capabilities beyond the sampled excerpts; those branches are shown where documented, while uncertain implementation links are omitted or marked unverified.

Main entry points: [`api/main.py`](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/main.py) (FastAPI gateway), [`api/services/legal.py`](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/services/legal.py) (Legal document service), [`ui/src/App.jsx`](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/ui/src/App.jsx) (Investigation workspace), [`legal/evidence.py`](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/legal/evidence.py) (Evidence assembly)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Investigator interface"]
  node_app["Investigation workspace<br/>[App.jsx]"]
  node_intake_ui["Evidence intake<br/>[CaseIntakeView.jsx]"]
  node_trace_ui["Trail and network views"]
  node_notice_ui["Freeze notice view"]
  node_ui_api["API client<br/>[api.js]"]
end

subgraph group_gateway["API services"]
  node_gateway_app["FastAPI gateway<br/>[main.py]"]
  node_api_deps["Database and profile access<br/>[deps.py]"]
  node_upload_service["Statement upload<br/>[upload.py]"]
  node_trace_service["Trace response mapping<br/>[trace.py]"]
  node_case_service["Case register and vault<br/>[cases.py]"]
  node_legal_service["Legal document service<br/>[legal.py]"]
end

subgraph group_forensics["Forensic analysis"]
  node_ingest["Statement ingestion<br/>[ingest.py]"]
  node_features["Behavioral features<br/>[features.py]"]
  node_scoring["Mule and trust scoring<br/>[scoring.py]"]
  node_links["Inter-layer links<br/>[links.py]"]
  node_rings["Syndicate rings<br/>[rings.py]"]
  node_graph[("Graph storage<br/>[graph.py]")]
  node_victim_trace["Victim trace engine<br/>[victim_trace.py]"]
end

subgraph group_casework["Cases and legal evidence"]
  node_case_store[("Case event store<br/>[case_store.py]")]
  node_evidence["Evidence assembly<br/>[evidence.py]"]
  node_notices["Statutory notices<br/>[notices.py]"]
  node_diary["Judicial case diary<br/>[diary.py]"]
  node_fir["FIR documents<br/>[fir.py]"]
end

subgraph group_support["Analysis support"]
  node_auditor["Audit analysis tools<br/>[tools.py]"]
end

node_investigator(("Investigator"))

node_investigator -->|"uses"| node_app
node_app -->|"presents"| node_intake_ui
node_app -->|"presents"| node_trace_ui
node_app -->|"presents"| node_notice_ui
node_intake_ui -.->|"submits evidence"| node_ui_api
node_trace_ui -.->|"requests trace"| node_ui_api
node_notice_ui -.->|"requests notices"| node_ui_api
node_ui_api -.->|"calls API"| node_gateway_app
node_gateway_app -->|"routes upload"| node_upload_service
node_gateway_app -->|"routes trace"| node_trace_service
node_gateway_app -->|"routes cases"| node_case_service
node_gateway_app -->|"routes legal"| node_legal_service
node_api_deps -->|"provides request dependencies"| node_gateway_app
node_upload_service -.->|"parses statements"| node_ingest
node_ingest -->|"feeds analysis"| node_features
node_features -->|"provides metrics"| node_scoring
node_scoring -->|"scores accounts"| node_links
node_links -->|"supports role assignment"| node_scoring
node_scoring -->|"identifies cells"| node_rings
node_rings -->|"builds graph buffers"| node_graph
node_graph -->|"serves graph traversal"| node_victim_trace
node_trace_service -->|"calls trace engine"| node_victim_trace
node_case_service -->|"records case data"| node_case_store
node_legal_service -->|"assembles evidence"| node_evidence
node_evidence -->|"retrieves victim trace"| node_victim_trace
node_legal_service -->|"generates notices"| node_notices
node_legal_service -->|"generates diary"| node_diary
node_legal_service -->|"generates FIR"| node_fir
node_evidence -->|"supplies evidence"| node_notices
node_evidence -->|"supplies evidence"| node_diary

click node_app "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/ui/src/App.jsx"
click node_intake_ui "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/ui/src/components/CaseIntakeView.jsx"
click node_trace_ui "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/ui/src/components/EndpointTrailView.jsx"
click node_notice_ui "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/ui/src/components/Section91NoticesView.jsx"
click node_ui_api "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/ui/src/api.js"
click node_gateway_app "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/main.py"
click node_api_deps "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/deps.py"
click node_upload_service "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/services/upload.py"
click node_trace_service "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/services/trace.py"
click node_case_service "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/services/cases.py"
click node_legal_service "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/services/legal.py"
click node_ingest "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/ingest.py"
click node_features "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/features.py"
click node_scoring "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/scoring.py"
click node_links "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/links.py"
click node_rings "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/rings.py"
click node_graph "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/graph.py"
click node_victim_trace "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/victim_trace.py"
click node_case_store "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/case_store.py"
click node_evidence "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/legal/evidence.py"
click node_notices "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/legal/notices.py"
click node_diary "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/legal/diary.py"
click node_fir "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/legal/fir.py"
click node_auditor "https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/auditor/tools.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_intake_ui,node_trace_ui,node_notice_ui,node_ui_api toneBlue
class node_gateway_app,node_api_deps,node_upload_service,node_trace_service,node_case_service,node_legal_service toneAmber
class node_ingest,node_features,node_scoring,node_links,node_rings,node_graph,node_victim_trace toneMint
class node_case_store,node_evidence,node_notices,node_diary,node_fir toneRose
class node_auditor,node_investigator toneIndigo
```

## Components

### Investigator interface

- [Investigation workspace](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/ui/src/App.jsx): `ui/src/App.jsx`
- [Evidence intake](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/ui/src/components/CaseIntakeView.jsx): `ui/src/components/CaseIntakeView.jsx`
- [Trail and network views](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/ui/src/components/EndpointTrailView.jsx): `ui/src/components/EndpointTrailView.jsx`
- [Freeze notice view](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/ui/src/components/Section91NoticesView.jsx): `ui/src/components/Section91NoticesView.jsx`
- [API client](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/ui/src/api.js): `ui/src/api.js`

### API services

- [FastAPI gateway](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/main.py): `api/main.py`
- [Database and profile access](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/deps.py): `api/deps.py`
- [Statement upload](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/services/upload.py): `api/services/upload.py`
- [Trace response mapping](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/services/trace.py): `api/services/trace.py`
- [Case register and vault](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/services/cases.py): `api/services/cases.py`
- [Legal document service](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/api/services/legal.py): `api/services/legal.py`

### Forensic analysis

- [Statement ingestion](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/ingest.py): `engine/ingest.py`
- [Behavioral features](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/features.py): `engine/features.py`
- [Mule and trust scoring](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/scoring.py): `engine/scoring.py`
- [Inter-layer links](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/links.py): `engine/links.py`
- [Syndicate rings](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/rings.py): `engine/rings.py`
- [Graph storage](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/graph.py): `engine/graph.py`
- [Victim trace engine](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/victim_trace.py): `engine/victim_trace.py`

### Cases and legal evidence

- [Case event store](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/engine/case_store.py): `engine/case_store.py`
- [Evidence assembly](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/legal/evidence.py): `legal/evidence.py`
- [Statutory notices](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/legal/notices.py): `legal/notices.py`
- [Judicial case diary](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/legal/diary.py): `legal/diary.py`
- [FIR documents](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/legal/fir.py): `legal/fir.py`

### Analysis support

- [Audit analysis tools](https://github.com/harshparmar2004/void-hack-hackathon-36h/blob/main/auditor/tools.py): `auditor/tools.py`

### Other components

- **Investigator**

## Connections

- Investigator → Investigation workspace: uses (evidence: `README.md`)
- Investigation workspace → Evidence intake: presents (evidence: `ui/src/App.jsx`)
- Investigation workspace → Trail and network views: presents (evidence: `ui/src/App.jsx`)
- Investigation workspace → Freeze notice view: presents (evidence: `ui/src/App.jsx`)
- Evidence intake → API client: submits evidence
- Trail and network views → API client: requests trace
- Freeze notice view → API client: requests notices
- API client → FastAPI gateway: calls API
- FastAPI gateway → Statement upload: routes upload (evidence: `api/main.py`)
- FastAPI gateway → Trace response mapping: routes trace (evidence: `api/main.py`)
- FastAPI gateway → Case register and vault: routes cases (evidence: `api/main.py`)
- FastAPI gateway → Legal document service: routes legal (evidence: `api/main.py`)
- Database and profile access → FastAPI gateway: provides request dependencies (evidence: `api/deps.py`)
- Statement upload → Statement ingestion: parses statements
- Statement ingestion → Behavioral features: feeds analysis (evidence: `README.md`)
- Behavioral features → Mule and trust scoring: provides metrics (evidence: `README.md`)
- Mule and trust scoring → Inter-layer links: scores accounts (evidence: `README.md`)
- Inter-layer links → Mule and trust scoring: supports role assignment (evidence: `README.md`)
- Mule and trust scoring → Syndicate rings: identifies cells (evidence: `README.md`)
- Syndicate rings → Graph storage: builds graph buffers (evidence: `README.md`)
- Graph storage → Victim trace engine: serves graph traversal (evidence: `engine/victim_trace.py`)
- Trace response mapping → Victim trace engine: calls trace engine (evidence: `api/services/trace.py`)
- Case register and vault → Case event store: records case data (evidence: `api/services/cases.py`)
- Legal document service → Evidence assembly: assembles evidence (evidence: `api/services/legal.py`)
- Evidence assembly → Victim trace engine: retrieves victim trace (evidence: `legal/evidence.py`)
- Legal document service → Statutory notices: generates notices (evidence: `api/services/legal.py`)
- Legal document service → Judicial case diary: generates diary (evidence: `api/services/legal.py`)
- Legal document service → FIR documents: generates FIR (evidence: `api/services/legal.py`)
- Evidence assembly → Statutory notices: supplies evidence (evidence: `legal/notices.py`)
- Evidence assembly → Judicial case diary: supplies evidence (evidence: `legal/diary.py`)
