Files
docs/development/backend-workflow.md
T

32 lines
2.7 KiB
Markdown

# Backend: ответственность и проверка
## Предварительные условия
Backend обслуживает публичный HTTP API, локальные сессии, хранение данных
и интеграции с внешними источниками. Локальная поставка использует Node 22
и SQLite. Окружению нужны адрес frontend, адрес базы, секрет подписи сессий
и отдельный ключ шифрования подключения. T-Bank token вводится пользователем
через настройки и не является общим секретом окружения.
Назначение параметров, согласование адресов и сохранение данных описаны в
[локальном окружении](local-workspace.md).
## Локальная проверка
Проверка backend объединяет статический анализ, проверку типов приложения
и тестов, автоматические сценарии и сборку. Она не изменяет исходные материалы;
автоматическое исправление форматирования не считается доказательством проверки.
Диагностика покрытия доступна отдельно, общего числового порога для backend нет.
[Сравнение OpenAPI](runtime-openapi-verification.md) проверяет соответствие
публичного контракта ожиданиям frontend. Валидация запросов, cookie, доступ
и ошибки требуют полного HTTP-потока; целостность и конкурентные изменения
данных — проверки с изолированной реальной базой.
**Известное ограничение:** движок Prisma 7.9.1 при применении миграций к новой
SQLite-базе возвращает `Schema engine error` до запуска сквозных тестов.
Это воспроизведено и при проверке локального окружения 12 сентября 2026 года.
Успех остальных проверок не подтверждает прохождение этой границы. Условие
пересмотра — стабильная версия с тремя последовательными успешными применениями
миграций на новых базах под Node 22.