PLBA2-1. Доработка change

This commit is contained in:
2026-10-10 19:36:16 +03:00
parent c540f591b9
commit 473cde126f
3 changed files with 87 additions and 97 deletions
@@ -1,42 +1,42 @@
# Tasks
## 1. Runtime и идентичность приложения
## 1. Runtime, workers и идентификатор приложения
- [ ] 1.1 Разрешать application_id из `config.yaml`, `pyproject.toml` или UUIDv4 и предоставлять его runtime-контексту по RT.AI-01.FR-01.
- [ ] 1.2 Поддержать уникальные имена, независимое выполнение и состояния workers; запускать только workers без `disabled: true` по RT.WK-01.FR-01–RT.WK-01.FR-02.
- [ ] 1.3 Реализовать запуск приложения и всех включённых workers по RT.AL-01.FR-01; при ошибке фиксировать состояние `failed`.
- [ ] 1.4 Реализовать graceful/force stop workers и групповой результат по RT.WK-02.FR-01–RT.WK-02.FR-02.
- [ ] 1.5 Реализовать остановку приложения с необязательным таймаутом ожидания и status `stopping` по RT.AL-02.FR-01–RT.AL-02.FR-02.
- [ ] 1.6 Реализовать цикл worker, проверку расписания и применение активной конфигурации по RT.WK-03.FR-01–RT.WK-03.FR-02.
- [ ] 1.7 Формировать автоматический health worker, сохранять цикл после исключения, принимать прикладные health-условия и передавать critical по RT.WK-04.FR-01–RT.WK-04.FR-02.
- [x] 1.1 Разрешать `application_id` в порядке `config.yaml` → `[project].name` из `pyproject.toml` → UUIDv4; предоставлять его runtime до запуска зависимых компонентов по RT.AI-01.FR-01.
- [x] 1.2 Реализовать регистрацию workers с уникальными именами и независимыми lifecycle/health; запускать worker при отсутствующем или `false` `disabled`, пропускать при `true`; применять изменение `disabled` при следующем запуске приложения по RT.WK-01.FR-01–RT.WK-01.FR-02.
- [x] 1.3 Реализовать последовательные циклы worker с настройками `interval_seconds` или `pause_seconds`, немедленным первым запуском и проверкой допустимого расписания по RT.WK-03.FR-01–RT.WK-03.FR-02.
- [x] 1.4 Формировать автоматический health worker по результату цикла, продолжать работу после исключения, поддержать прикладную health-логику и признак `critical` по RT.WK-04.FR-01–RT.WK-04.FR-02.
- [x] 1.5 Реализовать graceful/force stop всех запущенных workers и групповые результаты `WORKERS_STOPPED`/`WORKERS_STOPPING` по RT.WK-02.FR-01–RT.WK-02.FR-02.
- [x] 1.6 Реализовать запуск и остановку всего приложения, lifecycle states, необязательный `timeout_seconds` и продолжение остановки после ответа `stopping` по RT.AL-01.FR-01 и RT.AL-02.FR-01–RT.AL-02.FR-02.
## 2. Health и workflow
- [ ] 2.1 Собирать статусы runtime и запущенных workers по HL.AG-01.FR-01–HL.AG-01.FR-02; исключать отключённые workers из health-агрегации и возвращать `stopped` после остановки приложения.
- [ ] 2.2 Сохранить object-based workflow API PLBA v1, явные переходы, snapshots, persistence и передачу ошибок по WF.OR-01.FR-01–WF.OR-01.FR-02.
- [x] 2.1 Формировать отчёт с `application_id`, lifecycle и состояниями запущенных workers/contributors; применить правила criticality, отсутствующих workers и статусов `new`, `starting`, `running`, `stopping`, `stopped`, `failed` по HL.AG-01.FR-01–HL.AG-01.FR-02.
- [x] 2.2 Реализовать object-based workflow с именованными шагами и явными переходами; сохранять начало/итог запуска, шаги, snapshots и ошибки через переданный persistence-контракт; прекращать выполнение после исключения без retry по WF.OR-01.FR-01–WF.OR-01.FR-02.
## 3. Единый HTTP API
- [ ] 3.1 Добавить общий route adapter и отдельные endpoint Requirements с CONTRACT для GET /health, POST /runtime/start, POST /runtime/stop и GET /runtime/status по API.HTTP.CA-01–API.HTTP.CA-05; worker-specific routes не добавлять.
- [ ] 3.2 Подключать все routes к одному host и listener приложения; проверить, что capabilities не создают отдельные порты.
- [ ] 3.3 Делегировать health и lifecycle решения соответствующим contracts; HTTP слой отвечает за маршрутизацию и сериализацию.
- [x] 3.1 Реализовать общий route adapter, подключаемый к host приложения и его listener; не запускать отдельный HTTP server или порт по API.HTTP.CA-01.FR-01.
- [x] 3.2 Реализовать `GET /health` с сериализацией health report и передачей ошибок aggregator согласно API.HTTP.CA-02.
- [x] 3.3 Реализовать `POST /runtime/start` и `GET /runtime/status`, делегируя lifecycle runtime и возвращая описанные status по API.HTTP.CA-03 и API.HTTP.CA-05.
- [x] 3.4 Реализовать `POST /runtime/stop` с валидацией `force` и `timeout_seconds`, HTTP 200/202/400 и ответами `stopped`/`stopping` по API.HTTP.CA-04.
## 4. Конфигурация приложения
## 4. Настройки приложения
- [ ] 4.1 Описать структуру и назначение полей таблицы `settings` по CFG.AS-01.FR-01; сверить её с запросом PostgreSQL-адаптера.
- [ ] 4.2 Зафиксировать создание таблицы и загрузку начальных значений миграциями по CFG.AS-02.FR-01–CFG.AS-02.FR-02; определить обновление runtime-значений владельцем приложения без рестарта.
- [ ] 4.3 Реализовать SettingsReader и PostgreSQL read adapter по CFG.AS-03.FR-01–CFG.AS-03.FR-03; проверить фильтрацию ключа, config_key и is_enabled, порядок sort_order/id и видимость изменения БД при следующем чтении.
- [ ] 4.4 Заменить удалённый ConfigurationSnapshotManager на typed YAML provider для `config.yaml` в корне приложения с общими полями `application_id`, `workers.<worker_name>.disabled` (по умолчанию `false`) и настройками расписания workers по CFG.ACF-01.FR-01–CFG.ACF-01.FR-02; проверить успешную загрузку и блокировку запуска при ошибочном исходном файле.
- [ ] 4.5 Подхватывать изменения `config.yaml` без рестарта по CFG.ACF-02; проверять атомарную замену, сохранение последнего валидного снимка и передачу ошибки при некорректном изменении.
- [x] 4.1 Реализовать и документировать контракт таблицы `settings`: типы, ограничения и назначение полей, индексы, порядок чтения, отсутствие уникальности `setting_key`; зафиксировать роль `setting_value` и `is_enabled` по CFG.AS-01.FR-01.
- [x] 4.2 Документировать границу владения начальными данными: приложение создаёт `settings` и загружает начальные значения своей миграцией; PLBA2 не запускает миграции и не переносит YAML в БД по CFG.AS-02.FR-01–CFG.AS-02.FR-02.
- [x] 4.3 Реализовать типизированный `SettingsReader` и PostgreSQL adapter с чтением из переданных pool и схемы, фильтрами, сортировкой, безопасным именем схемы и результатами декодирования по CFG.AS-03.FR-01–CFG.AS-03.FR-03.
- [x] 4.4 Реализовать начальную загрузку корневого `config.yaml` по типизированной модели приложения; поддержать `application_id`, `workers.<worker_name>.disabled` (по умолчанию `false`), `interval_seconds` и `pause_seconds`; описать, что остальные поля задаёт приложение, файл содержит редко меняемые технические параметры, а бизнес-настройки, feature toggles и удалённо меняемые технические значения находятся в `settings` по CFG.ACF-01.FR-01–CFG.ACF-01.FR-02.
- [x] 4.5 Реализовать обнаружение и атомарное применение валидных изменений `config.yaml` без рестарта; сохранять последний валидный snapshot и сообщать об ошибке при невалидном обновлении по CFG.ACF-02.FR-01–CFG.ACF-02.FR-02.
## 5. Business trace и технические логи
## 5. Business trace и техническое логирование
- [ ] 5.1 Реализовать business trace contract и PostgreSQL adapter для `trace_contexts`/`trace_messages`, включая `application_id` в `attrs_json` контекстов и сообщений, по OBS.BT-01.FR-01–OBS.BT-01.FR-03.
- [ ] 5.2 Добавить пример первой миграции приложения для `trace_contexts`/`trace_messages` по OBS.BT-01.FR-01–OBS.BT-01.FR-02 и проверить ключи, индексы и каскадную связь сообщений с контекстом.
- [ ] 5.3 Реализовать JSON formatter для stdout с application_id и business_trace_id по OBS.TL-01.FR-01–OBS.TL-01.FR-02; оставить доставку платформе.
- [x] 5.1 Реализовать business trace contract и PostgreSQL adapter для `trace_contexts` и `trace_messages`, добавляя `application_id` в `attrs_json` обоих типов записей по OBS.BT-01.FR-01–OBS.BT-01.FR-03.
- [x] 5.2 Документировать структуру и ограничения таблиц business trace, включая `trace_id`, индексы и каскадную связь сообщений с контекстом; явно указать, что таблицы создаёт миграция приложения по OBS.BT-01.FR-01–OBS.BT-01.FR-03.
- [x] 5.3 Реализовать техническую JSON-запись с обязательными `timestamp`, `level`, `logger`, `message`, `application_id`, необязательными `attributes` и `business_trace_id`, выводом через stdlib `StreamHandler` в stdout по OBS.TL-01.FR-01–OBS.TL-01.FR-02.
## 6. Интеграция и документация
- [ ] 6.1 Удалить configuration-service и RabbitMQ business-event API из публичных exports и документации; сохранить границу RabbitMQ рабочих сообщений внутри приложений.
- [ ] 6.2 Обновить package metadata, YAML parser dependency, optional PostgreSQL extra, README и examples для десяти capabilities.
- [ ] 6.3 Добавить contract/unit/integration проверки для AL, WK, AI, HA, HTTP, WO, AS, ACF, BT и OBS.TL; проверить core-only и PostgreSQL extra imports.
- [x] 6.1 Сохранить границы PLBA2: не добавлять сервис конфигурации или бизнес-истории, миграции приложения, API истории, публикацию business events в RabbitMQ или общую инфраструктуру рабочих очередей.
- [x] 6.2 Обновить package metadata и зависимости загрузчика YAML; описать интеграцию всех десяти capabilities, включая подключение HTTP adapter и миграции, выполняемые приложением.
- [x] 6.3 Добавить contract/unit/integration проверки поведения, заданного требованиями RT.AL, RT.WK, RT.AI, HL.AG, API.HTTP, WF.OR, CFG.AS, CFG.ACF, OBS.BT и OBS.TL.