updated docs
This commit is contained in:
42
docs/data/en/room-setup.md
Normal file
42
docs/data/en/room-setup.md
Normal file
@@ -0,0 +1,42 @@
|
||||
# Room Setup
|
||||
|
||||
Two ways to create a room: CLI wizard or web wizard.
|
||||
|
||||
```bash
|
||||
# CLI wizard
|
||||
python -m init.cli myroom
|
||||
|
||||
# Web wizard (opens browser on :9000)
|
||||
python -m init.web
|
||||
|
||||
# Clone from existing room
|
||||
python -m init.cli myroom --from sample
|
||||
```
|
||||
|
||||
## Layers
|
||||
|
||||
Each layer is optional beyond layer 0.
|
||||
|
||||
| Layer | What | Files |
|
||||
|-------|------|-------|
|
||||
| 0 | Config + Data | `config.json`, `data/*.json` |
|
||||
| 1 | Docker | `soleprint/docker-compose.yml`, `.env` |
|
||||
| 2 | Managed App | `docker-compose.yml`, Dockerfiles, `.env` |
|
||||
| 3 | Link | `link/main.py`, `adapters/`, Dockerfile |
|
||||
| 4 | Scripts | `ctrl/start.sh`, `stop.sh`, `status.sh`, `logs.sh` |
|
||||
| 5 | Systems | tester environments, test scaffolds |
|
||||
| 6 | Nginx | `nginx/local.conf`, `docker-compose.nginx.yml` |
|
||||
|
||||

|
||||
|
||||
The wizard adds layers incrementally. Layer 0 is always created. Each subsequent layer builds on the previous ones but none are required.
|
||||
|
||||
## Build
|
||||
|
||||
After the wizard finishes, build the room:
|
||||
|
||||
```bash
|
||||
python build.py --cfg myroom
|
||||
```
|
||||
|
||||
Output goes to `gen/myroom/`. The build merges room-specific configs from `cfg/myroom/` into the base framework.
|
||||
Reference in New Issue
Block a user