# Self-Learning Changelog
**Файл:** Журнал изменений self-learning инструкций  
**Создан:** 2026-02-17

---

## [1.0.0] — 2026-02-17

### Создана первая версия `dashboard-generation-guide.md`

**Источник обучения:** 4 попытки генерации дашбордов (Нейротест, Нейро v2, v3, v4)

**Ключевые уроки:**

#### 🔴 Критические ошибки (повторялись на каждой странице)
1. **Дублирование заголовков** — `title` в chart config не был пустым, дублировался с widget title на dashboard. Обнаружено на всех 4 страницах, исправлено на v2 после первого аудита.
2. **showLabels: true на перегруженных графиках** — подписи значений налезали друг на друга при >7 категориях. Особенно критично на "Цена за м² по ЖК" (18 ЖК).
3. **Забыл выдать права** — Нейро v2 не открывался, редирект на первый таб. Добавил в чеклист.

#### 🟡 Существенные проблемы
4. **Фильтр расторжений на уровне карточки** — показывал 208 (все записи) вместо фильтрованных. Фильтры должны быть в `dataSettings` каждого value элемента.
5. **Sunburst/treemap в 2-col** — слишком сжаты, текст обрезается. Только 1-col.
6. **Хаотичная цветовая палитра** — каждая карточка разного цвета без системы.
7. **compactNumbers** использует латинские суффиксы — системное ограничение.

#### 🟢 Что работало хорошо
8. **Container-based сложные карточки** (v4) — text+value пары с единым spacing 45px.
9. **Info panel на sunburst** — 16 строк с формулами, dividers, variables.
10. **Фильтры** — стандартная структура filterConfig работает стабильно.
11. **3-col layout для сложных KPI** — оптимальная ширина 500px.

#### 📝 Добавлено в guide
- Чеклист из 9 пунктов перед созданием
- Таблица проверенных layout-комбинаций
- Шаблоны JSON для простых и сложных карточек
- Таблица цветовых тем
- Список известных ограничений платформы
- Метрики прогресса (UX scores)

#### 🔧 Технические заметки
- Puppeteer не рендерит тяжёлые страницы (3D + sunburst с panel) — timeout 8000ms недостаточен
- Токен авторизации протухает между скриншотами — нужно получать свежий
- `ON CONFLICT DO NOTHING` для permissions предотвращает дубли

---

### Формат будущих записей:

```markdown
## [X.Y.Z] — YYYY-MM-DD

### Что изменилось в guide
- ...

### Источник обучения
- (какая задача/ошибка привела к обновлению)

### Новые правила/шаблоны
- ...
```