docs: UI描画方式の比較条件を定義

[T4ko0522]

概要

Presentation Surface の描画方式として、baked-web、事前生成 Video、native-ui、embedded-web を同じ条件で比較するための基準を定義します。Issue #78 の実機 PoC と Issue #77 の方式決定で使用する入力、測定手順、採用 gate、撤退条件、fallback をまとめています。

背景

Web と Unity/MR で同じ UI 表現を再現する方式を、見た目だけでなく動的表現、性能、決定性、同期、復旧、保守性まで含めて実測可能にする必要があります。

Related: #74

この PR は Presentation 基盤を追加する Draft PR #93 に依存する stacked PR です。

主な変更点

• PoC 開始前に [Storyboard] 発表の絵コンテv0を作成する #73 と [Unity] 実機デモの制約と必要なMR表現を洗い出す #76 から固定する入力を定義
• 4 方式の責務、現行実装、Target contract、PoC の境界を整理
• 共通 fixture、実機環境、試行回数、測定項目を定義
• 全方式共通の採用 gate と方式別の撤退条件を定義
• fallback を build / Delivery 前に選択する検証済み方式として明確化
• Issue [Unity] UI統一方式の実機PoCを作る #78 の出力形式と Issue [Architecture] baked-web / embedded-web / native-uiの採用方式を決定する #77 の決定記録要件を定義
• Presentation Architecture から比較条件文書への導線を追加

影響範囲

• frontend: 特になし
• backend: 特になし
• config: 特になし
• CI: 特になし
• docs: docs/presentation/UI_RENDERING_COMPARISON.md を追加し、docs/presentation/ARCHITECTURE.md にリンクを追加

レビューで見るべきポイント

• 現行実装、Target contract、Issue [Unity] UI統一方式の実機PoCを作る #78 の PoC 専用実装を混同していないか
• [Storyboard] 発表の絵コンテv0を作成する #73 / [Unity] 実機デモの制約と必要なMR表現を洗い出す #76 の未確定値を推測せず、入力として確定させる構造になっているか
• hard gate の失敗を合計点で相殺せず、Surface class ごとに採用範囲を決める手順が妥当か
• runtime 中の暗黙切替を fallback に含めない定義が妥当か
• Issue [Unity] UI統一方式の実機PoCを作る #78 の担当者が追加解釈なしで fixture と測定手順を再現できるか

残っている論点

• Issue [Storyboard] 発表の絵コンテv0を作成する #73 の絵コンテは WIP のため、代表 Surface、State 系列、Runtime 値、必要な Web capability の確定待ち
• Issue [Unity] 実機デモの制約と必要なMR表現を洗い出す #76 は対象端末、負荷条件、許容値などの具体化待ち
• 上記が確定するまで本文書の Status は Working baseline とし、性能の採否判定は行わない
• PR 作成時点で未解決のコメント・レビュースレッドはなし

マージ前チェック

• CI が green か（ローカルの nix run .#check は成功済み）
• 未解決レビュースレッドが無いか
• ドキュメントのみの変更であり、コードテストの追加・更新が不要か
• [Storyboard] 発表の絵コンテv0を作成する #73 / [Unity] 実機デモの制約と必要なMR表現を洗い出す #76 の確定内容を反映し、比較条件を承認可能な状態へ更新したか

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	unframe-web-editor	c0ac2ad	Sep 02 2026, 05:42 AM

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	unframe-lp	c0ac2ad	Sep 02 2026, 05:42 AM

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	unframe-control-plane	c0ac2ad	Sep 02 2026, 05:44 AM