Files
docs/development/backend-workflow.md
T

2.7 KiB

Backend: ответственность и проверка

Предварительные условия

Backend обслуживает публичный HTTP API, локальные сессии, хранение данных и интеграции с внешними источниками. Локальная поставка использует Node 22 и SQLite. Окружению нужны адрес frontend, адрес базы, секрет подписи сессий и отдельный ключ шифрования подключения. T-Bank token вводится пользователем через настройки и не является общим секретом окружения.

Назначение параметров, согласование адресов и сохранение данных описаны в локальном окружении.

Локальная проверка

Проверка backend объединяет статический анализ, проверку типов приложения и тестов, автоматические сценарии и сборку. Она не изменяет исходные материалы; автоматическое исправление форматирования не считается доказательством проверки. Диагностика покрытия доступна отдельно, общего числового порога для backend нет.

Сравнение OpenAPI проверяет соответствие публичного контракта ожиданиям frontend. Валидация запросов, cookie, доступ и ошибки требуют полного HTTP-потока; целостность и конкурентные изменения данных — проверки с изолированной реальной базой.

Известное ограничение: движок Prisma 7.9.1 при применении миграций к новой SQLite-базе возвращает Schema engine error до запуска сквозных тестов. Это воспроизведено и при проверке локального окружения 12 сентября 2026 года. Успех остальных проверок не подтверждает прохождение этой границы. Условие пересмотра — стабильная версия с тремя последовательными успешными применениями миграций на новых базах под Node 22.