#1 - S-00 · Repository skeleton, Gitea Actions CI, contributor workflow - register-referentie

eho commented

2026-06-03 09:52:55 +00:00

Owner

Outcome: A fresh git clone from the Respellion Gitea remote, followed by docker compose up, produces a green "hello world" health endpoint from a placeholder BFF. Gitea Actions runs lint, build, unit tests, and the compose-up smoke test, all green. Issue templates, PR template, milestones, labels, and the first project board exist in Gitea.

Acceptance:

New developer follows README.md and reaches a green local environment in under 10 minutes.
Gitea Actions pipeline green on main.
git-cliff produces an empty CHANGELOG.md.
docs/PRD.md, CLAUDE.md, BACKLOG.md, docs/architecture/adr-0001-loose-coupling.md, docs/gitea-workflow.md all in repo.
.gitea/workflows/ci.yaml, .gitea/ISSUE_TEMPLATE/{slice,bug,adr-proposal}.md, .gitea/PULL_REQUEST_TEMPLATE.md all in repo.
Gitea milestone Iteration 1 — Walking Skeleton exists, populated with issues S-01 through S-09.

Touches: repo layout, Gitea Actions workflows, Dockerfile for placeholder BFF, docker-compose.yml skeleton, MkDocs scaffold, Gitea issue/PR templates.

Out of scope: any business logic, frontend, OpenZaak.

Definition of Done

A linked Gitea issue exists (this one).
Failing test written and committed first.
Implementation makes the test pass.
Refactor commit follows if structure improved.
Conventional Commit messages referencing this issue (refs #NN).
All Gitea Actions CI jobs green: lint, unit, integration, mutation (ratchet), e2e, container build + push, compose-up smoke test.
docker compose up from a fresh clone reaches green health checks within 3 minutes.
Docs touched if behaviour, contracts, or operations changed.
ADR added in docs/architecture/ if a non-obvious decision was made.
Demo note appended to docs/demo-script.md if the slice is user-visible.
This issue closed by the merging PR (closes #NN).

**Outcome:** A fresh `git clone` from the Respellion Gitea remote, followed by `docker compose up`, produces a green "hello world" health endpoint from a placeholder BFF. Gitea Actions runs lint, build, unit tests, and the compose-up smoke test, all green. Issue templates, PR template, milestones, labels, and the first project board exist in Gitea. **Acceptance:** - New developer follows `README.md` and reaches a green local environment in under 10 minutes. - Gitea Actions pipeline green on `main`. - `git-cliff` produces an empty `CHANGELOG.md`. - `docs/PRD.md`, `CLAUDE.md`, `BACKLOG.md`, `docs/architecture/adr-0001-loose-coupling.md`, `docs/gitea-workflow.md` all in repo. - `.gitea/workflows/ci.yaml`, `.gitea/ISSUE_TEMPLATE/{slice,bug,adr-proposal}.md`, `.gitea/PULL_REQUEST_TEMPLATE.md` all in repo. - Gitea milestone `Iteration 1 — Walking Skeleton` exists, populated with issues S-01 through S-09. **Touches:** repo layout, Gitea Actions workflows, Dockerfile for placeholder BFF, `docker-compose.yml` skeleton, MkDocs scaffold, Gitea issue/PR templates. **Out of scope:** any business logic, frontend, OpenZaak. ## Definition of Done - [ ] A linked Gitea issue exists (this one). - [ ] Failing test written and committed first. - [ ] Implementation makes the test pass. - [ ] Refactor commit follows if structure improved. - [ ] Conventional Commit messages referencing this issue (`refs #NN`). - [ ] All Gitea Actions CI jobs green: lint, unit, integration, mutation (ratchet), e2e, container build + push, compose-up smoke test. - [ ] `docker compose up` from a fresh clone reaches green health checks within 3 minutes. - [ ] Docs touched if behaviour, contracts, or operations changed. - [ ] ADR added in `docs/architecture/` if a non-obvious decision was made. - [ ] Demo note appended to `docs/demo-script.md` if the slice is user-visible. - [ ] This issue closed by the merging PR (`closes #NN`).