Appearance
Aufbau eines Projekts (Station)
Eine Station ist die Erlebnis-Einheit: Config, Assets und Deploy-Ziele in einem Ordner. In raumgrid heißt sie Station; im eingefrorenen Viewer v2 hieß derselbe Ordner „Projekt“.
Lies zuerst diese Seite. Details: Begriffe, Config, Assets & Deploy, Ordnerbaum.
Domain → Ordner
text
Customer
└── Project (Dach im Admin)
└── Station ← dieser Ordnerbaum| Begriff (raumgrid) | Flatfile | Rolle |
|---|---|---|
| Customer | customers/{slug}/ | Mandant, besitzt den Asset-Store |
| Project | — (nur DB) | Dach unter dem Kunden |
| Station | stations/{id}/ bzw. public/projects/{id}/ | Erlebnis: Szenen, POIs, Splats, Deploy |
Merke: „Project“ in der App ≠ Station-Ordner. Der Ordner ist immer die Station.
Kanonischer Baum
text
stations/{stationId}/
config/
project.json # Inhaltsverzeichnis der Station
scenes/{sceneId}/scene.json # eine Szene
pois/{poiId}.json # ein POI pro Datei
assets/
splats/ # .splat / .ply / .spz
HDR/ # Env-Maps
deploy/
deploy-targets.json # Auslieferungsziele
{TargetSlug}/ # flacher Web-Export (index.html + config + assets)In v2-Referenz: public/projects/{id}/ mit derselben Innenstruktur. Fonts liegen nicht pro Station, sondern global (public/assets/fonts/).
Was wohin — wer schreibt
| Pfad | Inhalt | Schreibt |
|---|---|---|
config/project.json | id, name, sceneIds, poiIds, defaultSceneId | Authoring |
config/scenes/…/scene.json | Kamera, Splats, Controls, Viewpoints, poiIds | Authoring |
config/pois/{id}.json | Position, Darstellung, Content | Authoring |
assets/splats/ | 3D-Modelle | Import / Asset-Store |
assets/HDR/ | Env-Maps | Authoring (Erzeugen) |
deploy/deploy-targets.json | Targets (Web, …) | Deploy |
deploy/{Target}/ | gebauter Player-Export | Deploy (Build) |
Lebenszyklus
text
Authoring → speichert config/ (+ HDR)
Deploy → liest Station, baut deploy/{Target}/
Player → liest die gebaute Station (flach, ohne projects/-Nest)- Station anlegen und in Authoring bearbeiten (Szenen, POIs, Splats).
- In Deploy ein Target wählen und bauen → Ordner unter
deploy/{TargetSlug}/. - Player liefert genau diesen Export aus.
Aktive Station in den Shells: gemeinsame Origin + viewer_current_project_id (localStorage). Der Player hat keine Stations-Auswahl — er folgt Authoring/Deploy.
Lebendes Beispiel: demo_v01
Referenzbaum (v2, eingefroren): frontend-viewer/v2/public/projects/demo_v01/.
config/project.json— iddemo_v01, mehreresceneIds,defaultSceneId: "Atelier"- Szenen unter
config/scenes/(z. B.Atelier/scene.json) - POIs unter
config/pois/ - Deploy-Target „Website“ →
deploy/Website/(flacher Export)
Zum Nachschlagen: Ordnerbaum, Config-Dateien.
Shells (kurz)
| raumgrid | früher (v2) | Job |
|---|---|---|
| Authoring | Editor | Config schreiben |
| Deploy | Admin | Targets, Build, ZIP |
| Player | Customer | Erlebnis ansehen |
Details: Shells.