Files
breadcrumb-the-shire/docs/howto-gitea-required-checks.md

44 lines
1.4 KiB
Markdown

# Gitea Required Checks (Phase 1: enforcement-ready)
Letzte Aktualisierung: 2026-04-01
## Ziel
QA-Pflichtchecks fuer CoreCore in Gitea vorbereiten, ohne sie sofort als Merge-Blocker zu aktivieren.
## Enthaltene Basis
- Beispiel-Workflow: `/.gitea/workflows/qa-required.yaml`
- Pflicht-Gate-Einstieg: `/bin/qa-required.sh`
- Policy-Quelle: `/.agents/checks/enforcement-policy.json`
## Was `qa-required` abdeckt
`bin/qa-required.sh` fuehrt die aktuell blockenden Gates aus:
- `QG-001` PHPUnit
- `QG-002` PHPStan
- `QG-003` Architecture Core Contract
- `QG-006` PHP Style Check
- `QG-008` Docs link integrity
- `QG-009` Codex skills sync
## Phase-1 Setup (noch nicht blockend)
1. Sicherstellen, dass der Gitea-Runner Docker + Docker Compose ausfuehren darf.
2. Workflow-Datei nach `.gitea/workflows/qa-required.yaml` uebernehmen.
3. PR gegen `main` oeffnen und pruefen, dass Job `qa-required` gruen laeuft.
4. Branch Protection noch **nicht** auf "required" setzen.
## Phase-2 Aktivierung (blockend)
1. Branch-Protection fuer `main` aktivieren.
2. Statuscheck `qa-required` als required markieren.
3. Optional: weitere Jobs ergaenzen (z. B. nightly/extended Checks), aber nur `qa-required` blockend setzen.
## Hinweise
- `QG-005` (Browser-Smoke) bleibt manuell/non-blocking.
- `QG-007` (composer-unused) bleibt periodisch/non-blocking.
- Fuer lokale Ausfuehrung: `bin/dev qa-required` bzw. `bin/dev qa-extended`.