# Pyramid interior ## What this builds A tight WebGL walk through the interior of a monument. The model and the textures are original (or public-domain / permissively licensed scan data, listed in a licence file). The camera follows a path of waypoints. Tests assert the camera hits documented waypoints, take golden frames, and fail if a non-redistributable asset is present. This is not a branded tour of a real ticketed site. Read `spekkr.inputs.json` first. `title` is at the first waypoint. `pace` multiplies path speed; tests step the path by waypoint, not by wall clock. `path` chooses the waypoint list. `guide` and `plan` change the chrome. ## Out of scope - Copyrighted scan data or a commercial tour's assets. - A live guided-tour service or a booking form. - Network or a stream of extra rooms in the checks. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. The path - Each waypoint has a position, a look-at, and a caption. The `guided` path is `fixtures/pyramid-path.json`. - A walk steps from one waypoint to the next. At each waypoint the camera position is within 0.05 units and the look-at within 0.05 units of the file. - The `short` path is the first four waypoints of `guided`. Accept when: every guided waypoint is hit within tolerance, and short ends at the fourth. ### R2. Assets - A `LICENCE.md` lists every model and texture and its licence, all redistributable. - A scan of the repo fails if a listed denied filename or a 'all rights reserved' asset without a redistributable grant is found. - The model used in CI is the one in `assets/`, not a network fetch. Accept when: the licence file is present, the scan is clean, and a fetch hook stays quiet while loading the scene. ### R3. Frames and files - Goldens at entrance, a passage, the main chamber, and the plan view, at those waypoints, pace ignored because tests snap. - One command runs the path, the licence scan, the hook, and writes the frames. No network. Accept when: the command passes for both paths, and the frames match the goldens. ### R4. Inputs - The build reads `spekkr.inputs.json`. Settings label the UI, options turn features on or off, and a swap must be one of its choices. - A value outside a stated range, or a swap that is not one of its choices, is refused before the app starts its checks, with a message that names the key. Accept when: the default inputs render, an illegal swap is refused by name, and changing a visible setting (for example the title) shows up in a later check. ## Verification The camera path hits every documented waypoint within 0.05 units. Golden frames are taken at four of them. Assets used in CI are local and listed as redistributable; a licence scan and a fetch hook fail the build otherwise. No copyrighted commercial tour data. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to walk the path, how assets are licensed, and how to run the checks.