zwitschi
71c7ca734b
Owner decision: prioritise realism, keep the performance target but put it last.
Re-applied on a branch after the first attempt landed directly on main (reverted
there; see b8209ce).
- Quality goals (01 + combined architecture.md): 1 visual realism, 2 geographic
fidelity, 3 walkability/usability, 4 reproducibility/portability, 5 provenance,
6 performance efficiency.
- Quality requirements (10 + combined) reordered to match, with two realism
requirements added (a façade reads like the photographs; placement within ~1 m)
and the scenarios renumbered so QS-1 is the reference comparison, QS-9 the frame
rate.
- Guard on both documents so the order cannot become an excuse: performance is a
floor, not a preference - 60 FPS at 1440p without frame generation must be met at
every release; if realism cannot fit, cut the realism scope deliberately and
record it, never the frame rate. Walkability outranks realism in one direction: a
block you fall through is not a demo.
- Solution strategy and 'quality achievement' lead with realism and describe
performance as a budget, not a driver.
- Docs/release-checks.md: the performance check is the last section and the per-
version check list now opens with realism and closes with performance.
- ROADMAP gains a 'Quality priority' section; AGENTS.md gains the tie-break rule
beside the existing scope-cutting rule.
39 lines
2.8 KiB
Markdown
39 lines
2.8 KiB
Markdown
# Introduction and Goals
|
||
|
||
Gig Line is a Linux-first Unreal Engine 5 game that reconstructs a walkable (and eventually drivable) stretch of Hollywood Boulevard around 6840 Hollywood Blvd / El Capitan Entertainment Centre. The initial release (`0.1.0`) delivers a first-person walking demo of the south-side block between Highland Avenue and Orange Drive, plus north-side buildings within 50 m of the frontage.
|
||
|
||
## Requirements Overview
|
||
|
||
| ID | Description |
|
||
| --- | --- |
|
||
| F-1 | Walk both sides of Hollywood Blvd in the demo area without falling through geometry |
|
||
| F-2 | First-person movement (WASD + mouse look), jump, reset (R), pause (Escape) |
|
||
| F-3 | Fixed daytime lighting and atmosphere (sun, sky, fog, exposure) |
|
||
| F-5 | Designated street crossing with zebra markings at signalised crossings |
|
||
| F-6 | Building façades recognisable against reference photography |
|
||
| F-7 | Terrain, road, and sidewalk follow real-world DEM elevation |
|
||
| F-8 | 60 FPS at 1440p on the documented workstation and quality preset |
|
||
|
||
Full requirements and progress are in [TODO.md](../../TODO.md); version direction is in [ROADMAP.md](../../ROADMAP.md).
|
||
|
||
## Quality Goals
|
||
|
||
| Priority | Quality Goal | Scenario |
|
||
| --- | --- | --- |
|
||
| 1 | **Visual realism** | Renders read as the reference photographs: façade identity, proportion, material and light — judged side by side, shot against photo |
|
||
| 2 | **Geographic fidelity** | Building placement and street scale match the measured data and the photographs |
|
||
| 3 | **Terrain walkability** | Zero raycast holes across both sidewalks and the carriageway (84-sample transect passes) |
|
||
| 4 | **Build reproducibility** | Fresh checkout + documented engine path produces a runnable Linux build |
|
||
| 5 | **Provenance** | Every committed asset has recorded provenance |
|
||
| 6 | **Performance efficiency** | 60 FPS at 2560×1440 on RTX 5070 Ti, documented preset, no frame generation |
|
||
|
||
**How the order is used.** It decides trade-offs. When realism and performance disagree, realism wins and the cost is paid — but never by silently shipping a frame rate below the floor. The 60 FPS figure is a **budget that must still be met**, so the response to "realism costs too much frame time" is to cut the realism feature deliberately, record the cut, and keep the floor — not to let frames slip. Walkability outranks realism in one direction only: a beautiful block the player falls through is not a demo.
|
||
|
||
## Stakeholders
|
||
|
||
| Role | Contact | Expectations |
|
||
| --- | --- | --- |
|
||
| Owner / Director | zwitschi | Sets scope, approves screenshots, cuts release tags |
|
||
| AI coding agents | multiple sessions | Read `AGENTS.md`, `TODO.md`, `ROADMAP.md`, and this document for architecture constraints; never commit directly to `main` |
|
||
| Players | end users | Walk the demo at 60 FPS without falling through the world; see a recognisable Hollywood block |
|