KeyForge Architecture Documentation

Status: World Class Version: 4.0

This directory contains the definitive architectural models for the KeyForge system.

The Static View (Structure)

• 01_DOMAIN_DICTIONARY.md - The Ubiquitous Language (Nouns).
• 02_ENTITY_RELATIONSHIPS.md - Class Diagrams & Aggregates.
• 03_SYSTEM_CONTEXT.md - Crate Dependencies (C4 Level 1).

The Dynamic View (Behavior)

• 04_DATA_FLOW.md - Sequence Diagrams (Success & Error Flows).
• 05_DESIGN_PATTERNS.md - Vertical Slices, Humble Object, etc.
• 06_API_SURFACE.md - REST Contract.
• 12_STATE_MODELS.md - Finite State Machines.

The Operational View (Reliability)

• 07_FAILURE_MODES.md - Failure Analysis.
• 08_SECURITY_MODEL.md - Trust & Auth.
• 09_DECISION_RECORDS.md - ADRs.
• 13_OBSERVABILITY.md - Logging, Metrics, Tracing.
• 14_CONFIGURATION_SCHEMA.md - Tunable parameters.
• 15_OPERATIONAL_STRATEGY.md - Migrations, Secrets, Scaling.
• 16_TESTING_STANDARDS.md - The Oracle, Performance Budgets.