Архитектура

Как устроено

Три независимых сервиса. Фронтенд знает только собственный адрес, API знает про сервис правил, сервис правил не знает ни про кого.

браузер
   ↓  /api/*  (тот же origin, без CORS)
web — Next.js, прокси-роут
   ↓  API_URL
api — Node + Express: диалог, карточка, очередь
   ↓  RULES_URL, таймаут 4 с, откат на резервные правила
rules — Python + FastAPI: срочность, длительность, сводка

Стек

Next.js 16 + React 19

Лендинг, опрос и экран врача. Серверный прокси-роут прячет адрес API и снимает вопрос CORS.

Three.js

Модель тела для указания зоны боли. Собрана из примитивов, без внешних файлов — лишний запрос стоил бы секунды до первого кадра.

CSS без фреймворка

Палитра токенами, тёмная тема, параллакс на одной переменной вместо пересчёта в JS.

Node.js + Express

Диалог, сборка карточки, очередь. Ходит в сервис правил и умеет работать без него.

Python + FastAPI

Тревожные признаки, разбор длительности из свободного текста, препараты меняющие тактику, сводка.

pytest

Двадцать четыре теста на правила, включая случаи, которые ломались на практике.

Решения, которые стоит знать

Вердикт считают правила, а не модель

Категория срочности выводится детерминированным кодом. Иначе демонстрационный режим и живой ключ давали бы разные ответы, и проверяющий увидел бы не то, что мы показывали на репетиции.

Сервис правил не обязателен

Node вызывает его с таймаутом в четыре секунды. Если сервис спит, карточка собирается по упрощённым правилам и честно помечается. На бесплатном хостинге это не теоретический сценарий — мы поймали такой отказ на живом деплое.

Модель тела — ввод, а не украшение

Выбранная зона подставляется в первый ответ опроса. Указать пальцем быстрее, чем подбирать слова, но обязательным шагом это не сделано: то же самое можно написать текстом.

Длительность разбирается, а не хранится строкой

«Три недели», «минут сорок назад», «с 1 июля» приводятся к числу дней. Когда пациент называет дату без года, система берёт прошлый год и помечает карточку как требующую уточнения, а не делает вид, что поняла.

Границы

Чего здесь нет

Голосового ввода, ролей и админки, интеграций с медицинскими информационными системами, реальных персональных данных, авторизации сложнее пароля в переменных окружения.

Это MVP под критерии приёмки, а не продукт. Модель тела не является анатомическим пособием: она нужна только для указания области.