feat: migrate cloud storage to project container model

Replace legacy paths (70_BIM, 99_overige_documenten/bim-validator) with
new project container structure (models/, validation/, project.wefc).
All reads try new path first with automatic fallback to legacy paths.
Writes always go to the new structure.

- nextcloud_client.py: DIR_MODELS/DIR_VALIDATION constants, manifest
  CRUD (read/write/upsert), list_models/list_validation_files with
  fallback, upload_to_validation, download_from with fallback
- volume_reader.py: fallback in list_bim_files, list_output_files,
  get_file_path; read_manifest from volume mount
- routers/cloud.py: endpoints use new paths, manifest endpoint,
  validation save with WefcValidation manifest update
- models/cloud.py: ManifestHeader + ManifestResponse models
- 26 tests (19 client + 7 endpoints), all passing

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: jochem25

STATUS.md

@@ -1,6 +1,6 @@
-# Project Status — 2026-03-29
+# Project Status — 2026-03-30
 
-## Huidige fase: Fase 7 (Hybrid Cloud + Multi-tenant) — deployed
+## Huidige fase: Fase 7 (Hybrid Cloud + Multi-tenant + Project Container) — in progress
 
 ### Wat is af
 - Fase 0: Research & validatie
@@ -13,41 +13,36 @@
 - Fase 6: Nextcloud Cloud Storage — WebDAV, save/open dialog
 - **Fase 7a: Project Management** — PostgreSQL backend, REST API, frontend UI
 - **Fase 7b: Hybrid Nextcloud I/O** — volume mount reads, WebDAV writes, multi-tenant
+- **Fase 7c: Project Container Model** — migratie naar models/validation/ structuur met project.wefc manifest
 
-### Gedaan in vorige sessie (2026-03-28)
-- Project management systeem gebouwd (full-stack):
-  - Backend: async SQLAlchemy 2.0 + PostgreSQL (SQLite fallback)
-  - ORM models: Project + ProjectFile
-  - REST API: /api/v2/projects CRUD + file upload/download/delete
-  - Frontend: IProjectStorage interface + ServerProjectStorage + LocalProjectStorage
-  - .bvp bestandsformaat voor lokale projecten (File System Access API)
-  - ProjectList component in Backstage + i18n (NL + EN)
-  - AppShell integratie met handleOpenProject
-- Hybrid Nextcloud I/O migratie:
-  - server/tenant_config.py: multi-tenant config loader (tenants.json)
-  - server/volume_reader.py: directe filesystem reads van NC volume mount
-  - server/routers/cloud.py: refactored cloud router (was inline in main.py)
-  - NextcloudClient: multi-tenant factory (from_tenant) + client registry
-  - docker-compose.yml: NC data volume (ro), tenant config mount
-  - config/tenants.json: 3BM tenant configuratie
-- Ghost mode pogingen (nog niet werkend):
-  - Opacity 0.85→0.15: transparantie zelf werkt nu
-  - Reset knop werkt
-  - Geselecteerd element wordt nog NIET opaque getoond
-  - Poging 1: mesh-level material restore → werkt niet (IFC batcht elementen in shared meshes)
-  - Poging 2: fragment highlight overlay met opacity 1.0 → werkt ook niet
-  - Moet dieper onderzocht worden hoe That Open Engine fragment highlights werken
-- Deployed naar Hetzner (commits a2d3b11, 5c8ba74, d12678f, 3674eb5)
-
-### Gedaan in deze sessie (2026-03-29)
+### Gedaan in vorige sessie (2026-03-29)
 - **Ghost mode bug opgelost:**
-  - Oorzaak: material-level opacity (`mat.opacity = 0.15`) beïnvloedt alle elementen in shared meshes door IFC batching
-  - Fragment highlight overlay werd door transparante materials heen gerenderd (Three.js render order: opaque → transparent)
   - Fix: vervangen door `FragmentsModel.setOpacity()` / `resetOpacity()` / `setColor()` — fragment-level per-element controle
-  - Verwijderd: `savedMaterials` map, `allGuidsCache`, `restoreMaterials()` methode
-  - Geselecteerd element krijgt nu correct volle opacity + Verdigris kleur (#44B6A8)
+
+### Gedaan in deze sessie (2026-03-30)
+- **Project container model migratie:**
+  - nextcloud_client.py: nieuwe constanten (DIR_MODELS, DIR_VALIDATION, MANIFEST_FILENAME)
+  - nextcloud_client.py: _tool_path schrijft nu naar validation/ i.p.v. 99_overige_documenten/bim-validator/
+  - nextcloud_client.py: list_models() met fallback models/ → 70_BIM/
+  - nextcloud_client.py: list_validation_files() met fallback validation/ → 99_overige_documenten/bim-validator/
+  - nextcloud_client.py: download_file() met fallback new → legacy
+  - nextcloud_client.py: upload_to_validation() — altijd naar validation/
+  - nextcloud_client.py: manifest CRUD — read_manifest(), write_manifest(), upsert_manifest_object()
+  - volume_reader.py: list_bim_files() met fallback models/ → 70_BIM/
+  - volume_reader.py: list_output_files() met fallback validation/ → 99_overige_documenten/bim-validator/
+  - volume_reader.py: get_file_path() met automatic legacy fallback
+  - volume_reader.py: read_manifest() voor volume mount reads
+  - routers/cloud.py: file listing gebruikt list_models/list_validation_files (met fallback)
+  - routers/cloud.py: upload gaat naar validation/ directory
+  - routers/cloud.py: save endpoint schrijft WefcValidation object naar manifest
+  - routers/cloud.py: nieuw GET /api/cloud/projects/{project}/manifest endpoint
+  - models/cloud.py: ManifestHeader + ManifestResponse Pydantic models
+  - tests: 19 tests voor nextcloud_client (constanten, paths, fallback, manifest CRUD)
+  - tests: 7 tests voor cloud endpoints (manifest, category routing, volume mount)
+  - Alle 26 tests slagen
 
 ### Nog te doen
 - NC_SERVICE_PASS_3BM instellen in .env op server → cloud wordt actief
 - Cloud status testen na wachtwoord configuratie
 - OIDC tenant claim koppelen aan tenant selectie (nu hardcoded default "3bm")
+- Frontend: ProjectList component updaten voor manifest-aware weergave

TODO.md

@@ -6,6 +6,19 @@
 - [x] Fix: FragmentsModel.setOpacity() / resetOpacity() / setColor() per element (fragment-level)
 - [x] Verwijderd: savedMaterials map, allGuidsCache, restoreMaterials(), material traversal
 
+## Project Container Model (Fase 7c)
+- [x] nextcloud_client.py: constanten DIR_MODELS, DIR_VALIDATION, MANIFEST_FILENAME
+- [x] nextcloud_client.py: paden migratie 99_overige_documenten → validation/, 70_BIM → models/
+- [x] nextcloud_client.py: fallback logica (new path first → legacy path)
+- [x] nextcloud_client.py: manifest CRUD (read, write, upsert)
+- [x] volume_reader.py: fallback logica voor list_bim_files, list_output_files, get_file_path
+- [x] volume_reader.py: read_manifest voor volume mount
+- [x] routers/cloud.py: endpoints updaten voor nieuwe paden
+- [x] routers/cloud.py: manifest endpoint (GET /api/cloud/projects/{project}/manifest)
+- [x] routers/cloud.py: validation save met WefcValidation manifest update
+- [x] models/cloud.py: ManifestHeader + ManifestResponse modellen
+- [x] Tests: 26 tests (19 nextcloud_client + 7 cloud endpoints)
+
 ## Blocker: NC service account
 - [ ] NC_SERVICE_PASS_3BM instellen in `/opt/openaec/bim-validator/.env` op server
 - [ ] `sudo docker compose up -d` na .env aanmaken
@@ -18,11 +31,14 @@
 - [x] Auth omgebouwd naar Authentik proxy headers
 - [x] Project management systeem deployed (PostgreSQL + REST API)
 - [x] Hybrid Nextcloud I/O deployed (volume mount + WebDAV)
+- [ ] Project container model deployen (rebuild na merge)
 
 ## Testen
-- [ ] Cloud: project listing via volume mount (70_BIM bestanden)
-- [ ] Cloud: BCF save via WebDAV → zichtbaar in Nextcloud
+- [ ] Cloud: project listing via volume mount (models/ bestanden)
+- [ ] Cloud: validatie save via WebDAV → zichtbaar in Nextcloud validation/
+- [ ] Cloud: manifest read via GET /api/cloud/projects/{project}/manifest
 - [ ] Cloud: IFC download via volume mount (performance test)
+- [ ] Cloud: fallback naar legacy paden bij bestaande projecten
 - [ ] Proxy auth: login via Authentik → user zichtbaar in TitleBar
 - [ ] BCF ZIP downloaden → importeren in BIMcollab/Solibri/Revit
 - [ ] Push issues naar BCF Platform → verifieer op platform UI

server/models/cloud.py

@@ -62,3 +62,31 @@ class CloudDeleteResponse(BaseModel):
     success: bool = Field(..., description="Whether the deletion succeeded")
     project: str = Field(..., description="Project name")
     filename: str = Field(..., description="Deleted file name")
+
+
+class ManifestHeader(BaseModel):
+    """Header section of a project.wefc manifest."""
+
+    schema_name: str = Field(
+        "WeFC", alias="schema", description="Schema identifier"
+    )
+    schema_version: str = Field(
+        "1.0.0", description="Schema version"
+    )
+    timestamp: str = Field("", description="Last update timestamp (ISO 8601)")
+    application: str = Field("", description="Application that last wrote")
+
+    model_config = {"populate_by_name": True}
+
+
+class ManifestResponse(BaseModel):
+    """Response for GET /api/cloud/projects/{project}/manifest."""
+
+    header: ManifestHeader = Field(
+        default_factory=ManifestHeader,
+        description="Manifest header",
+    )
+    data: list[dict] = Field(
+        default_factory=list,
+        description="List of WeFC objects in the project",
+    )