Контракты системы «Обратная связь — регион»
| Схема | Назначение |
|---|---|
| complaint-submit.schema.json | Тело отправки жалобы: ключ, текст, территория, первичная категория |
| agency-response.schema.json | Представление согласованной версии ответа с версией назначения |
| analytics-input.schema.json | Контракт синтетического снимка для расчёта эталона аналитики |
| workflow-context.schema.json | Начальные контексты приёмочных сценариев, не промышленный API |
Граница доверия
Автор жалобы определяется из доверенной сессии, не из тела. Approved_by в представлении ответа формируется системой после проверки роли; его нельзя принимать как доказательство согласования из произвольного клиентского ввода. Реальный межведомственный протокол и аутентификация блокируются Q-POS-003.
Коды ошибок
422 — нарушение контракта подачи;409 — конфликт ключа, версии, полноты либо устаревшего назначения;403 — чужое ведомство или запрещённые аналитические поля;404 — чужая жалоба для заявителя. Отказ не меняет защищаемые данные.
Дальнейшая детализация
Перед интеграцией требуется полный API/событийный контракт: endpoints, методы, схемы ответа и ошибки, авторизация, версии, идемпотентность, таймауты и совместимость. Представленные схемы определяют отдельные форматы данных; полный API-контракт разрабатывается отдельно.
architecture-transaction и architecture-dependencies — схемы входов испытания/инспекции, а не продуктовые API. Кандидатные зависимости не заменяют извлечение зависимостей реализации.