# shadow3456rh/civitas-lens architecture

> Architecture diagram of the GitHub repository shadow3456rh/civitas-lens, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shadow3456rh/civitas-lens
- Repository: https://github.com/shadow3456rh/civitas-lens

## Overview

Civitas Lens is a proposed incident-intelligence platform: people submit multimodal observations with context, AI helps structure and relate them, and the system connects evidence into evolving incidents for review. The README documents the intended workflow and capabilities, but the repository tree contains no implementation files; all nodes therefore point to the README, and the graph represents documented design rather than verified runtime calls.

Main entry points: [`README.md`](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md) (Observation Intake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Observation Capture"]
  node_intake["Observation Intake<br/>[README.md]"]
  node_text["Text Input<br/>[README.md]"]
  node_image["Image Input<br/>[README.md]"]
  node_voice["Voice Input<br/>[README.md]"]
  node_context["Location and Time<br/>[README.md]"]
end

subgraph group_analysis["AI Analysis"]
  node_understanding["Observation Analysis<br/>[README.md]"]
  node_gemma{{"Gemma 4<br/>[README.md]"}}
end

subgraph group_incidents["Incident Intelligence"]
  node_structured["Structured Observation<br/>[README.md]"]
  node_retrieval["Candidate Retrieval<br/>[README.md]"]
  node_matching["Relationship Analysis<br/>[README.md]"]
  node_incident[("Incident Records<br/>[README.md]")]
  node_evidence["Evidence and Timeline<br/>[README.md]"]
end

subgraph group_review["Situational Awareness"]
  node_summary["Incident Summary<br/>[README.md]"]
  node_dashboard["Incident Dashboard<br/>[README.md]"]
end

node_public(("Public Reporter"))
node_reviewer(("Analyst or Responder"))

node_public -->|"submits"| node_intake
node_text -->|"provides text"| node_intake
node_image -->|"provides image"| node_intake
node_voice -->|"provides recording"| node_intake
node_context -->|"provides context"| node_intake
node_intake -->|"processes input"| node_understanding
node_understanding -->|"analyzes observation"| node_gemma
node_gemma -->|"extracts and classifies"| node_structured
node_structured -->|"retrieves candidates"| node_retrieval
node_retrieval -->|"supplies candidates"| node_matching
node_matching -->|"compares relationships"| node_gemma
node_matching -->|"updates or creates"| node_incident
node_structured -->|"preserves report"| node_evidence
node_incident -->|"maintains timeline"| node_evidence
node_incident -->|"summarizes incident"| node_summary
node_evidence -->|"presents evidence"| node_dashboard
node_summary -->|"presents summary"| node_dashboard
node_dashboard -->|"supports review"| node_reviewer

click node_intake "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_text "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_image "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_voice "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_context "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_understanding "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_gemma "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_structured "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_retrieval "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_matching "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_incident "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_evidence "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_summary "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"
click node_dashboard "https://github.com/shadow3456rh/civitas-lens/blob/main/README.md"

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_intake,node_text,node_image,node_voice,node_context toneBlue
class node_understanding,node_gemma toneAmber
class node_structured,node_retrieval,node_matching,node_incident,node_evidence toneMint
class node_summary,node_dashboard toneRose
class node_public,node_reviewer toneIndigo
```

## Components

### Observation Capture

- [Observation Intake](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`
- [Text Input](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`
- [Image Input](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`
- [Voice Input](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`
- [Location and Time](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`

### AI Analysis

- [Observation Analysis](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`
- [Gemma 4](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`

### Incident Intelligence

- [Structured Observation](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`
- [Candidate Retrieval](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`
- [Relationship Analysis](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`
- [Incident Records](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`
- [Evidence and Timeline](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`

### Situational Awareness

- [Incident Summary](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`
- [Incident Dashboard](https://github.com/shadow3456rh/civitas-lens/blob/main/README.md): `README.md`

### Other components

- **Public Reporter**
- **Analyst or Responder**

## Connections

- Public Reporter → Observation Intake: submits (evidence: `README.md`)
- Text Input → Observation Intake: provides text (evidence: `README.md`)
- Image Input → Observation Intake: provides image (evidence: `README.md`)
- Voice Input → Observation Intake: provides recording (evidence: `README.md`)
- Location and Time → Observation Intake: provides context (evidence: `README.md`)
- Observation Intake → Observation Analysis: processes input (evidence: `README.md`)
- Observation Analysis → Gemma 4: analyzes observation (evidence: `README.md`)
- Gemma 4 → Structured Observation: extracts and classifies (evidence: `README.md`)
- Structured Observation → Candidate Retrieval: retrieves candidates (evidence: `README.md`)
- Candidate Retrieval → Relationship Analysis: supplies candidates (evidence: `README.md`)
- Relationship Analysis → Gemma 4: compares relationships (evidence: `README.md`)
- Relationship Analysis → Incident Records: updates or creates (evidence: `README.md`)
- Structured Observation → Evidence and Timeline: preserves report (evidence: `README.md`)
- Incident Records → Evidence and Timeline: maintains timeline (evidence: `README.md`)
- Incident Records → Incident Summary: summarizes incident (evidence: `README.md`)
- Evidence and Timeline → Incident Dashboard: presents evidence (evidence: `README.md`)
- Incident Summary → Incident Dashboard: presents summary (evidence: `README.md`)
- Incident Dashboard → Analyst or Responder: supports review (evidence: `README.md`)
