- миграции лежат по модулям в `apps/api/src/<module>/migrations/`; `tools/buildDataSource.ts`
сканирует `apps/api/src/**/migrations/` и генерирует список в `apps/api/src/migrations.ts`
- `deploy-staging` накатывает миграции шагами `migration:show` и `migration:run -t each`
- стенды получают маршрутизацию через лейблы `caddy` и `caddy.reverse_proxy`, web-образ стенда
собирается с `CADDYFILE=Caddyfile.staging`
## Мотивация
Миграции нужно накатывать на стендах автоматически и держать рядом с модулем, которому они
принадлежат, а деплой — сводить к одному шагу, который сам копирует компоуз-файл на хост и выполняет
скрипт.
## Ключевые моменты реализации
- `Caddyfile.staging` слушает `:80` без хостового матчера и HTTPS: имена стендов динамические,
маршрутизацию и TLS берёт внешний caddy-docker-proxy по лейблам
Reviewed-on: jt4d/jt4d#2
Co-authored-by: Arswarog <arswarog@yandex.ru>
Логгер на pino + nestjs-pino вместо стандартного ConsoleLogger: уровни
trace…fatal, details объектом, человекочитаемый вывод в dev и JSON в
проде,
автоматические HTTP-логи (reqId, url, statusCode, responseTime). Для
тестов —
LocalLoggerModule.forTesting() со своим TestingLogger и матчерами.
Документация по логированию — в docs/55-logging.
Порядок импортов в app.module, app.controller, typeorm.config и web-файлах,
пустая строка перед комментарием в styles.css, prettier в
.github/workflows/ci.yml. Каталог .agents исключён из prettier: это
сгенерированные файлы Nx, они перезаписываются инструментом.
- apps/api: @nestjs/swagger, @nestjs/terminus, typeorm, dotenv и pg
объявлены
зависимостями — без них api не собирался и не стартовал; pg убран из
devDependencies корня, lodash и @types/multer объявлены там же
- список миграций генерируется и для пустой директории migrations/:
иначе
api:build падал на db-migrations-list
- vitest/globals в types (web) и импорт expect в e2e-спеке: падал
typecheck
- yarn.lock приведён в соответствие с package.json: без этого не
проходит
yarn install --frozen-lockfile в CI и при сборке образа api
DataSource для CLI, генерация статического списка миграций для webpack,
отдельная сборка
data-source.js для деплоя, скрипты снимка и восстановления данных БД.