geointel/docs/TROUBLESHOOTING_RUNBOOK.md

Troubleshooting Runbook

Backend start niet

Controleer .env, database, Redis, dependencies en importeerbaarheid. Draai scripts/smoke_backend_import.sh.

PostGIS werkt niet

Controleer SELECT postgis_full_version(); en migration met CREATE EXTENSION IF NOT EXISTS postgis;.

Rasterio/GDAL problemen

Gebruik Docker-profiel voor GIS dependencies. Voeg geen willekeurige pip-fixes toe zonder dependency policy.

Vector import geeft lege resultaten

Controleer CRS, bounds overlap, geometry validity en clip-operatie.

YOLO/SAM inference te traag

Gebruik kleine fixture, ai-light mode, lagere tile size of hogere confidence threshold.

QA/QC scores lijken fout

Controleer projectie, units, valid geometry, IoU threshold, matchingmethode en duplicaten.

Frontend toont lege kaart

Controleer MapLibre style, API URL, GeoJSON-validiteit, WGS84-coördinaten en layer visibility.