# vamshig24/secure-digital-evidence architecture

> Architecture diagram of the GitHub repository vamshig24/secure-digital-evidence, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vamshig24/secure-digital-evidence
- Repository: https://github.com/vamshig24/secure-digital-evidence

## Overview

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: [`server/controllers/ragController.js`](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/controllers/ragController.js) (Forensic Orchestration), [`client/src/App.jsx`](https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/App.jsx) (React Application), [`server/controllers/evidenceController.js`](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/controllers/evidenceController.js) (Evidence Operations), [`server/controllers/caseController.js`](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/controllers/caseController.js) (Case Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Investigator Workspace"]
  node_app["React Application<br/>[App.jsx]"]
  node_caseui["Case Workspace<br/>[CaseDetailPage.jsx]"]
  node_casesui["Case Directory<br/>[CasesPage.jsx]"]
  node_evidenceui["Evidence Workspace<br/>[EvidencePage.jsx]"]
  node_aiui["AI Forensics UI<br/>[AiStudioPage.jsx]"]
  node_authctx["Session Context<br/>[AuthContext.jsx]"]
end

subgraph group_api["API and Security"]
  node_api["API Gateway<br/>[server.js]"]
  node_auth["Session and RBAC<br/>[authMiddleware.js]"]
  node_case_routes["Case Routes<br/>[caseRoutes.js]"]
  node_evidence_routes["Evidence Routes<br/>[evidenceRoutes.js]"]
  node_rag_routes["Forensics Routes<br/>[ragRoutes.js]"]
end

subgraph group_domain["Case and Forensics"]
  node_case_ctrl["Case Operations<br/>[caseController.js]"]
  node_evidence_ctrl["Evidence Operations"]
  node_rag_ctrl["Forensic Orchestration<br/>[ragController.js]"]
  node_rag_service["RAG Retrieval<br/>[ragService.js]"]
  node_agents["Forensic Agents<br/>[forensicAgents.js]"]
  node_custody["Custody Ledger Logic<br/>[custodyChain.js]"]
end

subgraph group_infra["Persistence and Integrations"]
  node_case_model[("Case Records<br/>[Case.js]")]
  node_evidence_model[("Evidence Records<br/>[Evidence.js]")]
  node_audit_model[("Audit Records<br/>[AuditLog.js]")]
  node_storage["Private File Storage<br/>[storage.js]"]
  node_redis[("Redis Cache<br/>[redis.js]")]
end

node_investigator(("Investigator"))
node_mongo[("MongoDB")]
node_cloudinary[("Cloudinary")]
node_gemini["Gemini AI"]

node_investigator -->|"uses"| node_app
node_app -->|"routes to"| node_caseui
node_app -->|"routes to"| node_casesui
node_app -->|"routes to"| node_evidenceui
node_app -->|"routes to"| node_aiui
node_app -->|"provides session"| node_authctx
node_investigator -.->|"sends requests"| node_api
node_api -->|"mounts"| node_case_routes
node_api -->|"mounts"| node_evidence_routes
node_api -->|"mounts"| node_rag_routes
node_case_routes -->|"protects routes"| node_auth
node_evidence_routes -->|"protects routes"| node_auth
node_rag_routes -->|"protects routes"| node_auth
node_case_routes -->|"dispatches"| node_case_ctrl
node_evidence_routes -->|"dispatches"| node_evidence_ctrl
node_rag_routes -->|"dispatches"| node_rag_ctrl
node_case_ctrl -->|"reads and writes"| node_case_model
node_case_ctrl -->|"reads and writes"| node_evidence_model
node_case_ctrl -->|"deletes assets"| node_storage
node_case_ctrl -->|"verifies ledger"| node_custody
node_evidence_ctrl -->|"reads and writes"| node_evidence_model
node_evidence_ctrl -->|"checks case access"| node_case_model
node_evidence_ctrl -->|"builds and verifies"| node_custody
node_evidence_ctrl -->|"uploads and reads"| node_storage
node_evidence_ctrl -->|"caches lists"| node_redis
node_rag_ctrl -->|"loads authorized case"| node_case_model
node_rag_ctrl -->|"loads evidence"| node_evidence_model
node_rag_ctrl -->|"retrieves chunks"| node_rag_service
node_rag_ctrl -->|"runs analyses"| node_agents
node_rag_ctrl -->|"fetches evidence"| node_storage
node_rag_ctrl -->|"caches extracted text"| node_redis
node_rag_ctrl -->|"logs queries"| node_audit_model
node_storage -->|"stores and signs files"| node_cloudinary
node_agents -->|"checks custody"| node_custody
node_case_model -.->|"persists records"| node_mongo
node_evidence_model -.->|"persists records"| node_mongo
node_agents -.->|"analyzes evidence"| node_gemini

click node_app "https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/App.jsx"
click node_caseui "https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/pages/CaseDetailPage.jsx"
click node_casesui "https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/pages/CasesPage.jsx"
click node_evidenceui "https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/pages/EvidencePage.jsx"
click node_aiui "https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/pages/AiStudioPage.jsx"
click node_authctx "https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/context/AuthContext.jsx"
click node_api "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/server.js"
click node_auth "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/middlewares/authMiddleware.js"
click node_case_routes "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/routes/caseRoutes.js"
click node_evidence_routes "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/routes/evidenceRoutes.js"
click node_rag_routes "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/routes/ragRoutes.js"
click node_case_ctrl "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/controllers/caseController.js"
click node_evidence_ctrl "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/controllers/evidenceController.js"
click node_rag_ctrl "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/controllers/ragController.js"
click node_rag_service "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/services/ragService.js"
click node_agents "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/services/forensicAgents.js"
click node_custody "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/utils/custodyChain.js"
click node_case_model "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/models/Case.js"
click node_evidence_model "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/models/Evidence.js"
click node_audit_model "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/models/AuditLog.js"
click node_storage "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/utils/storage.js"
click node_redis "https://github.com/vamshig24/secure-digital-evidence/blob/main/server/config/redis.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_caseui,node_casesui,node_evidenceui,node_aiui,node_authctx toneBlue
class node_api,node_auth,node_case_routes,node_evidence_routes,node_rag_routes,node_mongo,node_cloudinary toneAmber
class node_case_ctrl,node_evidence_ctrl,node_rag_ctrl,node_rag_service,node_agents,node_custody toneMint
class node_case_model,node_evidence_model,node_audit_model,node_storage,node_redis toneRose
class node_investigator,node_gemini toneIndigo
```

## Components

### Investigator Workspace

- [React Application](https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Case Workspace](https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/pages/CaseDetailPage.jsx): `client/src/pages/CaseDetailPage.jsx`
- [Case Directory](https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/pages/CasesPage.jsx): `client/src/pages/CasesPage.jsx`
- [Evidence Workspace](https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/pages/EvidencePage.jsx): `client/src/pages/EvidencePage.jsx`
- [AI Forensics UI](https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/pages/AiStudioPage.jsx): `client/src/pages/AiStudioPage.jsx`
- [Session Context](https://github.com/vamshig24/secure-digital-evidence/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`

### API and Security

- [API Gateway](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/server.js): `server/server.js`
- [Session and RBAC](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/middlewares/authMiddleware.js): `server/middlewares/authMiddleware.js`
- [Case Routes](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/routes/caseRoutes.js): `server/routes/caseRoutes.js`
- [Evidence Routes](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/routes/evidenceRoutes.js): `server/routes/evidenceRoutes.js`
- [Forensics Routes](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/routes/ragRoutes.js): `server/routes/ragRoutes.js`

### Case and Forensics

- [Case Operations](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/controllers/caseController.js): `server/controllers/caseController.js`
- [Evidence Operations](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/controllers/evidenceController.js): `server/controllers/evidenceController.js`
- [Forensic Orchestration](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/controllers/ragController.js): `server/controllers/ragController.js`
- [RAG Retrieval](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/services/ragService.js): `server/services/ragService.js`
- [Forensic Agents](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/services/forensicAgents.js): `server/services/forensicAgents.js`
- [Custody Ledger Logic](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/utils/custodyChain.js): `server/utils/custodyChain.js`

### Persistence and Integrations

- [Case Records](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/models/Case.js): `server/models/Case.js`
- [Evidence Records](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/models/Evidence.js): `server/models/Evidence.js`
- [Audit Records](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/models/AuditLog.js): `server/models/AuditLog.js`
- [Private File Storage](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/utils/storage.js): `server/utils/storage.js`
- [Redis Cache](https://github.com/vamshig24/secure-digital-evidence/blob/main/server/config/redis.js): `server/config/redis.js`

### Other components

- **Investigator**
- **MongoDB**
- **Cloudinary**
- **Gemini AI**

## Connections

- Investigator → React Application: uses (evidence: `README.md`)
- React Application → Case Workspace: routes to (evidence: `client/src/App.jsx`)
- React Application → Case Directory: routes to (evidence: `client/src/App.jsx`)
- React Application → Evidence Workspace: routes to (evidence: `client/src/App.jsx`)
- React Application → AI Forensics UI: routes to (evidence: `client/src/App.jsx`)
- React Application → Session Context: provides session (evidence: `client/src/App.jsx`)
- Investigator → API Gateway: sends requests (evidence: `README.md`)
- API Gateway → Case Routes: mounts (evidence: `server/server.js`)
- API Gateway → Evidence Routes: mounts (evidence: `server/server.js`)
- API Gateway → Forensics Routes: mounts (evidence: `server/server.js`)
- Case Routes → Session and RBAC: protects routes (evidence: `server/routes/caseRoutes.js`)
- Evidence Routes → Session and RBAC: protects routes (evidence: `server/routes/evidenceRoutes.js`)
- Forensics Routes → Session and RBAC: protects routes (evidence: `server/routes/ragRoutes.js`)
- Case Routes → Case Operations: dispatches (evidence: `server/routes/caseRoutes.js`)
- Evidence Routes → Evidence Operations: dispatches (evidence: `server/routes/evidenceRoutes.js`)
- Forensics Routes → Forensic Orchestration: dispatches (evidence: `server/routes/ragRoutes.js`)
- Case Operations → Case Records: reads and writes (evidence: `server/controllers/caseController.js`)
- Case Operations → Evidence Records: reads and writes (evidence: `server/controllers/caseController.js`)
- Case Operations → Private File Storage: deletes assets (evidence: `server/controllers/caseController.js`)
- Case Operations → Custody Ledger Logic: verifies ledger (evidence: `server/controllers/caseController.js`)
- Evidence Operations → Evidence Records: reads and writes (evidence: `server/controllers/evidenceController.js`)
- Evidence Operations → Case Records: checks case access (evidence: `server/controllers/evidenceController.js`)
- Evidence Operations → Custody Ledger Logic: builds and verifies (evidence: `server/controllers/evidenceController.js`)
- Evidence Operations → Private File Storage: uploads and reads (evidence: `README.md`)
- Evidence Operations → Redis Cache: caches lists (evidence: `server/controllers/evidenceController.js`)
- Forensic Orchestration → Case Records: loads authorized case (evidence: `server/controllers/ragController.js`)
- Forensic Orchestration → Evidence Records: loads evidence (evidence: `server/controllers/ragController.js`)
- Forensic Orchestration → RAG Retrieval: retrieves chunks (evidence: `server/controllers/ragController.js`)
- Forensic Orchestration → Forensic Agents: runs analyses (evidence: `server/controllers/ragController.js`)
- Forensic Orchestration → Private File Storage: fetches evidence (evidence: `server/controllers/ragController.js`)
- Forensic Orchestration → Redis Cache: caches extracted text (evidence: `server/controllers/ragController.js`)
- Forensic Orchestration → Audit Records: logs queries (evidence: `server/controllers/ragController.js`)
- Private File Storage → Cloudinary: stores and signs files (evidence: `server/utils/storage.js`)
- Forensic Agents → Custody Ledger Logic: checks custody (evidence: `server/services/forensicAgents.js`)
- Case Records → MongoDB: persists records (evidence: `README.md`)
- Evidence Records → MongoDB: persists records (evidence: `README.md`)
- Forensic Agents → Gemini AI: analyzes evidence (evidence: `README.md`)
