SYSTEM DIAGRAMS

Visual Documentation of WINDI Architecture

REFERENCE COLLECTION
"Visual clarity enables governance transparency."
— WINDI Documentation Principle
Diagram 1

Three Dragons Protocol

The coordination model for AI-assisted governance with distinct roles and responsibilities.

flowchart TB subgraph HUMAN["Human Authority"] HV["Human Volante
(Decision Maker)"] end subgraph DRAGONS["Three Dragons"] G["🐉 Guardian
Governance & Priority"] A["🐉 Architect
Structure & Design"] W["🐉 Witness
Validation & Audit"] end HV -->|"Commands"| DRAGONS G -->|"Advises"| HV A -->|"Proposes"| HV W -->|"Validates"| HV G <-->|"Coordinates"| A A <-->|"Reviews"| W W <-->|"Confirms"| G
Diagram 2

Human-in-the-Loop Workflow

Every system operation requires human initiation, review, and approval.

sequenceDiagram participant H as Human Operator participant S as WINDI System participant V as Validation Gate participant O as Output H->>S: 1. Initiate Task S->>S: 2. Process Request S->>H: 3. Present Draft H->>H: 4. Review & Evaluate alt Approved H->>V: 5a. Approve V->>O: 6. Release else Revision Needed H->>S: 5b. Request Changes S->>H: Return to Step 3 else Rejected H->>H: 5c. Discard end Note over H,O: Human approval required at every step
Diagram 3

System Architecture

Three-layer separation ensuring governance, processing, and infrastructure integrity.

flowchart TB subgraph INTERACTION["Interaction Layer"] UI["A4 Desk BABEL"] CHAT["Chat Interface"] EDITOR["Document Editor"] end subgraph PROCESSING["Processing Layer"] CORE["WINDI Core"] VALID["Constitutional Validator"] AGENT["WINDI Agent"] end subgraph INFRA["Infrastructure Layer"] DB["Database"] LEDGER["Governance Ledger"] BACKUP["Backup System"] end INTERACTION --> PROCESSING PROCESSING --> INFRA VALID -->|"Compliance Check"| CORE LEDGER -->|"Audit Trail"| VALID
Diagram 4

The Eight Invariantes

Constitutional principles that cannot be violated under any circumstances.

mindmap root((INVARIANTES)) Soberania Human authority AI serves only Non-Opacity Visible processes No hidden operations Transparência Audit trails Documented reasoning Jurisdição Defined scope Clear boundaries No Fabrication Verified facts only No invention Conflict Structuring Explicit handling Documented resolution Institutional Formal standards Professional conduct No Depth Punishment Consistent behavior Fair treatment
Diagram 5

Escalation Model

When uncertainty arises, institutional caution takes precedence over speed.

flowchart TD ISSUE["⚠️ Issue Detected"] ISSUE --> PAUSE["Operator: PAUSE"] PAUSE --> ESCALATE["Escalate to Guardian"] ESCALATE --> ASSESS{"Assessment"} ASSESS -->|"Technical"| ARCHITECT["Architect Review"] ASSESS -->|"Governance"| GUARDIAN["Guardian Decision"] ASSESS -->|"Operational"| OPERATOR["Operator Adjustment"] ARCHITECT --> RESOLVE["✓ Resolution"] GUARDIAN --> RESOLVE OPERATOR --> RESOLVE RESOLVE --> RESUME["Resume Operations"]
Diagram 6

Document Lifecycle

From creation to verified institutional output.

flowchart LR CREATE["Create"] --> EDIT["Edit"] EDIT --> REVIEW["Human Review"] REVIEW --> APPROVE{"Approved?"} APPROVE -->|"Yes"| SIGN["Generate Receipt"] APPROVE -->|"No"| EDIT SIGN --> EXPORT["Export PDF"] EXPORT --> VERIFY["QR Verification"] VERIFY --> ARCHIVE["Governance Ledger"]