Publish curated GeoIntel source from e92b13f5511700f5410671ee9dd7476efa584d8c

2026-09-30 10:07:30 +00:00
1 parent 0aae654d6e
commit 6189612863
@@ -1,7 +1,65 @@
-# GeoIntel · public source
+# GeoIntel

-GeoIntel is a GeoAI workbench for Belgium and the Belgian North Sea. This repository is the curated public source snapshot. The private canonical repository contains development history and operational material; public updates are generated from reviewed source revisions.
+<p align="center"><img src="frontend/public/geointel-icon-180.png" width="88" alt="GeoIntel icon"></p>
+<p align="center"><strong>Evidence-first geospatial analysis for Belgium and the Belgian North Sea.</strong></p>
+<p align="center"><a href="#explore-the-workbench">Workbench</a> · <a href="#what-it-does">Capabilities</a> · <a href="#quick-start">Quick start</a> · <a href="#technical-overview">Architecture</a></p>

-The source includes a FastAPI backend, a React frontend, API contracts, tests, and synthetic geospatial fixtures. See `docker-compose.yml` and `.env.example` for local setup. AI models and external geospatial data providers must be configured separately.
+GeoIntel combines official geospatial sources, map-based analysis, computer vision, QA/QC and reproducible exports. A saved result carries its source, spatial context, model revision and review evidence. The application covers Belgium and the legally distinct Belgian North Sea zones without hiding differences between regional source datasets.

-Licensed under [LICENSE](LICENSE). Report vulnerabilities using [SECURITY.md](SECURITY.md).
+Mol and the Kempen remain golden regression areas for the Belgium-wide workbench; they do not limit its geographic scope.
+
+![GeoIntel demo landing page](docs/assets/portfolio/geointel-landing-hero.png)
+
+## Explore the workbench
+
+The following captures use public or synthetic demonstration content. Select an official boundary or draw an area of interest, choose compatible layers, run an analysis, inspect object-level evidence, and export the reviewed result.
+
+| Map workbench | Quality review |
+| --- | --- |
+| ![Area selection and source layers](docs/assets/portfolio/geointel-workbench-map.png) | ![QA/QC results and object evidence](docs/assets/portfolio/geointel-workbench-quality.png) |
+
+The mobile workbench keeps the same analysis context on a narrow screen. [Asset provenance](docs/ASSET_PROVENANCE.md) describes these captures and project artwork.
+
+<p align="center"><img src="docs/assets/portfolio/geointel-workbench-mobile.png" width="300" alt="GeoIntel mobile workbench demo"></p>
+
+## What it does
+
+- **Source-aware mapping:** official boundaries, vector and raster layers, orthophotos, regional and maritime sources, and explicit coverage.
+- **Spatial analysis:** coordinate-system normalization, clipping, buffering, joins and raster statistics.
+- **Governed GeoAI:** PyTorch, YOLO and SAM-compatible model workflows with immutable revisions and release gates.
+- **Quality before publication:** precision, recall, F1, IoU, false-positive and false-negative evidence, plus human review.
+- **Traceable output:** reproducible GeoJSON and artifacts linked to the selected area, input versions and model revision.
+
+Model detections are reviewable proposal evidence until the relevant release gate passes. Official footprints are not assumed to be perfect image labels; temporal validity and spatial leakage are checked during training and calibration.
+
+## Quick start
+
+Requirements: Docker Engine with Compose. From the repository root:
+
+```bash
+docker compose up --build
+```
+
+Open <http://localhost:1202>. The development stack uses Python 3.11+, Node 20.19+ or 22.12+, and PostgreSQL/PostGIS. Set `GEOINTEL_AUTH_ENABLED=true` and explicitly opt in with `GEOINTEL_GUEST_ACCESS_ENABLED=true` only for a dedicated public-data demo. Guest sessions are short-lived and project-bound; administration and uploads remain restricted.
+
+## Technical overview
+
+```mermaid
+flowchart LR
+    Web[React, TypeScript and MapLibre] --> API[FastAPI]
+    API --> GIS[GeoPandas, Shapely and Rasterio]
+    API --> Jobs[PostgreSQL job queue]
+    Jobs --> AI[PyTorch inference]
+    GIS --> DB[(PostgreSQL and PostGIS)]
+    AI --> DB
+    DB --> QA[QA and provenance]
+    QA --> Web
+```
+
+Configured AI inference can use NVIDIA/CUDA and fails closed when a required accelerator is unavailable. A deployment needs persistent PostGIS and artifact storage, authentication, HTTPS, health checks, backups and a tested restore path. Do not place private model weights, credentials or operational exports in this repository.
+
+For source checks, run `python -m compileall backend/app`, the backend pytest suite, and the frontend typecheck, unit tests and build. `backend/` contains the API and spatial workflows; `frontend/` contains the UI; `contracts/` contains shared interfaces; `fixtures/` contains safe examples.
+
+## Public-source provenance
+
+This is a reviewed content-only export from a private canonical repository. `PUBLIC_SOURCE_MANIFEST.json` records the source revision and hashes; private Git history is absent. GeoIntel is licensed under [Apache 2.0](LICENSE). See [SECURITY.md](SECURITY.md) for vulnerability reporting.