# dakshinamoorthyaids/secure-digital-evidence-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/dakshinamoorthyaids/secure-digital-evidence-management-system
- Repository: https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system

## Overview

This is a secure digital-evidence management system: users sign in, manage cases and evidence, upload files, check integrity, and review custody history or reports. The frontend App routes users to role dashboards and feature views; those views communicate with a FastAPI backend that applies security logic and persists user, case, evidence, custody, and audit records. The source excerpts show only portions of the backend and some frontend calls, so undocumented API-to-backend links are marked unverified rather than asserted.

Main entry points: [`frontend/src/App.tsx`](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/App.tsx) (App and routing), [`frontend/src/api.ts`](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/api.ts) (API endpoint config), [`frontend/src/InvestigatorDashboard.tsx`](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/InvestigatorDashboard.tsx) (Investigator dashboard), [`frontend/src/ForensicOfficerDashboard.tsx`](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/ForensicOfficerDashboard.tsx) (Officer dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App and routing<br/>[App.tsx]"]
  node_investigator["Investigator dashboard"]
  node_officer["Officer dashboard"]
  node_viewer["Viewer dashboard"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_settings["Settings<br/>[Settings.tsx]"]
end

subgraph group_evidence["Evidence workflows"]
  node_evidence_view["Evidence records<br/>[Evidence.tsx]"]
  node_upload["Evidence upload<br/>[UploadEvidence.tsx]"]
  node_verification["Integrity verification<br/>[Verification.tsx]"]
  node_custody["Custody history<br/>[ChainOfCustody.tsx]"]
  node_audit["Audit logs<br/>[AuditLogs.tsx]"]
  node_reports["Report generation<br/>[GenerateReport.tsx]"]
end

subgraph group_backend["Backend services"]
  node_api["API endpoint config<br/>[api.ts]"]
  node_service["FastAPI service<br/>[main.py]"]
  node_auth["Password and roles<br/>[auth.py]"]
  node_security["Evidence security<br/>[security.py]"]
end

subgraph group_data["Persistence and records"]
  node_models["Domain models<br/>[models.py]"]
  node_db_session["Database sessions<br/>[database.py]"]
  node_store[("Relational database")]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_investigator
node_app -->|"routes to"| node_officer
node_app -->|"routes to"| node_viewer
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_evidence_view
node_app -->|"routes to"| node_upload
node_app -->|"routes to"| node_verification
node_app -->|"routes to"| node_custody
node_app -->|"routes to"| node_audit
node_app -->|"routes to"| node_settings
node_app -->|"routes to"| node_reports
node_investigator -->|"uses"| node_evidence_view
node_investigator -->|"uses"| node_upload
node_investigator -->|"uses"| node_verification
node_investigator -->|"uses"| node_custody
node_officer -->|"uses"| node_evidence_view
node_officer -->|"uses"| node_verification
node_officer -->|"uses"| node_custody
node_officer -->|"uses"| node_reports
node_dashboard -->|"uses"| node_upload
node_app -->|"configures API"| node_api
node_evidence_view -->|"requests data"| node_api
node_upload -->|"requests upload"| node_api
node_verification -->|"requests checks"| node_api
node_custody -->|"requests history"| node_api
node_audit -->|"requests logs"| node_api
node_reports -->|"requests reports"| node_api
node_api -.->|"calls API"| node_service
node_service -->|"uses credentials"| node_auth
node_service -->|"uses security"| node_security
node_service -->|"queries records"| node_models
node_service -->|"opens sessions"| node_db_session
node_models -->|"uses base"| node_db_session
node_db_session -->|"connects"| node_store

click node_app "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/App.tsx"
click node_investigator "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/InvestigatorDashboard.tsx"
click node_officer "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/ForensicOfficerDashboard.tsx"
click node_viewer "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/ViewerDashboard.tsx"
click node_dashboard "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/Dashboard.tsx"
click node_settings "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/Settings.tsx"
click node_evidence_view "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/Evidence.tsx"
click node_upload "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/UploadEvidence.tsx"
click node_verification "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/Verification.tsx"
click node_custody "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/ChainOfCustody.tsx"
click node_audit "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/AuditLogs.tsx"
click node_reports "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/GenerateReport.tsx"
click node_api "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/api.ts"
click node_service "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/backend/main.py"
click node_auth "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/backend/auth.py"
click node_security "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/backend/security.py"
click node_models "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/backend/models.py"
click node_db_session "https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/backend/database.py"

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_investigator,node_officer,node_viewer,node_dashboard,node_settings,node_user toneBlue
class node_evidence_view,node_upload,node_verification,node_custody,node_audit,node_reports toneAmber
class node_api,node_service,node_auth,node_security toneMint
class node_models,node_db_session,node_store toneRose
```

## Components

### Web application

- [App and routing](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Investigator dashboard](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/InvestigatorDashboard.tsx): `frontend/src/InvestigatorDashboard.tsx`
- [Officer dashboard](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/ForensicOfficerDashboard.tsx): `frontend/src/ForensicOfficerDashboard.tsx`
- [Viewer dashboard](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/ViewerDashboard.tsx): `frontend/src/ViewerDashboard.tsx`
- [Dashboard](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/Dashboard.tsx): `frontend/src/Dashboard.tsx`
- [Settings](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/Settings.tsx): `frontend/src/Settings.tsx`

### Evidence workflows

- [Evidence records](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/Evidence.tsx): `frontend/src/Evidence.tsx`
- [Evidence upload](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/UploadEvidence.tsx): `frontend/src/UploadEvidence.tsx`
- [Integrity verification](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/Verification.tsx): `frontend/src/Verification.tsx`
- [Custody history](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/ChainOfCustody.tsx): `frontend/src/ChainOfCustody.tsx`
- [Audit logs](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/AuditLogs.tsx): `frontend/src/AuditLogs.tsx`
- [Report generation](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/GenerateReport.tsx): `frontend/src/GenerateReport.tsx`

### Backend services

- [API endpoint config](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [FastAPI service](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/backend/main.py): `backend/main.py`
- [Password and roles](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/backend/auth.py): `backend/auth.py`
- [Evidence security](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/backend/security.py): `backend/security.py`

### Persistence and records

- [Domain models](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/backend/models.py): `backend/models.py`
- [Database sessions](https://github.com/dakshinamoorthyaids/secure-digital-evidence-management-system/blob/main/backend/database.py): `backend/database.py`
- **Relational database**

### Other components

- **User**

## Connections

- User → App and routing: uses
- App and routing → Investigator dashboard: routes to (evidence: `frontend/src/App.tsx`)
- App and routing → Officer dashboard: routes to (evidence: `frontend/src/App.tsx`)
- App and routing → Viewer dashboard: routes to (evidence: `frontend/src/App.tsx`)
- App and routing → Dashboard: routes to (evidence: `frontend/src/App.tsx`)
- App and routing → Evidence records: routes to (evidence: `frontend/src/App.tsx`)
- App and routing → Evidence upload: routes to (evidence: `frontend/src/App.tsx`)
- App and routing → Integrity verification: routes to (evidence: `frontend/src/App.tsx`)
- App and routing → Custody history: routes to (evidence: `frontend/src/App.tsx`)
- App and routing → Audit logs: routes to (evidence: `frontend/src/App.tsx`)
- App and routing → Settings: routes to (evidence: `frontend/src/App.tsx`)
- App and routing → Report generation: routes to (evidence: `frontend/src/App.tsx`)
- Investigator dashboard → Evidence records: uses (evidence: `frontend/src/InvestigatorDashboard.tsx`)
- Investigator dashboard → Evidence upload: uses (evidence: `frontend/src/InvestigatorDashboard.tsx`)
- Investigator dashboard → Integrity verification: uses (evidence: `frontend/src/InvestigatorDashboard.tsx`)
- Investigator dashboard → Custody history: uses (evidence: `frontend/src/InvestigatorDashboard.tsx`)
- Officer dashboard → Evidence records: uses (evidence: `frontend/src/ForensicOfficerDashboard.tsx`)
- Officer dashboard → Integrity verification: uses (evidence: `frontend/src/ForensicOfficerDashboard.tsx`)
- Officer dashboard → Custody history: uses (evidence: `frontend/src/ForensicOfficerDashboard.tsx`)
- Officer dashboard → Report generation: uses (evidence: `frontend/src/ForensicOfficerDashboard.tsx`)
- Dashboard → Evidence upload: uses (evidence: `frontend/src/Dashboard.tsx`)
- App and routing → API endpoint config: configures API (evidence: `frontend/src/App.tsx`)
- Evidence records → API endpoint config: requests data (evidence: `frontend/src/Evidence.tsx`)
- Evidence upload → API endpoint config: requests upload (evidence: `frontend/src/UploadEvidence.tsx`)
- Integrity verification → API endpoint config: requests checks (evidence: `frontend/src/Verification.tsx`)
- Custody history → API endpoint config: requests history (evidence: `frontend/src/ChainOfCustody.tsx`)
- Audit logs → API endpoint config: requests logs (evidence: `frontend/src/AuditLogs.tsx`)
- Report generation → API endpoint config: requests reports (evidence: `frontend/src/GenerateReport.tsx`)
- API endpoint config → FastAPI service: calls API
- FastAPI service → Password and roles: uses credentials (evidence: `backend/main.py`)
- FastAPI service → Evidence security: uses security (evidence: `backend/main.py`)
- FastAPI service → Domain models: queries records (evidence: `backend/main.py`)
- FastAPI service → Database sessions: opens sessions (evidence: `backend/main.py`)
- Domain models → Database sessions: uses base (evidence: `backend/models.py`)
- Database sessions → Relational database: connects (evidence: `backend/database.py`)
