How swetha-006/cipher-x works
CIPHER-X is a local digital-evidence investigation prototype. Investigators sign in, work within cases, upload evidence, and use the interface to inspect correlated evidence and investigation outputs. The documented evidence workflow spans secure ingestion, parsing and entity extraction, timeline and semantic analysis, graph correlation, conflict detection, authorized retrieval, and explainable responses. The backend excerpt confirms authentication, case access, evidence upload, database operations, and graph construction; the README documents broader capabilities whose implementation is not shown in the excerpts.
Main entry points: main.py API service · main.jsx Investigation UI · app Semantic retrieval
Components 17
Investigator interface
- Investigation UI
frontend/src/main.jsx
Backend and access
- API service
backend/app/main.py - Authentication and RBAC
backend/app/main.py - Case management
backend/app/main.py - Case database
backend/app/main.py - Audit logging
backend/app/main.py
Evidence processing
- Secure ingestion
backend/app/main.py - Encrypted evidence vault
backend/app/main.py - Parsing and OCR
backend/app - Entity extraction
backend/app/main.py
Investigation intelligence
- Timeline reconstruction
backend/app - Semantic retrieval
backend/app - Knowledge graph
backend/app/main.py - Conflict detection
backend/app - Explainable RAG
backend/app
Other components
- Investigator
- ClamAV scanner
Connections 23
- Investigator → Investigation UI: uses
README.md - Investigation UI → API service: calls
frontend/src/main.jsx - API service → Authentication and RBAC: checks identity
backend/app/main.py - API service → Case management: checks case access
backend/app/main.py - Authentication and RBAC → Case database: reads users
backend/app/main.py - Case management → Case database: reads membership
backend/app/main.py - API service → Secure ingestion: handles upload
backend/app/main.py - Secure ingestion → Encrypted evidence vault: stores encrypted
backend/app/main.py - Secure ingestion → Parsing and OCR: extracts text
backend/app/main.py - Parsing and OCR → Entity extraction: extracts entities
README.md - Secure ingestion → ClamAV scanner: optionally scans
backend/app/main.py - API service → Case database: reads and writes
backend/app/main.py - Entity extraction → Timeline reconstruction: supports reconstruction
README.md - Entity extraction → Semantic retrieval: indexes evidence
README.md - Timeline reconstruction → Knowledge graph: correlates evidence
README.md - Semantic retrieval → Knowledge graph: correlates evidence
README.md - Knowledge graph → Conflict detection: supports detection
README.md - Conflict detection → Explainable RAG: informs responses
README.md - Semantic retrieval → Explainable RAG: retrieves evidence
README.md - API service → Knowledge graph: builds graph
backend/app/main.py - API service → Audit logging: records actions
backend/app/main.py - Investigation UI → Semantic retrieval: searches evidence
frontend/src/main.jsx - Investigation UI → Audit logging: loads audit log
frontend/src/main.jsx