# DairyTrends Report Generator — состояние на 09.06.2026

## Репозитории
- **Генератор**: https://git.zeroday.su/admin/dairy-report-generator → `/var/www/dairy-report-generator/`
- **Next.js приложение**: https://git.zeroday.su/admin/dairynews-nextjs → `/var/www/dairynews/`
- **Сервер**: dev2 (77.222.43.248)

## Что сделано и работает

### 5 графиков (SVG → sharp → PNG → DOCX)

| Файл | Описание | Статус |
|------|----------|--------|
| chart1.js | Линейный: цена + себестоимость + 3 сценария + барчарт маржи | ✅ |
| chart2.js | Две панели: горизонт. бары (красный=переработчик, серый=производитель) + верт. бары объёма | ✅ |
| chart3.js | Горизонт. бары EBITDA, цвет по группе (А=красный, Б=серый, В=красный приглушённый) | ✅ |
| chart4.js | Две панели, серые бары + красный highlight; режим independentScales для регионов | ✅ |
| chart5.js | Группированные бары сценариев, зелёный/красный/серый | ✅ |

### Документ (document.js)
- Обложка: хедер DT, 4 KPI-блока, callout "Главный вывод"
- Раздел 1: Ключевые выводы
- Раздел 2: Введение
- Раздел 3: Методика + Таблица 1 (допущения)
- Раздел 4: Ретроспектива + **Таблица 2** (кварталы 2024/2025/2026) + Рисунок 1
- Раздел 5: Анализ предприятий (5.1 лидеры + Рис.2, 5.2 кластеры + Рис.3, callout разрыв, Рис.4)
- Раздел 6: Прогноз + Рис.5 + **Таблица 3** (3 сценария × 3 квартала + Пр-во тыс.т)
- Раздел 7: Рекомендации (3 аудитории)

### Данные
- **127 недель РФ** + **413 по 8 ФО** с 2024-01-01 по сегодня
- Источник: dn MySQL `region_index` → Prisma `DairyIndex`
- Автосинхронизация: cron пн 06:00 → `scripts/sync-region-index.js`
- `BITRIX_MYSQL_URL=mysql://dt_reader:DT_reader_2026!@188.127.243.10:3306/dn_ru`

### Дизайн
- Единый серо-красный стиль chart4 (серые соседи + красный выбранный субъект)
- Падеж субъекта в текстах: предложный "в Северо-Западном" (через FO_PREP)
- Динамические пороги кластеризации (фикс/квантильный fallback)

### Генерация картинок
- Страница `/admin/content/images`
- gpt-image-2 через aiguoguo199, баланс = лимит − потрачено
- Таймаут nginx 300s (был 504)

## Что нужно сделать (backlog)

1. **Региональный отчёт (не ФО)** — для конкретной области типа Вологды нужны данные надоя (model RegionalIndicator или внешний источник). Сейчас chart4 умеет independentScales=true, но данные надоя в БД нет.
2. **МЗЫ-отчёт** — для хозяйства Агромилк/МЗЫ: надой, поголовье, собственная цена. Нужна своя схема.
3. **Данные 2025 год в Таблице 2** — некоторые кварталы показывают прочерки, т.к. БД заполнена только с dec 2025 для РФ (ФО с 2024). Можно добрать из dn региональных данных.

## Smoke-тест
```bash
cd /var/www/dairynews
bash scripts/smoke-report.sh rf        # РФ
bash scripts/smoke-report.sh fo:СКФО   # Северо-Кавказский
bash scripts/smoke-report.sh fo:СЗФО   # Северо-Западный
bash scripts/smoke-report.sh fo:ПФО    # Приволжский
```

## Ключевые файлы
```
/var/www/dairynews/src/lib/dairytrends-report-config.ts  ← данные, тексты, таблицы
/var/www/dairy-report-generator/src/charts/chart1-5.js   ← SVG-генераторы
/var/www/dairy-report-generator/src/generators/document.js ← сборка DOCX
/var/www/dairynews/scripts/sync-region-index.js           ← cron-синхронизация
```