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

7.5 KiB
Raw Blame History

Tasks

1. Runtime, workers и идентификатор приложения

  • 1.1 Разрешать application_id в порядке config.yaml → [project].name из pyproject.toml → UUIDv4; предоставлять его runtime до запуска зависимых компонентов по RT.AI-01.FR-01.
  • 1.2 Реализовать регистрацию workers с уникальными именами и независимыми lifecycle/health; запускать worker при отсутствующем или false disabled, пропускать при true; применять изменение disabled при следующем запуске приложения по RT.WK-01.FR-01–RT.WK-01.FR-02.
  • 1.3 Реализовать последовательные циклы worker с настройками interval_seconds или pause_seconds, немедленным первым запуском и проверкой допустимого расписания по RT.WK-03.FR-01–RT.WK-03.FR-02.
  • 1.4 Формировать автоматический health worker по результату цикла, продолжать работу после исключения, поддержать прикладную health-логику и признак critical по RT.WK-04.FR-01–RT.WK-04.FR-02.
  • 1.5 Реализовать graceful/force stop всех запущенных workers и групповые результаты WORKERS_STOPPED/WORKERS_STOPPING по RT.WK-02.FR-01–RT.WK-02.FR-02.
  • 1.6 Реализовать запуск и остановку всего приложения, lifecycle states, необязательный timeout_seconds и продолжение остановки после ответа stopping по RT.AL-01.FR-01 и RT.AL-02.FR-01–RT.AL-02.FR-02.

2. Health и workflow

  • 2.1 Формировать отчёт с application_id, lifecycle и состояниями запущенных workers/contributors; применить правила criticality, отсутствующих workers и статусов new, starting, running, stopping, stopped, failed по HL.AG-01.FR-01–HL.AG-01.FR-02.
  • 2.2 Реализовать object-based workflow с именованными шагами и явными переходами; сохранять начало/итог запуска, шаги, snapshots и ошибки через переданный persistence-контракт; прекращать выполнение после исключения без retry по WF.OR-01.FR-01–WF.OR-01.FR-02.

3. Единый HTTP API

  • 3.1 Реализовать общий route adapter, подключаемый к host приложения и его listener; не запускать отдельный HTTP server или порт по API.HTTP.CA-01.FR-01.
  • 3.2 Реализовать GET /health с сериализацией health report и передачей ошибок aggregator согласно API.HTTP.CA-02.
  • 3.3 Реализовать POST /runtime/start и GET /runtime/status, делегируя lifecycle runtime и возвращая описанные status по API.HTTP.CA-03 и API.HTTP.CA-05.
  • 3.4 Реализовать POST /runtime/stop с валидацией force и timeout_seconds, HTTP 200/202/400 и ответами stopped/stopping по API.HTTP.CA-04.

4. Настройки приложения

  • 4.1 Реализовать и документировать контракт таблицы settings: типы, ограничения и назначение полей, индексы, порядок чтения, отсутствие уникальности setting_key; зафиксировать роль setting_value и is_enabled по CFG.AS-01.FR-01.
  • 4.2 Документировать границу владения начальными данными: приложение создаёт settings и загружает начальные значения своей миграцией; PLBA2 не запускает миграции и не переносит YAML в БД по CFG.AS-02.FR-01–CFG.AS-02.FR-02.
  • 4.3 Реализовать типизированный SettingsReader и PostgreSQL adapter с чтением из переданных pool и схемы, фильтрами, сортировкой, безопасным именем схемы и результатами декодирования по CFG.AS-03.FR-01–CFG.AS-03.FR-03.
  • 4.4 Реализовать начальную загрузку корневого config.yaml по типизированной модели приложения; поддержать application_id, workers.<worker_name>.disabled (по умолчанию false), interval_seconds и pause_seconds; описать, что остальные поля задаёт приложение, файл содержит редко меняемые технические параметры, а бизнес-настройки, feature toggles и удалённо меняемые технические значения находятся в settings по CFG.ACF-01.FR-01–CFG.ACF-01.FR-02.
  • 4.5 Реализовать обнаружение и атомарное применение валидных изменений config.yaml без рестарта; сохранять последний валидный snapshot и сообщать об ошибке при невалидном обновлении по CFG.ACF-02.FR-01–CFG.ACF-02.FR-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 Документировать структуру и ограничения таблиц business trace, включая trace_id, индексы и каскадную связь сообщений с контекстом; явно указать, что таблицы создаёт миграция приложения по OBS.BT-01.FR-01–OBS.BT-01.FR-03.
  • 5.3 Реализовать техническую JSON-запись с обязательными timestamp, level, logger, message, application_id, необязательными attributes и business_trace_id, выводом через stdlib StreamHandler в stdout по OBS.TL-01.FR-01–OBS.TL-01.FR-02.

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

  • 6.1 Сохранить границы PLBA2: не добавлять сервис конфигурации или бизнес-истории, миграции приложения, API истории, публикацию business events в RabbitMQ или общую инфраструктуру рабочих очередей.
  • 6.2 Обновить package metadata и зависимости загрузчика YAML; описать интеграцию всех десяти capabilities, включая подключение HTTP adapter и миграции, выполняемые приложением.
  • 6.3 Добавить contract/unit/integration проверки поведения, заданного требованиями RT.AL, RT.WK, RT.AI, HL.AG, API.HTTP, WF.OR, CFG.AS, CFG.ACF, OBS.BT и OBS.TL.