How roopesh1815-bot/cipher works
CIPHER is an offline-first investigative network-analysis application. Its main workflow takes FIR, call-detail, financial, and social records through extraction, entity resolution and source fusion, then builds a contextual relationship graph and derives analytical outputs for investigator review. The FastAPI application exposes case-scoped and global views, with authentication, membership checks, document-vault operations, and audit logging. The README documents an isolated synthetic temporal-ML demonstration; it is separate from production graph analysis. Some subsystem links below reflect README-documented capabilities because their implementation files were not sampled.
Main entry points: run_pipeline.py Pipeline runner · routers Analysis and case APIs · main.py FastAPI application · auth.py User authentication
Components 25
Production analysis
- Pipeline runner
pipeline/run_pipeline.py - CSV ingestion
pipeline/ingestion/csv_importer.py - Source extraction
pipeline/extraction - Entity resolution
pipeline/extraction/entity_resolver.py - Source fusion
pipeline/extraction/fusion_tagger.py - Relationship graph
pipeline/graph/builder.py - Influencer metrics
pipeline/graph/centrality.py - Community detection
pipeline/graph/community.py - Anomaly flags
pipeline/graph/anomaly.py - Risk and links
pipeline/intelligence - Temporal trends
pipeline/intelligence/temporal_engine.py - Case summaries
pipeline/intelligence/case_summariser.py - Graph exports
pipeline/graph/exporter.py
Case operations
- Case lifecycle
core/case_manager.py - Protected document vault
api/routers/case_vault.py - Case membership
core/case_access.py
Application interface
- FastAPI application
api/main.py - Analysis and case APIs
api/routers
Identity and audit
- Login routes
api/routers/auth.py - Session security
api/security.py - User authentication
core/auth.py - Hash-chained audit
core/audit.py - SQLite records
core/db.py
Synthetic ML demo
- Synthetic temporal ML
ml_experiment/temporal_link_demo.py
Other components
- Investigator
Connections 32
- Investigator → FastAPI application: uses
- FastAPI application → Analysis and case APIs: registers
api/main.py - Analysis and case APIs → Case lifecycle: manage cases
api/routers/cases.py - Analysis and case APIs → Protected document vault: serve vault
api/main.py - Protected document vault → Case membership: checks membership
api/routers/case_vault.py - FastAPI application → Session security: authenticates requests
api/main.py - Login routes → User authentication: verifies credentials
api/routers/auth.py - Login routes → Session security: creates tokens
api/routers/auth.py - Session security → User authentication: loads active user
api/security.py - User authentication → SQLite records: reads users
core/auth.py - User authentication → Hash-chained audit: records actions
core/auth.py - Hash-chained audit → SQLite records: stores audit chain
core/audit.py - Case lifecycle → SQLite records: stores case records
core/case_manager.py - Case membership → SQLite records: checks memberships
core/case_access.py - Pipeline runner → Source extraction: runs extraction
pipeline/run_pipeline.py - Pipeline runner → Entity resolution: resolves entities
pipeline/run_pipeline.py - Pipeline runner → Source fusion: tags sources
pipeline/run_pipeline.py - Pipeline runner → Relationship graph: builds graph
pipeline/run_pipeline.py - Pipeline runner → Influencer metrics: computes metrics
pipeline/run_pipeline.py - Pipeline runner → Community detection: detects communities
pipeline/run_pipeline.py - Pipeline runner → Anomaly flags: detects anomalies
pipeline/run_pipeline.py - Pipeline runner → Risk and links: computes scores and links
pipeline/run_pipeline.py - Pipeline runner → Temporal trends: runs temporal analysis
pipeline/run_pipeline.py - Pipeline runner → Case summaries: summarizes cases
pipeline/run_pipeline.py - Pipeline runner → Graph exports: exports graph
pipeline/run_pipeline.py - CSV ingestion → Case lifecycle: creates cases
pipeline/ingestion/csv_importer.py - Analysis and case APIs → Influencer metrics: serves influencer view
- Analysis and case APIs → Community detection: serves communities
- Analysis and case APIs → Anomaly flags: serves alerts
- Analysis and case APIs → Risk and links: serves risk and links
- Analysis and case APIs → Temporal trends: serves temporal alerts
- FastAPI application → Synthetic temporal ML: exposes separate demo