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
@@ -2,96 +2,85 @@
## Context
PLBA2 — Python-библиотека компонентов и runtime. Приложение владеет entrypoint, composition root, бизнес-логикой, рабочими сообщениями, схемой БД и HTTP host. PLBA2 предоставляет десять capabilities из [proposal.md](proposal.md). Реализации PLBA v1 служат ориентиром для worker, health, workflow и бизнес trace контрактов.
PLBA2 — библиотека компонентов и runtime. Приложение владеет entrypoint, composition root, бизнес-логикой, рабочими сообщениями, схемой БД и HTTP host. Изменение объединяет десять capabilities, перечисленных в [proposal.md](proposal.md), и использует PLBA v1 как ориентир для workers, health, workflow и business trace.
## Goals / Non-Goals
**Goals:**
- Запускать несколько независимо выполняемых workers с уникальными именами; управлять ими только через lifecycle всего приложения.
- Дать приложению единые contracts для lifecycle, health, workflow, HTTP API, identity, двух слоёв конфигурации и business trace.
- Разделить персистентную бизнес-историю и технический вывод в stdout.
- Поддержать замену PostgreSQL settings adapter без изменения кода, использующего SettingsReader.
- Запускать именованные workers независимо и управлять ими через lifecycle приложения.
- Предоставить единые contracts для lifecycle, health, workflow, HTTP API, application identity, двух слоёв конфигурации и business trace.
- Отделить business trace от технических логов.
- Позволить бизнес-коду читать настройки через `SettingsReader`, не завися от PostgreSQL-адаптера.
**Non-Goals:**
- Не создавать entrypoint, composition root, HTTP server, сервис настроек или API business history.
- Не предоставлять общую очередь, RabbitMQ consumer/producer для рабочих заданий, outbox или retry framework.
- Не управлять миграциями приложения, доставкой stdout логов или бизнес-правилами workflow.
- Не создавать entrypoint, composition root, HTTP server, сервис конфигурации, хранилище/API бизнес-истории.
- Не предоставлять общую очередь рабочих заданий или RabbitMQ API для них; приложение самостоятельно читает и публикует такие сообщения.
- Не выполнять миграции приложения, не реализовывать бизнес-логику workflow и не доставлять технические логи в платформенные системы.
## Decisions
### Runtime и workers
- Capability `runtime/worker` отвечает за имена, независимый lifecycle, расписание, внутреннюю остановку и health отдельных workers.
- Capability `runtime/application-lifecycle` управляет запуском и остановкой приложения; при запуске стартуют все workers без `disabled: true`. Отдельного API для запуска или остановки worker нет. Runtime не завершает принадлежащий приложению OS process или HTTP host.
- При обычной остановке каждый worker завершает текущий цикл и не начинает следующий; `force=true` прерывает активную обработку. Приложение становится `stopped` после остановки всех workers.
- `timeout_seconds` ограничивает только ожидание HTTP-вызова. При его истечении возвращается `stopping`, а остановка продолжается; отсутствие timeout означает неограниченное ожидание.
- Worker читает признак запуска из `workers.<worker_name>.disabled` и расписание из `workers.<worker_name>.interval_seconds` или `pause_seconds` в `config.yaml`. Отсутствующий `disabled` эквивалентен `false`; изменение признака во время работы вступает в силу при следующем запуске приложения.
- Интервал задаёт период между началами циклов, пауза — стабильное ожидание после каждого цикла; активные изменения расписания применяются при планировании следующего цикла.
- Исключение цикла не завершает worker. Runtime выставляет автоматический health status; прикладная health-логика добавляет собственные условия, а `critical` ограничивает влияние worker по правилам health aggregation.
- `runtime/worker` задаёт уникальное стабильное имя worker, его независимый lifecycle, расписание, остановку и health. Отдельных API для запуска или остановки worker нет.
- При старте приложения запускаются workers, у которых `workers.<worker_name>.disabled` отсутствует или равно `false`. `disabled: true` исключает worker из запуска; изменение этого признака действует при следующем запуске приложения.
- Для включённого worker задаётся ровно одно положительное значение: `interval_seconds` или `pause_seconds`. Первый цикл начинается сразу, циклы одного worker не пересекаются. Интервал задаёт период между началами циклов; пауза задаётся после завершения цикла. Изменения расписания из активной конфигурации применяются при планировании следующего цикла.
- Graceful stop завершает текущий цикл и не запускает следующий. `force=true` прерывает активную обработку. Supervisor останавливает все запущенные workers и сообщает имена тех, кто ещё работает.
- Исключение цикла переводит автоматический health worker в `unhealthy`, но не завершает worker: runtime планирует следующий цикл. Превышение интервала даёт `degraded`; успешный следующий цикл восстанавливает автоматический статус `ok`. Итоговый статус — худший из автоматического и прикладного; прикладная health-логика не скрывает ошибку цикла.
### Health
### Lifecycle и health приложения
- Сохраняется v1 модель worker health и агрегация `ok`, `degraded`, `unhealthy`.
- Health report содержит application_id, runtime state и health-состояния запущенных workers; contributors вычисляют собственное состояние. Некритичный компонент может ухудшить aggregate до `degraded`, но не до `unhealthy` по HL.AG-01.FR-01.
- Worker с `disabled: true` исключается из набора ожидаемых компонентов.
- Если runtime lifecycle приложения `stopped`, aggregate health возвращает `stopped`.
- `runtime/application-lifecycle` запускает все включённые workers; ошибка запуска переводит приложение в `failed`. При остановке lifecycle становится `stopped` после подтверждения остановки всех workers.
- Необязательный положительный `timeout_seconds` ограничивает ожидание ответа на stop-запрос. При истечении возвращается `stopping`, а остановка продолжается; без timeout ожидание не ограничено. Runtime не завершает OS process или HTTP host приложения.
- Health report включает `application_id`, lifecycle и состояния запущенных workers/contributors. Disabled workers не входят в набор ожидаемых компонентов. Статусы компонентов упорядочены `ok < degraded < unhealthy`; `unhealthy` некритичного компонента ограничивается до `degraded`. Отсутствующий некритичный worker даёт как минимум `degraded`, отсутствующий критичный — `unhealthy`. Lifecycle `new`/`failed` даёт `unhealthy`, `starting`/`stopping` — как минимум `degraded`, а `stopped` задаёт общий health `stopped`.
### Единый HTTP API
- PLBA2 предоставляет один router для health и lifecycle всего приложения; общий adapter описан в [API.HTTP.CA-01](specs/api/http/control-api/spec.md), отдельные endpoints — в своих Requirements.
- Приложение подключает router к одному HTTP host и listener. Все routes используют один порт; capabilities не запускают собственные серверы.
- HTTP слой делегирует расчёт health capability HL.AG-01 и управление приложением — RT.AL-01–RT.AL-02. Отдельных worker routes нет; состояния запущенных workers доступны в агрегированном health-отчёте.
- `api/http/control-api` предоставляет общий route adapter, который приложение подключает к собственному HTTP host и listener. PLBA2 не запускает сервер и не открывает отдельный порт.
- Adapter предоставляет `GET /health`, `POST /runtime/start`, `POST /runtime/stop` и `GET /runtime/status`. Health делегируется aggregator, управление — lifecycle runtime; отдельные worker routes отсутствуют.
- `GET /health` возвращает health report без пересчёта в adapter. Start/status возвращают lifecycle status. Stop принимает `force` и необязательный положительный `timeout_seconds`; завершённая остановка возвращает HTTP 200 и `stopped`, продолжающаяся после timeout — HTTP 202 и `stopping`, некорректный запрос — HTTP 400.
### Workflow
- Сохраняется object-based API PLBA v1: WorkflowDefinition, WorkflowNode, WorkflowStep, WorkflowContext и StepResult.
- Engine применяет только объявленные переходы, сохраняет ход выполнения через WorkflowPersistence и передаёт исключения вызывающему приложению.
- Рабочие сообщения, retries и предметные решения остаются у приложения.
- Приложение передаёт именованный `WorkflowDefinition` с начальным шагом и именованными узлами. Узел содержит `WorkflowStep` и карту переходов; шаг принимает `WorkflowContext` и возвращает `StepResult` с переходом, изменениями состояния и статусом.
- Engine применяет только объявленные переходы и не содержит бизнес-правил приложения. Переданный `WorkflowPersistence` сохраняет начало и итог запуска, начало и завершение каждого шага, snapshots контекста и ошибки.
- Исключение шага сохраняется и передаётся вызывающему коду; workflow прекращается без скрытого retry и без выполнения следующих шагов. Подключение к БД остаётся ответственностью приложения.
### Идентификатор приложения
- Необязательное `application_id` задаётся в корневом `config.yaml`. Если оно отсутствует или пустое, runtime берёт `[project].name` из `pyproject.toml`, а при недоступности метаданных генерирует UUIDv4.
- Идентификатор разрешается до старта зависимых компонентов, предоставляется runtime-контексту и не меняется в течение процесса. Health и логирование используют его согласно требованиям своих capabilities.
- В корневом `config.yaml` приложение может задать необязательный строковый `application_id`. Непустое значение используется без изменений; иначе берётся `[project].name` из `pyproject.toml`, а при недоступности имени генерируется UUIDv4.
- Идентификатор разрешается до запуска зависимых компонентов, предоставляется runtime-контексту и не меняется в процессе. Сгенерированный UUIDv4 создаётся заново при следующем запуске, если имя проекта или значение в файле не заданы.
- Health report и технические логи используют этот ID; business trace adapter добавляет его в `attrs_json` контекста и каждого сообщения.
### Настройки
### Два слоя конфигурации
- CFG.AS-01 описывает таблицу `settings` для бизнес-параметров, feature toggles и технических значений, которые требуется менять удалённо в runtime.
- По CFG.AS-02 приложение создаёт таблицу и загружает начальные значения собственными миграциями. Дальнейшие обновления строк выполняются владельцем приложения; PLBA2 не запускает миграции и не предоставляет сервис изменения конфигурации.
- По CFG.AS-03 типизированный SettingsReader читает актуальные значения. Изменения в БД становятся доступны при следующем чтении без рестарта приложения; PostgreSQL adapter фильтрует строки и сортирует их по `sort_order`, `id`.
### Техническая конфигурация из файла
- CFG.ACF-01 читает `config.yaml` из корня приложения. PLBA2 задаёт общее необязательное поле `application_id`, `workers.<worker_name>.disabled` (по умолчанию `false`) и поля расписания `workers.<worker_name>.interval_seconds` / `workers.<worker_name>.pause_seconds`; остальные поля и типизированную модель файла определяет приложение.
- Локальный file provider заменяет текущую модель удалённых configuration snapshots; отдельный configuration-service и сетевой client не входят в PLBA2.
- Файл хранит редко меняемые технические параметры. Бизнес-параметры, feature toggles и технические значения для удалённых runtime-изменений находятся в таблице `settings`.
- CFG.ACF-02 обнаруживает изменения файла и атомарно заменяет активную конфигурацию после проверки. Последующие чтения получают новый снимок; уже полученные снимки не мутируют.
- Ошибка начальной загрузки блокирует запуск зависимых компонентов. При невалидном runtime-изменении сохраняется последний валидный снимок и приложению сообщается ошибка.
- Реализация требует YAML parser; механизм обнаружения изменения файла остаётся деталью адаптера и не входит в публичный контракт.
- `configuration/application-config-file` читает `config.yaml` из корня приложения по объявленной приложением типизированной модели. Общие поля PLBA2 — `application_id`, `workers.<worker_name>.disabled` (default `false`), `interval_seconds` и `pause_seconds`; остальные поля определяет приложение.
- YAML предназначен для редко меняемых технических параметров. Бизнес-параметры, feature toggles и технические значения, меняемые удалённо в runtime, хранятся в `settings`.
- Ошибка начальной загрузки файла блокирует запуск зависимых компонентов. При успешной проверке обновление атомарно заменяет активную конфигурацию без рестарта; уже полученные snapshots остаются неизменными. При ошибке перезагрузки остаётся последняя валидная конфигурация и приложению передаётся ошибка.
- `configuration/application-settings` задаёт таблицу `settings` в схеме приложения. В таблице хранятся `config_key`, `setting_key`, `setting_value`, `sort_order`, `is_enabled` и `description` вместе с идентификатором строки; уникальность `setting_key` не требуется. `is_enabled` включает строку в чтение, а значение feature toggle хранится в `setting_value`.
- Приложение создаёт таблицу `settings` и загружает начальные данные своей миграцией. PLBA2 миграции не запускает, строки не изменяет и YAML в БД не переносит.
- `SettingsReader` использует типизированные ключи и возвращает упорядоченные значения. PostgreSQL adapter читает через переданный приложением pool из его схемы, фильтрует по ключу, `config_key` и `is_enabled = TRUE`, сортирует по `sort_order`, затем `id`. Следующее чтение видит актуальные значения без рестарта.
### Business trace и технические логи
- Business trace adapter пишет контексты и сообщения в `trace_contexts` и `trace_messages` схемы приложения; `application_id` входит в `attrs_json` контекста и каждого сообщения, без добавления колонок; migration приложения создаёт обе таблицы.
- В публичном контракте используется `business_trace_id`, в совместимой схеме таблиц — поле `trace_id`.
- Бизнес-события не публикуются через RabbitMQ. Чтение истории и API истории не входят в эту capability.
- Technical logger формирует JSON с фиксированными полями и пишет в stdout; platform agent отвечает за доставку и просмотр.
- Business trace adapter записывает контексты в `trace_contexts`, сообщения — в `trace_messages` схемы приложения. Публичный идентификатор называется `business_trace_id`, а в таблицах хранится как `trace_id`. В `attrs_json` обоих видов записей добавляется `application_id`.
- Приложение передаёт адаптеру PostgreSQL pool и имя схемы, а таблицы создаёт собственной миграцией. PLBA2 не владеет данными, не публикует business events в RabbitMQ и не предоставляет API бизнес-истории.
- Техническая запись — JSON-контракт с обязательными `timestamp`, `level`, `logger`, `message`, `application_id` и необязательными `attributes`, `business_trace_id`. Formatter использует stdlib `StreamHandler` для stdout; доставку и просмотр обеспечивает платформа.
## Risks / Trade-offs
- Отсутствие индивидуального worker API упрощает управление приложением; уникальные имена нужны для конфигурации, регистрации и health.
- Повторяющиеся setting keys требуют упорядоченного списка значений; adapter не сводит их к одной строке.
- Приложению нужно подключить один route bundle и включить миграции до запуска адаптеров.
- Изменение публичных контрактов текущего скелета требует отдельной версии PLBA2 и осознанной миграции потребителей.
- Если приложение не задаёт `application_id` и не имеет `[project].name`, UUIDv4 меняется между запусками; потребителям, которым нужен постоянный ID, следует задать его в `config.yaml`.
- Изменение `workers.<worker_name>.disabled` применяется только при следующем запуске приложения, тогда как валидные изменения расписания применяются при планировании следующего цикла.
- Приложению нужно владеть миграциями `settings`, `trace_contexts` и `trace_messages`, передавать PostgreSQL pool адаптерам и подключить HTTP routes к своему host.
## Migration Plan
1. Реализовать core contracts для application identity, worker runtime, health, workflow, двух слоёв конфигурации и business trace.
2. Добавить YAML loader dependency и PostgreSQL adapters; не добавлять RabbitMQ extra.
3. Включить создание `settings`, `trace_contexts` и `trace_messages` в первые миграции каждого приложения.
4. Перевести приложения на named workers, единый route bundle, SettingsReader, business trace adapter и JSON stdout formatter.
5. Выпустить новую major-версию; при откате вернуть предыдущую версию пакета, не удаляя данные приложений.
1. Реализовать runtime, health, workflow, identity и контракты адаптеров согласно capabilities.
2. Добавить загрузку и перезагрузку `config.yaml`, PostgreSQL adapters для настроек и business trace, а также технический formatter для stdout.
3. Документировать для потребителей, что создание таблиц и начальных данных `settings`, `trace_contexts`, `trace_messages` выполняется миграциями приложения.
4. Подключить route adapter к host приложения и выпустить обновлённую версию библиотеки; миграции и изменение кода потребителей выполняются в самих приложениях.
## Open Questions
Нет. HTTP host и единственный listener остаются у приложения; PLBA2 отдаёт подключаемый router.
Нет. HTTP host и listener принадлежат приложению; PLBA2 предоставляет подключаемый route adapter.
@@ -2,28 +2,29 @@
## Summary
Подготовить PLBA2 — библиотеку Python-компонентов и runtime для приложений. Каждое приложение сохраняет собственный entrypoint, composition root, бизнес-логику и интеграции.
Подготовить PLBA2 — библиотеку Python-компонентов и runtime для приложений. Приложение сохраняет собственные entrypoint, composition root, бизнес-логику и интеграции.
## Scope
- Добавить runtime для lifecycle всего приложения и независимого исполнения именованных workers. API управляет приложением целиком; выборочные операции запуска и остановки worker не предоставляются.
- Задавать расписание и признак запуска worker в техническом `config.yaml`; если `disabled` отсутствует, worker запускается.
- Сохранить contracts workers, health, workflow, application identity, DB-backed settings, business trace и технического JSON logging.
- Предоставить единый подключаемый HTTP router для health и управления приложением.
- Запускать и останавливать приложение целиком, независимо исполнять именованные workers по расписанию из `config.yaml` и агрегировать их health.
- Разрешать `application_id` из `config.yaml`, метаданных проекта или UUIDv4 и передавать его runtime.
- Предоставить один подключаемый HTTP route adapter для `GET /health`, `POST /runtime/start`, `POST /runtime/stop` и `GET /runtime/status`, использующий host и listener приложения.
- Разделить настройки: редко меняемые технические параметры задаются в корневом `config.yaml`; бизнес-параметры, feature toggles и технические значения для удалённого изменения хранятся в таблице `settings` схемы приложения.
- Поддержать workflow orchestration, запись business trace в таблицы приложения и единый контракт технического JSON-лога в stdout.
## Capabilities
- `runtime/application-lifecycle`: запуск и остановка приложения, включая таймаут ожидания и принудительную остановку.
- `runtime/worker`: независимое циклическое выполнение именованных workers, расписание, health и контролируемая остановка в составе приложения.
- `health/aggregation`: единый health-отчёт приложения и его активных компонентов.
- `api/http/control-api`: единый HTTP API health и lifecycle приложения на host приложения.
- `runtime/application-identity`: стабильный идентификатор приложения.
- `configuration/application-config-file`: загрузка и перезагрузка технических настроек из корневого `config.yaml`.
- `configuration/application-settings`: чтение бизнес-настроек и runtime-параметров из таблицы `settings` схемы приложения.
- `workflow/orchestration`: orchestration workflow по contracts PLBA v1.
- `observability/business-tracing`: запись бизнес-истории в таблицы схемы приложения.
- `observability/technical-logging`: структурированные технические JSON-логи в stdout.
- `runtime/application-lifecycle`: запуск и остановка всего приложения с graceful/force режимами и ограничением времени ожидания.
- `runtime/worker`: независимое циклическое выполнение именованных workers, расписание, health и контролируемая остановка.
- `health/aggregation`: единый health-отчёт приложения и его запущенных компонентов.
- `api/http/control-api`: общий HTTP route adapter для health и lifecycle endpoints на host приложения.
- `runtime/application-identity`: разрешение `application_id` из конфигурации или метаданных проекта с UUIDv4 fallback.
- `configuration/application-config-file`: загрузка и перезагрузка технической конфигурации из корневого `config.yaml`.
- `configuration/application-settings`: контракт таблицы `settings` и чтение бизнес-параметров, feature toggles и удалённо меняемых технических значений из схемы приложения.
- `workflow/orchestration`: выполнение шагов workflow по явным переходам и сохранение хода выполнения.
- `observability/business-tracing`: контракт и PostgreSQL-адаптер записи бизнес-контекстов и сообщений в таблицы приложения.
- `observability/technical-logging`: контракт технической JSON-записи и её передача в stdout.
## Out of scope
PLBA2 не становится приложением или развёртываемым сервисом, не владеет entrypoint, HTTP host, рабочими RabbitMQ messages, миграциями приложения, configuration-service, API бизнес-истории или доставкой технических логов.
PLBA2 не становится приложением или развёртываемым сервисом и не владеет entrypoint, HTTP host, схемой и миграциями приложения. В PLBA2 не входят сервис конфигурации или истории, API бизнес-истории, публикация бизнес-событий в RabbitMQ, общая очередь рабочих сообщений, RabbitMQ consumer/producer для рабочих заданий, бизнес-логика, доставка технических логов и средства развёртывания.
@@ -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.