Files
alex d517820088
PLBA package CI / Python tests (push) Failing after 2s
PLBA package CI / Package version increment (push) Skipped
PLBA2-2. Архивация спек
2026-10-10 20:55:13 +03:00

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