Поддержка (helpdesk)

Мини-хелпдеск Platform: пользователь в приложении создаёт заявку → она появляется в админке Поддержка.

Поток

Приложение (кнопка «Помощь»)
  → SDK.createSupportTicket(+ вложения)
  → Platform API
  → Админка → Поддержка (список / карточка / ответ)

Что отправляет клиент

Поле	Назначение
subject / description	Тема и текст проблемы
category	bug | billing | account | feature | other
platform, app_version, os_version, device_name, installation_id, locale	Среда запуска
metadata	Любой контекст: экран, extra
вложения	скрины, видео, логи (отдельным upload)

Приложение определяется по application_code + X-Public-Key. Нужен JWT пользователя.

Опциональные поля обратной связи (contact_*) — только если продукт сам собирает их у пользователя; в примерах и публичных материалах не указывайте реальные ФИО, email или телефоны.

Админка

• Список: статус, приложение, тема, дата
• Карточка: описание, metadata, файлы, переписка
• Статусы: new → open → waiting_user / waiting_staff → resolved / closed
• Ответ пользователю или внутренняя заметка (не видна клиенту)

SDK

TypeScript: createSupportTicket, uploadSupportAttachment, listMySupportTickets, getSupportTicket, replyToSupportTicket.

Flutter: те же методы на RaidBossPlatformClient.

Пример (TS):

const { data: ticket } = await platform.createSupportTicket({
  subject: "Sync issue",
  description: "…",
  category: "bug",
  platform: "windows",
  app_version: "1.2.0",
  installation_id: installationId,
  metadata: { screen: "sync_center" },
});

await platform.uploadSupportAttachment(ticket.id, logBlob, {
  filename: "app.log",
  kind: "log",
});

Что ещё можно добавить позже

• Уведомление админу о новой заявке
• Ответ пользователю вне админки
• Гостевые заявки без JWT
• SLA / время первого ответа
• Автоприкрепление последних N логов из SDK-буфера