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

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

Документ для пилотной эксплуатации 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.

Содержание