# 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.