> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bouquet-inc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Todo

# Discount Deck: 新しいお客様アカウント向けマニュアル更新

## 完了条件

1. 以下2ページが、アプリの実コード（`discount-deck` の `extensions/customer-account-coupon-list` / `customer-account-coupon-page` / `packages/shared`）と一致した記述になっている。
   * `/apps/discount-deck/notice-customer-account-migration`
   * `/apps/discount-deck/setup/new-customer-accounts`
2. 2ページそれぞれに、コードから読み取れる仕様を根拠にした「よくある質問」が載っている。
3. 日本語と英語の両方が更新され、`mint broken-links` が通る。

## 前提

* 独立ページ（フルページ拡張）は discount-deck PR #351 の内容で、**まだ本番リリースされていない**。
  この docs 変更のマージは #351 のリリース後に行う。
* 公開は `main` マージ時。作業は `docs/discount-deck-customer-account-fullpage` ブランチで行い、main には直接反映しない。

## タスク

* [x] 対象2ページの現状を読む
* [x] 拡張の設定スキーマ（toml）・ロケール・コンポーネントの挙動を確認する
* [x] 管理画面側のラベル（推奨画像サイズ・備考）を main で確認する
* [ ] `notice-customer-account-migration.mdx`（日本語）を更新
* [ ] `setup/new-customer-accounts.mdx`（日本語）を更新
* [ ] 英語版2ページを同内容で更新
* [ ] `mint broken-links` で検証
* [ ] レビューセクションを書く

## 記述の根拠（コード）

| 記述                              | 根拠                                                             |
| ------------------------------- | -------------------------------------------------------------- |
| メタフィールドのアクセス設定は「読み取り」           | `ensureMetafieldDefinition` の `access.customerAccount: "READ"` |
| ブロックは2件表示＋モーダルで全件               | `CouponListComponent.tsx` の `PREVIEW_COUNT = 2`                |
| ページは全件表示                        | `CouponPageComponent.tsx`（モーダルなし）                              |
| 開始前・終了後のクーポンは出ない                | `filterEnabledDiscounts`                                       |
| 並び順は有効期限が近い順、期限なしは末尾            | `sortDiscountsByEndsAt`                                        |
| 「あと〇日で終了」の既定は4日                 | `DEFAULT_DAYS_TO_DISPLAY_ALERT = 4`                            |
| 備考の既定は中央揃え                      | `resolveNoteAlign`                                             |
| 設定は Extension ごとに独立             | 別 Extension・別 toml                                             |
| 推奨画像サイズ PC 300x300 / SP 192x502 | `app/i18n.ts` の `pcImageLinkLabel` / `spImageLinkLabel`        |

## レビュー

### やったこと

| ファイル                                                               | 変更                                                            |
| ------------------------------------------------------------------ | ------------------------------------------------------------- |
| `apps/discount-deck/notice-customer-account-migration.mdx`         | 移行で変わること／変わらないことの対比表、2つの表示方法、移行手順、FAQ 6件を追加                   |
| `apps/discount-deck/setup/new-customer-accounts.mdx`               | 表示方法の選択、STEP2をブロック／専用ページの2通りに、設定項目11件の一覧と既定値、表示の仕様、FAQ 10件を追加 |
| `en/apps/discount-deck/notice-customer-account-migration.mdx`      | 同内容の英語版                                                       |
| `en/apps/discount-deck/setup/new-customer-accounts.mdx`            | 同内容の英語版。エディタ上の項目名が日本語のままである旨を明記                               |
| `apps/discount-deck/setup.mdx` / `en/apps/discount-deck/setup.mdx` | 扉ページのカード説明を新しい description に合わせた                              |

### 検証

* `mint broken-links` → `no broken links found`
* `mint dev` で4ページとも HTTP 200、MDX のコンパイルエラーなし
* 表・`<AccordionGroup>`・`` `{{count}}` `` のコードスパンが意図どおり描画されることをレンダリング結果で確認

### 残課題

1. **マージは discount-deck PR #351 のリリース後**。専用ページ表示は未リリースのため、先にマージすると存在しない機能の手順が公開される。
2. **専用ページ追加手順のスクリーンショットがない**。既存の `new-customer-accounts-2.jpg` はプロフィールページのエディタ画面。「ページを追加」の画面を撮って差し込みたい。
3. **`faq/coupons-not-displayed` との重複**。メタフィールド権限の話を setup ページの FAQ に書いたため、既存 FAQ ページからの導線を足すか、内容を寄せるか要判断。
4. **ブロック表示の備考テキストがモーダル内にしか出ない**（`CouponListComponent.tsx`）。設定の説明文「クーポン一覧の下に表示される注記です」と挙動が食い違う。ドキュメントには実際の挙動を書いたが、アプリ側の修正候補。
5. `tools/channel-talk-migration/convert.py` を再実行すると、この2ページはチャネルトークの元記事から再生成されて上書きされる。移行は完了しているため通常は実行しないが、実行する場合は注意。

## 追記（stg での実機確認）

stg（dd-auto-display-stg）のエディタとお客様画面で確認し、手順の誤りを1件修正した。

### 修正した誤り

**追加の入口は「ページを追加」ではなく、エディタ左上の「アプリ」アイコン。**
ここに Discount Deck の項目が並び、各行の「＋」で追加する。専用ページは「＋」を押すと
「ページの追加先」が出るので「アカウント」を選ぶ。ブロックも同じ一覧から追加する。

当初は Extension の README を根拠に「ページを追加」と書いていたが、実機に
その導線は無かった。ページ切り替えのドロップダウンにも、追加済みページの「…」
メニュー（URLをコピー / 削除）にも無い。

### 新しく分かったこと

* アプリ一覧には「保有クーポン一覧を表示」も並ぶ。これはチェックアウト用の別Extension
* 削除して追加し直すと、設定値は引き継がれない（新しいインスタンスになる）。FAQ に追記した
* エディタの変更は保存するまで反映されない。削除も「保存」を押さなければ元に戻せる

### 追加した画像

| ファイル                          | 内容                    |
| ----------------------------- | --------------------- |
| `new-customer-accounts-3.jpg` | プロフィールページにブロックを追加した状態 |
| `new-customer-accounts-4.jpg` | 専用ページと設定パネル           |
| `new-customer-accounts-5.jpg` | お客様に表示される専用ページ        |
| `new-customer-accounts-6.jpg` | アプリの一覧と「ページの追加先」      |

撮影はビューポートのみ（ブラウザのタブ・ブックマークを含まない）。既存画像と同じ
幅1600px・JPEG品質90に揃えている。

### stg の状態

削除 → 追加画面の撮影 → 元に戻す、まで行った。**保存は一度も押していない。**
未保存の変更を破棄して再読み込みし、元の設定（備考テキスト・ボタンのレイアウト
Secondary・画像の表示 Show）が戻っていること、お客様側のページが表示されることを確認済み。

## 追記（メニューに追加の導線）

専用ページを追加してもヘッダーメニューに項目が出ない場合がある。エディタで専用ページを
開くと、左パネルに案内が出る。

> お客様がこのページにアクセスできるようにするには、ストアのデフォルト用の新しいメニューを
> 作成するか、このページを既存のメニューに追加してください。
>
> ［メニューを作成］［メニューに追加］

「メニューに追加」を押すと、お客様アカウントのメニュー（`customer-account-main-menu`）の
編集画面が開き、「お持ちのクーポン一覧」の行が追加された状態になる。「名前」を変更して
チェックマークで確定し、「保存」を押すと反映される。

**この「名前」がメニューに並ぶ文言**で、設定パネルの「ページタイトル」（ページ内の見出し）
とは別物。FAQ の「項目名を変えたい」もこの画面を案内するよう書き換えた。

`新しいメニューを作成` の場合は「メニューを作成」を押す。

### stg の復旧

作業中に stg のメニュー項目が消えていたため、この導線で復旧した。
お客様画面で Orders / Profile / お持ちのクーポン一覧 が並ぶことを確認済み。
**この復旧のためにメニューの「保存」を1回押している。**（それ以外の保存はしていない）