# UX Core Specification v1

## 目的
- シリーズ内書籍の見た目と導線を「共通コア」で統一し、ばらつきを最小化する
- 差分は `profile` と `modules` で吸収し、強制ではなく段階適用を可能にする

## 適用範囲
- 新規書籍: book-formatter から生成する標準フォーマット
- 既存書籍: 破壊的変更を避け、まずは共通コア（ヘッダー/サイドバー/フッター等）を適用する

## 用語
- 共通コア: 全書籍で必須とする UI 骨格と導線
- プロファイル: 書籍の目的別に定義する A/B/C の類型
- モジュール: profile に応じて ON/OFF 可能な UI 部品

## 共通コアの要件
### Must（必須）
- ヘッダー: 書籍タイトル、トップへの導線
- サイドバー（または同等のグローバルナビ）: 章/付録への導線
- フッター: ライセンス表記（CC BY-NC-SA 4.0、商用は別契約）、リポジトリ導線
- 全ページで共通のテーマ/検索導線（既存の実装に追随）
- トップページの必須スロットを保持（標準スロットを参照）
- 章ページの必須スロットを保持

### Should（推奨）
- トップページの見出し名称を標準スロットに合わせる
- 章ページに「目的（objectives）」がある場合は章冒頭に表示する
- 付録/用語集/図表一覧などの導線を明示する

### May（任意）
- プロファイルに応じた modules を追加する
- 既存書籍の制約によりスロットの順序を微調整する

## UI骨格（スロット定義）
### トップページ標準スロット（index）
1. `hero` : タイトル / サブタイトル / 学習成果（3項目）
2. `readerProfile` : 想定読者 / 前提知識 / 所要時間
3. `readingGuide` : 読み方ガイド（module）
4. `toc` : 目次（自動生成）
5. `license` : ライセンス表記

注記:
- `readerProfile` は「想定読者」「前提知識」「所要時間」を別見出しで分割してもよい
- `readingGuide` は modules の ON/OFF に従い表示される

### 章ページ（chapter）
1. `objectives` : 章の目的（front matter）
2. `body` : 本文
3. `summary` : まとめ
4. `nextSteps` : 次に読む内容や関連章

### 付録/巻末
- `appendices` に modules（glossary / figureIndex / legalNotice 等）を配置可能

## 互換性方針
- `ux` 未指定の既存書籍は、現行挙動を維持する
- 段階適用時は共通コアの適用を最優先し、本文構造は変更しない