Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。
docs: record site-access flagship deployment (#101)
AAA39b3415d8e06
diff --git a/docs/deployment.md b/docs/deployment.mdindex 629a85c6..a3a5a523 100644--- a/docs/deployment.md+++ b/docs/deployment.md@@ -20,15 +20,18 @@ tracked coturn example remains `stun-only`; the shared host retains its olderauthenticated-relay daemon configuration and firewall range. The applicationdoes not pre-advertise TURN credentials to ordinary peers.-Production currently runs exact `c27df2235ecc0be17816f642ca49028e30380a34`+Production currently runs exact `5e4a3679076a9ea2fe7a41fadf4be65a439db450`on the existing shared public IP, with local/public health 200 and SQLite v3-integrity. The 912,999-byte artifact has SHA-256-`1c7f06e2608414f0a4facf8577c8b49a8fefb831e20826c0e23fa0d1e85240d6`.-The 2026-08-20T19:03:10Z UTC cutover held the deployment lock for 662 ms;-local health returned 552 ms after service stop (543 ms after the symlink+integrity. The 909,974-byte artifact has SHA-256+`e484773c7dc381e657da18720e842c3ae90ad727320a650abcb1098428c74774`.+The 2026-08-20T20:11:20Z UTC cutover held the deployment lock for 9,474 ms;+local health returned 676 ms after service stop (529 ms after the symlinkswitch). Screener, LiveKit, coturn, and nginx are active/running with`NRestarts=0`. SQLite v3 contains five rooms including room `1`, with the-service owner/mode preserved. Exact `cf149df2411798cd632cc92a562b0a35146e0c1b`+service owner/mode and database hash preserved. `SITE_ACCESS_PASSWORD`,+`/api/site-access`, and the nginx limiter replaced their retired Host-admission+names in the same lock-held cutover; the old endpoint returns 404. Exact+`c27df2235ecc0be17816f642ca49028e30380a34`is the immediate rollback target.The selected-edge UDP tuple is configured with TTL 120, but no real TURN/SFUmedia canary was triggered; this remains a bounded configuration smoke, notdiff --git a/docs/project-memory.md b/docs/project-memory.mdindex a179238a..32e2e101 100644--- a/docs/project-memory.md+++ b/docs/project-memory.md@@ -43,10 +43,10 @@ Last updated: 2026-08-21## Current Implementation- The repository is one npm package using Node.js 24, React, TypeScript, Vite, native WebRTC, `ws`, Zod, Vitest, and separate coturn.-- Production serves exact `c27df2235ecc0be17816f642ca49028e30380a34` at `https://share.bonfire.icu`. The immutable artifact is 912,999 bytes with SHA-256 `1c7f06e2608414f0a4facf8577c8b49a8fefb831e20826c0e23fa0d1e85240d6`; the 2026-08-20T19:03:10Z UTC cutover held the deployment lock for 662 ms and reached local health in 552 ms from stop (543 ms from symlink switch). Exact `cf149df2411798cd632cc92a562b0a35146e0c1b` is the immediate rollback release.+- Production serves exact `5e4a3679076a9ea2fe7a41fadf4be65a439db450` at `https://share.bonfire.icu`. The immutable artifact is 909,974 bytes with SHA-256 `e484773c7dc381e657da18720e842c3ae90ad727320a650abcb1098428c74774`; the 2026-08-20T20:11:20Z UTC cutover held the deployment lock for 9,474 ms and reached local health in 676 ms from stop (529 ms from symlink switch). Exact `c27df2235ecc0be17816f642ca49028e30380a34` is the immediate rollback release.- The current Screener, LiveKit, coturn, and nginx services are active/running with `NRestarts=0`; local and public health are 200. SQLite v3 is intact with five rooms including room `1`, and the DB owner/mode remain `screener:screener`/0600.- Production ICE remains ordinary STUN-only. `PEER_ASSISTED_MEDIA=true` enables the controller for every normal room, and selected-edge TURN is now configured for the single UDP tuple with TTL 120; the coturn daemon and nginx/LiveKit/firewall/listener baselines were unchanged. No real TURN/SFU media canary or quality claim is implied.-- The current source requires the independent site-access secret through `SITE_ACCESS_PASSWORD`. Its stateless cookie authorizes creation/Host and permits code-only Viewer attempts; valid private fragment grants remain direct. Public-watch accepts site access plus code, while private code-only entry additionally requires the room password. The atomic boundary and naming migration are not yet deployed; anonymous failures stay neutral, and there are no accounts/JWT/session rows.+- Production requires the independent site-access secret through `SITE_ACCESS_PASSWORD`. Its stateless cookie authorizes creation/Host and permits code-only Viewer attempts; valid private fragment grants remain direct. Public-watch accepts site access plus code, while private code-only entry additionally requires the room password. The env, endpoint, cookie, and nginx limiter naming migrated atomically; anonymous failures stay neutral, and there are no accounts/JWT/session rows.- Production uses nginx, Node.js 24.19.0, coturn 4.17.2, and LiveKit 1.13.5 on UDP 7882 (TCP fallback off). Ordinary peer ICE receives no TURN; the selected-edge tuple is configured only for the current controller edge, with no credential pre-advertised to ordinary peers. Coturn retains the old authenticated-relay ports. Services are healthy with zero restarts.- ADR-0005 source rejects `PEER_ASSISTED_ROOM_IDS`; `PEER_ASSISTED_MEDIA=true` enables every room, while ordinary peer ICE stays STUN-only. A stale room-ID variable fails startup. `screener-v2` is the only deployed signaling literal; there is no v1 parser or translator.- Chrome 151/LiveKit localhost A/B cut failure-to-active/render from 1.481/2.257 seconds to 0.200/0.320; 31 new frames and 25 ms sampling kept host edges at two. It is headless synthetic 720p30 and includes SDK/network prewarm, not public-network evidence.diff --git a/docs/status.md b/docs/status.mdindex 02eb7afd..82bd7e66 100644--- a/docs/status.md+++ b/docs/status.md@@ -4,8 +4,8 @@ Last updated: 2026-08-21## Phase-`https://share.bonfire.icu` serves exact `c27df2235ecc0be17816f642ca49028e30380a34`; the 912,999-byte artifact SHA-256 is `1c7f06e2608414f0a4facf8577c8b49a8fefb831e20826c0e23fa0d1e85240d6`.-The cutover held the lock 662 ms and returned local health 552 ms after stop. SQLite v3 has five rooms; Screener, LiveKit, coturn and nginx are healthy with zero restarts.+`https://share.bonfire.icu` serves exact `5e4a3679076a9ea2fe7a41fadf4be65a439db450`; the 909,974-byte artifact SHA-256 is `e484773c7dc381e657da18720e842c3ae90ad727320a650abcb1098428c74774`.+The cutover held the lock 9,474 ms and returned local health 676 ms after stop. SQLite v3 has five rooms; Screener, LiveKit, coturn and nginx are healthy with zero restarts.Ordinary ICE is STUN-only; all rooms use the bounded peer/SFU-UDP controller and selected-edge UDP TTL 120. Room `1` is historical smoke and no real TURN/SFU media canary has run.Web Host names/audio hint are deployed. Native H.264 and Windows x64 packaging are source-only; Web defaults VP8.@@ -16,7 +16,7 @@ Flagship; parallel; min run/smoke/rollback; benchmark later. Active UI/config/lo## Current Snapshot- Capture precedes room creation; source/quality changes preserve peers and pause keeps audio/connections. Quality defaults to `maintain-resolution` with balanced/fluid options.-- Production access is `screener-v2`: a valid private fragment grant enters directly; every code-only Viewer must first hold site access, after which public-watch accepts the code and private rooms still require their room password. The source fix and atomic `SITE_ACCESS_PASSWORD`/`/api/site-access`/site-access-cookie rename are not deployed; raw credentials are never stored.+- Production access is `screener-v2`: a valid private fragment grant enters directly; every code-only Viewer must first hold site access, after which public-watch accepts the code and private rooms still require their room password. `SITE_ACCESS_PASSWORD`, `/api/site-access`, and the site-access cookie are deployed atomically; raw credentials are never stored.- Web Hosts can set their local/session display name, and the current release advertises it through the existing presence wire. The name is not an account identity.- Native v2 remains source-only (memory rooms, 300s reclaim); production does not run it.- PR #44's STUN-only/SFU-UDP router and token-free fallback prewarm are process-enabled for all normal rooms: roots <=2, browser relay <=1, bounded failure. Room `1` is historical smoke; mobile/iPad viewers are leaves, healthy edges sticky, and HTTPS/WSS stays TLS/TCP.@@ -35,7 +35,7 @@ Flagship; parallel; min run/smoke/rollback; benchmark later. Active UI/config/lo- Access protocol/config/HTTP/storage/SQLite/signaling focused tests pass, including commit-first teardown and v1 rollback.- Source adds selected Host ingress and peer last-mile for every enabled room; focused routing/config tests pass with Peer ICE STUN-only.- Host names, the window-audio hint, all-room routing, and all-room Host selected ingress are active; the stale restart assertion is historical only.-- The `c27df22` gate preserved env/DB hashes, SQLite v3/five rooms/room `1`, services, and local/public health plus route/asset 200s. No TURN/SFU session ran.+- The `5e4a367` gate preserved the SQLite hash, v3/five rooms/room `1`, selected-edge/SFU/ordinary-ICE settings, services, and local/public health plus route/asset 200s. Site access returned the unauthenticated status and the retired endpoint returned 404; no TURN/SFU session ran. Exact `c27df2235ecc0be17816f642ca49028e30380a34` is the rollback release.## Unverified Boundaries