【Core SSoT】Optimistic UI & Design Token Architecture（超低遅延UI・デザイントークン絶対設計書）

⚠️ THE GENERATIVE SSoT: ZERO-LATENCY FRONTEND & THE UDON-GYOZA PARADIGM 本ドキュメントは、バックエンド（Rust）の超高速処理をさらに加速させ、ユーザーの体感レイテンシを物理的限界までゼロに近づけるUI設計を定義する。オープンナレッジの絶対原則「Astro+WASMマンデート（うどん餃子パラダイム）」を強制執行する。

1. オープンナレッジ絶対原則の強制 (The Sovereign Frontend Mandate)

「もしものはなし」のフロントエンドにおいて、Leptosによる全画面レンダリングは技術的エントロピーを引き起こすため絶対に禁止する。

• アーキテクチャの絶対解:
  • ベースシェル（SEO / LP / 静的ルーティング）: Astro + Tailwind CSS
  • 複雑な動的UI（士業ダッシュボード / 状態管理）: React (Vite/Islands) または Flutter (モバイル)
  • コア・ビジネスロジック: Rust (WASM Bindgen / FFI)
• この構成により、AI（Gemini/Claude）が極めて高い精度でUIコンポーネントを爆速生成（React/Tailwind）可能となり、開発工数を極小化しつつ、Rustの堅牢性を両立する。

2. Optimistic UI（楽観的UI）による体感ゼロレイテンシ

「APIの返答（ローディングスピナー）を待たせる」ことは、シニアや士業の操作ストレスを増大させる最大の障壁である。

• Web (Astro Islands / React): TanStack Query (React Query) の極限活用。
  • ユーザーがフォームを送信、または情報を更新した際、APIリクエストをネットワークに送信すると同時にローカルのUI状態（キャッシュ）を先行して更新し、即座に「完了」を見せる。
  • バックグラウンドでリクエストが成功すればそのまま維持、万が一失敗（HTTP 4xx/5xx）した場合は、UIを自動でロールバックし、不快感を与えないトースト通知でリトライを促す。
• Mobile (Flutter): BLoC パターンとローカル SQLite を組み合わせたOptimistic State Updates。
  • オフライン時やトンネル内でも完全な操作を可能にし、オンライン復帰時にRust Coreを介して同期（CRDTまたはキューイング）を行う。

3. デザインシステムのSSoT（Design Token）とAI連動

UI開発から「人間によるピクセル調整」を完全に排除し、AIがUIを爆速で生成・修正できるように、デザインの「原液」を一元化する。

• Tailwind Config as The Single Source of Truth:
  • Figmaから出力されたカラースキーム、タイポグラフィ、スペーシングの定義（Figma Node IDs）を、すべて tailwind.config.ts に JSON 構造（デザイントークン）として集約する。
  • 「B2Cのウォームホワイト」「B2Bのプロフェッショナルダーク」のテーマ切り替えは、CSS VariablesとTailwindプラグインを通じて完全に自動化・数式化される。
• コンポーネント工数の最小化（Headless UI）:
  • radix-ui や shadcn/ui などのHeadless UI基盤を流用し、自社でゼロからボタンやモーダルを構築する無駄な工数を極限まで削減する。

4. Extensible UI（将来のサードパーティ拡張基盤）

• 葬儀社、遺品整理業者、信託銀行などのサードパーティが、自社のサービス画面をプラットフォーム内に組み込めるよう、カプセル化された iframe 連携機能や、Web Components によるMicro Frontendsの提供を見据えたセキュアなUI設計を行う。