Files
plba_v2/openspec/changes/archive/2026-10-10-plba2-runtime-and-adapters/tasks.md
T
alex d517820088
PLBA package CI / Python tests (push) Failing after 2s
PLBA package CI / Package version increment (push) Skipped
PLBA2-2. Архивация спек
2026-10-10 20:55:13 +03:00

43 lines
7.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Tasks
## 1. Runtime, workers и идентификатор приложения
- [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
- [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
- [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. Настройки приложения
- [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 и техническое логирование
- [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. Интеграция и документация
- [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.