geointel/docs/PERFORMANCE_BUDGETS.md

Performance Budgets

GeoIntel will eventually process large geospatial files. V1 must make limits explicit.

V1 file limits

• Default max upload: 500 MB.
• Raster preview should not load full large raster into frontend memory.
• Backend metadata extraction should stream or sample where possible.

Processing rules

• Long operations must become jobs after foundation is complete.
• V1 can run small fixture operations synchronously if documented.
• Tile generation should avoid keeping all tiles in memory.

Frontend budgets

• Avoid rendering thousands of features directly without simplification/clustering.
• Use map layers for GeoJSON, not huge DOM lists.
• Paginate dataset and analysis lists if needed.

Database indexes

Required indexes:

• spatial index on areas.geometry
• spatial index on vector_features.geometry
• spatial index on detections.geometry
• foreign key indexes for project/dataset/analysis lookups

Known V1 limitation

Full production-scale remote sensing processing is not required in V1. The product must demonstrate correct architecture and working small/medium workflows.