# ワークスペース設定 — デザイン仕様書

> DiagramPreview の独立したサンプルです。製品に合わせて変更してください。Figma の公式テンプレートやインポート形式ではありません。

## 目的と範囲
所有者がワークスペース名と通知設定を変更できるようにする。
請求、招待、権限管理は対象外。架空データを使い、本番サーバーに接続しない。

## デザイントークン
- 主操作：#1D4ED8、白文字。
- 本文：#0F172A、背景 #FFFFFF。補助文字：#475569。エラー：#B91C1C。
- フォント：system-ui。本文 16px / 24px、見出し 24px / 32px。
- 余白：4、8、12、16、24、32px。カード角丸：8px。
- 名前付きトークンを使い、任意の色や余白を追加しない。

## コンポーネントと状態
### 保存ボタン
- 通常：「変更を保存」、主操作の背景色。
- ホバー：#1E40AF、白文字の読みやすさを保つ。
- フォーカス：2px の輪郭、2px の間隔。
- 未変更または無効な入力では無効化し、入力欄の横で理由を説明する。
- 保存中はメッセージを表示し、重複送信を防止する。
- 成功：「変更を保存しました」を live region で通知する。
- エラー時は入力を保持し、再試行を提供する。
### ワークスペース名
- 必須。前後の空白除去後、2〜60 文字。
- ラベルと補足を常に表示し、プレースホルダーで代替しない。
- フォーカスが外れた時と保存前に検証し、エラーを入力欄に関連付ける。
- 検証失敗時は保存しない。

## 操作とデータ
1. 現在の名前と通知設定を読み込む。
2. 有効な変更がある場合だけ保存を有効にする。
3. 送信時は模擬リクエストを実行し、読み込み状態を表示する。
4. 成功時は確定値を保持し、完了を通知する。
5. 失敗時は下書きを保持し、再試行を提供する。
- 初期読み込みは説明付きプレースホルダーを表示する。
- 初期取得の失敗時は再試行を提供し、保存済みデータを捏造しない。
- 名前が空欄の場合は必須メッセージを表示する。

## レスポンシブ配置
- 768px 未満：1 列、余白 16px、保存ボタンは全幅。
- 768px 以上：中央配置、最大幅 640px、余白 24px。
- 幅 320px で水平スクロールが発生しない。

## アクセシビリティ
- 各入力にプログラムで認識できるラベルを付け、Tab は表示順序に従う。
- キーボードで全操作ができ、フォーカスが見える。
- 成功と失敗は色だけでなく文字で伝える。
- 通常文字と実際の背景とのコントラスト比を 4.5:1 以上にする。

## 受け入れチェックリスト
- [ ] 空欄ではエラーを表示し、送信できない。
- [ ] 2〜60 文字の範囲外では具体的なエラーを表示する。
- [ ] 保存中に何度クリックしてもリクエストは 1 回だけ。
- [ ] 失敗時は入力を保持し、再試行できる。
- [ ] フォーカスを移動せずに完了を通知する。
- [ ] キーボード操作と幅 320px の表示を確認する。
- [ ] 実装した全状態を仕様書と比較する。

## 本番公開前の決定事項
- TODO：API、認可、エラーレスポンスを開発担当と確認する。
- TODO：通知動作と最終文言を製品担当と確認する。
- データ契約の承認後に模擬リクエストを置き換える。
