---

name: oce-geo-coordination description: "Portfolio mapping and model coordination in OpenConstructionERP: the 3D geo hub (Cesium), the coordination hub with clash AI, and geo-anchored projects. Use for multi-project portfolio views and BIM clash workflows."

Geo Hub & Coordination in OpenConstructionERP

Geo Hub (portfolio map)

• Projects anchored to real locations on a 3D globe (Cesium 3D Tiles).
• Each project card carries site map, BIM/DWG/PDF badges and live value.
• Multi-currency totals grouped by currency — never blended.

Workflow: create a project → set location/region/currency → the globe shows it; drill into the project for BOQ/BIM.

Coordination Hub (clash AI)

• Combine models (RVT/IFC/DWG/DGN) in one coordination space.
• Clash detection: automatic clash report between disciplines (structure vs MEP vs architecture).
• Each clash becomes a task/punch item linked to the model elements — track until resolved.

Workflow: upload models → run clash detection → review clash list → convert clashes to issues → fix and re-run.

Point clouds in the viewer

• Upload LAS/LAZ/COPC scans (E57 via optional extra) — decimated client-side for smooth viewing.
• Compare scan vs model for as-built verification.

API patterns

GET /api/v1/geo-hub/projects                # portfolio map data
POST /api/v1/coordination/models            # add model to coordination space
GET /api/v1/coordination/clashes            # clash report

(Endpoint names may vary by module version — check backend/app/modules/*/router.py.)

Best practices

1. Anchor every project geographically — the portfolio view is the fastest status board.
2. Run clash detection early (design stage), not after procurement.
3. Convert clashes to issues immediately; an unowned clash list decays into noise.
4. Keep currency groups separate in portfolio totals.