How vamshig24/secure-digital-evidence works
SDEMS manages investigative cases and digital evidence, with the central workflow of authenticated case work, evidence ingestion and custody tracking, then forensic analysis and court-ready reporting. The graph shows the React workspace, API routing and security, domain controllers, and persistence/integrations. Source excerpts establish selected controller and storage relationships; other major UI capabilities and the microservice deployment are included where documented, but their internal wiring is not inferred.
Main entry points: ragController.js Forensic Orchestration · App.jsx React Application · evidenceController.js Evidence Operations · caseController.js Case Operations
Components 26
Investigator Workspace
- React Application
client/src/App.jsx - Case Workspace
client/src/pages/CaseDetailPage.jsx - Case Directory
client/src/pages/CasesPage.jsx - Evidence Workspace
client/src/pages/EvidencePage.jsx - AI Forensics UI
client/src/pages/AiStudioPage.jsx - Session Context
client/src/context/AuthContext.jsx
API and Security
- API Gateway
server/server.js - Session and RBAC
server/middlewares/authMiddleware.js - Case Routes
server/routes/caseRoutes.js - Evidence Routes
server/routes/evidenceRoutes.js - Forensics Routes
server/routes/ragRoutes.js
Case and Forensics
- Case Operations
server/controllers/caseController.js - Evidence Operations
server/controllers/evidenceController.js - Forensic Orchestration
server/controllers/ragController.js - RAG Retrieval
server/services/ragService.js - Forensic Agents
server/services/forensicAgents.js - Custody Ledger Logic
server/utils/custodyChain.js
Persistence and Integrations
- Case Records
server/models/Case.js - Evidence Records
server/models/Evidence.js - Audit Records
server/models/AuditLog.js - Private File Storage
server/utils/storage.js - Redis Cache
server/config/redis.js
Other components
- Investigator
- MongoDB
- Cloudinary
- Gemini AI
Connections 37
- Investigator → React Application: uses
README.md - React Application → Case Workspace: routes to
client/src/App.jsx - React Application → Case Directory: routes to
client/src/App.jsx - React Application → Evidence Workspace: routes to
client/src/App.jsx - React Application → AI Forensics UI: routes to
client/src/App.jsx - React Application → Session Context: provides session
client/src/App.jsx - Investigator → API Gateway: sends requests
README.md - API Gateway → Case Routes: mounts
server/server.js - API Gateway → Evidence Routes: mounts
server/server.js - API Gateway → Forensics Routes: mounts
server/server.js - Case Routes → Session and RBAC: protects routes
server/routes/caseRoutes.js - Evidence Routes → Session and RBAC: protects routes
server/routes/evidenceRoutes.js - Forensics Routes → Session and RBAC: protects routes
server/routes/ragRoutes.js - Case Routes → Case Operations: dispatches
server/routes/caseRoutes.js - Evidence Routes → Evidence Operations: dispatches
server/routes/evidenceRoutes.js - Forensics Routes → Forensic Orchestration: dispatches
server/routes/ragRoutes.js - Case Operations → Case Records: reads and writes
server/controllers/caseController.js - Case Operations → Evidence Records: reads and writes
server/controllers/caseController.js - Case Operations → Private File Storage: deletes assets
server/controllers/caseController.js - Case Operations → Custody Ledger Logic: verifies ledger
server/controllers/caseController.js - Evidence Operations → Evidence Records: reads and writes
server/controllers/evidenceController.js - Evidence Operations → Case Records: checks case access
server/controllers/evidenceController.js - Evidence Operations → Custody Ledger Logic: builds and verifies
server/controllers/evidenceController.js - Evidence Operations → Private File Storage: uploads and reads
README.md - Evidence Operations → Redis Cache: caches lists
server/controllers/evidenceController.js - Forensic Orchestration → Case Records: loads authorized case
server/controllers/ragController.js - Forensic Orchestration → Evidence Records: loads evidence
server/controllers/ragController.js - Forensic Orchestration → RAG Retrieval: retrieves chunks
server/controllers/ragController.js - Forensic Orchestration → Forensic Agents: runs analyses
server/controllers/ragController.js - Forensic Orchestration → Private File Storage: fetches evidence
server/controllers/ragController.js - Forensic Orchestration → Redis Cache: caches extracted text
server/controllers/ragController.js - Forensic Orchestration → Audit Records: logs queries
server/controllers/ragController.js - Private File Storage → Cloudinary: stores and signs files
server/utils/storage.js - Forensic Agents → Custody Ledger Logic: checks custody
server/services/forensicAgents.js - Case Records → MongoDB: persists records
README.md - Evidence Records → MongoDB: persists records
README.md - Forensic Agents → Gemini AI: analyzes evidence
README.md