How dvcyberspace/truetrail works
TrueTrail is a forensic evidence ingestion API: users submit evidence files, which are identified and parsed into canonical records, reconciled, and stored for API access. Its documented inputs cover UPI, bank statements, CDR, IPDR, and device extractions; outputs include transactions, calls, IP sessions, device artifacts, evidence provenance, rejected rows, and summaries. The excerpts support the ingestion and persistence flow, but do not show a graphing or timeline-reconstruction implementation. Parser-to-helper links follow the SOURCE INDEX; unsampled API behavior is not inferred.
Main entry points: pipeline.py Ingestion pipeline · api.py Ingestion API · base.py Row parsing and dedupe · normalizers.py Field normalizers
Components 17
Evidence ingestion
- Evidence files
- Ingestion pipeline
backend/ingestion/pipeline.py
Parsing and normalization
- Source format rules
backend/ingestion/config.py - UPI parser
backend/ingestion/parsers/upi.py - Bank statement parser
backend/ingestion/parsers/bank_statement.py - CDR parser
backend/ingestion/parsers/cdr.py - IPDR parser
backend/ingestion/parsers/ipdr.py - Device extraction parser
backend/ingestion/parsers/device_forensics.py - Row parsing and dedupe
backend/ingestion/parsers/base.py - Field normalizers
backend/ingestion/normalizers.py
Canonical records
- Canonical data contract
backend/schemas.py - Transaction reconciliation
backend/ingestion/pipeline.py - Parsed evidence records
backend/ingestion/pipeline.py
API and storage
- Ingestion API
backend/api.py - SQLite evidence store
backend/storage.py - Evidence and record APIs
backend/api.py
Other components
- Evidence submitter
Connections 33
- Evidence submitter → Ingestion API: submits files
README.md - Ingestion API → Evidence files: saves uploads
backend/api.py - Ingestion API → Ingestion pipeline: invokes ingestion
backend/api.py - Evidence files → Ingestion pipeline: scans files
README.md - Ingestion pipeline → Source format rules: uses format rules
backend/ingestion/pipeline.py - Ingestion pipeline → UPI parser: dispatches to
backend/ingestion/pipeline.py - Ingestion pipeline → Bank statement parser: dispatches to
backend/ingestion/pipeline.py - Ingestion pipeline → CDR parser: dispatches to
backend/ingestion/pipeline.py - Ingestion pipeline → IPDR parser: dispatches to
backend/ingestion/pipeline.py - Ingestion pipeline → Device extraction parser: dispatches to
backend/ingestion/pipeline.py - UPI parser → Field normalizers: normalizes fields
backend/ingestion/parsers/upi.py - Bank statement parser → Field normalizers: normalizes fields
backend/ingestion/parsers/bank_statement.py - CDR parser → Field normalizers: normalizes fields
backend/ingestion/parsers/cdr.py - IPDR parser → Field normalizers: normalizes fields
backend/ingestion/parsers/ipdr.py - Device extraction parser → Field normalizers: normalizes fields
backend/ingestion/parsers/device_forensics.py - UPI parser → Row parsing and dedupe: consumes rows
backend/ingestion/parsers/upi.py - Bank statement parser → Row parsing and dedupe: consumes rows
backend/ingestion/parsers/bank_statement.py - CDR parser → Row parsing and dedupe: consumes rows
backend/ingestion/parsers/cdr.py - IPDR parser → Row parsing and dedupe: consumes rows
backend/ingestion/parsers/ipdr.py - Device extraction parser → Row parsing and dedupe: consumes rows
backend/ingestion/parsers/device_forensics.py - UPI parser → Canonical data contract: builds records
backend/ingestion/parsers/upi.py - Bank statement parser → Canonical data contract: builds records
backend/ingestion/parsers/bank_statement.py - CDR parser → Canonical data contract: builds records
backend/ingestion/parsers/cdr.py - IPDR parser → Canonical data contract: builds records
backend/ingestion/parsers/ipdr.py - Device extraction parser → Canonical data contract: builds records
backend/ingestion/parsers/device_forensics.py - Ingestion pipeline → Transaction reconciliation: reconciles transactions
backend/ingestion/pipeline.py - Ingestion pipeline → Parsed evidence records: assembles results
backend/ingestion/pipeline.py - Transaction reconciliation → Parsed evidence records: updates transactions
backend/ingestion/pipeline.py - Ingestion API → SQLite evidence store: replaces stored data
backend/api.py - Parsed evidence records → SQLite evidence store: persists results
README.md - Ingestion API → SQLite evidence store: reads records
backend/api.py - Ingestion API → Evidence and record APIs: serves endpoints
backend/api.py - SQLite evidence store → Evidence and record APIs: supplies stored results
backend/api.py