How isuyildiz/forensicchain works
ForensicChain manages evidence from role-gated upload through cryptographic proof, custody tracking, ledger review, and verifiable PDF reporting. The graph combines documented service workflows with UI routing shown in App.tsx. Several service internals and UI API modules were not excerpted, so their documented capabilities are represented without speculative implementation-level links; the gateway is omitted because it is not present in the supplied file tree.
Main entry points: App.tsx Route application · reports.py Audit reporter · evidence.py Evidence collector · LoginPage.tsx Login page
Components 25
Forensic UI
- Route application
forensic-ui/src/App.tsx - Login page
forensic-ui/src/pages/LoginPage.tsx - Artifact pages
forensic-ui/src/pages/ArtifactDetailPage.tsx - Evidence upload
forensic-ui/src/pages/ArtifactUploadPage.tsx - Ledger view
forensic-ui/src/pages/LedgerPage.tsx - Report view
forensic-ui/src/pages/ReportPage.tsx - Admin console
forensic-ui/src/pages/AdminPage.tsx - Token & role state
forensic-ui/src/hooks/useAuth.ts
Identity & Cases
- Authentication service
services/auth-service/routers/auth.py - JWT and RBAC
services/auth-service/routers/internal.py - Users & cases
services/auth-service/routers/admin.py
Evidence Integrity
- Evidence collector
services/evidence-collector/routers/evidence.py - Hash & sign gRPC
services/hash-sign/servicer.py - Hash & signature
services/hash-sign/crypto/hasher.py
Custody Events
- RabbitMQ events
- Custody consumer
services/chain-of-custody/consumer.py - Custody event chain
services/chain-of-custody/chain/custody_chain.py - Custody timeline API
services/chain-of-custody/routers/custody.py
Ledger & Reporting
- Immutable ledger
services/immutable-ledger/servicer.py - Ledger hash chain
services/immutable-ledger/chain/hash_chain.py - Audit reporter
services/audit-reporter/routers/reports.py - PDF generator
services/audit-reporter/report_generator.py - Report records
services/audit-reporter/db/models.py - Ledger REST API
services/immutable-ledger/main.py
Other components
- Forensic user
Connections 30
- Forensic user → Route application: uses
README.md - Route application → Login page: routes to
forensic-ui/src/App.tsx - Route application → Evidence upload: routes to
forensic-ui/src/App.tsx - Route application → Artifact pages: routes to
forensic-ui/src/App.tsx - Route application → Ledger view: routes to
forensic-ui/src/App.tsx - Route application → Report view: routes to
forensic-ui/src/App.tsx - Route application → Admin console: routes to
forensic-ui/src/App.tsx - Login page → Token & role state: stores token
- Login page → Authentication service: logs in
- Authentication service → JWT and RBAC: issues JWT
README.md - JWT and RBAC → Users & cases: checks assignments
- Admin console → Users & cases: manages users & cases
- Evidence upload → Evidence collector: uploads evidence
- Evidence collector → Hash & sign gRPC: requests signature
README.md - Hash & sign gRPC → Hash & signature: computes & signs
services/hash-sign/servicer.py - Evidence collector → Immutable ledger: appends proof
README.md - Evidence collector → RabbitMQ events: publishes events
README.md - RabbitMQ events → Custody consumer: delivers events
- Custody consumer → Custody event chain: chains events
- Custody timeline API → Custody event chain: reads timeline
- Immutable ledger → Ledger hash chain: chains records
services/immutable-ledger/servicer.py - Audit reporter → Evidence collector: fetches metadata
- Audit reporter → Custody timeline API: fetches timeline
README.md - Audit reporter → Ledger REST API: fetches proof
README.md - Audit reporter → PDF generator: renders PDF
README.md - Audit reporter → Report records: stores report
README.md - Audit reporter → Immutable ledger: anchors report hash
README.md - Ledger view → Ledger REST API: views chain
- Artifact pages → Custody timeline API: views timeline
- Report view → Audit reporter: requests report