3.1 KiB
Spec Delta
Purpose
Определять application_id приложения и предоставлять разрешённое значение runtime-контексту.
ADDED Requirements
Requirement: Разрешение идентификатора приложения
ID: RT.AI-01
PLBA2 SHALL разрешать application_id до запуска зависящих от него компонентов и предоставлять значение runtime.
Scenario: Определение идентификатора приложения
Участники
- Файл
config.yaml, метаданные проекта, загрузчик конфигурации и runtime приложения.
Предусловия
- Файл
config.yamlуспешно загружен; полеapplication_idи метаданные проекта могут отсутствовать.
Основной поток
- Разрешаем
application_idпо приоритету источников согласно RT.AI-01.FR-01. - Предоставляем значение runtime-контексту; операция завершается с
APPLICATION_ID_RESOLVEDпо RT.AI-01.FR-01.
Альтернативы и ошибки
application_idне задан, аpyproject.tomlили[project].nameотсутствует — генерируем UUIDv4; результат тот же.
Результат
Runtime-контекст содержит один application_id, неизменный в течение работы процесса.
Коды завершения
| Код | Смысл | Связанные FR |
|---|---|---|
APPLICATION_ID_RESOLVED |
Идентификатор выбран и предоставлен runtime | RT.AI-01.FR-01 |
Функциональные требования
RT.AI-01.FR-01: Разрешение идентификатора
В корневом config.yaml приложение может задать необязательное строковое поле application_id. Непустое значение используется без изменений. Если значение отсутствует или пустое, PLBA2 использует имя проекта из [project].name в pyproject.toml. Если файл, секция или имя проекта недоступны, PLBA2 генерирует случайный UUIDv4. Идентификатор разрешается один раз до запуска зависящих компонентов, предоставляется runtime-контексту и остаётся неизменным в течение работы процесса; UUIDv4 при новом запуске генерируется заново. Успешное разрешение завершается с APPLICATION_ID_RESOLVED.