Guides & references
Architecture overviews, API reference, security model, and operational guides for the Evident platform.
Getting started
Set up your account, upload your first evidence file, and run the processing pipeline.
1. Create an account
Sign up at /signup/. All new accounts start on the Starter (free) tier. No credit card is required. Paid plans include a 7-day free trial.
2. Upload evidence
Upload video, audio, or document files through the dashboard. Each file is hashed on upload (SHA-256) and stored immutably. The original is never modified.
3. Run the pipeline
Select processing stages such as transcription, OCR, audio events, object detection, and legal analysis. The pipeline runs each stage and records every parameter for reproducibility.
4. Review and export
Review results in the dashboard. Export court-ready packages that include the original evidence hash, processing provenance, and audit trail in a single verifiable bundle.
User playbooks & tier guides
Role-specific setup guidance, AI analysis workflows, and advanced in-app help references.
Getting Started Onboarding
First 5 minutes, first upload, first pipeline run, and setup checklists by tier.
Tier User Guide
What unlocks at each tier, upgrade triggers, and workflow examples by team size.
Lumen AI Quick Start
All 6 Lumen analysis tools with practical examples and best-use sequencing.
Documentation Hub
Master index for user docs, admin docs, API docs, and support paths.
Dashboard Help Guidance
In-app assistance model, contextual tooltips, and workflow prompts.
Interactive Help Center
Use the dashboard help panel for searchable, case-aware tool recommendations.
Architecture
How the platform is structured and how data flows through it.
Frontend
Static site generated by Eleventy (11ty) and served via CDN. The frontend handles presentation only — all forensic logic runs server-side. This separation ensures that UI changes cannot affect evidence processing.
API layer
Express.js REST API handles authentication, file upload, pipeline orchestration, and result retrieval. Tier gating is enforced at the API layer before any processing begins.
Processing pipeline
Evidence passes through configurable stages: audio extraction, dual-pass transcription, vision analysis, and report generation. Each stage records its parameters, model version, and output hash.
Storage and audit
Original evidence is stored immutably. Derivatives are stored separately and linked to the original by hash. The append-only audit log records every action with cryptographic chaining.
API reference
REST API endpoints for programmatic access (Professional tier and above).
| Endpoint | Method | Description |
|---|---|---|
| /api/upload/ | POST | Upload evidence file. Returns SHA-256 hash and evidence ID. |
| /api/cases/ | GET | List your cases with status, file counts, and updated timestamps. |
| /api/pipeline/run | POST | Start pipeline processing for an uploaded file. |
| /api/pipeline/result/{fileId} | GET | Retrieve pipeline status and stage outputs for a file. |
| /api/custody/{fileId}/verify | GET | Verify chain-of-custody integrity and hash lineage for a file. |
| /api/export/pdf/{fileId} | GET | Generate court-ready export package. |
Authentication: All API requests require a Bearer token in the Authorization header. Tokens are managed from the account dashboard. API access requires the Professional tier or above.
Security model
How evidence is protected at rest, in transit, and during processing.
Encryption at rest
All stored evidence and derivatives are encrypted using AES-256. Encryption keys are managed separately from data storage. Key rotation follows a defined schedule.
Encryption in transit
All connections use TLS 1.2 or later. Certificate pinning is enforced for API clients. HSTS headers ensure browsers always connect over HTTPS.
Hash verification
SHA-256 is computed on upload and verified at every stage. Any mismatch halts processing and generates an alert. Hashes are stored in the append-only audit log.
Access control
Role-based access control with tier-gated features. Every access attempt is logged. Failed authentication attempts trigger rate limiting and monitoring alerts.
Changelog
Recent platform updates and improvements.
v0.8.0 — Current
- Dual-pass transcription engine with confidence-weighted merge
- Chat assistant with transcript grounding and citations
- Centralized tier gating module
- Court formatter for structured legal documents
- Expanded service documentation (audit, compliance, custody)
v0.7.0
- Video upload and processing pipeline
- Object detection and scene analysis
- Append-only audit trail system
- Dashboard with evidence management
v0.6.0
- SHA-256 hash verification on upload
- Tier-based subscription system
- Authentication and account management
- Static site generation with Eleventy
Ready to get started?
Create a free account and process your first evidence file in minutes.