docs: capture todo - Gitea CI regression + Docker build/publish

2026-06-09 20:49:07 -04:00
parent 73fcdaf075
commit 2cae72e9dd
2 changed files with 53 additions and 8 deletions
@@ -0,0 +1,44 @@
+---
+created: 2026-06-10T00:48:16.555Z
+title: Gitea CI — full regression on PR to main + build/publish Docker image
+area: tooling
+files:
+  - docker-compose.yml
+  - docker-compose.dev.yml
+  - apps/api/Dockerfile
+---
+
+## Problem
+
+The repo is committed against a self-hosted Gitea instance with a registered
+Actions runner, but there is no CI yet (no `.gitea/workflows/` or `.github/workflows/`).
+Two things should run automatically:
+
+1. **Full regression testing** on every PR targeting `main` — gate the merge.
+2. **Build the app's Docker image and publish it to the Gitea container registry.**
+
+Open context / decisions to make when picking this up:
+- **Test scope:** "full regression" = lint + typecheck + unit + the API integration
+  tests. Those integration tests need a real MariaDB (see
+  [[api-integration-test-db]]) — the workflow must spin up a MariaDB service
+  container, bind it, and set `DB_HOST=127.0.0.1` + `.env` creds. The PWA build/test
+  also needs to run.
+- **Monorepo:** pnpm workspace (`apps/api`, `apps/pwa`, shared). Cache the pnpm store.
+- **Docker images:** only `apps/api/Dockerfile` exists today — there is no PWA
+  Dockerfile yet. Decide whether to publish one image (API) or also build/serve the
+  PWA. Tag scheme + when to publish (only on merge to `main`? on tags? per-PR?).
+- **Registry auth:** push to the Gitea registry using the runner's `GITHUB_TOKEN`/
+  Gitea-provided token or a dedicated package-write token.
+- Gitea Actions are GitHub-Actions-compatible syntax but run on the self-hosted
+  runner — confirm runner labels and available images.
+
+## Solution
+
+TBD — likely a `.gitea/workflows/ci.yml`:
+- `on: pull_request` (to `main`) → job: install (pnpm), lint, typecheck, unit tests,
+  API integration tests against a `mariadb` service container, PWA build.
+- `on: push` to `main` (or tag) → job: `docker build` `apps/api/Dockerfile`, login to
+  Gitea registry, push tagged image.
+
+Verify Gitea Actions enablement + runner is healthy before authoring. Decide image
+matrix (API only vs. API+PWA) and tag policy first.