PTSRaiAgent/web

Веб-приложение пациента

Ещё один канал к тому же движку диалога, что и Telegram-бот (ADR-004): согласие, онбординг, шкалы, чек-ины и кризисный скрипт приходят из app/dialog через /api/v1/dialog/{token}/.... Бот продолжает работать параллельно.

Запуск

make up                 # или: uv run uvicorn app.main:app --port 8000
cd web && npm install
npm run dev             # http://localhost:5173 — /api проксируется на :8000

Интерфейс открывается на :5173; на :8000 работает только API (/docs).

Вход

Способ	Что происходит	API
ЕМИАС (демо)	одноразовый код от врача → токен пациента, привязка к врачу; или синтетический демо-пациент	POST /auth/emias, POST /auth/emias/demo
Анонимно	случайный токен, в identity-БД ничего не пишется, врач не привязан	POST /auth/anonymous

Реальная авторизация ЕМИАС/ЕСИА подключается как IdentityProvider (app/integrations/emias_mock.py) без изменений во фронтенде.

Структура (под перенос в мобильное приложение)

src/theme/tokens.css   цвета, шрифт, отступы — единственный источник; три цвета = три направления сервиса
src/content/ru.ts      все тексты интерфейса (тексты диалога — в config/texts/, их отдаёт движок)
src/api/               типы-зеркала контрактов бэкенда и клиент
src/session/store.ts   хранение сессии за интерфейсом: localStorage → Capacitor Preferences/Keychain
src/dialog/            общий разговор с движком (DialogContext) и выбор вида экрана по ответу движка (step.ts)
src/screens/           экраны по docs/mock: вход A1–A3, фокус-экран /flow (A4–A6, B, D, E1–E3, E5, G2–G4),
                       «Сегодня» C1/C2, «Лекарства» E4, «Врач» F, «Профиль» H, «Сообщения» I1

Как устроены экраны

Логика сценариев живёт только в движке диалога. Экран /flow берёт последний ответ движка и рисует его как отдельный экран мокапа: вопрос анкеты с прогрессом «Вопрос n из N», шкала 0–10, свободный текст, напоминание о лекарстве, согласие, кризисный экран. Новый сценарий в движке появится в вебе без правок фронтенда.

Данные для «Сегодня» и «Лекарства» — GET /api/v1/me/{token}/today (дозы на сегодня, отметки за неделю, следующий визит, время по демо-часам).

Анкеты, дневник и модуль «Лекарства»

• Анкеты этапа 1 (C-SSRS, PHQ-2/PHQ-9, фильтр травмы, TSQ, PCL-5, RUS-AUDIT-S/RUS-AUDIT) и дневник этапа 2 — тот же фокус-экран. Пункт распознаётся по кнопкам iq:…; чип раздела, «Вопрос n из N» (для адаптивных форм — без «из N»), период, «Продолжить позже», «Мне нужна помощь сейчас», пропуск необязательных пунктов, ввод часов сна, шкалы 0–10 с подписями концов, таблица стандартных порций для п. 2 RUS-AUDIT (из утверждённого бланка, без калькулятора). Метаданные — GET /api/v1/instruments/catalog.
• Анкеты включаются только в демо: INTAKE_DEMO=1 (вместе с DEMO_CLOCK). Клинический замок в config/intake_runtime.yaml не трогается. Пока нет подписанной политики маршрутизации и формы C-SSRS «с последнего контакта», завершённый опрос и дневник уходят на оценку специалиста — UI показывает это отдельным экраном.
• Карточка препарата /meds/:ref — справочник data/meds/meds_reference.json (собирается scripts/build_meds_reference.py по КР Минздрава: депрессия 2024, ПТСР 2023): когда ждать эффекта (с днём лечения), сколько принимать, что может беспокоить, когда срочно к врачу, «не прекращать самостоятельно». Дозы не показываются. Черновик — вычитывает психиатр. GET /api/v1/meds/reference.
• «Сообщить о побочном эффекте» доступно всегда (med:side_effects:<доза или дата>), карточка «День N лечения» на «Сегодня» — в 1-й, 7-й и 14-й день.

Мобильная версия: mobile-first вёрстка, safe-area, hash-роутинг и относительные пути сборки — dist/ оборачивается Capacitor без изменений (VITE_API_BASE = абсолютный адрес API).

Известные ограничения прототипа

• Токен пациента используется как учётные данные сессии; в проде — короткоживущие серверные сессии.
• Подбор кодов не ограничен по частоте.
• В демо нет сида кодов подключения: для показа используйте демо-пациента.