How kartik-kumar-pandey/truthchain-2.0 works
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: server.py AI Service API · audit_service.py Blockchain Audit · page.tsx Claims Dashboard · agri_graph.py Agriculture Orchestrator
Components 25
Claim Experience
- Claims Dashboard
frontend/src/app/claims/new/page.tsx
Claim API
- Backend API
backend/src/app.ts - Claim Routes
backend/src/routes/claim.routes.ts - Claim Controller
backend/src/controllers/claim.controller.ts - Claim Service
backend/src/services/claim.service.ts - Claims Database
backend/src/database/prisma.ts
Motor Assessment
- AI Service API
ai-services/server.py - Motor Orchestrator
ai-services/graph/motor_graph.py - Text Image Sensor
ai-services/agents/image_agent.py - Cross-modal Fusion
ai-services/agents/cross_modal_agent.py - Risk Scoring
ai-services/agents/risk_engine.py - Adversarial Verification
ai-services/agents/adversarial_verifier.py - Explanation
ai-services/agents/explanation_agent.py - Communication
ai-services/agents/communication_agent.py - Vehicle Vision
ai-services/vision/inference.py
Agriculture Assessment
- Agriculture Orchestrator
ai-services/graph/agri_graph.py - Crop Evidence Agents
ai-services/agriculture/agents - Satellite Scene Search
ai-services/agriculture/satellite/stac_client.py - Satellite Features
ai-services/agriculture/satellite/features.py - Crop Image Inference
ai-services/agriculture/image/inference.py - Claim Decision
ai-services/agriculture/agents/decision_engine.py
Audit Records
- Blockchain Audit
blockchain/audit_service.py - Audit Database
blockchain/db.py - Assessment Registry
blockchain/assessment_registry.py
Other components
- Claimant
Connections 26
- Claimant → Claims Dashboard: files claim
README.md - Claims Dashboard → AI Service API: submits assessment
README.md - Claims Dashboard → Backend API: manages claims
- Backend API → Claim Routes: registers routes
backend/src/app.ts - Claim Routes → Claim Controller: dispatches
backend/src/routes/claim.routes.ts - Claim Controller → Claim Service: calls
backend/src/controllers/claim.controller.ts - Claim Service → Claims Database: reads and writes
backend/src/services/claim.service.ts - AI Service API → Motor Orchestrator: runs workflow
README.md - Motor Orchestrator → Text Image Sensor: fans out
README.md - Text Image Sensor → Cross-modal Fusion: provides reports
README.md - Cross-modal Fusion → Risk Scoring: provides evidence
README.md - Risk Scoring → Adversarial Verification: provides risk
README.md - Adversarial Verification → Explanation: provides verdict
README.md - Explanation → Communication: provides synthesis
README.md - AI Service API → Vehicle Vision: runs inference
ai-services/server.py - AI Service API → Blockchain Audit: requests audit
ai-services/server.py - AI Service API → Agriculture Orchestrator: runs workflow
README.md - Agriculture Orchestrator → Crop Evidence Agents: fans out
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
README.md - Blockchain Audit → Assessment Registry: anchors record
README.md - Blockchain Audit → Audit Database: stores audit data
blockchain/audit_service.py - Blockchain Audit → Claims Database: records assessment
- Claims Database → Claims Dashboard: shows claim results
README.md