Добавлен OTLP-провайдер, реализовано отбрасывание метрик и трейсов в observability + добавлен перезапуск nginx при пересборке контейнеров (ошибка, когда докер меняет адреса сервисов)

codebase/backend/deployment/DEPLOYMENT_GUIDE.ru.md

@@ -535,6 +535,33 @@ docker compose --env-file .env logs --tail=200 <SERVICE_NAME>
 docker inspect "$(docker compose --env-file .env ps -q <SERVICE_NAME>)"
 ```
 
+### 12.1. Повторная раскатка upstream при уже работающем nginx
+
+Nginx разрешает Docker DNS имена upstream при загрузке конфигурации. После
+`up --build`, `pull`, rollback или `--force-recreate` контейнер может получить
+новый IP, а работающий nginx продолжит использовать старый и вернёт `502
+Connection refused`.
+
+После пересоздания `api-backend`, `keycloak`, `sms-service` или
+`bitrix-local-app` обязательно выполните:
+
+```sh
+docker compose --env-file .env up -d --wait \
+  api-backend keycloak sms-service bitrix-local-app
+docker compose --env-file .env exec -T nginx \
+  nginx -t -c /tmp/nginx.conf
+docker compose --env-file .env kill -s HUP nginx
+
+curl -fsS "https://${PUBLIC_HOST}/api/v1/public/app-config" | jq
+curl -fsS \
+  "https://${PUBLIC_HOST}/auth/realms/han-chat/.well-known/openid-configuration" |
+  jq
+```
+
+Не используйте bare-команды `nginx -t` и `nginx -s reload`: рабочая
+конфигурация находится в `/tmp/nginx.conf`, PID — в `/tmp/nginx.pid`, а
+контейнер использует read-only filesystem.
+
 ## 13. Первоначальный выпуск TLS-сертификата
 
 Для ACME требуется работающий nginx по HTTP. В `.env` оставьте

codebase/backend/deployment/RUNBOOK.md

@@ -148,9 +148,19 @@ docker compose up -d delivery-worker safety-recovery-worker cleanup-worker \
   notification-expire-worker notification-draft-cleanup-worker
 docker compose up -d bitrix-local-app bitrix-sync
 docker compose up -d nginx
+docker compose up -d --wait api-backend keycloak sms-service bitrix-local-app
+docker compose exec -T nginx nginx -t -c /tmp/nginx.conf
+docker compose kill -s HUP nginx
 docker compose ps
 ```
 
+Nginx resolves Docker upstream names when its configuration is loaded. After
+recreating `api-backend`, `keycloak`, `sms-service`, or `bitrix-local-app`,
+wait for readiness, validate the active `/tmp/nginx.conf`, and signal the
+master process with `HUP` as shown above. Do not use bare `nginx -t` or
+`nginx -s reload`: they target the default config/PID under read-only
+`/var/run`, not the running Nginx instance.
+
 - [ ] No restart loop/OOM; critical readiness is green.
 - [ ] `notification-expire-worker` runs daily closure with an advisory lock; `notification-draft-cleanup-worker` removes expired drafts/S3 objects. Both entrypoints exist in the installed image.
 - [ ] Only documented Bitrix not-installed/sync-stub degradation remains.

codebase/backend/deployment/RUNBOOK.ru.md

@@ -170,9 +170,19 @@ docker compose up -d delivery-worker safety-recovery-worker cleanup-worker \
   notification-expire-worker notification-draft-cleanup-worker
 docker compose up -d bitrix-local-app bitrix-sync
 docker compose up -d nginx
+docker compose up -d --wait api-backend keycloak sms-service bitrix-local-app
+docker compose exec -T nginx nginx -t -c /tmp/nginx.conf
+docker compose kill -s HUP nginx
 docker compose ps
 ```
 
+Nginx разрешает Docker DNS имена upstream при загрузке конфигурации. После
+любого пересоздания `api-backend`, `keycloak`, `sms-service` или
+`bitrix-local-app` дождитесь их readiness, проверьте именно рабочий
+`/tmp/nginx.conf` и отправьте master-процессу `HUP`, как показано выше.
+Обычные `nginx -t` и `nginx -s reload` использовать нельзя: они обращаются к
+дефолтному config/PID в read-only `/var/run` и не перезагружают рабочий Nginx.
+
 - [ ] Нет циклических перезапусков и OOM; критические readiness-проверки успешны.
 - [ ] `notification-expire-worker` выполняет ежедневное закрытие с advisory lock; `notification-draft-cleanup-worker` очищает просроченные drafts/S3. Оба entrypoint присутствуют в установленном образе.
 - [ ] Сохраняется только документированная деградация: Bitrix не установлен и bitrix-sync работает как заглушка.

codebase/backend/deployment/scripts/seed-personal-notifications-test.sh

@@ -0,0 +1,445 @@
+#!/usr/bin/env bash
+# Создаёт 9 персональных уведомлений всех видов контура P для одного user_id.
+# Запускать на ВМ из каталога backend: /opt/han-chat/backend
+#
+#   cd /opt/han-chat/backend
+#   sed -i 's/\r$//' deployment/scripts/seed-personal-notifications-test.sh
+#   chmod +x deployment/scripts/seed-personal-notifications-test.sh
+#   ./deployment/scripts/seed-personal-notifications-test.sh
+#
+# Токен берётся из .env (NOTIFICATIONS_TOKEN_PRODUCER_TEST) — тот же, что у api-backend.
+# При старте api-backend синхронизирует hash токена в notification_sources.
+
+set -euo pipefail
+
+cd "$(dirname "$0")/../.."
+
+ENV_FILE="${ENV_FILE:-.env}"
+
+if [[ ! -f "$ENV_FILE" ]]; then
+  echo "Не найден $ENV_FILE. Запускайте из каталога backend." >&2
+  exit 1
+fi
+
+env_value() {
+  python3 - "$ENV_FILE" "$1" <<'PY'
+import sys
+from pathlib import Path
+
+path, wanted = sys.argv[1:]
+for raw in Path(path).read_text(encoding="utf-8").splitlines():
+    line = raw.strip()
+    if not line or line.startswith("#") or "=" not in line:
+        continue
+    key, value = line.split("=", 1)
+    if key.strip() == wanted:
+        value = value.strip()
+        if len(value) >= 2 and value[0] == value[-1] and value[0] in "\"'":
+            value = value[1:-1]
+        print(value)
+        break
+else:
+    raise SystemExit(f"missing environment variable: {wanted}")
+PY
+}
+
+trim_token() {
+  printf '%s' "$1" | tr -d '\r\n\t '
+}
+
+TOKEN="$(trim_token "${NOTIFICATIONS_TOKEN_PRODUCER_TEST:-}")"
+if [[ -z "$TOKEN" ]]; then
+  TOKEN="$(trim_token "$(env_value NOTIFICATIONS_TOKEN_PRODUCER_TEST 2>/dev/null || true)")"
+fi
+if [[ -z "$TOKEN" ]]; then
+  read -rsp "NOTIFICATIONS_TOKEN_PRODUCER_TEST (из .env не найден): " TOKEN
+  echo
+  TOKEN="$(trim_token "$TOKEN")"
+fi
+
+read -rp "USER_ID клиента: " USER_ID
+USER_ID="$(trim_token "$USER_ID")"
+
+if [[ -z "${TOKEN}" || -z "${USER_ID}" ]]; then
+  echo "TOKEN и USER_ID обязательны." >&2
+  exit 1
+fi
+
+echo "Токен: ${#TOKEN} символов (первые 8: ${TOKEN:0:8}…)"
+
+PAYLOAD_DIR="$(mktemp -d)"
+trap 'rm -rf "$PAYLOAD_DIR"' EXIT
+
+BASE_TS="$(date +%s)"
+RUN_ID="manual-test-${BASE_TS}"
+
+NOW="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+DT_URGENT="$(date -u -d "${NOW} +0 seconds" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v+0S +"%Y-%m-%dT%H:%M:%SZ")"
+DT_PAYMENT="$(date -u -d "${NOW} - 60 seconds" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v-60S +"%Y-%m-%dT%H:%M:%SZ")"
+DT_DOCS_REQ="$(date -u -d "${NOW} - 120 seconds" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v-120S +"%Y-%m-%dT%H:%M:%SZ")"
+DT_DOCS_READY="$(date -u -d "${NOW} - 180 seconds" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v-180S +"%Y-%m-%dT%H:%M:%SZ")"
+DT_STATUS="$(date -u -d "${NOW} - 240 seconds" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v-240S +"%Y-%m-%dT%H:%M:%SZ")"
+DT_REMINDER="$(date -u -d "${NOW} - 300 seconds" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v-300S +"%Y-%m-%dT%H:%M:%SZ")"
+DT_NEWS="$(date -u -d "${NOW} - 360 seconds" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v-360S +"%Y-%m-%dT%H:%M:%SZ")"
+DT_PROMO="$(date -u -d "${NOW} - 420 seconds" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v-420S +"%Y-%m-%dT%H:%M:%SZ")"
+DT_ADS="$(date -u -d "${NOW} - 480 seconds" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v-480S +"%Y-%m-%dT%H:%M:%SZ")"
+
+DEADLINE_URGENT="$(date -u -d "${NOW} + 2 days" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v+2d +"%Y-%m-%dT%H:%M:%SZ")"
+DEADLINE_DOCS="$(date -u -d "${NOW} + 5 days" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v+5d +"%Y-%m-%dT%H:%M:%SZ")"
+DEADLINE_REMINDER="$(date -u -d "${NOW} + 1 day" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v+1d +"%Y-%m-%dT%H:%M:%SZ")"
+EXPIRE_PAYMENT="$(date -u -d "${NOW} + 3 days" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -v+3d +"%Y-%m-%dT%H:%M:%SZ")"
+
+write_payload() {
+  local name="$1"
+  cat > "${PAYLOAD_DIR}/${name}.json"
+}
+
+create_notification() {
+  local label="$1"
+  local payload_file="${PAYLOAD_DIR}/${label}.json"
+  if [[ ! -f "$payload_file" ]]; then
+    echo "Нет payload: ${payload_file}" >&2
+    return 1
+  fi
+  echo
+  echo "========== ${label} =========="
+  docker run --rm \
+    --network han-chat-backend \
+    -v "${payload_file}:/payload.json:ro" \
+    curlimages/curl:latest \
+    -sS -i \
+    -X POST \
+    'http://api-backend:8000/internal/notifications/v1/notifications' \
+    -H "Authorization: Bearer ${TOKEN}" \
+    -H 'Content-Type: application/json; charset=utf-8' \
+    --data-binary @/payload.json
+}
+
+prepare_docs_in_s3() {
+  echo >&2
+  echo "========== PREP: загрузка тестовых документов в S3 для docs_ready ==========" >&2
+  docker compose --env-file "$ENV_FILE" exec -T \
+    -e "USER_ID=${USER_ID}" \
+    -e "RUN_ID=${RUN_ID}" \
+    api-backend python3 - <<'PY'
+import hashlib
+import os
+import uuid
+
+import boto3
+from botocore.client import Config
+
+from app.settings import Settings
+
+USER_ID = os.environ["USER_ID"]
+settings = Settings()
+
+client = boto3.client(
+    "s3",
+    endpoint_url=str(settings.selectel_s3_endpoint_url),
+    aws_access_key_id=settings.selectel_s3_access_key.get_secret_value(),
+    aws_secret_access_key=settings.selectel_s3_secret_key.get_secret_value(),
+    config=Config(signature_version="s3v4", s3={"addressing_style": "virtual"}),
+)
+bucket = settings.selectel_s3_bucket_documents
+
+fixtures = [
+    {
+        "prefix": "CONTRACT",
+        "title": "Уведомление о постановке на миграционный учёт.pdf",
+        "body": b"""%PDF-1.4
+1 0 obj<</Type/Catalog/Pages 2 0 R>>endobj
+2 0 obj<</Type/Pages/Kids[3 0 R]/Count 1>>endobj
+3 0 obj<</Type/Page/MediaBox[0 0 612 792]/Parent 2 0 R>>endobj
+xref
+0 4
+trailer<</Size 4/Root 1 0 R>>
+startxref
+100
+%%EOF
+""",
+    },
+    {
+        "prefix": "RESULTS",
+        "title": "Справка о соблюдении миграционного законодательства.pdf",
+        "body": b"""%PDF-1.4
+1 0 obj<</Type/Catalog/Pages 2 0 R>>endobj
+2 0 obj<</Type/Pages/Kids[3 0 R]/Count 1>>endobj
+3 0 obj<</Type/Page/MediaBox[0 0 612 792]/Parent 2 0 R>>endobj
+xref
+0 4
+trailer<</Size 4/Root 1 0 R>>
+startxref
+100
+%%EOF
+""",
+    },
+]
+
+lines: list[str] = []
+for item in fixtures:
+    doc_id = str(uuid.uuid4())
+    key = f"documents/users/{USER_ID}/{doc_id}"
+    body = item["body"]
+    checksum = hashlib.sha256(body).hexdigest()
+    client.put_object(
+        Bucket=bucket,
+        Key=key,
+        Body=body,
+        ContentType="application/pdf",
+    )
+    p = item["prefix"]
+    lines.append(
+        f"{p}_KEY={key}\n"
+        f"{p}_TITLE={item['title']}\n"
+        f"{p}_SIZE={len(body)}\n"
+        f"{p}_SHA256={checksum}"
+    )
+
+print("\n".join(lines))
+PY
+}
+
+echo "Run ID: ${RUN_ID}"
+echo "User ID: ${USER_ID}"
+
+read -rp "Подготовить документы в S3 для docs_ready? [Y/n]: " PREP_DOCS
+PREP_DOCS="${PREP_DOCS:-Y}"
+
+CONTRACT_KEY=""
+CONTRACT_TITLE=""
+CONTRACT_SIZE=""
+CONTRACT_SHA256=""
+RESULTS_KEY=""
+RESULTS_TITLE=""
+RESULTS_SIZE=""
+RESULTS_SHA256=""
+
+if [[ "${PREP_DOCS^^}" != "N" ]]; then
+  PREP_OUT="$(prepare_docs_in_s3)"
+  echo "${PREP_OUT}"
+  while IFS= read -r line; do
+    [[ "$line" =~ ^([A-Z][A-Z0-9_]*)=(.*)$ ]] || continue
+    declare "${BASH_REMATCH[1]}=${BASH_REMATCH[2]}"
+  done <<< "${PREP_OUT}"
+fi
+
+# --- payloads ---
+
+write_payload urgent <<JSON
+{
+  "user_id": "${USER_ID}",
+  "notification_type": "urgent",
+  "source": "producer_test",
+  "external_id": "${RUN_ID}-urgent",
+  "notification_datetime": "${DT_URGENT}",
+  "header": "Истекает срок постановки на учёт",
+  "text": "По данным сервиса, срок уведомления о месте пребывания истекает 29 июля — просрочка влечёт административную ответственность.",
+  "priority_override": 1,
+  "details": {
+    "deadline": "${DEADLINE_URGENT}",
+    "details_header": "Срочно: соблюдение сроков миграционного учёта",
+    "details_text": "Федеральный закон № 109-ФЗ обязывает иностранного гражданина в течение 7 рабочих дней с даты въезда подать уведомление о прибытии в место пребывания (если иное не предусмотрено для вашего правового статуса).\n\nПо имеющимся данным крайний срок для вашего случая — 29.07.2026. Нарушение сроков может повлечь штраф от 2 000 до 5 000 ₽ и, при повторном нарушении, более серьёзные последствия, включая административное выдворение.\n\nЕсли уведомление уже подано — отметьте «Готово»; если нужна помощь — напишите оператору в чат.",
+    "todo_header": "Что проверить сейчас",
+    "todo_plan": [
+      {"number": 1, "text": "Сверьте дату въезда и адрес фактического проживания в анкете личного кабинета."},
+      {"number": 2, "text": "Подготовьте копии паспорта, миграционной карты и документа о праве пребывания (виза, РВП, ВНЖ, патент)."},
+      {"number": 3, "text": "Нажмите «Готово», если уведомление уже подано через МВД или принимающую сторону."},
+      {"number": 4, "text": "При сомнениях выберите «Сделаю позже» и задайте вопрос оператору — укажите город и тип документа."}
+    ]
+  }
+}
+JSON
+
+write_payload payment_pending <<JSON
+{
+  "user_id": "${USER_ID}",
+  "notification_type": "payment_pending",
+  "source": "producer_test",
+  "external_id": "${RUN_ID}-payment_pending",
+  "notification_datetime": "${DT_PAYMENT}",
+  "header": "Оплата сопровождения по миграционному учёту",
+  "text": "Счёт №МИГ-2026-0718 на 18 500 ₽ за подготовку пакета и подачу уведомления — оплатите до 30 июля.",
+  "price": "18500.00",
+  "old_price": "22000.00",
+  "date_expired": "${EXPIRE_PAYMENT}",
+  "payment_url": "https://pay.han0107.ru/checkout/test-${RUN_ID}"
+}
+JSON
+
+write_payload docs_required <<JSON
+{
+  "user_id": "${USER_ID}",
+  "notification_type": "docs_required",
+  "source": "producer_test",
+  "external_id": "${RUN_ID}-docs_required",
+  "notification_datetime": "${DT_DOCS_REQ}",
+  "header": "Загрузите документы для миграционного учёта",
+  "text": "Для проверки соблюдения миграционного законодательства нужен комплект документов — загрузите до 01 августа.",
+  "details": {
+    "deadline": "${DEADLINE_DOCS}",
+    "details_header": "Документы для постановки на миграционный учёт",
+    "details_text": "Специалист проверит комплект в течение 1 рабочего дня после отправки. Принимаются чёткие фото или сканы в JPG, PNG, PDF. Каждый файл — до 10 МБ, не более 10 файлов за одну отправку.\n\nВсе документы должны быть действительными на дату проверки. Если какого-то документа пока нет (например, договор найма ещё не подписан), загрузите доступные — оператор подскажет порядок действий и допустимые альтернативы.",
+    "todo_header": "Необходимый пакет",
+    "todo_plan": [
+      {"number": 1, "text": "Паспорт: страница с фото, действующая виза или иной документ на право пребывания."},
+      {"number": 2, "text": "Миграционная карта с отметкой о въезде (обе стороны)."},
+      {"number": 3, "text": "Документ о месте пребывания: договор найма, свидетельство собственности или письмо принимающей стороны."},
+      {"number": 4, "text": "При трудовой деятельности — копия патента или разрешения на работу (если применимо)."},
+      {"number": 5, "text": "Нажмите «Отправить документы», когда все файлы приложены."}
+    ],
+    "send_documents": true
+  }
+}
+JSON
+
+if [[ -n "${CONTRACT_KEY}" && -n "${RESULTS_KEY}" ]]; then
+  write_payload docs_ready <<JSON
+{
+  "user_id": "${USER_ID}",
+  "notification_type": "docs_ready",
+  "source": "producer_test",
+  "external_id": "${RUN_ID}-docs_ready",
+  "notification_datetime": "${DT_DOCS_READY}",
+  "header": "Миграционные документы готовы",
+  "text": "Уведомление о постановке на учёт и справка о соблюдении требований закона сформированы — скачайте в деталях.",
+  "details": {
+    "details_header": "Документы по миграционному учёту",
+    "details_text": "Документы подготовлены на основании переданных вами данных и проверены специалистом. Сохраните копии на устройство — они могут понадобиться при проверке или продлении статуса пребывания.\n\nСсылки на скачивание действуют ограниченное время. После первого скачивания карточка скроется с главной, но останется в Центре уведомлений до нажатия «Понятно».",
+    "documents": [
+      {
+        "object_key": "${CONTRACT_KEY}",
+        "title": "${CONTRACT_TITLE}",
+        "mime_type": "application/pdf",
+        "size_bytes": ${CONTRACT_SIZE},
+        "checksum_sha256": "${CONTRACT_SHA256}"
+      },
+      {
+        "object_key": "${RESULTS_KEY}",
+        "title": "${RESULTS_TITLE}",
+        "mime_type": "application/pdf",
+        "size_bytes": ${RESULTS_SIZE},
+        "checksum_sha256": "${RESULTS_SHA256}"
+      }
+    ]
+  }
+}
+JSON
+fi
+
+write_payload status_changed <<JSON
+{
+  "user_id": "${USER_ID}",
+  "notification_type": "status_changed",
+  "source": "producer_test",
+  "external_id": "${RUN_ID}-status_changed",
+  "notification_datetime": "${DT_STATUS}",
+  "header": "Статус миграционной заявки обновлён",
+  "text": "Заявка №МГ-8841 переведена на этап «Проверка комплектности документов».",
+  "details": {
+    "details_header": "Ход рассмотрения заявки №МГ-8841",
+    "details_text": "27.07.2026 в 11:42 специалист принял ваш пакет документов в работу. Сейчас выполняется проверка на соответствие требованиям миграционного законодательства РФ: сроки пребывания, адрес учёта, основания для трудовой деятельности.\n\nОжидаемое время на этом этапе: 1–2 рабочих дня. При выявлении недостающих документов вы получите отдельное уведомление с перечнем. При успешной проверке будет сформировано уведомление о постановке на учёт.",
+    "todo_header": "Этапы обработки",
+    "todo_plan": [
+      {"number": 1, "text": "Документы получены — выполнено 25.07.2026"},
+      {"number": 2, "text": "Первичная верификация — выполнено 27.07.2026"},
+      {"number": 3, "text": "Проверка комплектности и сроков — в работе"},
+      {"number": 4, "text": "Формирование уведомления / рекомендаций — ожидает"}
+    ]
+  }
+}
+JSON
+
+write_payload reminder <<JSON
+{
+  "user_id": "${USER_ID}",
+  "notification_type": "reminder",
+  "source": "producer_test",
+  "external_id": "${RUN_ID}-reminder",
+  "notification_datetime": "${DT_REMINDER}",
+  "header": "Напоминание: продление патента",
+  "text": "28 июля истекает срок действия патента — подайте заявление на продление заранее.",
+  "details": {
+    "deadline": "${DEADLINE_REMINDER}",
+    "details_header": "Сроки продления документа на право работы",
+    "details_text": "Патент на работу необходимо продлевать заблаговременно — подача заявления рекомендуется не позднее чем за 10–15 рабочих дней до даты окончания действия. Просрочка означает прекращение права на трудовую деятельность и риск штрафа по ст. 18.15 КоАП РФ.\n\nДля продления потребуются: действующий патент, чеки об оплате авансовых платежей по НДФЛ, полис ДМС, сертификат о знании русского языка (если срок действия истекает), договор найма или иной документ о месте пребывания.",
+    "todo_header": "Чек-лист перед подачей",
+    "todo_plan": [
+      {"number": 1, "text": "Проверьте дату окончания патента в личном кабинете или на бланке документа."},
+      {"number": 2, "text": "Убедитесь, что авансовые платежи по НДФЛ оплачены без просрочки."},
+      {"number": 3, "text": "Подготовьте сканы документов — при необходимости загрузите через уведомление «Требуются документы»."},
+      {"number": 4, "text": "При вопросах напишите оператору — укажите регион и номер патента."}
+    ]
+  }
+}
+JSON
+
+write_payload news <<JSON
+{
+  "user_id": "${USER_ID}",
+  "notification_type": "news",
+  "source": "producer_test",
+  "external_id": "${RUN_ID}-news",
+  "notification_datetime": "${DT_NEWS}",
+  "header": "Изменения в правилах миграционного учёта",
+  "text": "С 1 августа 2026 уточнены сроки подачи уведомлений при смене адреса пребывания.",
+  "details": {
+    "details_header": "Что изменилось для иностранных граждан",
+    "details_text": "С 01.08.2026 при смене адреса фактического проживания в том же субъекте РФ уведомление необходимо подать в течение 3 рабочих дней (ранее — 7). При переезде в другой регион срок остаётся 7 рабочих дней с даты регистрации по новому адресу.\n\nСервис HAN напомнит о приближающихся сроках через Центр уведомлений. Рекомендуем заранее подготовить копии договора найма и отметку о регистрации — это ускорит проверку оператором.\n\nПодробности процедуры — в чате с оператором или на официальном портале МВД России."
+  }
+}
+JSON
+
+write_payload promo_personal <<JSON
+{
+  "user_id": "${USER_ID}",
+  "notification_type": "promo_personal",
+  "source": "producer_test",
+  "external_id": "${RUN_ID}-promo_personal",
+  "notification_datetime": "${DT_PROMO}",
+  "header": "Скидка 15% на годовое сопровождение",
+  "text": "Персональное предложение: контроль сроков патента, учёта и уведомлений — до конца месяца.",
+  "price": "15725.00",
+  "old_price": "18500.00",
+  "date_expired": "${EXPIRE_PAYMENT}",
+  "chat_message_text": "Здравствуйте! Хочу подключить годовое сопровождение по соблюдению миграционного законодательства со скидкой 15%. Подскажите, что входит в пакет и как оформить."
+}
+JSON
+
+write_payload ads_personal <<JSON
+{
+  "user_id": "${USER_ID}",
+  "notification_type": "ads_personal",
+  "source": "producer_test",
+  "external_id": "${RUN_ID}-ads_personal",
+  "notification_datetime": "${DT_ADS}",
+  "header": "Бесплатная проверка миграционного статуса",
+  "text": "15 минут с экспертом: оценим риски и составим чек-лист обязательных действий.",
+  "chat_message_text": "Здравствуйте! Хочу воспользоваться бесплатной проверкой миграционного статуса. Подскажите, как записаться и какие документы подготовить к консультации."
+}
+JSON
+
+# --- отправка ---
+
+create_notification urgent
+create_notification payment_pending
+create_notification docs_required
+if [[ -f "${PAYLOAD_DIR}/docs_ready.json" ]]; then
+  create_notification docs_ready
+else
+  echo
+  echo "========== docs_ready — ПРОПУЩЕН =========="
+fi
+create_notification status_changed
+create_notification reminder
+create_notification news
+create_notification promo_personal
+create_notification ads_personal
+
+echo
+echo "========== Готово =========="
+echo "External ID prefix: ${RUN_ID}-*"
+echo
+echo "Если видите 401: проверьте NOTIFICATIONS_TOKEN_PRODUCER_TEST в .env и перезапустите api-backend."
+echo "  grep NOTIFICATIONS_TOKEN_PRODUCER_TEST .env"
+echo "  docker compose --env-file .env up -d --force-recreate api-backend"

codebase/backend/deployment/scripts/ssl-renew.sh

@@ -9,5 +9,5 @@ flock -n 9 || { echo '{"event":"tls.renew.skipped","reason":"lock_busy"}'; exit
 docker compose --profile certbot run --rm certbot renew \
   --webroot -w /var/www/certbot --quiet
 docker compose exec -T nginx nginx -t -c /tmp/nginx.conf
-docker compose exec -T nginx nginx -s reload
+docker compose kill -s HUP nginx
 echo "{\"event\":\"tls.renew.completed\",\"timestamp\":\"$(date -u +%FT%TZ)\"}"

codebase/backend/deployment/scripts/verify-observability.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+NETWORK="${OBSERVABILITY_NETWORK:-han-chat-observability}"
+COLLECTOR_SERVICE="${COLLECTOR_SERVICE:-otel-collector}"
+errors=0
+
+ok() { printf 'OK   %s\n' "$*"; }
+fail() { printf 'FAIL %s\n' "$*" >&2; errors=$((errors + 1)); }
+
+collector_id="$(docker compose ps -q "$COLLECTOR_SERVICE" 2>/dev/null || true)"
+if [[ -n "$collector_id" ]] &&
+  [[ "$(docker inspect --format '{{.State.Status}}' "$collector_id")" == running ]]; then
+  ok "Collector service is running"
+else
+  fail "Collector service '$COLLECTOR_SERVICE' is not running"
+fi
+
+for service in sms-service sms-worker; do
+  if docker compose exec -T "$service" python - <<'PY' >/dev/null 2>&1
+import os
+import urllib.request
+port = os.environ.get("SMS_METRICS_PORT", "9464") if "worker" in os.environ.get("OTEL_SERVICE_NAME", "") else "8080"
+urllib.request.urlopen(f"http://127.0.0.1:{port}/metrics", timeout=3).read(1024)
+PY
+  then
+    ok "${service} metrics endpoint"
+  else
+    fail "${service} metrics endpoint"
+  fi
+done
+
+docker run --rm --network "$NETWORK" \
+  ghcr.io/open-telemetry/opentelemetry-collector-contrib/telemetrygen:latest \
+  traces --otlp-endpoint otel-collector:4317 --otlp-insecure \
+  --service han-chat-e2e-canary --traces 100 --rate 20 >/dev/null \
+  && ok "100 canary traces submitted" \
+  || fail "telemetrygen failed"
+
+bad_logs="$(
+  docker compose logs --since=10m "$COLLECTOR_SERVICE" 2>&1 |
+    grep -Ei 'queue is full|connection refused|tls:|Unauthenticated|Permanent error' || true
+)"
+if [[ -z "$bad_logs" ]]; then
+  ok "No exporter/queue errors in last 10 minutes"
+else
+  fail "Collector reports exporter/queue errors"
+  printf '%s\n' "$bad_logs" >&2
+fi
+
+if ((errors)); then
+  printf 'Observability verification failed: %d check(s)\n' "$errors" >&2
+  exit 1
+fi
+
+cat <<'EOF'
+Локальный канал исправен. В SigNoz проверьте за последние 15 минут:
+  service.name = han-chat-e2e-canary
+  service.namespace = han-chat
+Затем выполните synthetic API request и проверьте общий trace между
+api-backend и dependency spans, service.version и deployment.environment.
+EOF