53 lines
3.5 KiB
Markdown
53 lines
3.5 KiB
Markdown
# Capability: Идентификатор приложения
|
||
|
||
## Purpose
|
||
|
||
Определять `application_id` приложения и предоставлять разрешённое значение runtime-контексту.
|
||
|
||
## Границы
|
||
|
||
- В capability входит однократное разрешение application_id из config.yaml, метаданных проекта или UUIDv4 и предоставление значения runtime до запуска зависимых компонентов.
|
||
|
||
## Requirements
|
||
|
||
### Requirement: Разрешение идентификатора приложения
|
||
|
||
**ID:** `RT.AI-01`
|
||
|
||
PLBA2 SHALL разрешать `application_id` до запуска зависящих от него компонентов и предоставлять значение runtime.
|
||
|
||
#### Scenario: Определение идентификатора приложения
|
||
|
||
##### Участники
|
||
|
||
- Файл `config.yaml`, метаданные проекта, загрузчик конфигурации и runtime приложения.
|
||
|
||
##### Предусловия
|
||
|
||
- Файл `config.yaml` успешно загружен; поле `application_id` и метаданные проекта могут отсутствовать.
|
||
|
||
##### Основной поток
|
||
|
||
1. Разрешаем `application_id` по приоритету источников согласно [RT.AI-01.FR-01](#rtai-01fr-01-разрешение-идентификатора).
|
||
2. Предоставляем значение runtime-контексту; операция завершается с `APPLICATION_ID_RESOLVED` по [RT.AI-01.FR-01](#rtai-01fr-01-разрешение-идентификатора).
|
||
|
||
##### Альтернативы и ошибки
|
||
|
||
- `application_id` не задан, а `pyproject.toml` или `[project].name` отсутствует — генерируем UUIDv4; результат тот же.
|
||
|
||
##### Результат
|
||
|
||
Runtime-контекст содержит один `application_id`, неизменный в течение работы процесса.
|
||
|
||
##### Коды завершения
|
||
|
||
| Код | Смысл | Связанные FR |
|
||
| --- | --- | --- |
|
||
| `APPLICATION_ID_RESOLVED` | Идентификатор выбран и предоставлен runtime | [RT.AI-01.FR-01](#rtai-01fr-01-разрешение-идентификатора) |
|
||
|
||
#### Функциональные требования
|
||
|
||
##### RT.AI-01.FR-01: Разрешение идентификатора
|
||
|
||
В корневом `config.yaml` приложение может задать необязательное строковое поле `application_id`. Непустое значение используется без изменений. Если значение отсутствует или пустое, PLBA2 использует имя проекта из `[project].name` в `pyproject.toml`. Если файл, секция или имя проекта недоступны, PLBA2 генерирует случайный UUIDv4. Идентификатор разрешается один раз до запуска зависящих компонентов, предоставляется runtime-контексту и остаётся неизменным в течение работы процесса; UUIDv4 при новом запуске генерируется заново. Успешное разрешение завершается с `APPLICATION_ID_RESOLVED`.
|