---
name: report-design
description: Проектирование макета PRD или Product Review Deck — структура, навигация, визуальная иерархия
---
# Report Design — Проектирование макета PRD / Product Review Deck

## Когда использовать
- При подготовке **финального PRD** или **Product Review Deck** (Сессия 6 Full Pipeline A/B).
- При необходимости **спроектировать структуру** PDF-документа: какие секции, какие визуализации, какая иерархия.
- При создании **design specification** для передачи Layouter'у.
- При проектировании **executive summary** на основе Unified Strategy Brief (Mediator synthesis) или утверждённого scope.
- При определении **цветовой палитры** и **визуальной иерархии** для PRD-документа (B2B SaaS обычно sober, data-driven tone).

## Вход

| Поле | Обязательно | Описание |
|------|:-----------:|----------|
| Mediator synthesis | ✅ | Unified Strategy Brief (Full A) или Final Scope Decision (Full B) |
| PRD (из PM-SPEC) | ✅ | User stories, AC, NFR, success metrics, risks, rollout |
| Отчёт Team Beta | ⬚ | Альтернативное исследование, критика, стратегия (Full Pipeline) |
| Interview Brief | ✅ | Тема, scope, ограничения, целевая аудитория |
| Appendix D (Synthesis) | ⬚ | Объединённые выводы (если одобрен) |
| Целевая аудитория | ✅ | CEO / инвестор / операционная команда / внешний клиент |
| Предпочтения по стилю | ⬚ | Корпоративный брендбук, цвета, шрифты |

> Если обязательные поля не предоставлены — **запросить у пользователя** до начала работы. Не генерировать заглушки.

## Источники данных
1. session-1-handoff.md — Interview Brief с scope и ограничениями.
2. session-2-handoff.md — Alpha Report с findings и фреймворками.
3. session-3-handoff.md — Beta Report с критикой и альтернативой.
4. session-4-handoff.md — Mediated Conclusion с финальным вердиктом.
5. Пользовательские предпочтения — аудитория, стиль, формат.

### Связь с другими скилами
| Скил | Взаимодействие | Когда |
|------|----------------|-------|
| `$html-pdf-report` | Главный получатель: Report Design Spec → Layouter реализует в HTML/CSS/Chart.js | После завершения дизайна (шаг 7) |
| `$gates` (DS-01) | Проверка готовности design spec перед передачей Layouter | После шага 7 |
| `$handoff` | Передача design spec через handoff envelope | После gate check |
| `$board` | Обновление статуса DS-01 | После передачи |
| Фреймворк-скилы | Шаблоны вывода фреймворков (SWOT, BCG, Ansoff и т.д.) → определяют тип визуализации | Шаг 3: выбор визуализаций |

## Протокол

### Шаг 0 — Clarification
1. Уточнить целевую аудиторию отчёта.
2. Узнать о наличии корпоративного стиля / брендбука.
3. Определить уровень детализации:

   | Аудитория | Уровень | Объём | Фокус |
   |-----------|---------|-------|-------|
   | CEO / инвестор | Executive | 8-12 стр. | Вердикт, метрики, рекомендации |
   | Операционная команда | Detailed | 15-25 стр. | Данные, методология, action plan |
   | Внешний клиент | Presentable | 10-15 стр. | Findings, визуализации, рекомендации |

4. Уточнить формат (A4 portrait, количество страниц).
5. Зафиксировать предпочтения по визуализациям.

### Шаг 1 — Инвентаризация контента
1. Пройти все входные артефакты последовательно.
2. Для каждого элемента зафиксировать:

   | Источник | Элемент | Тип данных | Важность | Рекомендация |
   |----------|---------|:----------:|:----------:|-------------|
   | PRD | Problem + TL;DR | Текст | Критический | Обложка + Резюме для руководства |
   | Mediator synthesis | Unified vision + NSM | Текст + метрика | Критический | Pull quote + Резюме для руководства |
   | PRD / PM-SPEC | User stories + AC (top 5) | Таблица | Критический | Таблица stories + Appendix A |
   | PM / RICE | Prioritized backlog | Таблица оценок | Важный | Bar chart + раздел Backlog |
   | Strategy / Roadmap | Now/Next/Later | Timeline | Важный | Визуализация roadmap |
   | Data Analyst | Metric tree + targets | Диаграмма + числа | Критический | Диаграмма metric tree |
   | Tech Lead | Risk register (top 5) | Таблица | Важный | Раздел рисков |
   | Strategy Briefs Alpha+Beta (Full A) | Отклонённые пути | Текст | Вспомогательный | Appendix B (обоснование синтеза) |

3. Подсчитать: сколько Critical / Important / Supporting элементов.
4. Отметить точки данных, требующие визуализации.
5. Отметить текстовые блоки для callout boxes и pull quotes.

### Шаг 2 — Структура отчёта
1. Определить секции:

   | # | Секция | Стр. | Содержание | Разрыв страницы |
   |---|--------|:----:|------------|:----------:|
   | 1 | Титульная страница | 1 | Название, дата, аудитория, логотип | После |
   | 2 | Оглавление | 1 | Автогенерация из секций | После |
   | 3 | Резюме для руководства | 1-1.5 | Вердикт, выводы, рекомендации | После |
   | 4 | Main: Вердикт и метрики | 2-3 | Ключевые данные, scoring | — |
   | 5 | Main: Стратегия и roadmap | 2-3 | Рекомендации, дорожная карта | — |
   | 6 | Main: Детальный анализ | 3-5 | Фреймворки, таблицы | — |
   | 7 | Appendix A: Alpha Report | 3-5 | Полный отчёт Team Alpha | До |
   | 8 | Appendix B: Beta Report | 3-5 | Полный отчёт Team Beta (Full) | До |
   | 9 | Appendix C: Mediator Reasoning | 1-2 | Обоснование вердикта | До |
   | 10 | Appendix D: Sources | 1-2 | Все источники с датами | До |

2. Для Quick Pipeline: убрать Appendix B, секции 4-6 сократить.
3. Назначить page breaks между секциями.

### Шаг 3 — Выбор визуализаций

**Decision tree: тип данных → визуализация:**

| Тип данных | Визуализация | Инструмент | Пример |
|------------|-------------|------------|--------|
| Сравнение N значений | **Bar chart** (вертикальный) | Chart.js | Threat Score конкурентов |
| Тренд / динамика | **Line chart** | Chart.js | Retention curves, выручка по месяцам |
| Доли / распределение | **Doughnut / Pie** | Chart.js | Доли рынка, распределение бюджета |
| Мультикритериальное сравнение | **Radar chart** | Chart.js | Сравнение конкурентов по 6+ осям |
| Позиционирование 2D | **Scatter chart** | Chart.js | Карта позиционирования |
| Матрица 2×2 | **CSS Grid matrix** | HTML/CSS | SWOT, BCG, Ansoff, Impact×Effort |
| Процесс / поток | **Flowchart** | Mermaid | Customer journey, пайплайн |
| Иерархия / структура | **Mindmap** | Mermaid | Стратегия роста, организационная карта |
| Приоритизация 2D | **Quadrant chart** | Mermaid | Importance×Satisfaction, Impact×Effort |
| Детальное сравнение | **HTML table** | HTML/CSS | Матрица функционала, scoring |
| Ключевой вывод | **Callout box** | HTML/CSS | Critical finding, риск, рекомендация |
| Цитата / вердикт | **Pull quote** | HTML/CSS | Финальный вердикт Медиатора |
| Единичная метрика | **Score badge** | HTML/CSS | NPS, Threat Score, Opportunity Score |

**Правила:**
- Максимум **3 визуализации на страницу**.
- Каждая визуализация имеет `<figcaption>` (подпись) и `aria-label` (accessibility).
- Фреймворк-скилы определяют структуру данных → Дизайнер выбирает визуальную форму.

### Шаг 4 — Визуальная иерархия
1. Определить 4 уровня emphasis:

   | Уровень | Элементы | Размещение | CSS-приём |
   |---------|----------|------------|-----------|
   | **Hero** | Вердикт, главная рекомендация | Exec Summary, начало Main | Pull quote, крупный шрифт (14-16pt), accent цвет |
   | **Key Finding** | ТОП-3 ключевых вывода, критические метрики | Основная секция | Callout box, score badge, bold |
   | **Supporting** | Данные, фреймворки, таблицы | Main + Appendices | Стандартный шрифт, data tables |
   | **Background** | Методология, источники, детали | Appendices | Мелкий шрифт (9-10pt), приглушённый цвет |

2. Индикаторы критичности:

   | Критичность | Цвет | Использование |
   |----------|------|---------------|
   | Критический / Негативный | `var(--danger)` красный | Риски, угрозы, blockers |
   | Предупреждение / Внимание | `var(--warning)` оранжевый | Ограничения, ⚠️ данные |
   | Позитивный / Возможность | `var(--success)` зелёный | Возможности, сильные стороны |
   | Нейтральный / Информация | `var(--accent)` синий | Контекст, нейтральные данные |

3. Для каждой секции — назначить emphasis level.

### Шаг 5 — Цветовая палитра
1. Если есть брендбук — адаптировать под корпоративные цвета.
2. Если нет — использовать дефолтную профессиональную палитру:

   **Дефолтная палитра (тёмно-синяя основа):**

   | Variable | HEX | Использование |
   |----------|-----|---------------|
   | `--primary` | `#1a1a2e` | Заголовки, header таблиц, основной текст |
   | `--secondary` | `#16213e` | Подзаголовки, h3 |
   | `--accent` | `#0f3460` | Ссылки, callout info, нейтральные акценты |
   | `--highlight` | `#e94560` | Ключевые метрики, hero-элементы |
   | `--success` | `#2ecc71` | Позитивные индикаторы, возможности |
   | `--warning` | `#f39c12` | Предупреждения, ⚠️ данные |
   | `--danger` | `#e74c3c` | Риски, угрозы, критические |
   | `--bg-light` | `#f5f5f5` | Фон callout, alternating rows |
   | `--border` | `#e0e0e0` | Границы таблиц, разделители |
   | `--text` | `#1a1a2e` | Основной текст |
   | `--muted` | `#666666` | Подписи, мелкий текст, источники |

   **Chart.js палитра (6 серий):**
   `['#1a1a2e', '#0f3460', '#e94560', '#2ecc71', '#f39c12', '#9b59b6']`

3. Проверить:
   - Контрастность WCAG AA: текст на фоне ≥ 4.5:1.
   - Различимость в ч/б печати: каждый цвет различим в greyscale.
   - Цветовая слепота: не полагаться только на красный/зелёный — добавлять иконки/текст.

### Шаг 6 — Executive Summary
1. Написать черновик на основе заключения Медиатора.
2. Структура:

   ```
   ## Executive Summary

   ### Контекст
   [1-2 предложения: что анализировалось, для кого, в каком scope]

   ### Методология
   [1-2 предложения: какие фреймворки, сколько источников, adversarial подход]

   ### Ключевые выводы

   > «[Главный вердикт Медиатора — pull quote]»

   1. **[Finding 1]:** [описание + ключевая метрика]
   2. **[Finding 2]:** [описание + ключевая метрика]
   3. **[Finding 3]:** [описание + ключевая метрика]

   ### Рекомендация
   [1-2 предложения: что делать, какой приоритет]

   ### Риски
   [1-2 предложения: основные ограничения и риски]

   ### Следующие шаги
   [Bulleted list: 3-5 конкретных действий]
   ```

3. Объём: **максимум 1.5 страницы A4**.
4. Язык: чёткий, без жаргона, адаптированный под аудиторию.
5. Каждый finding подкреплён числом или фактом (не «рынок растёт», а «TAM $4.2B, CAGR 18%»).

### Шаг 7 — Report Design Spec (финальный deliverable)
1. Заполнить полную спецификацию (см. шаблон вывода).
2. Приложить:
   - Content Inventory (шаг 1)
   - Report Structure (шаг 2)
   - Visualization Map (шаг 3)
   - Color Palette (шаг 5)
   - Executive Summary Draft (шаг 6)
3. Передать Верстальщику через `$handoff`.

## Пример — TeamFlow Product Review Deck для exec review

**Контекст:** TeamFlow (B2B SaaS HR-tech, $8M ARR). Инициатива: AI-powered 1:1 summarization. Full Pipeline A завершён, готовим Product Review Deck для CEO / CRO / VP Eng review. Уровень: Executive (12 слайдов).

### Content Inventory (фрагмент)

| Источник | Элемент | Тип | Важность | Визуализация |
|----------|---------|:---:|:----------:|-------------|
| Mediator synthesis | Vision: «Помочь компаниям измеримо повысить эффективность менеджеров через AI-assisted 1:1s» | Текст | Критический | Pull quote (Слайд 3) |
| Mediator / Data Analyst | NSM: «weekly 1:1s with AI summary used» target 50% в 90 дн | Метрика | Критический | Metric tree + target gauge |
| PM / RICE | Топ-7 приоритизированных user stories | Таблица оценок | Критический | Backlog bar chart |
| Alpha/AN-01 | SWOT-матрица | 2×2 | Important | CSS Matrix |
| Beta/AN-02 | Альтернативный Porter's 5 Forces | Scoring 1-5 | Supporting | Radar chart |
| Mediator | Итоговый scoring Alpha vs Beta | Scoring | Critical | Table + badge |

**Всего:** 28 элементов (8 Critical, 12 Important, 8 Supporting).

### Report Structure

| # | Секция | Стр. | Визуализации | Emphasis |
|---|--------|:----:|:------------:|:--------:|
| 1 | Title Page | 1 | — | Hero |
| 2 | TOC | 0.5 | — | — |
| 3 | Executive Summary | 1.5 | 1 pull quote, 1 callout | Hero |
| 4 | Рынок и конкуренция | 2 | Bar (TAM), Radar (конкуренты), Table (threat) | Key Finding |
| 5 | Стратегия и roadmap | 1.5 | Mindmap (стратегия), Table (actions) | Key Finding |
| 6 | Appendix A: Alpha | 2 | SWOT matrix, Table | Supporting |
| 7 | Appendix B: Beta | 1.5 | Porter's radar | Supporting |
| 8 | Appendix C: Mediator | 1 | Scoring table | Background |
| 9 | Appendix D: Sources | 1 | — | Background |

**Итого:** ~12 страниц, 9 визуализаций.

### Visualization Map (фрагмент)

| # | Секция | Данные | Тип | Инструмент |
|---|--------|--------|-----|------------|
| 1 | Exec Summary | Вердикт Медиатора | Pull quote | HTML/CSS |
| 2 | Рынок | TAM $4.2B, SAM $1.8B, SOM $180M | Bar chart | Chart.js |
| 3 | Конкуренция | Threat Score: Skillbox 7.2, Нетология 6.8, Яндекс 7.6 | Bar chart | Chart.js |
| 4 | Конкуренция | 6 осей сравнения конкурентов | Radar | Chart.js |
| 5 | Стратегия | Дерево стратегии роста | Mindmap | Mermaid |
| 6 | App. A | SWOT S/W/O/T | 2×2 matrix | CSS Grid |

## Валидация (Quality Gate)

- [ ] Content Inventory полный: каждый элемент из входных артефактов учтён
- [ ] Каждая числовая точка данных имеет назначенный тип визуализации (по decision tree)
- [ ] Структура отчёта полная (Title → TOC → Summary → Main → Appendices)
- [ ] Executive Summary ≤ 1.5 стр., содержит: контекст, методологию, 3-5 findings с числами, рекомендацию
- [ ] Визуальная иерархия определена (4 уровня emphasis) и назначена секциям
- [ ] Палитра определена (11 CSS variables), проверена на контрастность WCAG AA и ч/б различимость
- [ ] Chart.js палитра определена (6 серий)
- [ ] Максимум 3 визуализации на страницу
- [ ] Report Design Spec заполнен полностью (structure + visualization map + palette + exec summary)
- [ ] Brief compliance: отчёт отвечает на вопросы из Interview Brief
- [ ] Appendix D (Sources) включён / исключён осознанно
- [ ] Каждая визуализация имеет подпись (`figcaption`) и `aria-label`

## Handoff
Результат `$report-design` является входом для:
- **`$html-pdf-report`** (Layouter) — главный получатель: реализация в HTML/CSS/Chart.js/Mermaid.
- **`$gates` (DS-01)** — проверка готовности design spec.
- **`$board`** — обновление статуса DS-01.

Формат передачи: Report Design Spec (structure + content inventory + visualization map + color palette + executive summary draft). При передаче — использовать `$handoff`.

## Anti-patterns

| Ошибка | Почему плохо | Как правильно |
|--------|-------------|---------------|
| Дизайн без инвентаризации | Пустые секции, лишние графики | Сначала пройти все артефакты, создать реестр |
| Один тип графика на всё | Неинформативно, не подходит под тип данных | Decision tree: тип данных → визуализация |
| Executive summary > 2 стр. | Руководитель не читает | Максимум 1.5 страницы, факты с числами |
| Палитра для экрана | В PDF серо и неразличимо | WCAG AA, ч/б различимость, тест цветовой слепоты |
| Перегруженные страницы | Каша из графиков | Максимум 3 визуализации на страницу |
| Изменение выводов | Нарушение chain of custody: Дизайнер не аналитик | Оформлять, не редактировать содержание |
| Findings без чисел | «Рынок растёт» — не finding | Каждый finding = конкретная метрика: «TAM $4.2B, CAGR 18%» |
| Палитра без HEX-кодов | Layouter не может реализовать «тёмно-синяя основа» | 11 CSS variables с конкретными HEX |

## Шаблон вывода

```
## Report Design Spec: [Тема отчёта]
**Аудитория:** [CEO / инвестор / опер. команда / внешний клиент]
**Уровень:** [Executive / Detailed / Presentable]
**Режим:** Full / Quick
**Страниц:** ~[N]
**Дата:** [дата]

---

### Content Inventory

| Источник | Элемент | Тип данных | Importance | Рекомендация |
|----------|---------|:----------:|:----------:|-------------|
| [Источник] | [Элемент] | [Число/Текст/Фреймворк/Scoring] | Critical/Important/Supporting | [Визуализация / секция] |

**Итого:** [N] элементов ([N] Critical, [N] Important, [N] Supporting)

---

### Report Structure

| # | Секция | Стр. | Визуализации | Emphasis | Page Break |
|---|--------|:----:|:------------:|:--------:|:----------:|
| 1 | Title Page | 1 | — | Hero | After |
| 2 | TOC | 0.5-1 | — | — | After |
| 3 | Executive Summary | 1-1.5 | [N]: [типы] | Hero | After |
| 4 | Main: [Название] | [N] | [N]: [типы] | Key Finding | — |
| 5 | Main: [Название] | [N] | [N]: [типы] | Key Finding | — |
| 6 | Appendix A: Alpha | [N] | [N]: [типы] | Supporting | Before |
| 7 | Appendix B: Beta | [N] | [N]: [типы] | Supporting | Before |
| 8 | Appendix C: Mediator | [N] | [N]: [типы] | Background | Before |
| 9 | Appendix D: Sources | [N] | — | Background | Before |

---

### Visualization Map

| # | Секция | Данные | Тип визуализации | Инструмент | Подпись (figcaption) |
|---|--------|--------|:----------------:|:----------:|---------------------|
| 1 | [Секция] | [Какие данные] | [Bar/Line/Radar/...] | Chart.js / Mermaid / CSS | «Рис. N — [описание]» |

---

### Color Palette

| Variable | HEX | Использование |
|----------|-----|---------------|
| --primary | #XXXXXX | Заголовки, header таблиц |
| --secondary | #XXXXXX | Подзаголовки |
| --accent | #XXXXXX | Ссылки, callout info |
| --highlight | #XXXXXX | Ключевые метрики |
| --success | #XXXXXX | Позитивные индикаторы |
| --warning | #XXXXXX | Предупреждения |
| --danger | #XXXXXX | Риски, критические |
| --bg-light | #XXXXXX | Фон callout, alternating rows |
| --border | #XXXXXX | Границы |
| --text | #XXXXXX | Основной текст |
| --muted | #XXXXXX | Подписи, мелкий текст |

**Chart.js серии:** ['#XXXXXX', '#XXXXXX', '#XXXXXX', '#XXXXXX', '#XXXXXX', '#XXXXXX']

**Проверки:** WCAG AA ✅ / ⚠️ | ч/б различимость ✅ / ⚠️ | Цветовая слепота ✅ / ⚠️

---

### Executive Summary (Draft)

## Executive Summary

### Контекст
[1-2 предложения: что анализировалось, для кого, scope]

### Методология
[1-2 предложения: фреймворки, источники, adversarial подход]

### Ключевые выводы

> «[Главный вердикт Медиатора]»

1. **[Finding 1]:** [описание + метрика]
2. **[Finding 2]:** [описание + метрика]
3. **[Finding 3]:** [описание + метрика]

### Рекомендация
[1-2 предложения: что делать]

### Риски
[1-2 предложения: ограничения]

### Следующие шаги
- [Действие 1]
- [Действие 2]
- [Действие 3]

---

### Emphasis Map

| Секция | Emphasis Level | Элементы |
|--------|:-------------:|----------|
| [Секция] | Hero / Key / Supporting / Background | [Какие элементы] |
```

## Worked Example — TeamFlow Product Review Deck Design Spec

**Контекст:** `/ship-right-thing` завершён. Unified Strategy Brief (Mediator) + PRD + Metric Plan готовы. Designer готовит design spec для Layouter — Product Review Deck (12 слайдов, executive-аудитория).

```markdown
# Design Spec: TeamFlow AI Summarization Product Review Deck

**Целевой артефакт:** Product Review Deck (презентация для executive sign-off)
**Уровень аудитории:** Executive (CEO, CPO, VP Sales, VP Product)
**Объём:** 12 страниц в формате слайдов
**Распространение:** PDF по email + живая презентация на review meeting
**Тон:** Сдержанный, профессиональный, ориентированный на данные (см. оси тона GTM brief — 80% serious)

---

## Выбор типа артефакта

**Почему Deck, а не PRD-как-документ:**
- Аудитория = руководители (5-10 минут просмотра; живая презентация 30 минут)
- Требуемое решение = go/no-go sign-off (не справочный материал)
- Ожидание mid-market + enterprise B2B SaaS = визуалы уровня exec

**Вторичный артефакт:** Полный PRD (40+ страниц, формат документа) делается separately for engineering/design team — через отдельный скил `$prd-template`. Deck ссылается на PRD в приложении.

---

## Информационная архитектура (12 страниц)

| # | Страница | Назначение | Акцент | Ключевая визуализация |
|:-:|----------|-----------|:------:|----------------------|
| 1 | Обложка | Привлечь внимание, задать контекст | Hero | Крупный заголовок, подзаголовок, дата |
| 2 | Executive Summary (TL;DR) | 30-секундное чтение даёт полную картину | Hero | Pull quote + 3 KPI-карточки |
| 3 | Проблема | Обозначить срочность с доказательствами | Key | 3 KPI-карточки «масштаб боли» + callouts с дословными цитатами |
| 4 | Возможность | Масштаб приза | Key | Metric tree со стрелками бизнес-влияния |
| 5 | Unified Strategy (синтез Mediator) | Подход | Key | Vision statement + список 4 принципов + диаграмма tier-архитектуры |
| 6 | Product Scope (MoSCoW) | Что входит, что нет | Key | Таблица Must/Should/Could с обоснованием scope |
| 7 | Пользовательский опыт | Ощущение продукта | Supporting | 3-4 вайрфрейм-миниатюры + стрелки флоу |
| 8 | Метрики и NSM | Определение успеха | Key | Metric tree + целевые показатели 30/90 дней |
| 9 | Риски и меры снижения | Доверие | Key | Таблица top 5 рисков с матрицей вероятность × влияние |
| 10 | План rollout | Исполнение | Supporting | Таймлайн по неделям + диаграмма поэтапного rollout |
| 11 | Инвестиции и ROI | Бизнес-кейс | Key | График прогноза 3 сценариев + разбивка затрат |
| 12 | Roadmap Now/Next/Later | Будущее направление | Supporting | 3-колоночный roadmap |

---

## Визуальная иерархия

### Типографическая шкала

| Уровень | Шрифт | Размер | Насыщенность | Использование |
|---------|-------|:------:|:------------:|--------------|
| H1 (заголовок страницы) | Inter | 32px | 700 | Заголовки страниц |
| H2 (раздел) | Inter | 22px | 600 | Разделы внутри страницы |
| H3 (подраздел) | Inter | 16px | 600 | Подразделы |
| Lead (вступительный абзац) | Inter | 16px | 400 | Первый абзац на странице |
| Body | Inter | 14px | 400 | Стандартный текст |
| Pull-quote | Source Serif Pro | 20px | 400 | Ключевые цитаты, vision statements |
| Значение KPI | Inter | 32px | 700 | Крупные числа метрик |
| Подпись KPI | Inter | 11px | 500 | Контекст метрики |
| Caption | Inter | 10px | 400 | Подвалы страниц, атрибуция источников |

### Цветовая палитра

```css
--color-primary: #0A2540;     /* Фирменный тёмно-синий TeamFlow — заголовки, основной акцентный цвет */
--color-accent: #F2A900;      /* Янтарный TeamFlow — выделения, рамки KPI, CTA */
--color-text: #1A1A1A;         /* Основной текст (почти чёрный) */
--color-text-muted: #6B6B6B;   /* Вторичный текст */
--color-bg: #FFFFFF;           /* Фон страницы */
--color-bg-alt: #F7F9FB;       /* Фон callout, чередующиеся строки */
--color-success: #22A06B;      /* Зелёные метрики, позитивные сигналы */
--color-warning: #E67E22;      /* Янтарные предупреждения */
--color-danger: #C0392B;       /* Красные алерты, метрики масштаба боли */
--color-border: #E1E4E8;       /* Деликатные рамки, разделители таблиц */
```

**Обоснование сдержанной палитры:** Executive-аудитория B2B SaaS положительно реагирует на профессиональный, ориентированный на данные стиль. Слишком много цветов → «потребительский» вид. Зелёный / янтарный / красный — только для метрик с эмоциональной нагрузкой.

### Система отступов (сетка 8pt)

- `--space-1: 4px` (плотно — между связанными элементами)
- `--space-2: 8px` (отступ элементов списка)
- `--space-3: 16px` (интервал между абзацами)
- `--space-4: 24px` (между разделами на странице)
- `--space-5: 32px` (между крупными блоками)
- `--space-6: 48px` (редко — шапка страницы / hero)

---

## Ключевые визуализации (детальные спецификации)

### 1. KPI-карточка (страницы 2, 3, 11)

**Анатомия:**
```
┌─────────────────────────────────┐
│ [янтарная левая рамка 3px]       │
│                                  │
│    40               ← крупное    │
│    ────              число       │
│    Target Team Tier  (32px 700)  │
│    Upgrades (Q2)  ← подпись      │
│                      (11px 500)  │
└─────────────────────────────────┘
```

**Правила:**
- Максимум 1 число на карточку
- Подпись максимум 1-2 строки
- Группировать в сетки по 3 (правило трёх)
- Цвет числа по настроению: основной синий (по умолчанию) / зелёный успех / красный опасность

**Примеры для TeamFlow:**
- Страница 2: «40 целевых апгрейдов» / «+$8 надбавка за место» / «3 ч сэкономлено в неделю»
- Страница 3 (боль): «3-4 ч admin/неделю» / «40% action items теряется» / «0% видимости у VP» (все красные)

### 2. Pull Quote (страницы 2, 3, 5)

**Анатомия:**
```
┌──────────────────────────────────────────┐
│▐ «Текст цитаты в Source Serif Pro,       │
│▐  20px, межстрочный 1.4. Привлекает      │
│▐  взгляд, но не слишком крупный.»        │
└──────────────────────────────────────────┘
                        — Атрибуция (12px 400 приглушённый)
```

**Правила:**
- Использовать для ключевого vision statement или дословной цитаты клиента
- Максимум 1-2 на странице
- Строка атрибуции выровнена вправо, приглушённый цвет
- Левая рамка 3px акцентного цвета; фон alt

### 3. Callout Box (все страницы)

**Варианты:**
- Нейтральный (акцентная рамка)
- Успех (зелёная рамка — позитивный сигнал)
- Предупреждение (янтарная рамка — на что обратить внимание)
- Опасность (красная рамка — риск / критическое)

**Анатомия:**
```
┌──────────────────────────────────────────┐
│▐ Ожидаемый результат  ← заголовок 600
│▐ Текст описания, перенос строк...
└──────────────────────────────────────────┘
```

### 4. Metric Tree (страницы 4, 8)

**Анатомия:**
```
         NSM: Sticky Manager Ratio (AI Tier)
         ┌─────────────┼─────────────┐
         ▼             ▼             ▼
    Входные:       Входные:     Ограждения:
  Конверсии        Уровень       NPS, Churn,
  в новый tier     активации     объём Support
```

**Реализация:** SVG (для точности) или Mermaid (для редактируемости). TeamFlow предпочитает SVG из Figma.

### 5. Roadmap Columns (страница 12)

**Анатомия:**
```
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ [accent top] │ │ [accent top] │ │ [accent top] │
│ NOW          │ │ NEXT         │ │ LATER        │
│ (Q2 2026)    │ │ (Q3 2026)    │ │ (Q4+)        │
├─────────────┤ ├─────────────┤ ├─────────────┤
│ ✨ AI Summary│ │ 📊 Dashboard │ │ 🌍 Multi-lang│
│ ✨ Action items│ │ ⏱️ Real-time  │ │ 📱 Mobile app│
│ 🔐 SSO/SCIM  │ │ 🎯 Health Sc.│ │ 🔍 AI Coach  │
└─────────────┘ └─────────────┘ └─────────────┘
```

**Правила:**
- 3-5 элементов в столбце (не перегружать)
- Emoji-префикс как подсказка категории (✨ фича / 🔐 безопасность / 📊 аналитика)
- Вертикальная линия между элементами для удобства сканирования
- Верхняя рамка акцентного цвета поддерживает присутствие бренда

### 6. Матрица рисков (страница 9)

**Реализация:** сетка 2×2, показывающая вероятность × влияние:

```
           НИЗКОЕ ВЛИЯНИЕ     ВЫСОКОЕ ВЛИЯНИЕ
ВЫСОКАЯ  ┌──────────────┬──────────────┐
 ВЕРОЯТ. │ мониторинг    │ ⚠️ ТОП РИСКИ │
         │               │ R1, R2, R3   │
         ├──────────────┼──────────────┤
НИЗКАЯ   │ приемлемо     │ список слежки│
 ВЕРОЯТ. │               │ R4, R5       │
         └──────────────┴──────────────┘
```

**Под матрицей:** детальная таблица top 5 рисков с колонками: #, Риск, Вероятность, Влияние, Меры снижения.

---

## Библиотека компонентов для Layouter

**Файлы:** папка `components/` в design handoff

| Компонент | Файл | Использование |
|-----------|------|--------------|
| `kpi-card.html` | Сниппет | Витрины метрик |
| `pull-quote.html` | Сниппет | Vision statements, цитаты клиентов |
| `callout-[variant].html` | 4 сниппета | Предупреждения, успехи, инфо |
| `roadmap-columns.html` | Сниппет | Только страница 12 |
| `metric-tree.svg` | Ассет | Страницы 4 + 8 |
| `risk-matrix.svg` | Ассет | Страница 9 |
| `page-footer.html` | Сниппет | Все страницы |
| `meta-bar.html` | Сниппет | Все страницы |

---

## Спецификации передачи дизайна Layouter'у

### CSS-токены

Все стили определены как CSS custom properties (см. вывод Layouter'а). Обеспечивают:
- Лёгкую перекраску для white-label
- Единообразие отступов и размеров
- Готовность к тёмной теме в будущем (токены легко переопределяются)

### Спецификации для печати

- `@page { size: A4 portrait; margin: 2cm 1.8cm; }` — стандартный A4
- `.page { page-break-after: always; }` — каждый крупный раздел на отдельной странице
- `page-break-inside: avoid` на таблицах + callouts — предотвращает неудобные разрывы
- `print-color-adjust: exact` — сохраняет фирменные цвета при печати

### Подключение шрифтов

- **Встроенные шрифты** в генерации PDF для единообразия:
  - Inter (все насыщенности): [ссылка Google Fonts CSS — OK для web, но для PDF встраивать WOFF2 локально]
  - Source Serif Pro: аналогично — встраивать для PDF
- **Фолбэки** при отсутствии шрифтов: `-apple-system, sans-serif` (Inter), `Georgia, serif` (Source Serif Pro)

### Пакет ассетов

- Логотип TeamFlow (SVG + PNG 2×)
- Логотипы партнёров (если референсируются кейс-стади): сравнение с Lattice и т.д.
- Иконки (lucide-react или аналог — SVG inline)
- Изображения графиков (экспортированные PNG 2× из Figma для сложных диаграмм)

---

## Требования доступности (WCAG AA)

- **Цветовой контраст:** весь текст ≥ 4.5:1 к фону (проверено: основной синий на белом = 11:1)
- **Семантический HTML:** иерархия `<section>`, `<article>`, `<h1-h6>` корректна
- **Alt text** на всех изображениях и SVG
- **Состояния фокуса** видимы (если deck интерактивен) — не важно для PDF, но важно, если HTML доступен онлайн
- **Подписи для экранных читалок** на статус-бейджах, иконках

---

## Deliverables для Layouter (handoff)

- [x] Этот документ design spec (markdown)
- [x] Файл CSS-токенов (`tokens.css`)
- [x] Папка HTML-сниппетов (`components/`)
- [x] SVG-ассеты (`assets/`)
- [x] Файлы шрифтов (WOFF2 встроенные)
- [x] Справочный лист по цвету / типографике (1-страничный PDF для быстрой справки)
- [x] Figma-файл со всеми макетами экранов (hi-fi, экспортированные страницы) [ссылка]
- [x] Манифест экспорта ассетов (какие изображения в каких размерах)

---

## Требуется согласование

- [ ] PM (Alex K.) — точность содержания
- [ ] Руководитель дизайна (Jordan M.) — визуальные стандарты
- [ ] Бренд-команда — соответствие идентичности TeamFlow
- [ ] Технический руководитель (Priya S.) — осуществимость с точки зрения верстки

Целевая дата согласования: 20 мая 2026. Окно производства верстки: 21 мая — 10 июня. Финальный deck готов к запуску 30 июня.

---

### Сводная карта акцентов (Emphasis Map)

| Страница | Акцент | Элементы |
|:--------:|:------:|----------|
| 1 Обложка | Hero | Заголовок 42px, подзаголовок, акцентная полоса бренда |
| 2 TL;DR | Hero | Pull quote, 3 KPI-карточки, разделители секций |
| 3 Проблема | Key | 3 красных KPI, 2 callout с дословными цитатами |
| 4 Возможность | Key | Metric tree, стрелки влияния |
| 5 Стратегия | Key | Vision quote, tier-архитектура |
| 6 Scope | Key | Таблица MoSCoW, обоснование |
| 7 UX | Supporting | 4 миниатюры вайрфреймов, флоу |
| 8 Метрики | Key | Metric tree (второй), таблица целей |
| 9 Риски | Key | Матрица 2×2 + таблица top 5 |
| 10 Rollout | Supporting | Таймлайн по неделям (плотный, но детальный) |
| 11 Инвестиции | Key | График 3 сценариев, разбивка затрат |
| 12 Roadmap | Supporting | 3 колонки Now/Next/Later |
```

> **Урок report-design:** Design spec = контракт между Designer и Layouter. CSS-токены + библиотека компонентов превращают разовую работу страница за страницей в системную сборку. **Emphasis map** не позволяет всем страницам быть одинаково громкими = информационный шум. Executive-аудитория = сдержанная палитра + плотный, но чистый контент. **Требования доступности** (WCAG AA) — обязательны для mid-market + enterprise закупок; библиотека компонентов повторно используется для будущих decks (Product Review Q3 и т.д.) — инвестиция накапливается.