# kartik-kumar-pandey/truthchain-2.0 architecture

> Architecture diagram of the GitHub repository kartik-kumar-pandey/truthchain-2.0, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kartik-kumar-pandey/truthchain-2.0
- Repository: https://github.com/kartik-kumar-pandey/truthchain-2.0

## Overview

TruthChain evaluates motor and agriculture insurance claims using multimodal evidence, agent consensus, and blockchain audit records. The principal workflow is claim submission, AI assessment, immutable evidence recording, and dashboard review. The README documents the domain workflows and their fan-out stages; sampled source also confirms motor orchestration, vision inference, API claim handling, and blockchain auditing. Agriculture orchestration and several agent internals are unsampled, so their documented capabilities are shown without speculative implementation-level links.

Main entry points: [`ai-services/server.py`](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/server.py) (AI Service API), [`blockchain/audit_service.py`](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/blockchain/audit_service.py) (Blockchain Audit), [`frontend/src/app/claims/new/page.tsx`](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/frontend/src/app/claims/new/page.tsx) (Claims Dashboard), [`ai-services/graph/agri_graph.py`](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/graph/agri_graph.py) (Agriculture Orchestrator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["Claim Experience"]
  node_webapp["Claims Dashboard<br/>[page.tsx]"]
end

subgraph group_backend["Claim API"]
  node_backend_api["Backend API<br/>[app.ts]"]
  node_claim_routes["Claim Routes<br/>[claim.routes.ts]"]
  node_claim_controller["Claim Controller"]
  node_claim_service["Claim Service<br/>[claim.service.ts]"]
  node_claims_db[("Claims Database<br/>[prisma.ts]")]
end

subgraph group_motor["Motor Assessment"]
  node_ai_api["AI Service API<br/>[server.py]"]
  node_motor_graph["Motor Orchestrator<br/>[motor_graph.py]"]
  node_motor_evidence["Text Image Sensor<br/>[image_agent.py]"]
  node_motor_fusion["Cross-modal Fusion"]
  node_motor_risk["Risk Scoring<br/>[risk_engine.py]"]
  node_motor_verifier["Adversarial Verification"]
  node_motor_explanation["Explanation"]
  node_motor_communication["Communication"]
  node_vehicle_vision["Vehicle Vision<br/>[inference.py]"]
end

subgraph group_agriculture["Agriculture Assessment"]
  node_agri_graph["Agriculture Orchestrator<br/>[agri_graph.py]"]
  node_agri_evidence["Crop Evidence Agents"]
  node_satellite_search["Satellite Scene Search<br/>[stac_client.py]"]
  node_satellite_features["Satellite Features<br/>[features.py]"]
  node_crop_vision["Crop Image Inference<br/>[inference.py]"]
  node_agri_decision["Claim Decision<br/>[decision_engine.py]"]
end

subgraph group_audit["Audit Records"]
  node_blockchain_audit["Blockchain Audit<br/>[audit_service.py]"]
  node_blockchain_store[("Audit Database<br/>[db.py]")]
  node_assessment_contract["Assessment Registry"]
end

node_claimant(("Claimant"))

node_claimant -->|"files claim"| node_webapp
node_webapp -->|"submits assessment"| node_ai_api
node_webapp -.->|"manages claims"| node_backend_api
node_backend_api -->|"registers routes"| node_claim_routes
node_claim_routes -->|"dispatches"| node_claim_controller
node_claim_controller -->|"calls"| node_claim_service
node_claim_service -->|"reads and writes"| node_claims_db
node_ai_api -->|"runs workflow"| node_motor_graph
node_motor_graph -->|"fans out"| node_motor_evidence
node_motor_evidence -->|"provides reports"| node_motor_fusion
node_motor_fusion -->|"provides evidence"| node_motor_risk
node_motor_risk -->|"provides risk"| node_motor_verifier
node_motor_verifier -->|"provides verdict"| node_motor_explanation
node_motor_explanation -->|"provides synthesis"| node_motor_communication
node_ai_api -->|"runs inference"| node_vehicle_vision
node_ai_api -->|"requests audit"| node_blockchain_audit
node_ai_api -->|"runs workflow"| node_agri_graph
node_agri_graph -->|"fans out"| node_agri_evidence
node_agri_evidence -.->|"searches scenes"| node_satellite_search
node_satellite_search -.->|"supplies imagery"| node_satellite_features
node_agri_evidence -.->|"analyzes photos"| node_crop_vision
node_agri_graph -->|"produces verdict"| node_agri_decision
node_blockchain_audit -->|"anchors record"| node_assessment_contract
node_blockchain_audit -->|"stores audit data"| node_blockchain_store
node_blockchain_audit -.->|"records assessment"| node_claims_db
node_claims_db -->|"shows claim results"| node_webapp

click node_webapp "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/frontend/src/app/claims/new/page.tsx"
click node_backend_api "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/backend/src/app.ts"
click node_claim_routes "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/backend/src/routes/claim.routes.ts"
click node_claim_controller "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/backend/src/controllers/claim.controller.ts"
click node_claim_service "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/backend/src/services/claim.service.ts"
click node_claims_db "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/backend/src/database/prisma.ts"
click node_ai_api "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/server.py"
click node_motor_graph "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/graph/motor_graph.py"
click node_motor_evidence "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agents/image_agent.py"
click node_motor_fusion "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agents/cross_modal_agent.py"
click node_motor_risk "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agents/risk_engine.py"
click node_motor_verifier "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agents/adversarial_verifier.py"
click node_motor_explanation "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agents/explanation_agent.py"
click node_motor_communication "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agents/communication_agent.py"
click node_vehicle_vision "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/vision/inference.py"
click node_agri_graph "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/graph/agri_graph.py"
click node_agri_evidence "https://github.com/kartik-kumar-pandey/truthchain-2.0/tree/main/ai-services/agriculture/agents"
click node_satellite_search "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agriculture/satellite/stac_client.py"
click node_satellite_features "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agriculture/satellite/features.py"
click node_crop_vision "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agriculture/image/inference.py"
click node_agri_decision "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agriculture/agents/decision_engine.py"
click node_blockchain_audit "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/blockchain/audit_service.py"
click node_blockchain_store "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/blockchain/db.py"
click node_assessment_contract "https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/blockchain/assessment_registry.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 toneBlue
class node_backend_api,node_claim_routes,node_claim_controller,node_claim_service,node_claims_db toneAmber
class node_ai_api,node_motor_graph,node_motor_evidence,node_motor_fusion,node_motor_risk,node_motor_verifier,node_motor_explanation,node_motor_communication,node_vehicle_vision toneMint
class node_agri_graph,node_agri_evidence,node_satellite_search,node_satellite_features,node_crop_vision,node_agri_decision toneRose
class node_blockchain_audit,node_blockchain_store,node_assessment_contract,node_claimant toneIndigo
```

## Components

### Claim Experience

- [Claims Dashboard](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/frontend/src/app/claims/new/page.tsx): `frontend/src/app/claims/new/page.tsx`

### Claim API

- [Backend API](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Claim Routes](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/backend/src/routes/claim.routes.ts): `backend/src/routes/claim.routes.ts`
- [Claim Controller](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/backend/src/controllers/claim.controller.ts): `backend/src/controllers/claim.controller.ts`
- [Claim Service](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/backend/src/services/claim.service.ts): `backend/src/services/claim.service.ts`
- [Claims Database](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/backend/src/database/prisma.ts): `backend/src/database/prisma.ts`

### Motor Assessment

- [AI Service API](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/server.py): `ai-services/server.py`
- [Motor Orchestrator](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/graph/motor_graph.py): `ai-services/graph/motor_graph.py`
- [Text Image Sensor](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agents/image_agent.py): `ai-services/agents/image_agent.py`
- [Cross-modal Fusion](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agents/cross_modal_agent.py): `ai-services/agents/cross_modal_agent.py`
- [Risk Scoring](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agents/risk_engine.py): `ai-services/agents/risk_engine.py`
- [Adversarial Verification](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agents/adversarial_verifier.py): `ai-services/agents/adversarial_verifier.py`
- [Explanation](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agents/explanation_agent.py): `ai-services/agents/explanation_agent.py`
- [Communication](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agents/communication_agent.py): `ai-services/agents/communication_agent.py`
- [Vehicle Vision](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/vision/inference.py): `ai-services/vision/inference.py`

### Agriculture Assessment

- [Agriculture Orchestrator](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/graph/agri_graph.py): `ai-services/graph/agri_graph.py`
- [Crop Evidence Agents](https://github.com/kartik-kumar-pandey/truthchain-2.0/tree/main/ai-services/agriculture/agents): `ai-services/agriculture/agents`
- [Satellite Scene Search](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agriculture/satellite/stac_client.py): `ai-services/agriculture/satellite/stac_client.py`
- [Satellite Features](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agriculture/satellite/features.py): `ai-services/agriculture/satellite/features.py`
- [Crop Image Inference](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agriculture/image/inference.py): `ai-services/agriculture/image/inference.py`
- [Claim Decision](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/ai-services/agriculture/agents/decision_engine.py): `ai-services/agriculture/agents/decision_engine.py`

### Audit Records

- [Blockchain Audit](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/blockchain/audit_service.py): `blockchain/audit_service.py`
- [Audit Database](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/blockchain/db.py): `blockchain/db.py`
- [Assessment Registry](https://github.com/kartik-kumar-pandey/truthchain-2.0/blob/main/blockchain/assessment_registry.py): `blockchain/assessment_registry.py`

### Other components

- **Claimant**

## Connections

- Claimant → Claims Dashboard: files claim (evidence: `README.md`)
- Claims Dashboard → AI Service API: submits assessment (evidence: `README.md`)
- Claims Dashboard → Backend API: manages claims
- Backend API → Claim Routes: registers routes (evidence: `backend/src/app.ts`)
- Claim Routes → Claim Controller: dispatches (evidence: `backend/src/routes/claim.routes.ts`)
- Claim Controller → Claim Service: calls (evidence: `backend/src/controllers/claim.controller.ts`)
- Claim Service → Claims Database: reads and writes (evidence: `backend/src/services/claim.service.ts`)
- AI Service API → Motor Orchestrator: runs workflow (evidence: `README.md`)
- Motor Orchestrator → Text Image Sensor: fans out (evidence: `README.md`)
- Text Image Sensor → Cross-modal Fusion: provides reports (evidence: `README.md`)
- Cross-modal Fusion → Risk Scoring: provides evidence (evidence: `README.md`)
- Risk Scoring → Adversarial Verification: provides risk (evidence: `README.md`)
- Adversarial Verification → Explanation: provides verdict (evidence: `README.md`)
- Explanation → Communication: provides synthesis (evidence: `README.md`)
- AI Service API → Vehicle Vision: runs inference (evidence: `ai-services/server.py`)
- AI Service API → Blockchain Audit: requests audit (evidence: `ai-services/server.py`)
- AI Service API → Agriculture Orchestrator: runs workflow (evidence: `README.md`)
- Agriculture Orchestrator → Crop Evidence Agents: fans out (evidence: `README.md`)
- Crop Evidence Agents → Satellite Scene Search: searches scenes
- Satellite Scene Search → Satellite Features: supplies imagery
- Crop Evidence Agents → Crop Image Inference: analyzes photos
- Agriculture Orchestrator → Claim Decision: produces verdict (evidence: `README.md`)
- Blockchain Audit → Assessment Registry: anchors record (evidence: `README.md`)
- Blockchain Audit → Audit Database: stores audit data (evidence: `blockchain/audit_service.py`)
- Blockchain Audit → Claims Database: records assessment
- Claims Database → Claims Dashboard: shows claim results (evidence: `README.md`)
