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

5.7 KiB
Raw Blame History

Tasks

1. Runtime и идентичность приложения

  • 1.1 Разрешать application_id из config.yaml, pyproject.toml или UUIDv4 и предоставлять его runtime-контексту по RT.AI-01.FR-01.
  • 1.2 Поддержать уникальные имена, независимое выполнение и состояния workers; запускать только workers без disabled: true по RT.WK-01.FR-01–RT.WK-01.FR-02.
  • 1.3 Реализовать запуск приложения и всех включённых workers по RT.AL-01.FR-01; при ошибке фиксировать состояние failed.
  • 1.4 Реализовать graceful/force stop workers и групповой результат по RT.WK-02.FR-01–RT.WK-02.FR-02.
  • 1.5 Реализовать остановку приложения с необязательным таймаутом ожидания и status stopping по RT.AL-02.FR-01–RT.AL-02.FR-02.
  • 1.6 Реализовать цикл worker, проверку расписания и применение активной конфигурации по RT.WK-03.FR-01–RT.WK-03.FR-02.
  • 1.7 Формировать автоматический health worker, сохранять цикл после исключения, принимать прикладные health-условия и передавать critical по RT.WK-04.FR-01–RT.WK-04.FR-02.

2. Health и workflow

  • 2.1 Собирать статусы runtime и запущенных workers по HL.AG-01.FR-01–HL.AG-01.FR-02; исключать отключённые workers из health-агрегации и возвращать stopped после остановки приложения.
  • 2.2 Сохранить object-based workflow API PLBA v1, явные переходы, snapshots, persistence и передачу ошибок по WF.OR-01.FR-01–WF.OR-01.FR-02.

3. Единый HTTP API

  • 3.1 Добавить общий route adapter и отдельные endpoint Requirements с CONTRACT для GET /health, POST /runtime/start, POST /runtime/stop и GET /runtime/status по API.HTTP.CA-01–API.HTTP.CA-05; worker-specific routes не добавлять.
  • 3.2 Подключать все routes к одному host и listener приложения; проверить, что capabilities не создают отдельные порты.
  • 3.3 Делегировать health и lifecycle решения соответствующим contracts; HTTP слой отвечает за маршрутизацию и сериализацию.

4. Конфигурация приложения

  • 4.1 Описать структуру и назначение полей таблицы settings по CFG.AS-01.FR-01; сверить её с запросом PostgreSQL-адаптера.
  • 4.2 Зафиксировать создание таблицы и загрузку начальных значений миграциями по CFG.AS-02.FR-01–CFG.AS-02.FR-02; определить обновление runtime-значений владельцем приложения без рестарта.
  • 4.3 Реализовать SettingsReader и PostgreSQL read adapter по CFG.AS-03.FR-01–CFG.AS-03.FR-03; проверить фильтрацию ключа, config_key и is_enabled, порядок sort_order/id и видимость изменения БД при следующем чтении.
  • 4.4 Заменить удалённый ConfigurationSnapshotManager на typed YAML provider для config.yaml в корне приложения с общими полями application_id, workers.<worker_name>.disabled (по умолчанию false) и настройками расписания workers по CFG.ACF-01.FR-01–CFG.ACF-01.FR-02; проверить успешную загрузку и блокировку запуска при ошибочном исходном файле.
  • 4.5 Подхватывать изменения config.yaml без рестарта по CFG.ACF-02; проверять атомарную замену, сохранение последнего валидного снимка и передачу ошибки при некорректном изменении.

5. Business trace и технические логи

  • 5.1 Реализовать business trace contract и PostgreSQL adapter для trace_contexts/trace_messages, включая application_id в attrs_json контекстов и сообщений, по OBS.BT-01.FR-01–OBS.BT-01.FR-03.
  • 5.2 Добавить пример первой миграции приложения для trace_contexts/trace_messages по OBS.BT-01.FR-01–OBS.BT-01.FR-02 и проверить ключи, индексы и каскадную связь сообщений с контекстом.
  • 5.3 Реализовать JSON formatter для stdout с application_id и business_trace_id по OBS.TL-01.FR-01–OBS.TL-01.FR-02; оставить доставку платформе.

6. Интеграция и документация

  • 6.1 Удалить configuration-service и RabbitMQ business-event API из публичных exports и документации; сохранить границу RabbitMQ рабочих сообщений внутри приложений.
  • 6.2 Обновить package metadata, YAML parser dependency, optional PostgreSQL extra, README и examples для десяти capabilities.
  • 6.3 Добавить contract/unit/integration проверки для AL, WK, AI, HA, HTTP, WO, AS, ACF, BT и OBS.TL; проверить core-only и PostgreSQL extra imports.