diff --git a/docs/PLATFORM_ARCHITECTURE_v2.md b/docs/PLATFORM_ARCHITECTURE_v2.md new file mode 100644 index 000000000..dcbbb5d6c --- /dev/null +++ b/docs/PLATFORM_ARCHITECTURE_v2.md @@ -0,0 +1,110 @@ +# LandveX Platform Architecture v2.0 + +## One Platform, Multiple Roles + +**LandveX is one platform — not two.** + +Same backend, same database, same API, same map. +Only the modules and detail level differ by role. + +``` +LandveX Platform +├── Customer Portal +│ ├── Dashboard +│ ├── Map +│ ├── Decision Cases +│ ├── Reports +│ └── Administration +│ +├── Operations Console +│ ├── Live Missions +│ ├── Coverage +│ ├── Hotspots +│ ├── Mission Generator +│ ├── Economy +│ └── Monitoring +│ +└── Intelligence Lab (Developer Mode) + ├── Datasets + ├── Annotation + ├── Replay + ├── Models + ├── Training + ├── Evaluation + └── Decision Validation +``` + +## Same Artifact Viewer Everywhere + +**Same Artifact, different detail level by role:** + +| Role | Sees | +|------|------| +| Customer | Image, Date, Recommendation | +| Operations | + Hash, Metadata, EXIF, GPS | +| Intelligence Lab | + AI results, Bounding boxes, Replay, Model version, Lineage | + +## Same Map Everywhere + +**Same map, different layers by role:** + +| Role | Layers | +|------|--------| +| Customer | Decision Cases, Risk, Objects, History | +| Operations | + Zoomers, Uploads, Coverage, Hotspots, Knowledge Gaps, Contradictions | +| Intelligence Lab | + Bounding boxes, Segmentation, AI confidence, Replay, Dataset status, Annotations | + +## Role-Based Access + +| User | Modules | +|------|---------| +| **Erik** | Everything: Operations, Intelligence Lab, Admin, Economy, Customers, Missions, Decision Cases | +| **Johan** | Operations, Intelligence Lab, Replay, Models, Logs, Deploy, Health | +| **Pilot Customer** | Dashboard, Map, My Missions, Reports, Decisions | +| **Municipality** | My Area, My Objects, My Decision Cases, My Reports, History | + +## Developer Mode + +Intelligence Lab is not a separate product. +It is **Developer Mode** in the same platform. + +``` +LandveX + ↓ +Settings + ↓ +Developer Mode + ↓ +Intelligence Lab +``` + +**Reused across all roles:** +- Authentication +- Map engine +- API +- Permissions +- Design system +- Component library +- Logging + +## Architecture Principle + +> **One platform. One API. One data model. One map. One Artifact system. Multiple roles.** + +This means Intelligence Lab is not a separate system, but an **advanced work mode** in the same platform customers use. You reuse everything — from authentication and map engine to Artifact Viewer and Decision Cases — and only differentiate on **which information and tools each role gets access to**. + +## Benefits + +- Lower development cost +- Easier maintenance +- Consistent user experience +- Faster iteration +- No "rebuild Intelligence Lab" moments + +## Current Status + +- ✅ Domain model supports all roles +- ✅ API layer ready +- ⏳ Role-based access control (RBAC) +- ⏳ Module system +- ⏳ Developer Mode toggle