cleanup

docs/ci-cd.md

@@ -0,0 +1,81 @@
+# Bookra CI/CD
+
+## Current shape
+
+- CI runs in GitHub Actions from `.github/workflows/ci.yml`.
+- Frontend CD should stay on Vercel Git deployments.
+- Backend and auth-service CD should stay on Railway Git autodeploys.
+
+This avoids duplicate deployments from both GitHub Actions and platform-native Git integrations.
+
+## CI coverage
+
+Every pull request, push to `main`, and manual workflow run executes:
+
+1. frontend install, API client generation, typecheck, and production build
+2. backend `go test` + `go build`
+3. auth-service `go test` + `go build`
+4. Docker image builds for `apps/backend` and `apps/auth-service`
+
+Go is pinned to `1.26.2`, the latest stable release at time of setup.
+
+## Platform CD wiring
+
+### Vercel
+
+- Create Vercel project for frontend.
+- Set project root directory to `apps/frontend`.
+- Keep Git-based deployments enabled for `main`.
+- Let Vercel keep monorepo auto-detection enabled. Vercel documents monorepo root-directory support and automatic per-project Git deployments.
+- Only override build settings if auto-detection is wrong during first import.
+
+### Railway
+
+Create two Railway services from this repo:
+
+- backend root directory: `apps/backend`
+- auth-service root directory: `apps/auth-service`
+
+Both services now have code-based Railway config:
+
+- [apps/backend/railway.json](/home/tdvorak/Desktop/PROG+HTML/Bookra/apps/backend/railway.json:1)
+- [apps/auth-service/railway.json](/home/tdvorak/Desktop/PROG+HTML/Bookra/apps/auth-service/railway.json:1)
+
+Enable for each service:
+
+- GitHub Autodeploys
+- Wait for CI
+
+Health checks:
+
+- backend: `/healthz`
+- auth-service: `/health`
+
+## Local mirror of CI
+
+```bash
+PATH=/usr/local/go/bin:$PATH npm run verify
+docker build -t bookra-backend-ci ./apps/backend
+docker build -t bookra-auth-ci ./apps/auth-service
+```
+
+## Low-RAM act checks
+
+For local GitHub Actions validation on a memory-constrained machine, run one job at a time:
+
+```bash
+act push -W .github/workflows/ci.yml -j frontend \
+  --concurrent-jobs 1 -b \
+  --container-options='--memory=3g --cpus=2'
+
+act push -W .github/workflows/ci.yml -j go \
+  --matrix app:apps/backend \
+  --concurrent-jobs 1 -b \
+  --container-options='--memory=3g --cpus=2'
+```
+
+Notes:
+
+- `frontend` job was executed successfully with `act`.
+- `go` job was executed successfully with `act` for `apps/backend`.
+- Dockerfiles were validated with direct `docker build`, which is cheaper than running full Docker-action matrix through `act`.