PLBA2-1. Спецификация

This commit is contained in:
2026-10-10 18:19:37 +03:00
commit c540f591b9
37 changed files with 3921 additions and 0 deletions
@@ -0,0 +1,48 @@
# 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` и метаданные проекта могут отсутствовать.
##### Основной поток
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`.