Files
orchestrator/docs/work-items/ORCH-069/10-tech-risks.md

2.9 KiB
Raw Permalink Blame History

Технические риски — ORCH-069

Work Item ID: ORCH-069 Уровень общего риска: низкий (аддитивное, обратносовместимое, изолированное изменение).

# Риск Вероятность Влияние Митигация
R-1 ValidationError на старте при мусоре в ORCH_QG0_TITLE_MAX → краш прод-процесса (self-hosting) Средняя (опечатка в env) Высокое (падение инструмента всех проектов) field_validator(mode="before") гасит невалидный вход → дефолт 200 (ADR Р-2, AC-3). never-raise.
R-2 Чтение лимита один раз на module-import вместо per-call → тесты не смогут патчить settings Низкая Среднее (нетестируемость AC-2) _qg0_errors читает settings.qg0_title_max динамически на каждый вызов (ADR Р-3).
R-3 Off-by-one на границе (>= вместо >) Низкая Низкое (1 символ) Явная семантика len > limit зафиксирована (ТЗ §4, AC-1/AC-2); тесты на 200/201, 120/121.
R-4 Регресс нижних лимитов (< 5 title, < 20 description) при правке функции Низкая Среднее Трогать только верхний лимит; AC-4 покрывает нижние; диф минимален.
R-5 Тихое проглатывание невалидного env → оператор не заметит опечатку Средняя Низкое (лимит молча = 200, конвейер работает) Осознанный trade-off (ADR «Минусы»): устойчивость > громкость. Опц. logger.warning — вне объёма.
R-6 Случайное затрагивание вне-объёмных элементов (slug [:30], БД, реестры, handle_*, soft-QG-0) Низкая Среднее AC-8 — изоляция; reviewer проверяет диф; ADR Р-4 фиксирует инварианты.
R-7 Документация не обновлена в том же PR (.env.example, .env.staging.example, CHANGELOG.md) Средняя Среднее (reviewer REQUEST_CHANGES) AC-6 чек-лист; документация = golden source (правило 2 CLAUDE.md).

Не-риски (явно)

  • Схема БД — не меняется (tasks.title TEXT без ограничения).
  • API/эндпоинты — не меняются.
  • Топология/контейнеры/порты — не меняются.
  • Откат/миграция — не требуется (дефолт 200 > 80, чисто аддитивно).