# AV8 設計資料

画面の確認は **[図解ガイド](design/visual-guide.html)**。各機能の入口と結果を並べた現在の設計案で、Android実装の完成を示すものではない。

## 必要なときに開くもの

| 資料 | 役割 |
| --- | --- |
| [要件定義](product/requirements.md) | 目的・優先度・要件ID・受入条件の正本 |
| [操作・状態仕様](product/interaction-spec.md) | 画面と入力・編集・中断の規則の正本 |
| [プラットフォーム設計](product/platform-design.md) | プロファイル・ページのモデル、OS境界、Private等の安全性 |
| [未決事項と実装差分](product/review-register.md) | 判断待ちの項目と、モック／Androidとの違い |
| [指摘事項・回帰確認](pointed-issues.md) | 過去の不具合指摘をテストの種として保持 |

設定からの[アプリ自動整理の確定仕様](product/interaction-spec.md#app-auto-organize)は操作・状態仕様に統合した。外部LLMとのコピー／貼り付けによる補助機能をAndroidと図解ガイドに反映。初回の端末内デフォルト分類改善とは別に扱う。

図解ガイドのHTMLは直接開く。サーバーは不要。アプリアイコンは外部配信のためネット接続が必要。ローカルのツールアイコンはlucide-static 0.468.0で、[ライセンス](design/assets/lucide-LICENSE)を同梱する。

外出先の確認先は [公開モック](https://test.iciclize.net/av8/design/visual-guide.html)。相対リンクを維持するため、設計資料とアイコンも同じディレクトリ構成で公開する。

```sh
bash scripts/deploy-mock.sh
```

今後はモック・資料・アイコンの更新時に同時デプロイする。事前検証後、SSHで `ice@iciclize.net:/home/ice/www/public/av8` へアップロードし、公開HTML・アイコンとローカルの内容一致を確認する。APK・テスト・ログ・Git情報は送らず、既存の無関係なファイルは削除しない。

## モックの範囲

[パレット候補100案](design/palette-candidates.html)は配色選定だけの比較カタログ。アプリの別版モックではない。各案は8色のライト／ダークペアで、候補番号と配色は固定。採用済みのP010（バランス／ミュート）をAndroid・正本ガイドのSimpleプリセットへ反映した。

壁紙・背景色・透明度の章では全カテゴリ共通スライダーだけを操作できる。ホーム背景色の明暗ペア・透明度・解除、設定から編集画面への入口、各カテゴリの⋮からの全展開・全縮小も図解する。写真は [Luca Bravo / Unsplash](https://unsplash.com/photos/brown-house-near-body-of-water-zAjdgNXsMeg) の「Boathouse on a mountain lake」を [Unsplash License](https://unsplash.com/license) に基づき同梱した説明用サンプル。Androidにこの画像を壁紙として強制設定する機能ではない。

図解ガイド1本で、16章・64画面の静的な設計案を確認する。操作箇所と結果を並べたもので、共通透明度のプレビュー以外はドラッグ・検索・保存・認証等の動作を実行しない。Android本体とはデータを共有せず、図の存在を実装や試験の成功証拠としない。ページ管理・専用設定・ドット表示スイッチ・移動ダイアログ・スライド・下部切替・壁紙・カテゴリ色・提供元プレビュー・下辺リサイズハンドル・テキストによるアプリ整理はAndroidへ反映。実装の検証範囲と残る差分はレビュー項目を参照する。下部ナビは左右分散案を日本語・英語・文字150%で比較し、幅不足時は設定・検索の両方を右端の三点メニューへ収納する。現行仕様と異なる操作試作は置かない。

## 検証

```sh
node docs/design/tests/docs.test.cjs
```

資料のリンク・到達経路・要件参照・図解生成と、不要な資料が再追加されていないことを検証する。Androidの操作・状態・保存を検証するテストではない。実ブラウザの表示と、Androidの実操作・OS機能は別途検証が必要。

## 更新の規則

- 同じ仕様を別ファイルへ複製せず、正本を更新してリンクする。
- 合意内容と詳細案・未決事項を区別し、実装の挙動だけを理由に仕様を書き換えない。
- 撤回案は現行資料に積み重ねない。比較が終わったHTMLは、固有情報を正本へ移して削除する。
- 新しい資料は、上のどの役割にも収まらない場合だけ追加する。画面の確認先は図解ガイドに集約する。