geointel/docs/18-ultra-prep/FEATURE_FLAG_STRATEGY.md

Feature Flag Strategy

Feature flags prevent future modules from appearing as broken V1 features.

Required Flags

• ENABLE_GRB_CONNECTOR
• ENABLE_OSM_CONNECTOR
• ENABLE_SENTINEL_LAB
• ENABLE_SAM_SEGMENTATION
• ENABLE_YOLO_DETECTION
• ENABLE_LIDAR_LAB
• ENABLE_TRAINING_STUDIO
• ENABLE_QGIS_EXPORT

V1 Defaults

ENABLE_GRB_CONNECTOR=true
ENABLE_OSM_CONNECTOR=true
ENABLE_SENTINEL_LAB=false
ENABLE_SAM_SEGMENTATION=false
ENABLE_YOLO_DETECTION=true
ENABLE_LIDAR_LAB=false
ENABLE_TRAINING_STUDIO=false
ENABLE_QGIS_EXPORT=false

UI Behavior

Disabled features may be visible as roadmap cards, but must not look like broken tools. They should show:

• why disabled;
• what dependency is missing;
• which milestone enables them.

Backend Behavior

Disabled endpoints return a typed FEATURE_DISABLED error, not 404 and not silent success.