Initial public release

docs/CI_CD_SPECIFICATION.md

@@ -0,0 +1,68 @@
+# CI/CD Specification
+
+## Doel
+De CI/CD-pipeline moet elke wijziging snel valideren zonder zware AI- of GIS-jobs verplicht te maken. Zware checks krijgen aparte profielen.
+
+## Checkprofielen
+
+### `quick`
+Moet lokaal binnen enkele minuten kunnen draaien.
+
+- Backend import check.
+- Python lint/type smoke.
+- Frontend install/build smoke.
+- API schema consistency check.
+- Geen ontbrekende verplichte documentatie.
+
+### `integration`
+Draait met Docker Compose.
+
+- PostgreSQL/PostGIS start.
+- Redis start.
+- Backend start.
+- Health endpoint geeft OK.
+- Alembic migrations kunnen naar laatste versie.
+- Test fixtures kunnen worden ingeladen.
+
+### `geospatial`
+Draait alleen wanneer GDAL/Rasterio/GeoPandas beschikbaar zijn.
+
+- Raster metadata fixture.
+- Vector fixture import.
+- CRS-transformatie fixture.
+- Clip operatie fixture.
+
+### `ai-light`
+Draait zonder groot model.
+
+- Model registry laadt.
+- Detection pipeline accepteert dummy model adapter.
+- Outputcontract voor detections klopt.
+- GeoJSON exportcontract klopt.
+
+### `ai-full`
+Optioneel en niet verplicht voor elke commit.
+
+- YOLO/SAM echte modelrun op kleine fixture.
+- Output wordt geprojecteerd naar kaartcoördinaten.
+- QA/QC tegen referentievector draait.
+
+## Verplichte CI-stappen voor M1-builds
+1. `scripts/check_repo_structure.sh`
+2. `scripts/smoke_backend_import.sh`
+3. `scripts/smoke_contracts.py`
+4. `scripts/smoke_docs.py`
+
+## Verplichte CI-stappen zodra code bestaat
+1. `pytest backend/tests`
+2. `npm run typecheck`
+3. `npm run build`
+4. `alembic upgrade head`
+5. `python scripts/validate_fixtures.py`
+
+## Build failure policy
+Een build mag alleen als groen worden beschouwd wanneer:
+
+- Alle quick checks slagen.
+- Bekende failures expliciet in `docs/KNOWN_LIMITATIONS_M3.md` of nieuwere limitation doc staan.
+- Geen nieuwe regressies zonder vermelding in changelog.