feat: add backend container delivery

2026-09-16 09:41:56 +03:00
parent 32c12fb10d
commit 1a6be432f2
8 changed files with 214 additions and 138 deletions
@@ -22,6 +22,33 @@ npm run start:dev
 T-Bank token в `.env`: он вводится пользователем и хранится в зашифрованном
 виде.

+## Контейнерный image
+
+`Dockerfile` имеет targets `development` (Nest watch, generated Prisma client и Linux native modules)
+и `production` (compiled Node process от UID 1000, Prisma CLI/migrations и T-Bank proto assets). Node соответствует `.nvmrc`.
+Build context ограничен `.dockerignore`; `.env`, local DB и host node_modules
+не попадают в image.
+
+```bash
+docker build --target development -t wealthledger-backend:development .
+docker build --target production -t wealthledger-backend:production .
+nvm use --silent
+npm run test:container -- wealthledger-backend:production
+```
+
+Gitea `image.yml` запускается на защищённом release tag `vX.Y.Z`, проверяет
+package/lock version и canonical gates. Runner `ubuntu-latest` должен иметь
+Docker/buildx. Dedicated package writer задаётся Actions secrets
+`REGISTRY_USERNAME`/`REGISTRY_TOKEN`; server использует отдельную read-only
+identity. Публикуются semver tags, без `latest`; существующие
+release tags не перезаписываются. Production выбирает опубликованный version tag.
+
+Compose topology принадлежит workspace, эксплуатационная последовательность —
+[документация](https://git.personal.ksv741.ru/WealthLedger/docs),
+страница `architecture/deployment.md`.
+Проверка публикации требует настроенного registry/runner; локальный build
+не доказывает package permissions.
+
 ## Проверка

 Единый completion gate не изменяет versioned-файлы: