c4-architecturelisted

<!-- BSV — Brief Skill View | поиск: BSV Скил : c4-architecture TL;DR : 4-уровневая архитектурная документация с Mermaid диаграммами (C4 Model) Вызов : /c4-architecture, /c4, c4 model, architecture diagram НЕ для : Архитектурные решения (→ /architect); код review (→ /reviewer) --> # C4 Architecture — 4-Level Documentation ## Зачем C4 Одна диаграмма не может показать всё. C4 Model (Simon Brown) решает это: - **Non-technical stakeholders** видят только Level 1 (Context) - **Architects** работают с Level 2-3 (Container + Component) - **Developers** используют Level 4 (Code) Каждый уровень — зум в предыдущий. Никакого информационного перегруза. --- ## Level 1 — Context Diagram **Аудитория:** CEO, product managers, external partners — все кто не знает internals. **Что показывает:** Система как чёрный ящик + кто её использует + с чем она интегрируется. **Шаблон:** ```markdown # System Context: [System Name] ## System Overview [1-2 предложения — что делает система для кого] ## Users & Personas | Persona | Role | Key Actions | |---------|------|-------------| | [Human user] | [Role] | [What they do] | | [External system] | [Integration] | [API/data flow] | ## External Dependencies | System | Direction | Protocol | Purpose | |--------|-----------|----------|---------| | [Name] | outbound | REST | [Why] | ## User Journeys ### [Feature]: [Persona] Flow 1. [Step 1] 2. [Step 2] ``` **Mermaid диаграмма:** ```mermaid C4Context title System Context for [System Name] Per