# 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.