- миграции лежат по модулям в `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>
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
одной строкой.