Update architecture.md with project package details

This commit is contained in:
2026-03-31 17:45:30 +02:00
parent 9e86905e7b
commit 6b8e0ce2d1

View File

@@ -725,6 +725,30 @@ Reasons:
- easier to migrate than overloading glTF with editor-only metadata
- decouples authoring from runtime/export packaging
Canonical document format is not the same thing as the portable project format.
Once scenes reference external binary assets, JSON alone is no longer enough to move a project between machines.
At that point, the user-facing save/load format should be a **project package** built around:
- `scene.json`
- referenced asset payloads
Recommended logical shape:
```txt
project/
scene.json
assets/
...
```
The project package may be represented as:
- a folder
- a zip/archive of that folder
Runner/deployment output is separate from this and should not become the editable source package by default.
### Migration rule
Every persisted schema change must be accompanied by: