Files
aetherbound-guild/docs/runtime/PHASE9_0_WEB_PREVIEW.md
T

67 lines
3.3 KiB
Markdown

# Phase 9.0 Web Preview Delivery
## Owner Authorization
On 2026-08-12 the Owner requested a dedicated remote H5 page for phone review
of the accepted P9.0 runtime candidate. This authorizes only a Godot Web export,
local browser verification and private Artifact Gallery deployment.
## Content Boundary
- Product behavior authority remains P9.0 source
`f881920b1be29933169950429d4e55d8cac825d8`; the Web-compatible successor may
add only the embedded font, stream-playback selection, export configuration
and capture-harness cleanup required by this delivery.
- The Web package may expose the preserved Contract page only through the
already accepted `Start New Game` handoff.
- It may not change Boot, Title, Contract, Recruit, Market, battle, economy,
save, art, audio or content authority.
- Tests, evidence, build outputs, source documents and repository history must
not be included in the exported PCK.
## Delivery Contract
- Preset: `Web Preview` in `runtime/export_presets.cfg`.
- Template: Godot 4.6.1 non-threaded Web release, so the private remote page
does not require cross-origin isolation headers.
- Canvas: browser-window responsive, canvas focused on startup, experimental
mobile virtual keyboard enabled.
- Portrait phones show an explicit rotate-to-landscape overlay instead of a
tiny letterboxed game canvas; rotating to landscape reveals the game.
- Local output: ignored `runtime/build/web-preview/<product-source>/`.
- Remote output: the smallest self-contained export directory, published as a
dedicated Artifact Gallery HTML item.
Verify export success, expected HTML/JS/WASM/PCK files, exact ZIP data-package
contents with zero `tests/`, `evidence/` or `build/` entries, local HTTP loading,
real browser canvas dimensions, portrait rotation guidance, one canvas click
and the `Start New Game` handoff. Verify the Gallery health and signed share URL
after publication.
The browser build embeds `runtime/assets/fonts/NotoSansSC.ttf` and its
`runtime/assets/fonts/OFL.txt` license so Simplified Chinese does not depend on
a host font. `PrototypeSFX` must use Godot stream playback; a Web backend may
not select sample playback for `AudioStreamGenerator`.
This is a browser preview, not physical-device, packaging, store, publishing or
release acceptance. Owner review of the remote page remains a human gate.
## Remote Delivery
Fixed Web source `f0aa84738041cebf4968d91c6bf170668804e203` is published
as private Artifact Gallery item `PRji-yhJo0nQ`. The signed item URL redirects
to the full-screen `index.html` only after setting an artifact-scoped HttpOnly
cookie; the signing token is not stored in this repository. Direct access
without that cookie still reaches the Gallery login boundary.
Remote verification confirms correct JavaScript, WASM and PCK response types,
a runtime CSP without the document sandbox, successful Godot/WASM startup,
Simplified Chinese Title rendering in the requested landscape phone viewport,
the real canvas `Start New Game` handoff to Contract, and the portrait rotate
overlay. Browser warning/error count is zero. Artifact Gallery retains its
document sandbox for ordinary HTML; executable delivery requires an explicit
`runtime-html` manifest kind.
The final source-bound evidence inventory verifies 34/34 with SHA-256
`cb3111f86012d313c85d1eebed6574b8b5936531bf30821421f89f1442aeb945`.