# Пилотный регламент

Документ для пилотной эксплуатации poultry-объекта на площадке.

Дата версии: `2026-03-06`.

## 1. Контур пилота

- Уровень развёртывания: `site/cabinet` (одна активная отрасль).
- Отрасль: `poultry`.
- Подтипы: `poultry.broiler`, `poultry.layer`.
- Базовые модули пилота:
  - `poultry-climate`
  - `poultry-flock`
  - `poultry-feedwater`
  - `poultry-production`
  - `poultry-alarms`
  - `status` (bridge критических тревог)

## 2. Подготовка перед запуском

1. Проверить контекст:
   - `GET /api/v1/app/context`
   - `industry_code=poultry`
   - корректные `tenant_id`/`site_id`
2. Проверить установку модулей:
   - `GET /api/v1/modules/list?industry_code=poultry&site_id=<site_id>`
3. Проверить site-policy:
   - `GET /api/v1/modules/site-policy/list?site_id=<site_id>`
4. Проверить опубликованные профили:
   - `GET /api/v1/poultry-climate/list?state=published`
   - `GET /api/v1/poultry-feedwater/list?state=published`
5. Проверить доступность alarm/status-контуров:
   - `GET /api/v1/poultry-alarms/list?limit=1`
   - `GET /api/v1/status/list?limit=1`

## 3. Ежедневный операционный цикл

### 3.1. Старт смены

1. Проверить активные партии:
   - `GET /api/v1/poultry-flock/list?status=active`
2. Проверить активные возрастные фазы:
   - `GET /api/v1/poultry-climate/list?batch_id=<batch_id>&current_age_days=<N>&age_mode=active`
3. Проверить последние telemetry/ingest:
   - `POST /api/v1/poultry-climate/commands/telemetry` (контрольный heartbeat)
   - `POST /api/v1/poultry-climate/sensors/commands/ingest` (датчики T/RH/pressure/gas)
   - `POST /api/v1/poultry-feedwater/commands/ingest` (feed/water counters)

### 3.2. В течение смены

1. Для корректировки профиля:
   - `POST /api/v1/poultry-climate/commands/setpoint`
   - `POST /api/v1/poultry-climate/commands/ack`
2. Для диагностики тревог по telemetry:
   - `POST /api/v1/poultry-alarms/commands/evaluate`
3. Для подтверждения/эскалации:
   - `POST /api/v1/poultry-alarms/commands/ack`
   - `POST /api/v1/poultry-alarms/commands/escalate`

### 3.3. Закрытие смены

1. Проверить KPI:
   - `GET /api/v1/poultry-production/kpi?window_days=7`
2. Проверить отклонения feed/water:
   - `GET /api/v1/poultry-feedwater/list?limit=50`
   - Контроль полей: `operational_status`, `*_deviation_pct`, `anomaly_flags`, `last_counter_at`
3. Проверить трассировку критических событий:
   - `GET /api/v1/poultry-alarms/list?severity=critical`
   - `GET /api/v1/status/list` (по `correlation_id`)

## 4. Реакция на инциденты

### 4.1. Критический микроклимат (`critical/high`)

1. Выполнить `POST /api/v1/poultry-alarms/commands/evaluate` с текущей telemetry.
2. Проверить, что событие появилось в:
   - `poultry-alarms` (детальный контур),
   - `status` (bridge).
3. Назначить ответственного и подтвердить:
   - `POST /api/v1/poultry-alarms/commands/ack`
4. Если SLA нарушен, выполнить:
   - `POST /api/v1/poultry-alarms/commands/escalate`

### 4.2. Отклонения по корму/воде

1. Подать counters:
   - `POST /api/v1/poultry-feedwater/commands/ingest`
2. При `status=warn|alarm`:
   - проверить `anomaly_flags` и `*_deviation_pct`,
   - запустить `poultry-alarms/evaluate` с `water_deviation_pct`/`feed_deviation_pct`,
   - зафиксировать действие оператора через `ack`.

## 5. Нормативы и rollback

1. Экспорт нормативов:
   - `POST /api/v1/poultry-profiles/commands/export-yaml`
2. Импорт в другое хозяйство:
   - `POST /api/v1/poultry-profiles/commands/import-yaml`
3. Публикация новой версии:
   - `POST /api/v1/poultry-profiles/commands/publish`
4. Откат:
   - `POST /api/v1/poultry-profiles/commands/rollback`

## 6. Критерии готовности пилота

- Все poultry-модули установлены и доступны по site-policy.
- Age-phase микроклимат подтвержден тестом и e2e-сценарием.
- Критические тревоги и SLA-эскалация подтверждены.
- KPI и эксплуатационные отклонения трассируются сквозно.
- Операторы используют единый порядок действий по разделам 3-5.