Files
plba_v2/openspec/changes/plba2-runtime-and-adapters/specs/runtime/application-identity/spec.md
T

3.1 KiB
Raw Blame History

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.
  2. Предоставляем значение 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.