Skip to content

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)FlatfileRolle
Customercustomers/{slug}/Mandant, besitzt den Asset-Store
Project— (nur DB)Dach unter dem Kunden
Stationstations/{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 ​

PfadInhaltSchreibt
config/project.jsonid, name, sceneIds, poiIds, defaultSceneIdAuthoring
config/scenes/…/scene.jsonKamera, Splats, Controls, Viewpoints, poiIdsAuthoring
config/pois/{id}.jsonPosition, Darstellung, ContentAuthoring
assets/splats/3D-ModelleImport / Asset-Store
assets/HDR/Env-MapsAuthoring (Erzeugen)
deploy/deploy-targets.jsonTargets (Web, …)Deploy
deploy/{Target}/gebauter Player-ExportDeploy (Build)

Lebenszyklus ​

text
Authoring  →  speichert config/ (+ HDR)
Deploy     →  liest Station, baut deploy/{Target}/
Player     →  liest die gebaute Station (flach, ohne projects/-Nest)
  1. Station anlegen und in Authoring bearbeiten (Szenen, POIs, Splats).
  2. In Deploy ein Target wählen und bauen → Ordner unter deploy/{TargetSlug}/.
  3. 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 — id demo_v01, mehrere sceneIds, 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) ​

raumgridfrüher (v2)Job
AuthoringEditorConfig schreiben
DeployAdminTargets, Build, ZIP
PlayerCustomerErlebnis ansehen

Details: Shells.