# Radio globe ## What this builds A globe with marks for radio stations. Clicking a mark plays a local fixture loop, not a live radio network. The stations are fictional, with documented coordinates. A hook fails if a known live-radio host is contacted. The look is original. Read `spekkr.inputs.json` first. `title` sits over the globe. `volume` is the default. `set` chooses the list. `labels` and `night` change the picture. The sun position for night is a fixture, not a live clock, unless tests inject one. ## Out of scope - A live radio network or a commercial stream directory in the checks. - A claim that the stations are real broadcasters. - Network in the checks. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Coordinates and play - Each station has a name, lat, lon, and a local audio path. Fixture positions in `fixtures/radio-stations.json` are drawn at the documented projected pixel, within 3 px, on the default camera. - Clicking a listed station starts its local file, sets a playing flag, and shows its name if labels are on. - A fetch hook fails if a known radio or stream host is contacted. Accept when: every listed station projects within 3 px, play requests the local file, and the hook stays quiet. ### R2. Frames and files - Goldens: the sample globe, a selected station, a playing chrome, and the tiny set. - One command projects, plays, hooks, and writes the frames. No network. Accept when: the command passes for both sets, and the frames match the goldens. ### R3. 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. ### R4. Checks and report - One command runs every acceptance check at the defaults and at the person's inputs, including golden frames where a requirement asks for them. - Checks do not need a network, a paid API, or physical hardware. Accept when: the command passes at the defaults, and a deliberately broken fixture or a wrong price fails it. ## Verification Fixture stations appear at documented latitudes and longitudes, checked in projection. Click-to-play uses a local audio fixture, not a live radio network; a fetch hook fails otherwise. Golden frames are taken. Stations are fictional. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to add a fixture station, how play is local, and how to run the checks.