Event Center — mobile contract v2 (wire mapping)

Контрактные таблицы для мобильных клиентов и интеграторов Event Center / Communications Attention. Полная матрица маршрутизации не дублируется. Операционный cutover: runbook-mobile-contract-v2. Канон в репозитории ask: documentation/technical/event-center/runbook-mobile-contract-v2.md.

1. HTTP header X-ASK-EC-Contract vs outbound always dual

Клиент v2 обязан слать X-ASK-EC-Contract: 2 только после event_center_version ≥ 2 в bootstrap / /.well-known/ask-mobile. Feature detection — только bootstrap, не 404.

Web HTMX без заголовка → HTTP contract 1.

2. action_status: ORM vs wire; alias action_status_orm; SYSTEM_CLOSE_REASONS

ORM хранит: na | open | completed | expired | cancelled (значения auto_resolved в ORM нет).

SYSTEM_CLOSE_REASONS = {auto_resolved, ack_completed, reassigned, lost_relevance, expired_ack}.

Просроченное, но ещё требуемое действие: wire open + overdue=true, не expired.

3. Inbox sections v2 + unknown_section envelope

Allowed section (contract 2): action | important | reminder | info | snoozed | all

Chat-секции EC (mentions, response_required, following, replies, action_required как имя, attention, unread, channels) при contract 2 → HTTP 400, не empty-all.

Единый 4xx envelope Inbox/execute (error и code — одно машинное значение):

{
  "error": "unknown_section",
  "code": "unknown_section",
  "detail": "Unknown inbox section"
}

Contract 1: as-is INBOX_SECTIONS, unknown → all.

4. Counters / mobile_badge_total

Инвариант badge «Входящие» / app / push / Server Switcher:

mobile_badge_total = action_open

(action_open = action_required = attention_total в dual-publish EC counters.)

Лёгкий summary: GET /api/v1/mobile/attention-summary/ — mobile_badge_total, action_open, critical_open, chat_unread, instance_id.

5. available_actions + execute URL; capability semantics

URL: POST /api/v1/event-center/events/{recipient_id}/actions/{action_key}/

Body: { "comment": "…" } (опционально; обязателен, если descriptor requires_comment).

Capability generic_approval_execute=true = протокол готов (descriptor + endpoint + идемпотентность). Не означает «все типы Матрицы уже in-inbox». Пустой список вне волны — ожидаемо; execute → 409 action_not_available.

6. Push data: as-is + purpose / severity / mobile_badge_total

As-is поля сохраняются: recipient_id, work_event_id, event_type, notification_id, entity, instance_id, account_id.

Добавляются: purpose, severity, mobile_badge_total (+ aliases attention_class, type; для ACTION на migration — type=work_event_action).

Push ≠ source of truth; после tap клиент актуализирует состояние с сервера. Delivery не мутирует Inbox.

Доставка (ops): при MOBILE_PUSH_ENABLED и credentials Gateway события уходят через transport mobile_push (очередь Celery push). В режиме cutover parallel path-A должен по-прежнему планировать MOBILE_PUSH для карточек Event Center (_ensure_policy_deliveries / dual-write) — иначе приложение не получит сигнал при «старой» ветке notify. Клиентский deep-link после tap: conversation / inbox (recipient_id + purpose) / task — см. ASK Mobile и mobile-api-overview.

7. RR wire: answered / canceled

Response Request остаётся в Communications (не EC ACTION). Wire-канон UC-M21:

List/detail/resolve обязаны отдавать канон answered (не только ORM resolved). Expiry обновляет ту же строку; второй EC ACTION не создаётся.

8. Search: filters + snoozed breaking

GET /api/v1/event-center/search/

Breaking vs as-is («search never snoozed»):

• snoozed опущен или false — исключить активный snooze (как as-is)
• snoozed=true — только snoozed_until > now()

Фильтр status=auto_resolved → ORM completed|expired + resolution_reason ∈ SYSTEM_CLOSE_REASONS.

9. Cutover waves: Pilot / Wave 2 / Wave 3

Порядок ops: migrate → reconcile counters → deploy → bootstrap event_center_version ≥ 2. Подробности: runbook.

Capabilities bootstrap

GET /api/v1/mobile/bootstrap/ и GET /.well-known/ask-mobile:

При выключенном EC блок version/capabilities отсутствует (legacy Communications). Целевой инстанс с доработкой: event_center_version: 2.