# Обзор продукта

## 1. Краткое описание

ПО «Зеленый робот» — прикладной программный слой для промышленных и отраслевых IoT-решений на базе IOOT PRO. В текущем published срезе продукт объединяет runtime backend, операторский `L1` kiosk на `iT-2110`, сервисный authoring/publish слой и общую телеметрию/событийный контур.

## 2. Проблема

Типичная проблема таких решений — разрыв между уровнями системы: устройства и локальный контроллер живут отдельно, cloud/runtime отдельно, эксплуатационная документация отдельно. В результате сложно:

- одинаково разворачивать контуры `cloud-multi` и `edge-single`;
- переносить shell/policy/runtime-конфигурацию между площадками;
- воспроизводимо проходить rollout, sign-off и promotion `pilot -> production`;
- развивать отрасли без конфликтов с ядром платформы.

## 3. Решение

Единая платформа, которая включает:
- модульную аппаратную и протокольную основу IOOT PRO;
- единый backend-контур со схемами, published `project` contract, monitoring read-model и `/ws`;
- shell-интерфейс для операторов и локальных `L1` панелей;
- отраслевые workspace/модули, использующие общие контракты ядра;
- process tooling для release gate, shell-profile portability, pilot sign-off, observability и fleet rollout.

В продуктовом слое для пользователя особенно важны:

- мониторинг в реальном времени;
- цикл автоматизации объекта;
- контроль действий персонала;
- работа с беспроводными датчиками;
- единый операторский интерфейс `iP-1510` на панели `iT-2110`.

## 4. Что уже закреплено в reference runtime

- `app/context`, `modules/*`, `status/*`, `auth/*`, `operability/*` как базовые runtime-контуры;
- shared SQL persistence/migrations для module install state, shell preferences, burger-menu access, versioned shell-profile snapshot и `site-policy`;
- отрасли `poultry`, `melioration`, `swine`, `weighbridge` с формализованными границами `tenant_id / industry_code / site_id`;
- отдельный zero-operator пакет `weighbridge` с runtime-модулями `weighbridge-session`, `weighbridge-identity`, `weighbridge-media`, `weighbridge-alarms` и соседним ANPR/device слоем в `../ioot-pro-anpr`;
- pilot/fleet tooling: bootstrap package, evidence bundle, rollback drill, sign-off, retention, promotion gate, rollout registry, incident handover, immutability policy.

## 5. Целевая аудитория

- команды, которые строят вертикальные решения на базе Green Robot / IOOT PRO;
- эксплуатационные и сервисные группы, которым нужен воспроизводимый rollout и handover;
- интеграторы и продуктовые команды, запускающие отраслевые контуры поверх общего ядра;
- команды, которые синхронизируют authoring/runtime/UI цепочку `iP-1220 -> green-robot-go -> iP-1510`.

## 6. Основные ценности

- единый путь от модульного MVP к pilot и multi-site rollout;
- общие контракты и policy-модель для разных отраслей и площадок;
- эксплуатационная воспроизводимость: sign-off, retention, observability, promotion checks;
- снижение фрагментации между документацией, runtime и процессами поставки.