# rupesh-001/digital-evidence-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/rupesh-001/digital-evidence-management-system
- Repository: https://github.com/rupesh-001/digital-evidence-management-system

## Overview

DEMS is a Flask/MongoDB application for investigators to manage cases and digital evidence, verify file integrity, and preserve chain-of-custody and audit records. The main workflow is authentication, case management, evidence intake and SHA-256 verification, followed by custody tracking and reporting; dashboard, admin, and JWT-protected API capabilities are also represented. Route and model interactions are shown where excerpts support them. Several route implementations were not sampled, so their feature nodes rely on the README and uncertain internal links are omitted.

Main entry points: [`app/__init__.py`](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/__init__.py) (App factory), [`app/routes/api.py`](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/api.py) (REST API), [`app/models/evidence.py`](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/evidence.py) (Case records), [`app/routes/evidence.py`](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/evidence.py) (Evidence management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_entry["Flask entry<br/>[app.py]"]
  node_factory["App factory<br/>[__init__.py]"]
  node_presentation["Web templates"]
  node_config["Application config<br/>[config.py]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication<br/>[auth.py]"]
  node_users["User and roles<br/>[user.py]"]
end

subgraph group_investigation["Investigation workflow"]
  node_cases["Case management<br/>[cases.py]"]
  node_case_data["Case records<br/>[evidence.py]"]
  node_evidence["Evidence management<br/>[evidence.py]"]
  node_integrity["Hash verification<br/>[evidence.py]"]
  node_custody["Custody tracking<br/>[custody.py]"]
  node_custody_data["Custody records<br/>[evidence.py]"]
end

subgraph group_oversight["Oversight and reporting"]
  node_dashboard["Dashboard<br/>[dashboard.py]"]
  node_reports["Report generation<br/>[reports.py]"]
  node_admin["Admin panel<br/>[admin.py]"]
  node_audit_data["Audit records<br/>[evidence.py]"]
  node_api["REST API<br/>[api.py]"]
  node_seeder["Demo data seeder<br/>[seeder.py]"]
end

node_investigator(("Investigator"))
node_mongo[("MongoDB")]

node_investigator -->|"uses"| node_entry
node_entry -->|"creates app"| node_factory
node_factory -->|"loads"| node_config
node_factory -->|"connects and indexes"| node_mongo
node_factory -->|"registers"| node_auth
node_factory -->|"registers"| node_cases
node_factory -->|"registers"| node_evidence
node_factory -->|"registers"| node_custody
node_factory -->|"registers"| node_dashboard
node_factory -->|"registers"| node_reports
node_factory -->|"registers"| node_admin
node_factory -->|"registers"| node_api
node_factory -->|"loads conditionally"| node_seeder
node_auth -->|"authenticates"| node_users
node_auth -->|"logs sign-in"| node_audit_data
node_cases -->|"reads and updates"| node_case_data
node_cases -->|"logs actions"| node_audit_data
node_evidence -->|"lists cases"| node_case_data
node_evidence -->|"creates and verifies"| node_integrity
node_evidence -->|"records intake and downloads"| node_custody_data
node_integrity -->|"reads and updates"| node_mongo
node_custody_data -->|"writes records"| node_mongo
node_case_data -->|"reads and writes"| node_mongo
node_users -->|"reads and writes"| node_mongo
node_admin -->|"manages users"| node_users
node_admin -->|"searches logs"| node_audit_data
node_api -->|"serves case data"| node_case_data
node_api -->|"serves custody data"| node_custody_data
node_api -->|"serves audit data"| node_audit_data
node_api -->|"serves evidence data"| node_integrity
node_reports -->|"reads case data"| node_case_data
node_reports -->|"reads custody history"| node_custody_data
node_presentation -.->|"renders interface"| node_investigator
node_dashboard -.->|"renders dashboard"| node_presentation
node_reports -.->|"presents reports"| node_presentation

click node_entry "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app.py"
click node_factory "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/__init__.py"
click node_presentation "https://github.com/rupesh-001/digital-evidence-management-system/tree/main/app/templates"
click node_auth "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/auth.py"
click node_users "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/user.py"
click node_cases "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/cases.py"
click node_case_data "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/evidence.py"
click node_evidence "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/evidence.py"
click node_integrity "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/evidence.py"
click node_custody "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/custody.py"
click node_custody_data "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/evidence.py"
click node_dashboard "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/dashboard.py"
click node_reports "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/reports.py"
click node_admin "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/admin.py"
click node_audit_data "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/evidence.py"
click node_api "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/api.py"
click node_seeder "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/seeder.py"
click node_config "https://github.com/rupesh-001/digital-evidence-management-system/blob/main/config.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_entry,node_factory,node_presentation,node_config toneBlue
class node_auth,node_users,node_mongo toneAmber
class node_cases,node_case_data,node_evidence,node_integrity,node_custody,node_custody_data toneMint
class node_dashboard,node_reports,node_admin,node_audit_data,node_api,node_seeder toneRose
class node_investigator toneIndigo
```

## Components

### Web application

- [Flask entry](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app.py): `app.py`
- [App factory](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/__init__.py): `app/__init__.py`
- [Web templates](https://github.com/rupesh-001/digital-evidence-management-system/tree/main/app/templates): `app/templates`
- [Application config](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/config.py): `config.py`

### Identity and access

- [Authentication](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/auth.py): `app/routes/auth.py`
- [User and roles](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/user.py): `app/models/user.py`

### Investigation workflow

- [Case management](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/cases.py): `app/routes/cases.py`
- [Case records](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/evidence.py): `app/models/evidence.py`
- [Evidence management](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/evidence.py): `app/routes/evidence.py`
- [Hash verification](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/evidence.py): `app/models/evidence.py`
- [Custody tracking](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/custody.py): `app/routes/custody.py`
- [Custody records](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/evidence.py): `app/models/evidence.py`

### Oversight and reporting

- [Dashboard](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/dashboard.py): `app/routes/dashboard.py`
- [Report generation](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/reports.py): `app/routes/reports.py`
- [Admin panel](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/admin.py): `app/routes/admin.py`
- [Audit records](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/evidence.py): `app/models/evidence.py`
- [REST API](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/routes/api.py): `app/routes/api.py`
- [Demo data seeder](https://github.com/rupesh-001/digital-evidence-management-system/blob/main/app/models/seeder.py): `app/models/seeder.py`

### Other components

- **Investigator**
- **MongoDB**

## Connections

- Investigator → Flask entry: uses (evidence: `README.md`)
- Flask entry → App factory: creates app (evidence: `app.py`)
- App factory → Application config: loads (evidence: `app/__init__.py`)
- App factory → MongoDB: connects and indexes (evidence: `app/__init__.py`)
- App factory → Authentication: registers (evidence: `app/__init__.py`)
- App factory → Case management: registers (evidence: `app/__init__.py`)
- App factory → Evidence management: registers (evidence: `app/__init__.py`)
- App factory → Custody tracking: registers (evidence: `app/__init__.py`)
- App factory → Dashboard: registers (evidence: `app/__init__.py`)
- App factory → Report generation: registers (evidence: `app/__init__.py`)
- App factory → Admin panel: registers (evidence: `app/__init__.py`)
- App factory → REST API: registers (evidence: `app/__init__.py`)
- App factory → Demo data seeder: loads conditionally (evidence: `app/__init__.py`)
- Authentication → User and roles: authenticates (evidence: `app/routes/auth.py`)
- Authentication → Audit records: logs sign-in (evidence: `app/routes/auth.py`)
- Case management → Case records: reads and updates (evidence: `app/routes/cases.py`)
- Case management → Audit records: logs actions (evidence: `app/routes/cases.py`)
- Evidence management → Case records: lists cases (evidence: `app/routes/evidence.py`)
- Evidence management → Hash verification: creates and verifies (evidence: `app/routes/evidence.py`)
- Evidence management → Custody records: records intake and downloads (evidence: `app/routes/evidence.py`)
- Hash verification → MongoDB: reads and updates (evidence: `app/models/evidence.py`)
- Custody records → MongoDB: writes records (evidence: `app/models/evidence.py`)
- Case records → MongoDB: reads and writes (evidence: `app/models/evidence.py`)
- User and roles → MongoDB: reads and writes (evidence: `app/models/user.py`)
- Admin panel → User and roles: manages users (evidence: `app/routes/admin.py`)
- Admin panel → Audit records: searches logs (evidence: `app/routes/admin.py`)
- REST API → Case records: serves case data (evidence: `app/routes/api.py`)
- REST API → Custody records: serves custody data (evidence: `app/routes/api.py`)
- REST API → Audit records: serves audit data (evidence: `app/routes/api.py`)
- REST API → Hash verification: serves evidence data (evidence: `app/routes/api.py`)
- Report generation → Case records: reads case data (evidence: `app/routes/reports.py`)
- Report generation → Custody records: reads custody history (evidence: `app/routes/reports.py`)
- Web templates → Investigator: renders interface
- Dashboard → Web templates: renders dashboard
- Report generation → Web templates: presents reports
