How rupesh-001/digital-evidence-management-system works
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: __init__.py App factory · api.py REST API · models/evidence.py Case records · routes/evidence.py Evidence management
Components 20
Web application
- Flask entry
app.py - App factory
app/__init__.py - Web templates
app/templates - Application config
config.py
Identity and access
- Authentication
app/routes/auth.py - User and roles
app/models/user.py
Investigation workflow
- Case management
app/routes/cases.py - Case records
app/models/evidence.py - Evidence management
app/routes/evidence.py - Hash verification
app/models/evidence.py - Custody tracking
app/routes/custody.py - Custody records
app/models/evidence.py
Oversight and reporting
- Dashboard
app/routes/dashboard.py - Report generation
app/routes/reports.py - Admin panel
app/routes/admin.py - Audit records
app/models/evidence.py - REST API
app/routes/api.py - Demo data seeder
app/models/seeder.py
Other components
- Investigator
- MongoDB
Connections 35
- Investigator → Flask entry: uses
README.md - Flask entry → App factory: creates app
app.py - App factory → Application config: loads
app/__init__.py - App factory → MongoDB: connects and indexes
app/__init__.py - App factory → Authentication: registers
app/__init__.py - App factory → Case management: registers
app/__init__.py - App factory → Evidence management: registers
app/__init__.py - App factory → Custody tracking: registers
app/__init__.py - App factory → Dashboard: registers
app/__init__.py - App factory → Report generation: registers
app/__init__.py - App factory → Admin panel: registers
app/__init__.py - App factory → REST API: registers
app/__init__.py - App factory → Demo data seeder: loads conditionally
app/__init__.py - Authentication → User and roles: authenticates
app/routes/auth.py - Authentication → Audit records: logs sign-in
app/routes/auth.py - Case management → Case records: reads and updates
app/routes/cases.py - Case management → Audit records: logs actions
app/routes/cases.py - Evidence management → Case records: lists cases
app/routes/evidence.py - Evidence management → Hash verification: creates and verifies
app/routes/evidence.py - Evidence management → Custody records: records intake and downloads
app/routes/evidence.py - Hash verification → MongoDB: reads and updates
app/models/evidence.py - Custody records → MongoDB: writes records
app/models/evidence.py - Case records → MongoDB: reads and writes
app/models/evidence.py - User and roles → MongoDB: reads and writes
app/models/user.py - Admin panel → User and roles: manages users
app/routes/admin.py - Admin panel → Audit records: searches logs
app/routes/admin.py - REST API → Case records: serves case data
app/routes/api.py - REST API → Custody records: serves custody data
app/routes/api.py - REST API → Audit records: serves audit data
app/routes/api.py - REST API → Hash verification: serves evidence data
app/routes/api.py - Report generation → Case records: reads case data
app/routes/reports.py - Report generation → Custody records: reads custody history
app/routes/reports.py - Web templates → Investigator: renders interface
- Dashboard → Web templates: renders dashboard
- Report generation → Web templates: presents reports