Files
plba_v2/openspec/changes/plba2-runtime-and-adapters/proposal.md
T

2.9 KiB

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 бизнес-истории или доставкой технических логов.