Реализована интеграция с СМС провайдером

architectory/arch-00-glossary.md

@@ -34,6 +34,9 @@
 | `text_resources` | `han_app` | Тексты UI по мнемоникам |
 | `popular_questions` | `han_app` | Популярные вопросы главного экрана |
 | `dialog_sessions` | `bitrix_local` | Маппинг чата Open Lines |
+| `sms_template` | `sms` | Версионируемый согласованный SMS-шаблон; active-версия уникальна для `code`+`channel`+`locale` |
+| `sms_setting` | `sms` | Технические runtime-настройки `sms-service`, не секреты и не OTP product settings |
+| `sms_outbound_message` | `sms` | Бессрочный журнал заказа, отправки и доставки SMS; источник истины provider status |
 
 ## Идентификаторы
 
@@ -50,6 +53,9 @@
 | `session_id` | ID сессии Open Lines (поле `dialog_sessions`; не путать с `ux_session_id`) |
 | `task_id` | ID async-проверки Message Safety |
 | `request_id` | Корреляция HTTP-запроса (заголовок `X-Request-ID`) |
+| `sms_message_id` | UUID `sms.sms_outbound_message.id`; логическая ссылка из Keycloak challenge/event, межсхемного FK нет |
+| `provider_message_id` | `messageUuid` i-Digital Direct; хранится только в `sms-service` |
+| `provider_external_id` | `externalMessageId`; в v1 равен `sms_message_id` и является корреляцией, а не доказанной идемпотентностью Direct |
 
 Публичные id сущностей — **UUID**.
 
@@ -127,9 +133,16 @@ Realtime-событие `message.status` передаёт актуальные `
 
 ## Строковые enum vs справочники
 
-- **Строковые enum** (значения в API/контрактах): `Dialog.status`, `Message.sender_type`, `Message.safety_status`, `Message.delivery_status`, `MessageAttachment.scan_status`, `content_kind`, `start_reason`.
+- **Строковые enum** (значения в API/контрактах): `Dialog.status`, `Message.sender_type`, `Message.safety_status`, `Message.delivery_status`, `MessageAttachment.scan_status`, `content_kind`, `start_reason`, SMS `send_status`, SMS `delivery_status`, OTP `challenge_status`.
 - **Справочники (sequence ID)** — для больших/изменяемых списков UI и доменных классификаторов (типы документов post-MVP, причины и т.п.); правило — [`arch-05-agent-development-process.md`](arch-05-agent-development-process.md).
 
+### SMS и OTP статусы
+
+- `sms_outbound_message.send_status`: `pending`, `accepted`, `rejected`, `failed`, `uncertain`, `skipped`.
+- `sms_outbound_message.delivery_status`: `unknown`, `sent`, `delivered`, `undelivered`, `unsent`.
+- `han_otp_challenge.challenge_status`: `ordering`, `active`, `consumed`, `superseded`, `expired`, `limited`, `order_failed`.
+- Provider statuses принадлежат только `sms-service`: Keycloak не читает их и не использует для verify.
+
 ## Мнемоники internal API
 
 Префикс: **`/internal/{service_mnemonic}/v1/`**. Health: **`/health/*`**.
@@ -140,6 +153,14 @@ Realtime-событие `message.status` передаёт актуальные `
 | `openlines` | `bitrix-local-app`, приёмник inbox на `api-backend` |
 | `sync` | `bitrix-sync` |
 | `settings` | internal settings bridge на `api-backend` для Keycloak SPI |
+| `sms` | `sms-service`; durable order/read API во внутренней сети |
+
+## SMS-конфигурация
+
+- Product OTP settings: `otp.phone.code_length`, `otp.phone.ttl_seconds`, `otp.phone.sms_order_timeout_ms` и лимиты — `han_app.app_settings`, выдаются Keycloak через settings bridge.
+- Runtime SMS settings: `provider.idgtl.*` и `worker.*` — `sms.sms_setting`.
+- Infra/secrets env: `KEYCLOAK_SMS_SERVICE_URL`, `SMS_DATABASE_URL`, парные `KEYCLOAK_SMS_SERVICE_TOKEN`/`SMS_SERVICE_TOKEN`, `IDGTL_SMS_BASE_URL`, `IDGTL_SMS_API_KEY`, `IDGTL_SMS_CALLBACK_PUBLIC_URL`, `IDGTL_SMS_CALLBACK_USERNAME`, `IDGTL_SMS_CALLBACK_PASSWORD`.
+- Текст, placeholders и sender template не хранятся в env: они принадлежат `sms_template`; default sender — `sms_setting`.
 
 ## Bitrix24 Open Lines