deploy-staging создаёт роль и БД ветки через staging-db-postgres до
docker compose up, cleanup.yaml удаляет их при удалении ветки (гасит
стек раньше, иначе DROP DATABASE не пройдёт). POSTGRES_* в compose
читаются из .env, куда инструмент пишет доступы.
Попутно: DEPLOY_URL стенда из env и в summary, версия сборки — ветка и
короткий sha, в проде APP_VERSION берётся из VERSION, health в Caddyfile
одной строкой.
Логгер на 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 для деплоя, скрипты снимка и восстановления данных БД.
Каркас воркспейса: конфигурация Nx и TypeScript, манифест yarn
workspaces, EditorConfig,
параметры docker-сборки и инструкции со скиллами для ИИ-агентов
(AGENTS.md).