How koushikrayapudi97-dotcom/forensicx works
This is a local, authorization-bounded Android forensics dashboard. Investigators create cases, detect an authorized ADB device, perform read-only acquisition or import an existing forensic image, preserve evidence and custody metadata, analyze artifacts, and generate reports. The graph retains the documented analysis, intelligence, malware, adapter, and optional AI branches. Some route-to-service links are supported by the SOURCE INDEX rather than inspected call bodies; unsampled implementation details and uncertain links are omitted.
Main entry points: database.py SQLite persistence · main.py API application · incident_timeline_engine.py Incident timeline · forensic_intelligence_routes.py Forensic intelligence endpoints
Components 27
Investigation interface
- Dashboard
frontend/app.js - API application
backend/main.py - Case management
backend/api/case_routes.py
Device and evidence collection
- Device endpoints
backend/api/device_routes.py - Device management
backend/services/device_manager.py - Read-only ADB
backend/services/adb_manager.py - Mobile intelligence
backend/services/mobile_intelligence.py - Controlled acquisition
backend/services/acquisition_manager.py - Evidence endpoints
backend/api/evidence_routes.py - Authorized image import
backend/services/authorized_importer.py - SHA-256 integrity
backend/services/hashing.py
Forensic analysis
- Artifact analysis endpoints
backend/api/analysis_routes.py - Filesystem, metadata, search, timeline
forensic - Tool adapters
forensic/adapters.py
Intelligence and reporting
- Forensic intelligence endpoints
backend/api/forensic_intelligence_routes.py - Evidence normalization
backend/services/evidence_normalization_engine.py - Evidence correlation
backend/services/evidence_correlation_engine.py - Reliability scoring
backend/services/evidence_reliability_engine.py - Evidence graph
backend/services/evidence_graph_engine.py - Incident timeline
backend/services/incident_timeline_engine.py - Optional AI investigation
backend/services/ai_investigation_service.py - Malware scanning
backend/services/malware_scanner_service.py - PDF reporting
backend/services/report_manager.py
Identity and persistence
- Authentication routes
backend/api/auth_routes.py - Authentication service
backend/services/auth_service.py - SQLite persistence
backend/database/database.py
Other components
- Investigator
Connections 47
- Investigator → Dashboard: uses
README.md - Dashboard → API application: calls API
- API application → Case management: registers routes
backend/main.py - API application → Authentication routes: registers routes
backend/main.py - API application → Device endpoints: registers routes
backend/main.py - API application → Evidence endpoints: registers routes
backend/main.py - API application → Artifact analysis endpoints: registers routes
backend/main.py - API application → Forensic intelligence endpoints: registers routes
backend/main.py - API application → SQLite persistence: initializes
backend/main.py - Authentication routes → Authentication service: delegates to
backend/api/auth_routes.py - Authentication service → SQLite persistence: reads and writes
backend/services/auth_service.py - Case management → SQLite persistence: reads and writes
backend/api/case_routes.py - Device endpoints → Device management: uses
backend/api/device_routes.py - Device endpoints → Mobile intelligence: uses
backend/api/device_routes.py - Device management → Read-only ADB: queries devices
backend/services/device_manager.py - Device management → SQLite persistence: records state
backend/services/device_manager.py - Controlled acquisition → Read-only ADB: runs read-only commands
backend/services/acquisition_manager.py - Controlled acquisition → Mobile intelligence: collects records
backend/services/acquisition_manager.py - Controlled acquisition → SQLite persistence: registers artifacts
backend/services/acquisition_manager.py - Evidence endpoints → SHA-256 integrity: verifies hashes
backend/api/evidence_routes.py - Evidence endpoints → SQLite persistence: persists evidence
backend/api/evidence_routes.py - Evidence endpoints → Authorized image import: imports authorized images
- Artifact analysis endpoints → Filesystem, metadata, search, timeline: uses analysis modules
backend/api/analysis_routes.py - Artifact analysis endpoints → SQLite persistence: loads case evidence
backend/api/analysis_routes.py - Forensic intelligence endpoints → Evidence normalization: runs normalization
backend/api/forensic_intelligence_routes.py - Forensic intelligence endpoints → Evidence correlation: runs correlation
backend/api/forensic_intelligence_routes.py - Forensic intelligence endpoints → Reliability scoring: runs scoring
backend/api/forensic_intelligence_routes.py - Forensic intelligence endpoints → Evidence graph: runs graph
backend/api/forensic_intelligence_routes.py - Forensic intelligence endpoints → Incident timeline: runs timeline
backend/api/forensic_intelligence_routes.py - Evidence normalization → SQLite persistence: reads artifacts
backend/services/evidence_normalization_engine.py - Evidence correlation → Evidence normalization: uses normalized evidence
backend/services/evidence_correlation_engine.py - Evidence correlation → SQLite persistence: stores correlations
backend/services/evidence_correlation_engine.py - Reliability scoring → Evidence correlation: uses correlations
backend/services/evidence_reliability_engine.py - Reliability scoring → SQLite persistence: stores scores
backend/services/evidence_reliability_engine.py - Evidence graph → Evidence correlation: uses correlations
backend/services/evidence_graph_engine.py - Evidence graph → Evidence normalization: uses normalized evidence
backend/services/evidence_graph_engine.py - Evidence graph → SQLite persistence: stores graph
backend/services/evidence_graph_engine.py - Incident timeline → Evidence correlation: uses correlations
backend/services/incident_timeline_engine.py - Incident timeline → Evidence graph: uses graph data
backend/services/incident_timeline_engine.py - Incident timeline → Evidence normalization: uses normalized evidence
backend/services/incident_timeline_engine.py - Incident timeline → Reliability scoring: uses reliability scores
backend/services/incident_timeline_engine.py - Incident timeline → SQLite persistence: stores timeline
backend/services/incident_timeline_engine.py - PDF reporting → Incident timeline: includes timeline
backend/services/report_manager.py - PDF reporting → SQLite persistence: loads report data
backend/services/report_manager.py - Optional AI investigation → SQLite persistence: grounds analysis
- Malware scanning → SQLite persistence: analyzes case evidence
- Tool adapters → Investigator: reports configuration