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,40 @@
+# Codex Module Contract — Detection Boundary
+
+Build the detection architecture so real YOLO can be added safely, but V1 may use deterministic fixture mode first.
+
+## Required Concepts
+
+- model registry entry
+- analysis run
+- detection result
+- output layer
+- model mode: `fixture`, `stub`, `real`
+
+## Required Backend
+
+- detection service interface
+- fixture detection provider
+- analysis run persistence
+- detection persistence
+- GeoJSON export of detections
+
+## Required Frontend
+
+- detection run form
+- model selector
+- confidence threshold
+- mode indicator
+- results table
+- map overlay
+
+## Required Tests
+
+- fixture detection produces stable number of detections
+- output includes class, confidence and geometry
+- response clearly states mode
+
+## Forbidden
+
+- fake real model claims
+- silent fallback from real to fixture
+- detections without geospatial provenance
@@ -0,0 +1,43 @@
+# Codex Module Contract — Project, Area, Dataset
+
+Build only the project, area and dataset foundation.
+
+## Required Backend
+
+- `GET /projects`
+- `POST /projects`
+- `GET /projects/{project_id}`
+- `POST /projects/{project_id}/areas`
+- `GET /projects/{project_id}/areas`
+- `POST /projects/{project_id}/datasets/upload`
+- `GET /projects/{project_id}/datasets`
+
+## Required Frontend
+
+- project list
+- create project form
+- project workspace
+- area list
+- dataset list
+- upload form
+
+## Required Validation
+
+- project name required
+- area geometry required and valid
+- dataset file required
+- unsupported file types rejected with structured error
+
+## Required Tests
+
+- create/list/read project
+- create/list area using fixture polygon
+- dataset upload stores metadata record
+
+## Do Not Build Yet
+
+- real YOLO
+- real SAM
+- Sentinel
+- LiDAR
+- training studio
@@ -0,0 +1,52 @@
+# Codex Module Contract — QA/QC Foundation
+
+Build deterministic QA/QC using fixture GeoJSON files before real AI integration.
+
+## Input
+
+- predicted polygon layer
+- reference polygon layer
+- IoU threshold, default 0.5
+
+## Required Metrics
+
+- true positives
+- false positives
+- false negatives
+- precision
+- recall
+- f1
+- mean_iou for matched pairs
+
+## Required Outputs
+
+- summary metrics JSON
+- matched pairs list
+- false positives GeoJSON
+- false negatives GeoJSON
+
+## Required Backend
+
+- QA service with pure functions
+- API endpoint to run QA for two stored layers or fixture mode
+- persisted quality_check record
+
+## Required Frontend
+
+- QA run form
+- threshold input
+- metrics cards
+- map layers for FP/FN
+- explanation of IoU threshold
+
+## Required Tests
+
+- golden fixture test with deterministic counts
+- zero denominator test
+- invalid geometry test
+
+## Forbidden
+
+- presenting confidence as accuracy
+- changing IoU formula
+- computing area in EPSG:4326 degrees