PLBA2-4. Доработка регистрации http эндпоинтов
PLBA package CI / Python tests (push) Successful in 23s
PLBA package CI / Package version increment (push) Skipped

This commit is contained in:
2026-10-11 10:44:59 +03:00
parent a0d2db6bd0
commit d46993a092
30 changed files with 1666 additions and 583 deletions
@@ -0,0 +1,36 @@
---
status: Proposed
date: YYYY-MM-DD
decision-makers:
- <имя или роль владельца решения>
supersedes: []
superseded-by:
---
# ADR-<номер>: <Краткое название решения>
## Контекст и проблема
Какую проблему нужно решить и какие ограничения важны для выбора?
## Факторы решения
- <Требование или ограничение, влияющее на решение>
## Рассмотренные варианты
- **<Вариант>** — преимущества и недостатки.
## Решение
Какой вариант выбран и почему? Заполняется при принятии ADR; до этого раздел
может содержать предлагаемое решение.
## Последствия
- Положительные: <результаты и преимущества>.
- Отрицательные или компромиссы: <цена решения, ограничения, риски>.
## Связанные решения
- <ID и ссылка на связанные ADR, если есть>
@@ -0,0 +1,21 @@
# Design
## Context
<!-- Текущее состояние и ограничения. Мотивация описана в proposal.md — не повторяй её. -->
## Goals / Non-Goals
**Goals:**
<!-- Цели этого design -->
**Non-Goals:**
<!-- Что явно не входит в scope -->
## Decisions
<!-- Ключевые технические решения, причины и рассмотренные альтернативы -->
## Risks / Trade-offs
<!-- Известные риски и компромиссы -->
@@ -0,0 +1,16 @@
# Capability: <название>
## Purpose
<Бизнес-функция capability и понятный результат, не менее 50 знаков.>
## Границы
<!-- Кратко опиши ответственность capability: что входит в её область,
что остаётся за её пределами и кому это принадлежит. Не дублируй Requirements. -->
## Requirements
<!-- Полный актуальный набор Requirements capability. Оформляй Requirements
по правилам schema.yaml. Не используй заголовки операций delta:
ADDED, MODIFIED, REMOVED или RENAMED. -->
@@ -0,0 +1,29 @@
# Proposal
## Why
<!-- Объясни мотивацию change: какую проблему он решает и почему нужен сейчас. -->
## What Changes
<!-- Опиши изменения: новые возможности, доработки и удаления. -->
## Capabilities
### New Capabilities
<!-- Добавляемые capabilities. Новые сегменты пути пиши в kebab-case и
согласуй с существующей структурой спецификаций. Для каждой создай
specs/<capability-path>/spec.md. -->
- `<capability-path>`: <brief description of what this capability covers>
### Modified Capabilities
<!-- Существующие capabilities, требования которых меняются. Указывай их только
при изменении поведения на уровне спецификации; для каждой создай delta
spec по точному пути openspec/specs/. Если требования не меняются, оставь
раздел пустым и установи skip_specs: true в .openspec.yaml. Не создавай
требование только ради прохождения проверки. -->
- `<existing-capability-path>`: <what requirement is changing>
## Impact
<!-- Затронутые код, API, зависимости и системы -->
@@ -0,0 +1,107 @@
# Spec Delta
## Purpose
<!-- Только для новой capability: 1–2 предложения, не менее 50 знаков.
Для существующей capability удали этот раздел. -->
<!-- Включай только сведения, меняющие поведение, контракт или обязательное
ограничение. Удаляй повторы и пояснения без такого влияния. -->
## ADDED Requirements
<!-- Для изменения существующего Requirement используй MODIFIED Requirements
и полный блок из master spec: ID, единственный Scenario и все FR.
Сохраняй заголовок, ID, номера FR и заголовки FR, на которые ссылаются по slug. -->
### Requirement: <название завершённой технической функции>
**ID:** `AREA.CAP-01`
Система SHALL <наблюдаемый результат завершённой функции>.
#### Scenario: <название завершённого процесса>
##### Участники
- <участники процесса>.
##### Предусловия
- <условия начала процесса>.
##### Основной поток
1. <Что делаем — как делаем> по [AREA.CAP-01.FR-01](#areacap-01fr-01-правило-обработки-или-устойчивый-контракт).
2. Завершаем с `FUNCTION_COMPLETED` — фиксируем результат по [AREA.CAP-01.FR-02](#areacap-01fr-02-коды-завершения-тексты-и-дальнейшее-поведение).
##### Альтернативы и ошибки
- <условие ошибки> — завершаем с `FUNCTION_FAILED` по [AREA.CAP-01.FR-02](#areacap-01fr-02-коды-завершения-тексты-и-дальнейшее-поведение).
##### Результат
<Наблюдаемое состояние после завершения>.
##### Коды завершения
| Код | Смысл | Связанные FR |
| --- | --- | --- |
| `FUNCTION_COMPLETED` | <самодостаточный смысл успешного завершения> | [AREA.CAP-01.FR-02](#areacap-01fr-02-коды-завершения-тексты-и-дальнейшее-поведение) |
| `FUNCTION_FAILED` | <самодостаточный смысл ошибки> | [AREA.CAP-01.FR-02](#areacap-01fr-02-коды-завершения-тексты-и-дальнейшее-поведение) |
#### Функциональные требования
##### AREA.CAP-01.FR-01: Правило обработки
<Обычный FR описывает логику, правило или последовательность шагов. Для
специального формата добавь метку после ID: [DB], [API] или [UI]. Структуру
таблицы БД и контракт сообщения оформи по соответствующему паттерну. Контракт
HTTP endpoint располагай в завершающем разделе CONTRACT.>
##### AREA.CAP-01.FR-02: Коды завершения, тексты и дальнейшее поведение
| Код | Текст сообщения | Дальнейшее поведение |
| --- | --- | --- |
| `FUNCTION_COMPLETED` | <текст или явное отсутствие сообщения> | <следующие действия> |
| `FUNCTION_FAILED` | <текст ошибки> | <обработка ошибки, повтор, действие оператора> |
<При необходимости — параметры сообщений, связанные требования и соответствие
действующему runtime. Явно отметь коды и тексты, которые ещё не реализованы.>
<!-- HTTP endpoint описывай в отдельном Requirement с полным Use case.
Контракт размещай в конце Requirement, не разбивая request/response на FR:
#### CONTRACT
##### Request
Метод: `POST`; путь: `/resource`. <Тело запроса или явное отсутствие тела.>
##### Response
HTTP status: <код и условие возврата>.
| Поле | Тип | Обязательность | Ограничения и значение по умолчанию | Назначение | Формирование значения |
| --- | --- | --- | --- | --- | --- |
| `field_name` | `JSON type` | <Обязательное или опциональное> | <Ограничения> | <Назначение> | <Источник или правило формирования> |
-->
<!-- Автор выбирает полный или сокращенный Use case по ситуации, независимо от
типа FR и предмета описания. Для сокращенного Use case используй только основной
поток и ссылки на FR:
#### Scenario: Сокращенный use case: <предмет описания>
##### Основной поток
1. <Кратко опиши первый аспект> по [AREA.CAP-01.FR-01](#areacap-01fr-01-правило-обработки).
2. <Кратко опиши следующий аспект> по [AREA.CAP-01.FR-02](#areacap-01fr-02-правило-или-контракт).
-->
<!-- Типы FR: без метки — логика и правила; [DB] — структура БД;
[API] — контракт сообщения или технического лога; [UI] — требования к UI.
[DB] с таблицей оформляй по openspec/schemas/use-case-driven/patterns/database-table.md.
Сериализуемый контракт FR [API] оформляй по
openspec/schemas/use-case-driven/patterns/message-contract.md. В response-таблице
добавь колонку «Формирование значения» для каждого поля. -->
@@ -0,0 +1,11 @@
# Tasks
## 1. <!-- Название группы задач -->
- [ ] 1.1 <!-- Формулировка задачи -->
- [ ] 1.2 <!-- Формулировка задачи -->
## 2. <!-- Название группы задач -->
- [ ] 2.1 <!-- Формулировка задачи -->
- [ ] 2.2 <!-- Формулировка задачи -->