How surya1259f/adfip works
ADFIR is a desktop digital-forensics investigation platform. Investigators create cases and supply evidence; the documented workflow preserves and hashes evidence, plans deterministic tool work, runs specialist analysis, correlates and verifies findings, adds LLM reasoning, and produces a court-ready report for investigator review. The graph follows that documented product flow and highlights the API, persistence, and desktop UI layers. Several service and endpoint implementations were not sampled, so their connections are shown only where the README or inspected references support them.
Main entry points: endpoints Case and evidence API · orchestrator.py Execution orchestrator · registry.py Forensic tool registry · review.py Investigator review
Components 20
Desktop interface
- Desktop app
frontend/src/App.tsx - Investigation views
frontend/src/pages - API client
frontend/src/services/api.ts
API and case data
- API router
backend/app/api/v1/router.py - Case and evidence API
backend/app/api/v1/endpoints - Case database
backend/app/core/database.py - Case records
backend/app/models/models.py
Evidence and forensics
- Evidence acquisition
backend/app/services/acquisition.py - Integrity and custody
backend/app/services/integrity.py - Specialist agents
agents - Forensic tool registry
forensic_tools/registry.py
Analysis and reporting
- Investigation planner
investigation/planner/planner.py - Execution orchestrator
investigation/orchestrator/orchestrator.py - Finding correlation
investigation/correlation/engine.py - Finding verification
investigation/verification/engine.py - LLM reasoning
backend/app/services/ai_reasoning.py - Report generation
investigation/reporting/generator.py
Review and governance
- Investigator review
backend/app/api/v1/endpoints/review.py - Audit service
backend/app/services/audit.py
Other components
- Investigator
Connections 21
- Investigator → Desktop app: uses
README.md - Desktop app → Investigation views: presents
- Investigation views → API client: requests data
frontend/src/pages/InvestigatorReviewPage.tsx - API client → API router: calls API
- API router → Case and evidence API: routes requests
backend/app/api/v1/router.py - Case and evidence API → Case database: accesses data
backend/app/api/v1/endpoints/review.py - Case database → Case records: maps records
backend/app/models/models.py - Case and evidence API → Evidence acquisition: acquires evidence
- Evidence acquisition → Integrity and custody: records integrity
- Integrity and custody → Investigation planner: supplies evidence
README.md - Investigation planner → Execution orchestrator: plans execution
investigation/orchestrator/orchestrator.py - Execution orchestrator → Specialist agents: dispatches tasks
investigation/orchestrator/orchestrator.py - Specialist agents → Forensic tool registry: uses tools
agents/disk/disk_agent.py - Execution orchestrator → Forensic tool registry: resolves tools
investigation/orchestrator/orchestrator.py - Forensic tool registry → Finding correlation: produces tool facts
- Finding correlation → Finding verification: correlates findings
- Finding verification → LLM reasoning: supplies verified facts
README.md - LLM reasoning → Report generation: informs report
README.md - Report generation → Investigator review: presents report
- Investigator → Investigator review: reviews results
backend/app/api/v1/endpoints/review.py - Investigator review → Audit service: records decisions