Initial GeoIntel V1 foundation

docs/MODEL_REGISTRY_SEED.md

@@ -0,0 +1,55 @@
+# Model Registry Seed
+
+The application must ship with a deterministic demo model registry before real ML models are integrated.
+
+## Seed Models
+
+### demo-yolo-buildings-v1
+- framework: demo
+- task: object_detection
+- classes: building
+- purpose: deterministic demo detections for UI and QA/QC development
+- production_ready: false
+
+### demo-seg-vegetation-v1
+- framework: demo
+- task: segmentation
+- classes: vegetation, water, impervious_surface
+- purpose: deterministic segmentation polygons for UI and metrics development
+- production_ready: false
+
+### ultralytics-yolo-placeholder
+- framework: ultralytics
+- task: object_detection
+- classes: configurable
+- purpose: real YOLO integration slot
+- production_ready: false until implemented and tested
+
+### sam-placeholder
+- framework: segment-anything
+- task: segmentation
+- classes: prompt_based
+- purpose: real SAM integration slot
+- production_ready: false until implemented and tested
+
+## Registry Fields
+```json
+{
+  "id": "demo-yolo-buildings-v1",
+  "name": "Demo YOLO Buildings",
+  "version": "1.0.0",
+  "framework": "demo",
+  "task": "object_detection",
+  "classes": ["building"],
+  "artifact_path": null,
+  "metadata": {
+    "deterministic": true,
+    "portfolio_demo": true
+  }
+}
+```
+
+## Rules
+- Demo models must be clearly labeled as non-production.
+- Real model integration must not silently replace demo behavior.
+- Model outputs must always include model id and version.