PLBA2-1. Доработка change
This commit is contained in:
@@ -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 для рабочих заданий, бизнес-логика, доставка технических логов и средства развёртывания.
|
||||
|
||||
Reference in New Issue
Block a user