7.5 KiB
7.5 KiB
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 при отсутствующем или
falsedisabled, пропускать при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, выводом через stdlibStreamHandlerв 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.