clocklear
7c68aa3bd3
Puzzle 1 crossfades to the stitched map with a link to /museum-path; puzzle 2 is a touch-friendly drag-and-order challenge with PDF extract scripts for map and artifact assets.
103 lines
4.4 KiB
Markdown
103 lines
4.4 KiB
Markdown
# Agent context — Egyptian Escape Room Digital Lock
|
||
|
||
Homeschool Egyptian-themed escape room: two browser puzzles on separate routes.
|
||
|
||
| Route | Puzzle |
|
||
|-------|--------|
|
||
| `/` | Artifact room door — 8 color-coded numeric inputs |
|
||
| `/museum-path` | Museum path — drag 8 of 16 artifacts into order |
|
||
|
||
## Puzzle mapping
|
||
|
||
| Color | Hex | Answer |
|
||
|-------|-----|--------|
|
||
| Red | `#ee1c11` | 8 |
|
||
| Orange | `#ed7910` | 9 |
|
||
| Yellow | `#eed611` | 10 |
|
||
| Green | `#259e34` | 6 |
|
||
| Cyan | `#1adcd1` | 8 |
|
||
| Blue | `#1b54db` | 6 |
|
||
| Purple | `#841adc` | 12 |
|
||
| Magenta | `#dc18d4` | 4 |
|
||
|
||
All inputs allow up to 2 digits; validation uses numeric comparison (`8` and `08` both match answer `8`). Combined code: `8910686124`.
|
||
|
||
Answers are in client-side `src/lockConfig.ts` — acceptable for a kids' escape room, not a security boundary.
|
||
|
||
## Success flow
|
||
|
||
**Puzzle 1:** Wrong code → OPEN DOOR jiggles + error banner. Correct code → confetti (~2s) → fullscreen unlock video → map crossfades in (9s before end) with **HELP TED ESCAPE** → `/museum-path`.
|
||
|
||
**Puzzle 2:** Drag artifacts from bank into 8 ordered slots; CHECK PATH validates against `src/puzzle2Config.ts`. Correct → confetti + success message. Touch-friendly via `@dnd-kit/core`.
|
||
|
||
Map image is generated from PDF pages 9–10 (left/right halves) via `scripts/extract-artifact-room-map.py` (requires `pip install pymupdf`; Pillow for trimming).
|
||
|
||
## Media assets
|
||
|
||
**Source folder** (WSL: `/mnt/lockbox/storage/...`; Unraid: `/mnt/user/storage/...`):
|
||
|
||
`Documents/Home School Projects/Egyptian Escape Room/`
|
||
|
||
Copied into each environment via setup scripts. Runtime config: `/media/config.json` (see `config.json.example`).
|
||
|
||
| File | Role |
|
||
|------|------|
|
||
| `unlock.mp4` | Success video (`Ted Escape Room 1-5.mp4`) |
|
||
| `artifact-room-map.jpg` | Stitched puzzle 5 map from `EgyptEscapeRoomPrintables.pdf` pages 9–10 |
|
||
| `incorrect.mp3` | Wrong-code sound on UNLOCK |
|
||
| `unlock-confirm.mp3` | Success chime with confetti |
|
||
| `celebration-pop.mp3` | Balloon pop at confetti start |
|
||
| `celebration-horn.mp3` | Party horn — plays with pop; first 2s only |
|
||
| `artifacts/` | 16 PNGs + `manifest.json` for museum-path puzzle |
|
||
|
||
| Environment | Host path |
|
||
|-------------|-----------|
|
||
| Local dev | `public/media/` (via `scripts/setup-dev-media.sh`) |
|
||
| Production | `/mnt/user/appdata/egyptian-escape-room/public/` (via `scripts/setup-prod-media.sh`) |
|
||
|
||
## Local development
|
||
|
||
```bash
|
||
npm install
|
||
./scripts/setup-dev-media.sh # copy video + celebration MP3s → public/media/
|
||
npm run dev # http://localhost:5173
|
||
npm run dev -- --host # LAN access for iPad testing
|
||
```
|
||
|
||
## Docker
|
||
|
||
Requires **Docker Desktop** with WSL integration on the dev workstation. If `docker` is not found, stop and open Docker Desktop, then retry — see homelab [AGENTS.md](https://gitea.apps.lockleartech.com/clocklear/homelab/src/branch/main/AGENTS.md) § “Docker CLI in WSL”.
|
||
|
||
```bash
|
||
./scripts/setup-dev-media.sh
|
||
docker compose -f docker-compose.local.yml up --build # http://localhost:8080
|
||
./scripts/build-push.sh # push to homelab registry
|
||
```
|
||
|
||
Image: `docker-registry.apps.lockleartech.com/egyptian-escape-room:latest`
|
||
|
||
Registry login uses an Authentik app password — see homelab [docs/authentik.md](https://gitea.apps.lockleartech.com/clocklear/homelab/src/branch/main/docs/authentik.md).
|
||
|
||
## Homelab deployment
|
||
|
||
| Item | Value |
|
||
|------|-------|
|
||
| Stack | `egyptian-escape-room` |
|
||
| Hostname | `https://egyptian-escape-room.locklear.net` (LAN-only, `internal-only@file`) |
|
||
| Endpoint | Portainer `Lockbox` (`10.1.0.2`) |
|
||
| Appdata | `/mnt/user/appdata/egyptian-escape-room/public` → container `/media:ro` |
|
||
| Compose snapshot | homelab `lockbox/portainer-traefik/backup/compose/egyptian-escape-room.yml` |
|
||
|
||
Deploy order: `setup-prod-media.sh` on Unraid → build/push image → create/update Portainer stack.
|
||
|
||
## Repo layout
|
||
|
||
- `src/lockConfig.ts` — puzzle colors and answers
|
||
- `src/DigitalLock.tsx` — puzzle 1 UI
|
||
- `src/MuseumPathPuzzle.tsx` — puzzle 2 drag-and-order UI
|
||
- `src/puzzle2Config.ts` — correct artifact slug order
|
||
- `public/media/` — dev media (gitignored copies)
|
||
- `scripts/extract-artifact-room-map.py` — PDF pages 9–10 → stitched JPEG
|
||
- `scripts/extract-artifact-images.py` — 16 embedded map artifacts → `public/media/artifacts/` + `manifest.json`
|
||
- `scripts/setup-dev-media.sh`, `scripts/setup-prod-media.sh`, `scripts/build-push.sh`
|