# Evidentium Developer Handoff

## System Overview: "Institutional Trust"
This document outlines the visual system, interaction patterns, and component architecture developed for Evidentium. The design is optimized for high-stakes legal data management, prioritizing clarity, provenance, and regulatory compliance (LABE guardrails).

---

## 1. Design Tokens (Evidentium System)

**Color Palette**
- **Brand Primary**: `#1a3050` (Navy) - Used for headers, primary actions, and "institutional" sections.
- **Surface**: `#f8f9fb` - Soft off-white to reduce eye strain.
- **Surface Container**: `#ffffff` - Elevated card backgrounds.
- **Accent/Alerts**:
  - **Crisis**: Deep Red (#b91c1c) - High visibility for support resources.
  - **Warning**: Amber (#f59e0b) - For pending verifications and gaps.
  - **Success**: Emerald (#10b981) - For verified alignment.

**Typography**
- **Headings**: _Playfair Display_ (Serif) - Establishes formal, document-like authority.
- **Body/UI**: _Inter_ or System Sans-Serif - High legibility for dense data grids and timelines.

**Elevation & Shape**
- **Roundness**: `ROUND_EIGHT` (8px corners) for a modern yet stable feel.
- **Shadows**: Low-altitude `shadow-sm` on cards to maintain a "flat document" metaphor.

---

## 2. Core Screen Architecture

### Dashboard & Navigation
- **TopAppBar**: Persistent brand presence with case-specific breadcrumbs.
- **BottomNavBar**: Primary navigation (Dashboard, Matters, Escalations, Audit Log, AI Transparency).
- **Global Disclaimer**: High-visibility persistent banner explicitly stating "NOT LEGAL ADVICE."

### Matter Detail & Timeline
- **The Chronology Rail**: A vertical line connecting events. Each event node displays a confidence score pill (e.g., `85% Confidence`).
- **Source Data Excerpt**: Standardized quote blocks for `source_excerpt`, clearly separated from AI summaries.

### Verification Flow (Split-Pane)
- **Document Preview Pane**: Top pane (scroll-to-sync capable) displaying source text.
- **Extraction Summary**: Bottom pane with direct actions: `Verify Alignment` vs. `Flag Contradiction`.
- **Integrated Crisis Support**: In-line UI injection (Lifeline 13 11 14) within stressful flagging workflows.

### Document Coverage Matrix
- **Category-Based Grid**: Maps document categories (e.g., Proof of Employment, Medical Nexus) to uploaded files.
- **Guardrail Logic**: Focuses on "Document Coverage" and "Procedural Tracking" rather than "Legal Sufficiency."

---

## 3. Component Inventory

---

## 4. Implementation Notes for Base44
1. **LABE Guardrails**: UI text must strictly avoid "sufficiency" or "merit" language. All matrix views are titled "Document Coverage."
2. **Data Model Alignment**:
   - `Event` entities map to the `ChronologyRail`.
   - `EvidenceGap` entities populate the `Document Coverage Matrix`.
   - `source_excerpt` should be rendered in the `Original Source Document` pane.
3. **Crisis Triggers**: High-severity contradiction flags should conditionally render the crisis support component in-line.
4. **Mobile Responsiveness**: All views use a single-column stacked layout with consistent `px-margin-mobile` spacing.

---

## Matter Summary
Investigation into alleged intellectual property misappropriation involving former technical staff and subsequent patent filings in secondary jurisdictions.

**Case ID**: MAT-0892-IP  
**Custodian**: Michael Thorne  
**Status**: Active Audit  
**Priority**: High Risk  
**Evidence Count**: 142 Items

### Chain of Custody
The digital chain of custody is cryptographically sealed and verified against the Ethereum Mainnet ledger for immutable proof of existence.

### Chronology Rail
Timeline of reconstructed events from verified digital artifacts.

- **Unauthorized Access Detected** `98% Confidence`
  - _Oct 14, 2023 • 03:42 AM_
  - "Log access recorded from IP address 192.168.1.104 attempting authentication via legacy VPN tunnel 04. Credentials utilized: 'm.thorne_admin'. Session duration: 142 minutes."
  - **Source Excerpt**: `system_auth_logs.log`

- **Large Data Transfer Initiated** `72% Confidence`
  - _Oct 14, 2023 • 05:15 AM_
  - "Outbound packet burst detected. Total volume: 14.2 GB. Destination node: encrypted-cloud-storage-772. Metadata indicates file extensions associated with CAD schematics and proprietary source code."
  - **Source Excerpt**: `network_traffic_analysis.json`

- **Communication via Encrypted Channel** `85% Confidence`
  - _Oct 14, 2023 • 09:12 AM_
  - "Message fragment recovered from RAM slack space: 'The package has been delivered to the repository. Please confirm receipt and initiate the second phase of the transition as discussed.'"
  - **Source Excerpt**: `recovered_memory_dump_02.raw`

---

## Document Coverage Matrix
**Document Coverage**: Smith v. Transport Co  |  **Evidentium** 
### Proof of Employment  
- 2/3 Required  
  - Required Document  
    - Letter of Offer  ✅ Uploaded  
      
  - Required Document  
    - Recent Payslip (3 months) ❌ Missing (Critical)

- Required Document  
  - Official Transport Co Incident Log  📃 Pending Verification

### Critical Gaps
3 Files

---

## Recent Custody Activity
View Audit Log
- Evidence #E-2940 was accessed by Detective Marcus Thorne.
- Batch Upload: 24 CCTV Footages added to M-2024-001.
- Legal Note appended to Evidence #DOC-8112 by Sarah Jenkins, Assoc. Counsel.

### Legal Hold Alert
4 matters have evidence retention windows expiring within 30 days. Action required for preservation.

**Institutional Custody Engine v4.2**