geointel/adr/ADR-001-technology-stack.md

ADR-001 — Technology Stack

Status

Accepted for V1.

Context

GeoIntel Kempen must demonstrate modern web development, geospatial processing, and GeoAI engineering. The stack must be realistic for a portfolio project while remaining close to professional workflows.

Decision

Use:

• Frontend: React + TypeScript.
• Map UI: MapLibre GL with Deck.gl where advanced overlays are useful.
• Backend: FastAPI.
• Database: PostgreSQL + PostGIS.
• Processing: GeoPandas, Shapely, Rasterio, PyProj, GDAL-compatible tools.
• AI: PyTorch with Ultralytics YOLO first; SAM/segmentation later.
• Jobs: Redis + RQ for V1.
• Storage: local filesystem with explicit storage abstraction.

Consequences

This stack keeps the first build achievable while matching the vacancy profile closely: Python, raster/vector processing, computer vision, AI pipelines, and GIS outputs.

Non-goals

Do not introduce Django, Flask, MongoDB, Firebase, or a second frontend framework unless a future ADR explicitly replaces this decision.