PLBA2-1. Спецификация

This commit is contained in:
2026-10-10 18:19:37 +03:00
commit c540f591b9
37 changed files with 3921 additions and 0 deletions
@@ -0,0 +1,29 @@
# Proposal
## Summary
Подготовить 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 и управления приложением.
## 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.
## Out of scope
PLBA2 не становится приложением или развёртываемым сервисом, не владеет entrypoint, HTTP host, рабочими RabbitMQ messages, миграциями приложения, configuration-service, API бизнес-истории или доставкой технических логов.