43 lines
7.5 KiB
Markdown
43 lines
7.5 KiB
Markdown
# 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.
|