Initial public release

2026-08-31 21:56:53 +02:00
commit faeb58ef6d
1386 changed files with 263203 additions and 0 deletions
@@ -0,0 +1,97 @@
+# SPRINT 1 SCOPE FREEZE
+
+This document freezes the first implementation scope. Codex must not expand Sprint 1 beyond this boundary.
+
+## Sprint 1 goal
+
+Build the GeoIntel foundation vertical slice: a locally runnable app that proves project, area, dataset, PostGIS and map foundations.
+
+## Must build
+
+### Backend foundation
+
+- FastAPI app skeleton.
+- Settings/config module.
+- Structured logging baseline.
+- Health/readiness endpoint.
+- API response envelope.
+- Error handling middleware or equivalent.
+- CORS configuration for local frontend.
+
+### Database foundation
+
+- PostgreSQL/PostGIS connection.
+- Migration tooling.
+- Core models/schemas for projects, areas and datasets.
+- Geometry persistence.
+- Minimal seed/fixture support.
+
+### Project and area workflow
+
+- Create/list/read project.
+- Create/list/read area.
+- Store area geometry.
+- Validate geometry.
+- Return area metadata such as area size where practical.
+
+### Dataset workflow
+
+- Register/upload GeoJSON dataset.
+- Store original file or registered reference.
+- Extract metadata:
+  - dataset type;
+  - feature count;
+  - geometry type;
+  - CRS if available;
+  - bounds.
+- Persist metadata.
+
+### Frontend foundation
+
+- Vite/React/TypeScript app.
+- Main shell/layout.
+- MapLibre map.
+- Project workspace page.
+- Dataset manager page/panel.
+- Minimal layer display using demo GeoJSON.
+- API client.
+
+### Tooling
+
+- Docker Compose for DB and services.
+- README quickstart updated if implementation changes commands.
+- `make readiness` remains green.
+- Basic tests/smoke scripts.
+
+## Should build if Sprint 1 musts are complete
+
+- Area import from fixture.
+- GeoJSON export endpoint for area or dataset features.
+- Minimal QA placeholder that validates reference vs prediction fixture schema, but does not run full QA engine yet.
+- Frontend layer opacity toggle.
+
+## May build only if zero risk
+
+- Demo fixture loader.
+- Simple statistics card for feature count and area.
+- Simple project status panel.
+
+## Must not build in Sprint 1
+
+- YOLO live inference.
+- SAM live segmentation.
+- Sentinel/STAC integration.
+- GRB live WFS client.
+- DHMV integration.
+- LiDAR LAS/LAZ processing.
+- Training Studio.
+- Model registry UI.
+- AI Copilot.
+- Advanced PDF reports.
+- Multi-user authentication.
+- Role-based permissions.
+- Production Kubernetes/deployment stack.
+
+## Scope conflict rule
+
+If a task seems useful but is not listed under `Must`, `Should` or `May`, Codex must not implement it in Sprint 1. Add it to backlog/open issues instead.