3.8 KiB
3.8 KiB
Proposal
Summary
Подготовить PLBA2 — библиотеку Python-компонентов и runtime для приложений. Приложение сохраняет собственные entrypoint, composition root, бизнес-логику и интеграции.
Scope
- Запускать и останавливать приложение целиком, независимо исполнять именованные 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: запуск и остановка всего приложения с 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, схемой и миграциями приложения. В PLBA2 не входят сервис конфигурации или истории, API бизнес-истории, публикация бизнес-событий в RabbitMQ, общая очередь рабочих сообщений, RabbitMQ consumer/producer для рабочих заданий, бизнес-логика, доставка технических логов и средства развёртывания.