From ea9c42953c68b93f7ad16ee43d969807f0faa971 Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sat, 29 Aug 2026 19:56:57 +0800
Subject: [PATCH 01/20] docs(plans): add implementation plan for #46 UX-D
 terminology

---
 .../plans/2026-07-31-ux-d-terminology.md      | 1752 +++++++++++++++++
 1 file changed, 1752 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-07-31-ux-d-terminology.md

diff --git a/docs/superpowers/plans/2026-07-31-ux-d-terminology.md b/docs/superpowers/plans/2026-07-31-ux-d-terminology.md
new file mode 100644
index 0000000..98e8562
--- /dev/null
+++ b/docs/superpowers/plans/2026-07-31-ux-d-terminology.md
@@ -0,0 +1,1752 @@
+# UX-D 術語與文案統一 Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Make every zh-TW string in ChipPot use one word per concept — 驗證 (not 核准), 已繳待驗 (not 已繳), 繳費渠道 (not 支付渠道), 此期 (not 本期), 開繳 (not 開帳), 成員 (not 使用者) — and stop showing raw English enums and raw English worker errors to Chinese-reading users.
+
+**Architecture:** This is a copy sweep, not a refactor. §A below is the canonical-terms SPEC — one mapping table per concept. Each task takes one concept, **regenerates its own edit-site list with `git grep` at execution time**, applies the mapping, then proves the concept is gone with a zero-hits assertion. Nothing in this plan changes a DB value, an API request/response *shape*, an enum stored in D1, or a `custom_id`. Three tasks do change API response *strings* (`routes/admin.ts` errors, `core/payments.ts` race message) and Discord reply strings; those are TDD with real vitest assertions.
+
+**Tech Stack:** TypeScript, React 18 (admin + web SPAs, Vite 6), Cloudflare Workers, Vitest 4 with `@cloudflare/vitest-pool-workers` (real Miniflare D1/R2), pnpm workspaces.
+
+---
+
+## Why this plan has no line numbers
+
+This batch runs **last** — after UX-A (danger actions, `#43`), UX-B (mobile/a11y, `#44`) and UX-C (member feedback, `#45`) have merged. Those batches rewrite `Dashboard.tsx`, `Payments.tsx`, `Manage.tsx`, `Settings.tsx`, `handler.ts` and `web/App.tsx`. **Every line number in the source audit (`.superpowers/sdd/ux-audit-copy.md`) is stale by the time you read this.**
+
+So: the audit's `file:line` lists are an *inventory of what existed on 2026-07-30*, reproduced in §A only to tell you roughly how many sites to expect. **Never navigate by line number.** Every task starts with a `git grep` that rebuilds the list from the tree you actually have, and ends with the same grep returning nothing.
+
+Three consequences you must internalise:
+
+1. **A site may already be fixed.** UX-A owns `A5` (the 發起繳費 「本期」 wording). If your grep shows it already reads `${period}`, that is success, not a missing file — move on.
+2. **A site may have moved to a file this plan never names.** If `git grep` finds the term in a file not listed in §B, fix it there too. The grep is the authority; §B is a hint.
+3. **A string may have been reworded.** Match on the *concept*, not on the exact old sentence. If UX-A rewrote a tooltip and it still says 「本期」, the 本期 sweep still owns that word.
+
+`docs/superpowers/plans/**` is a **historical archive**. It contains 核准, 已繳, 本期 in abundance. **Never edit it.** Every grep in this plan is pathspec-scoped to `packages README.md README.zh-TW.md` precisely to keep it out.
+
+---
+
+## Global Constraints
+
+Every task's requirements implicitly include this section.
+
+- **Branch:** `ux/46-terminology`, cut from `main` after A/B/C have merged. One PR, body contains `Closes #46`.
+- **Worker suite green after every task.** Baseline on 2026-07-31 (before A/B/C) was **300 passed, 41 files**. A/B/C will raise it. **Do not hardcode 300 anywhere** — capture the real baseline in Task 1 Step 2 and use that number.
+- **`pnpm -r typecheck` green after every task** (worker + admin + web `tsc --noEmit`).
+- **Admin and web must build:** `pnpm --filter @chippot/admin build` and `VITE_API_BASE=https://example.invalid pnpm --filter @chippot/web build`. Run both in Task 15; run them earlier too if a task touched `.tsx` and you want the signal.
+- **`packages/worker/wrangler.toml` must not be touched.** It is `skip-worktree`'d locally and its committed copy holds placeholders. Do not `git add` it, do not open it to "check" something.
+- **`docs/deploy-state.md` is gitignored (`.gitignore:10`) — local-only.** Append the entry (Task 15) but **never `git add` it**; `git add docs/` would fail to stage it anyway, so use explicit paths in every `git add`.
+- **Conventional commits**, zh-TW subject line after the type/scope, matching repo history (e.g. `fix(admin-ui): 彈窗內文字不再繼承靠右對齊 (#33)`).
+- **Display-layer only.** English enum *values* (`active`/`paused`/`cancelled`, `user_slash`/`admin_manual`/`cron`, `pending`/`paid`/`verified`/`rejected`) stay English in the DB, in `<option value=…>`, in request bodies and in every SQL string. Only what a human reads changes.
+- **Do not edit `docs/superpowers/plans/**`** (historical record) or `.superpowers/sdd/**` (audit record).
+- **Both READMEs are in scope of every sweep.** `README.md` (English prose, but it quotes zh-TW UI labels verbatim) and `README.zh-TW.md`. A sweep that leaves a README naming a button that no longer exists is a failed sweep.
+- **One commit per task**, and the worker suite must be green *at that commit*.
+
+---
+
+# §A — Canonical terms SPEC
+
+This is the contract. Where a task and this table disagree, this table wins.
+
+### A.1 驗證 (D1 / copy P1-1) — the act of accepting a payment
+
+Four words for one action today. **驗證** is the verb, **已驗證** is the resulting state, **審核** is the process/queue name (keep — it is the nav label 繳費審核 and the 已繳待驗 queue). **核准 is deleted entirely, including from code comments and test titles.**
+
+| Old (audit found ~17 sites incl. comments) | New |
+|---|---|
+| `核准` (button label) | `驗證` |
+| `一鍵全部核准` | `一鍵全部驗證` |
+| `核准已繳待驗（N 筆）` | `驗證已繳待驗（N 筆）` |
+| `已核准 ${n} 筆` | `已驗證 ${n} 筆` |
+| `已核准 ${n} 筆，另 ${m} 筆（待繳／已退回）需逐筆處理` | `已驗證 ${n} 筆，另 ${m} 筆（待繳／已退回）需逐筆處理` |
+| `批次核准中斷，已核准 ${n} 筆：${message}` | `批次驗證中斷，已驗證 ${n} 筆：${message}` |
+| `標記已驗證` (button label, PaymentDetail) | `驗證` |
+| `標記已驗證（帶入申報渠道）` (tooltip) | `標記為「已驗證」（帶入申報渠道）` |
+| `一鍵全部核准` inside English code comments / `describe()` titles | `一鍵全部驗證` |
+| README `一鍵全部核准` / `單筆核准／退回` / `一鍵掃過去核准` | `一鍵全部驗證` / `單筆驗證／退回` / `一鍵掃過去驗證` |
+
+**Keep unchanged:** `撤回驗證` (PaymentDetail), `繳費審核` (nav label), `審核` in prose meaning the process, `已驗證` everywhere.
+
+### A.2 `paid` 狀態 (D2 / copy P1-2)
+
+`已繳` reads as "the money arrived", but the state means "member says they paid, nobody checked yet". **已繳待驗** everywhere, **待驗** where a table header has no room.
+
+| Old | New | Note |
+|---|---|---|
+| `STATUS_LABEL.paid = "已繳"` (`ui.tsx`) | `"已繳待驗"` | the badge — the single highest-value fix here |
+| Dashboard 各方案 table header `已繳` | `待驗` | 7-column table, no room for 3 more chars |
+| `🔒 保留(已繳)` (Stat label, ×2: SyncModal + RetractModal) | `🔒 保留（已繳待驗、已驗證）` | frozen = `paid` **+** `verified` (see `billing.ts` frozen calc and the modal's own prose) — the old label was also *wrong*, not just inconsistent. Parens go full-width (§A.10). |
+| `保留 ${n} 筆已繳。` (retract success line) | `保留 ${n} 筆已繳待驗／已驗證。` | prose "A or B" → ／ (§A.10) |
+| `已繳／已驗證的紀錄不受影響` / `已繳／已驗證的 ${n} 筆一律原樣保留` | **unchanged** | already the accurate pair |
+| README `已繳待驗` | unchanged; README `已繳／已驗證` unchanged |
+
+**Do not** rename `已繳待驗` → anything. It is already canonical in `Payments.tsx` pills, `Dashboard.tsx` stats and `MemberReview.tsx`.
+
+### A.3 期別標籤 (D3 + D5 + D7 / copy P1-3, P1-5, P1-7) — inherited from the deferred batch E
+
+**本期 is deleted.** Three replacements depending on what the sentence actually means:
+
+| Situation | Replacement |
+|---|---|
+| A control acting on the admin's currently-picked period, and the period value is in scope | interpolate the real value — `${period}` |
+| A control acting on the picked period, value **not** in scope (button labels, tooltips, ActionRow descriptions) | `此期` / `所選期別` |
+| Discord replies to a member, period value in scope | interpolate `${period}` and drop the 本期 framing (never say 期別 to a member — §A.4) |
+
+Concrete mapping (regenerate the site list; these are the strings as of the audit):
+
+| Old | New |
+|---|---|
+| `重新同步本期` (button) | `重新同步此期帳單` — **full name**, so `Settings.tsx`'s reference matches the button exactly (D7) |
+| `對齊本期帳單到目前名單／現價` (tooltip) | `對齊此期帳單到目前名單／現價` |
+| `收回本期開繳` (button) | `收回此期開繳` |
+| `重新同步本期帳單 · ${period}` (modal title) | `重新同步此期帳單 · ${period}` |
+| `收回本期開繳 · ${period}` (modal title) | `收回此期開繳 · ${period}` |
+| `本期已是最新，無需變更。` | `此期已是最新，無需變更。` |
+| `本期沒有可刪除的未繳／已退回帳單，收回只會把期別改回「未開繳」。` | `此期沒有可刪除的未繳／已退回帳單，收回只會把期別改回「未開繳」。` |
+| `收回後本期回到「未開繳」：刪掉的帳單不會被「重新同步本期」補回來…` | `收回後此期回到「未開繳」：刪掉的帳單不會被「重新同步此期帳單」補回來…` |
+| `…重開本期也不會重複開帳單。` | `…重開此期也不會重複產生帳單。` (also kills 開帳 — §A.5) |
+| `請到「繳費審核」按重新同步本期帳單清理` (Settings import warning) | `請到「繳費審核」按「重新同步此期帳單」清理` |
+| `確認本期金額並向所有成員發出開繳通知。` (Settings ActionRow desc) | `確認所選期別的金額並向所有成員發出開繳通知。` |
+| `（管理員）確認本期各方案金額並發出開繳通知` (`/發起繳費` description) | `（管理員）確認指定期別各方案金額並發出開繳通知` |
+| `✅ 已更新本期金額（…）。本期通知先前已發送，未重複發送。` | `✅ 已更新 ${period} 金額（…）。${period} 的通知先前已發送，未重複發送。` |
+| `本期（${current}）繳費尚未開放，待管理員發出開繳通知後即可繳費。` (×2, Discord) | `${current} 的繳費尚未開放，待管理員發出開繳通知後即可繳費。` |
+| `本期（${period}）已登記繳費，無需重複操作。` | `${period} 已登記繳費，無需重複操作。` |
+| `✅ 已登記本期（${period}）繳費 NT$…` | `✅ 已登記 ${period} 繳費 NT$…` |
+| `本期繳費尚未開放，待管理員發出開繳通知後即可繳費。` (pay-select guard) | `${period} 的繳費尚未開放，待管理員發出開繳通知後即可繳費。` (`period` is in scope there) |
+| `✅ 你本期已登記繳費，無需重複操作。` | `✅ ${period} 已登記繳費，無需重複操作。` |
+| README `重新同步本期帳單` (both files) | `重新同步此期帳單` |
+| README `確認本期各方案金額` | `確認指定期別各方案金額` |
+| `本期尚無資料` / `本期尚無已驗證款項` (Dashboard empty states) | `此期尚無資料` / `此期尚無已驗證款項` |
+
+**Some of these belong to UX-A (A5).** If A already interpolated the period, skip. If A left it, fix it here — D is last and owns the leftover.
+
+### A.4 期別 (後台) vs 月份 (成員面) (D4 / copy P1-4)
+
+Same `YYYY-MM` value, two audiences, one word each.
+
+| Surface | Word |
+|---|---|
+| Admin SPA (`packages/admin`) | **期別** |
+| Discord bot replies (`adapters/discord/**`), member pay page (`packages/web`) | **月份** |
+
+| Old | New |
+|---|---|
+| `<span className="stub__label">期別</span>` (web pay page) | `月份` |
+| Discord `選擇要繳的月份` / `你有多個月份待繳` / `這個月份已無待繳項目` / `✅ 這個月份已登記繳費` | **unchanged** (already correct) |
+
+**Documented exception — leave alone:** `Settings.tsx` CSV import `起算月份第一天（選填，YYYY-MM-DD）` and the prose `起算月份留空＝當月`. That field is a **date** (`start_date`, `YYYY-MM-DD`), not a period selector; calling it 期別 would be a lie. This is the *only* permitted 月份 in `packages/admin` and the leftover assertion in Task 5 allows exactly these.
+
+### A.5 開繳 (D5 / copy P1-5)
+
+**開帳 is deleted** (3 sites). The action is 發起繳費 / 開繳, the notification is 開繳通知, the data row is 帳單.
+
+| Old | New |
+|---|---|
+| `每月幾號向所有成員開帳收費（1–28）。` | `每月幾號自動向所有成員開繳（1-28）。` (also fixes the en-dash — §A.10) |
+| `開帳後幾天仍未繳就列入催繳。` | `開繳後幾天仍未繳就列入催繳。` |
+| `重開本期也不會重複開帳單。` | `重開此期也不會重複產生帳單。` (same edit as §A.3) |
+| README.zh-TW `自動開帳、每期發一則整批催繳` | `自動開繳、每期發一則整批催繳` |
+| README.zh-TW architecture diagram `— 開帳 / 催繳 / 保存期` | `— 開繳 / 催繳 / 保存期` |
+| `📢 **{period} 開始繳費**` (default `billing_opened_template` in `env.ts`) | `📢 **{period} 開繳**` |
+
+**Note on the template default:** changing `DEFAULT_SETTINGS.billing_opened_template` only affects workspaces that have **never** customised it (`parseSettings` falls back to the default). Production may already hold a saved template, in which case nothing changes there. `env.test.ts` asserts the default's *shape* (`toEqual(DEFAULT_SETTINGS)`, `toContain("{plans}")`), not its prose, so this is test-safe — verify that claim by running the suite, don't assume it.
+
+### A.6 繳費渠道 (D8 / copy P1-8) and 繳費頻道 (D6 / copy P1-6)
+
+| Old | New |
+|---|---|
+| `支付渠道` (nav label, Card title, delete-confirm prose) | `繳費渠道` |
+| `渠道` as a table header / short field name | **unchanged** — the sanctioned short form |
+| `在帳單頻道貼一則含「綁定 Discord」按鈕的公開訊息` | `在繳費頻道貼一則含「綁定 Discord」按鈕的公開訊息` |
+
+Both names point at the same `discord_billing_channel_id`; the field label is already `繳費頻道 ID`.
+
+### A.7 成員 (D9 / copy P1-9)
+
+| Old | New |
+|---|---|
+| `<dt>使用者備註</dt>` | `<dt>成員備註</dt>` (matches `MemberReview`'s `成員備註：`) |
+
+`使用者` must reach **zero** occurrences in `packages/**`. `夥伴` stays — it is a member-facing greeting in `web` (`嗨，{name} 夥伴`) and in the default overdue template, and the audit explicitly permits it there.
+
+### A.8 純聲明 (D10 / copy P1-10)
+
+One state (`paid`/`verified` with `has_proof = 0`), one label.
+
+| Old | New |
+|---|---|
+| `無憑證(已繳)` (Dashboard stat) | `純聲明（已繳待驗、已驗證）` — matches the SQL, which is `status IN ('paid','verified') AND has_proof = 0` |
+| `純聲明` (Payments table cell) | unchanged |
+| `無憑證，純聲明 — 請依備註與帳戶自行核對。` (×2) | unchanged — this is the one place 無憑證 is allowed, as explanatory prose |
+
+### A.9 enum → zh-TW 顯示對映 (D11 / copy P1-11) — **display layer only**
+
+Follow the existing precedent in `Manage.tsx`: `CHANNEL_TYPES` + `CHANNEL_TYPE_LABEL` (a `Record<string,string>` with `?? raw` fallback). Never change a stored value.
+
+**`payments.source`** (schema: `CHECK (source IN ('user','user_slash','user_web','admin_manual','cron'))`):
+
+| value | who writes it | label |
+|---|---|---|
+| `user` | nobody today — schema default, so only legacy rows | `Discord（舊版）` |
+| `user_slash` | `/繳費` **and** the 繳費 button channel-select | `Discord` |
+| `user_web` | `routes/upload.ts` | `網頁上傳` |
+| `admin_manual` | `routes/admin.ts` manual entry | `後台補登` |
+| `cron` | `billing.ts` bill creation default (cron **and** 發起繳費/同步, which pass no source) | `系統建立` |
+
+**`subscriptions.status`** (`active`/`paused`/`cancelled`): `啟用中` / `暫停` / `已取消`.
+
+**`plans.provider`** — a free-text column, not an enum. Only its *label* is English:
+
+| Old | New |
+|---|---|
+| `<th>provider</th>` | `<th>供應商</th>` |
+| `provider（選現有或直接輸入新的，如 gemini、glm）` | `供應商（選現有或直接輸入新的，如 gemini、glm）` |
+| `請填 provider` (client-side validation) | `請填供應商` |
+
+And the sentence that teaches admins the raw enum:
+
+| Old | New |
+|---|---|
+| `（若只想停收可改用「編輯 → 狀態 cancelled」）` | `（若只想停收，可改用「編輯 → 狀態：已取消」）` |
+
+### A.10 標點與格式 (D17 + D18 / copy P2-1,2,3,4,6,10,11)
+
+Rules, in force for every task in this plan — not just the format task:
+
+1. **Parentheses.** Inside a Chinese sentence or a Chinese-content label → full-width `（）` with no surrounding space. A label whose parenthetical is a pure Latin/numeric token → half-width `()` with one leading space: `月費 (TWD)`, `起算日 (YYYY-MM-DD)`, `結帳日 (1-28)`, `${p.name} 金額 (NT$)` all stay as they are.
+2. **Number ranges** use an ASCII hyphen: `1-28`. The one en-dash (`1–28`) becomes `1-28`.
+3. **Enumerations** separate with `、`. **"A or B" prose** uses full-width `／`. Never a half-width `/` between Chinese words.
+4. **Admin success messages** are prefixed `✓ ` (space after). Discord keeps `✅` — cross-surface difference is fine, intra-surface is not.
+5. **A button that opens a dialog needing more input gets a trailing `…`** — but only toolbar/header actions. Row-level `編輯`／`刪除`／`停用`／`啟用` do **not** (adding `…` to every table row is noise, especially in UX-B's mobile cards).
+6. **Progress text** in a preview modal is `計算差異中…` (both the sync and retract previews compute a diff).
+7. **Member-facing sentences end with `。`**
+
+### A.11 千分位 (D19 / copy P2-5)
+
+Any rendered TWD amount uses `.toLocaleString()`, matching `ui.tsx`'s `Money`, `core/notify.ts` and the Discord handler. Four known holes: the web pay page's per-subscription amount and total, and the admin plan `<select>` option and plan-table monthly fee. **Call it exactly as the codebase already does — `v.toLocaleString()` with no locale argument** — do not introduce `Intl.NumberFormat` or a locale string.
+
+### A.12 至少填一項 (D13 + P0-8 / copy P1-15, P0-5)
+
+One sentence, one field order (渠道 → 截圖 → 備註, matching the UI):
+
+> `渠道、截圖、備註至少填一項。`
+
+and when screenshots are disabled (no R2):
+
+> `渠道、備註至少填一項。`
+
+The Discord command description is the **exception**, taken verbatim from issue #46 because Discord descriptions are a different register and length-capped:
+
+> `登記繳費（一次涵蓋你所有訂閱；渠道／截圖／備註 至少填一項）`
+
+### A.13 語氣 (D20 / copy P2-7, P2-9, P2-12)
+
+| Old | New |
+|---|---|
+| `解除後他可重新用綁定按鈕／指令綁定。` | `解除後可重新用綁定按鈕／指令綁定。` |
+| `（開繳／催繳才能 @ 到他）` | `（開繳／催繳才 @ 得到）` |
+| `<title>ChipPot · 繳費上傳</title>` | `<title>ChipPot · 繳費登記</title>` — screenshots are optional and may be disabled entirely |
+| `連線失敗，請稍後再試` | `連線失敗，請稍後再試。` |
+
+Never reintroduce a gendered third-person pronoun for a member. zh-TW drops the pronoun.
+
+### A.14 錯誤訊息中文化 (D14 + D15 / copy P1-16, P1-17)
+
+**In scope** — the settings-tools group and `not found`, i.e. everything an admin can actually reach by clicking:
+
+| English (match by handler, not line) | zh-TW |
+|---|---|
+| `not found` (every 404 in `routes/admin.ts`) | per-entity: `找不到這位成員` / `找不到這筆訂閱` / `找不到這個方案` / `找不到這個渠道` / `找不到這筆繳費紀錄` / `找不到工作區設定` |
+| `discord_billing_channel_id is not set` | `尚未設定繳費頻道 ID，請到「設定 → Discord 串接」填入。` |
+| `discord_guild_id is not set` | `尚未設定伺服器 ID（Guild），請到「設定 → Discord 串接」填入。` |
+| `bot token not configured` | `尚未設定 Discord Bot Token，請在 Worker 環境變數設定後重新部署。` |
+| `DISCORD_APPLICATION_ID is not set` | `尚未設定 DISCORD_APPLICATION_ID，請在 Worker 環境變數設定後重新部署。` |
+| `WEB_ORIGIN is not configured` | `尚未設定 WEB_ORIGIN，無法產生上傳連結；請在 Worker 環境變數設定後重新部署。` |
+| `failed to post Discord message` | `Discord 訊息張貼失敗，請確認機器人在該頻道有發言權限。` |
+| `failed to register commands` | `指令註冊失敗，請確認 Bot Token 與伺服器 ID 是否正確。` |
+| `invalid channel tag` | `渠道無效，請重新選擇。` |
+| `invalid user` | `找不到這位成員。` |
+| `invalid subscription` | `找不到這筆訂閱。` |
+| `invalid status` | `狀態無效。` |
+| `integer amount required` | `金額必須是整數。` |
+| `amount must be a non-negative integer` | `金額必須是 0 或正整數。` |
+| `payment ${id} cannot transition to '${to}'` (`core/payments.ts`) | `這筆的狀態已被變動（可能已由其他人處理），請重新載入後再試。` |
+
+**Deliberately left in English** (audit X4 — unreachable from the UI because the inputs are `type="month"` / `type="number"` / client-side-required): `period must be YYYY-MM`, `billing_day must be 1..28`, `start_date must be YYYY-MM-DD`, `amounts is required`, `each amount needs an integer plan_id and non-negative amount`, `type must be billing_opened or overdue`, `kind must be bark or webhook`, `expected a multipart form`, `csv is required`, `display_name is required`, `name is required`, `name, provider, monthly_amount are required`, `user_id, plan_id, start_date are required`, `subscription_id and period are required`, `user_id and period are required`, `user_id must be a positive integer`, `` `${param} must be a positive integer` ``.
+
+**Out of scope — belongs to UX-C (#45, its P0-6):** `routes/upload.ts` and `core/storage.ts` English errors reaching the member pay page. Do not touch them; if C somehow left them, file a follow-up rather than widening this PR.
+
+**`InvalidPaymentTransition` must keep its `paymentId` and `to` public fields** — they are the debugging handle once the message stops naming the id.
+
+### A.15 標註而非改造 (D16, D21, D22)
+
+Three findings resolve as **annotation this round**, deliberately:
+
+- **D16 (hardcoded vs templated messages).** Three messages are editable in 設定 → Discord 訊息文字 (開繳通知/逾期催繳/常駐繳費訊息); the bind-button message and the new-member nudge are hardcoded in the worker. Unifying them is a settings-schema change = batch E scope. **Annotate**: one line in the Settings card description saying which messages the card covers, plus a code comment at each hardcoded builder.
+- **D21 (`plans.discord_role_id`).** It is used only to `@` a role in announcements; ChipPot never grants or revokes roles. The field label currently implies less than it should. **Fix the label** so nobody expects automation.
+- **D22 (`settings.timezone`).** Parsed in `env.ts`, read by nobody; time is hardcoded `Asia/Taipei` in `core/time.ts`. There is **no admin UI field** for it (verified: `timezone` appears only in `env.ts`). Removing it would change the settings schema and the `parseSettings` round-trip that `env.test.ts` asserts — scope creep. **Annotate in code + README.**
+
+---
+
+# §B — File map
+
+Where each concept lived on 2026-07-30. **A hint, not a target list** — `git grep` is the authority.
+
+| File | Responsibility | Concepts it carried |
+|---|---|---|
+| `packages/admin/src/ui.tsx` | shared admin primitives (`StatusBadge`, `Money`, `Modal`, `Stat`) | A.2 (`STATUS_LABEL`) |
+| `packages/admin/src/App.tsx` | nav shell + view registry | A.6 (nav label) |
+| `packages/admin/src/views/Payments.tsx` | payments list, sync/retract/manual/link modals | A.2, A.3, A.8, A.10 |
+| `packages/admin/src/views/MemberReview.tsx` | member × period aggregate review | A.1, A.2 |
+| `packages/admin/src/views/PaymentDetail.tsx` | single-payment modal | A.1, A.7, A.9 (`source`) |
+| `packages/admin/src/views/Dashboard.tsx` | reconcile board + push status | A.2, A.3, A.8, A.10 |
+| `packages/admin/src/views/Manage.tsx` | 成員/訂閱/方案/渠道 CRUD | A.6, A.9, A.10, A.11, A.13 |
+| `packages/admin/src/views/Settings.tsx` | settings + tools + CSV import | A.3, A.4, A.5, A.6, A.10, A.13, A.15 |
+| `packages/web/src/App.tsx` | member pay page | A.4, A.11, A.12, A.13 |
+| `packages/web/src/api.ts` | member pay page fetch layer | A.13 |
+| `packages/web/index.html` | member page `<title>` | A.13 |
+| `packages/worker/src/adapters/discord/commands.ts` | slash-command registration payloads + component builders | A.3, A.12 — **Discord-visible; see Task 15's re-register note** |
+| `packages/worker/scripts/register-commands.mjs` | standalone `pnpm register` script | **hand-duplicates both command descriptions** (a `.mjs` can't import the TS module; its header says "Keep these payloads in sync"). Tasks 1 and 4 must edit both copies; Task 15 Step 2b proves they agree. |
+| `packages/worker/src/adapters/discord/handler.ts` | all Discord interaction replies | A.3, A.12 |
+| `packages/worker/src/env.ts` | settings schema + default templates | A.5, A.15 |
+| `packages/worker/src/routes/admin.ts` | admin API + its error strings | A.1, A.14 |
+| `packages/worker/src/core/payments.ts` | payment state machine | A.1 (comment), A.14 |
+| `packages/worker/test/**` | vitest suite — asserts several of these strings | every task |
+| `README.md`, `README.zh-TW.md` | user-facing docs quoting zh-TW labels | every task |
+
+**Known test assertions that this plan breaks** (find them with the greps, don't trust this list to stay complete):
+- `test/adapters/discord-pay.test.ts` — `expect(captured).toContain("已登記本期")` → breaks in Task 4.
+- `test/core/payments-verify-all.test.ts` — `describe("verifyUserPeriod (一鍵全部核准)")` → renamed in Task 2.
+- `test/routes/payments-review.test.ts` — asserts `toContain("模擬硬錯誤")`, the *inner* message. Task 2 changes only the outer 批次核准中斷 wrapper, so this assertion survives. Confirm by running, don't assume.
+
+---
+
+# §C — Tasks
+
+## Task 1: 分支、基準線，與兩個 P0 誤導文案
+
+Two P0s: a diff heading that calls a *paused* subscription 退訂, and a `/繳費` description that says three fields are optional when at least one is mandatory.
+
+**Files:**
+- Modify: `packages/admin/src/views/Payments.tsx` (the `DiffList title="移除（已退訂）"` in the sync preview)
+- Modify: `packages/worker/src/adapters/discord/commands.ts` (`PAY_COMMAND.description`)
+- Modify: `packages/worker/scripts/register-commands.mjs` — **the same description is duplicated here** (the `.mjs` cannot import the TS module without a build step; its header comment says "Keep these payloads in sync"). Miss it and `pnpm --filter @chippot/worker register` silently re-registers the old wording.
+- Test: `packages/worker/test/` — run the whole suite; no new test (a registration-payload literal has no behaviour to assert beyond what `commands.ts` already is)
+
+**Interfaces:**
+- Consumes: nothing.
+- Produces: branch `ux/46-terminology`; the recorded baseline test count that Tasks 2–15 compare against.
+
+- [ ] **Step 1: Cut the branch**
+
+```bash
+cd /Users/poterpan/Documents/Coding/Project/chippot
+git checkout main && git pull
+git checkout -b ux/46-terminology
+```
+
+- [ ] **Step 2: Record the real baseline — every later task compares to this number**
+
+```bash
+pnpm --filter @chippot/worker test 2>&1 | tail -6
+```
+
+Write the `Tests  N passed (N)` number down. It was 300 before batches A/B/C; it will be higher now. **If this run is red, stop** — you inherited a broken `main` and this plan cannot proceed on top of it.
+
+- [ ] **Step 3: Fix P0-7 — 「移除（已退訂）」 lies about paused subscriptions**
+
+`git grep -n "已退訂" -- packages README.md README.zh-TW.md`
+
+The sync preview's remove-list is computed from `sub_status !== "active"`, so **paused** subscriptions land in it — and pausing is the *main* path (a `FALSE` cell in the CSV import pauses a subscription, and the import warning then tells the admin to run the sync). Replace the heading:
+
+```tsx
+{diff.remove.length > 0 && <DiffList title="移除（訂閱已暫停／已取消）" rows={diff.remove.map((a) => `${a.user_name}·${a.plan_name} NT$${a.amount.toLocaleString()}`)} />}
+```
+
+Both READMEs repeat the same wrong claim in their 重新同步 bullet — fix them in this commit:
+
+- `README.zh-TW.md`: `（補缺漏 · 移除已退訂 · 待繳改現價 · 已繳／已驗證凍結）` → `（補缺漏 · 移除已暫停／已取消的訂閱 · 待繳改現價 · 已繳待驗／已驗證凍結）`
+- `README.md`: `(add missing · remove de-subscribed · reprice pending · freeze settled)` → `(add missing · remove paused/cancelled · reprice pending · freeze settled)`
+
+- [ ] **Step 4: Fix P0-8 — `/繳費` says the three fields are optional, in both copies**
+
+```bash
+git grep -n "可選渠道" -- packages
+```
+
+Expect **two** hits: `src/adapters/discord/commands.ts` and `scripts/register-commands.mjs`. The handler rejects a submit where 渠道, 截圖 and 備註 are all empty, so "可選" sends members straight into a wall. Use issue #46's wording verbatim in `commands.ts`:
+
+```ts
+export const PAY_COMMAND = {
+  name: "繳費",
+  type: 1,
+  description: "登記繳費（一次涵蓋你所有訂閱；渠道／截圖／備註 至少填一項）",
+  options: [
+    { type: OPT_STRING, name: "渠道", description: "繳費渠道", autocomplete: true, required: false },
+    { type: OPT_ATTACHMENT, name: "截圖", description: "繳費截圖（PNG / JPG / WebP）", required: false },
+    { type: OPT_STRING, name: "備註", description: "備註（自由文字，僅供審核參考）", required: false },
+  ],
+};
+```
+
+and the identical string in `scripts/register-commands.mjs`:
+
+```js
+    name: "繳費", type: 1,
+    description: "登記繳費（一次涵蓋你所有訂閱；渠道／截圖／備註 至少填一項）",
+```
+
+- [ ] **Step 5: Assert both concepts are gone, and that the two payload copies agree**
+
+```bash
+git grep -n "已退訂" -- packages README.md README.zh-TW.md ; echo "expect: no output"
+git grep -n "可選渠道\|，可選" -- packages ; echo "expect: no output"
+git grep -h "登記繳費（一次涵蓋" -- packages | sed 's/^ *//' | sort -u | wc -l
+echo "expect: 1 — the .ts and .mjs descriptions are byte-identical"
+```
+
+The first two must print nothing; the third must print `1`.
+
+- [ ] **Step 6: Run the suite**
+
+```bash
+pnpm --filter @chippot/worker test 2>&1 | tail -6
+```
+
+Expected: PASS, same count as Step 2.
+
+- [ ] **Step 7: Commit**
+
+```bash
+git add packages/admin/src/views/Payments.tsx packages/worker/src/adapters/discord/commands.ts \
+        packages/worker/scripts/register-commands.mjs README.md README.zh-TW.md
+git commit -m "fix(copy): 同步預覽不再把「暫停」講成「已退訂」;/繳費 描述改為「至少填一項」 (#46)"
+```
+
+---
+
+## Task 2: 核准 → 驗證
+
+**Files:**
+- Modify: every file `git grep -l "核准" -- packages README.md README.zh-TW.md` reports — expected: `admin/src/views/MemberReview.tsx`, `admin/src/views/PaymentDetail.tsx`, `admin/src/views/Payments.tsx`, `worker/src/routes/admin.ts`, `worker/src/core/payments.ts`, `worker/test/core/payments-verify-all.test.ts`, `README.md`, `README.zh-TW.md`
+- Test: `packages/worker/test/core/payments-verify-all.test.ts`, `packages/worker/test/routes/payments-review.test.ts`
+
+**Interfaces:**
+- Consumes: branch `ux/46-terminology` from Task 1.
+- Produces: `核准` reaches zero occurrences under `packages/` and both READMEs. Later tasks may assume 驗證 is the only verb.
+
+- [ ] **Step 1: Regenerate the edit-site list**
+
+```bash
+git grep -n "核准" -- packages README.md README.zh-TW.md
+```
+
+Every hit is in scope, **including English code comments and the `describe()` title** — the codebase's own vocabulary counts.
+
+- [ ] **Step 2: Apply §A.1 to the admin SPA**
+
+`MemberReview.tsx` — the bulk action, its result banner, the per-row button, and the two comments:
+
+```tsx
+                const r = await api.verifyAll(userId, period);
+                return outstanding.length > 0
+                  ? `已驗證 ${r.verified} 筆，另 ${outstanding.length} 筆（待繳／已退回）需逐筆處理`
+                  : `已驗證 ${r.verified} 筆`;
+```
+
+```tsx
+              {/* 全部 is only true when every row is 已繳待驗; otherwise name the subset the sweep covers. */}
+              <IconCheck />{busy ? "處理中…" : outstanding.length > 0
+                ? `驗證已繳待驗（${reviewable.length} 筆）`
+                : `一鍵全部驗證（${reviewable.length} 筆）`}
+```
+
+```tsx
+                    <button className="btn iconlbl" disabled={busy} title="標記為「已驗證」（帶入申報渠道）"
+                      onClick={() => run(async () => { await api.verify(p.id, null); return null; })}>
+                      <IconCheck />驗證
+                    </button>
+```
+
+and in the file header comment plus the reload comment, `一鍵全部核准` → `一鍵全部驗證`, `per-row 核准／退回` → `per-row 驗證／退回`.
+
+`PaymentDetail.tsx` — the primary action label (it sits next to `撤回驗證`, so `驗證`/`撤回驗證` now reads as one pair):
+
+```tsx
+        {canVerify && <button className="btn btn--primary" disabled={busy} onClick={() => run(() => api.verify(payment.id, tagId === "" ? null : Number(tagId)))}>驗證</button>}
+```
+
+`Payments.tsx` — the QuickVerify tooltip (`標記已驗證（帶入申報渠道）` → `標記為「已驗證」（帶入申報渠道）`); its button label is already `驗證`.
+
+- [ ] **Step 3: Apply §A.1 to the worker**
+
+`routes/admin.ts` — the partial-batch error and the handler's doc comment:
+
+```ts
+    return errorResponse(500, `批次驗證中斷，已驗證 ${paymentIds.length} 筆：${message}`, {
+      verified: paymentIds.length, payment_ids: paymentIds,
+    });
+```
+
+```ts
+ * 一鍵全部驗證: verify every reviewable payment this member has in the period. A single member
+```
+
+`core/payments.ts` — the `verifyUserPeriod` doc comment: `一鍵全部核准:` → `一鍵全部驗證:`.
+
+- [ ] **Step 4: Update the test that names the old term**
+
+`packages/worker/test/core/payments-verify-all.test.ts`:
+
+```ts
+describe("verifyUserPeriod (一鍵全部驗證)", () => {
+```
+
+`payments-review.test.ts` asserts on `模擬硬錯誤` (the *inner* message), which the new wrapper still carries — leave it, and let Step 6 prove it.
+
+- [ ] **Step 5: Update both READMEs**
+
+`README.md` — three `一鍵全部核准` → `一鍵全部驗證`.
+`README.zh-TW.md` — `一鍵全部核准` ×2 → `一鍵全部驗證`; `可單筆核准／退回` → `可單筆驗證／退回`; `一鍵掃過去核准` → `一鍵掃過去驗證`; `可一鍵核准` → `可一鍵驗證`.
+
+- [ ] **Step 6: Zero-hits assertion + suite**
+
+```bash
+git grep -n "核准" -- packages README.md README.zh-TW.md ; echo "expect: no output"
+pnpm --filter @chippot/worker test 2>&1 | tail -6
+pnpm --filter @chippot/admin run typecheck
+```
+
+Expected: grep silent; tests PASS at the Task 1 baseline count; tsc clean.
+
+- [ ] **Step 7: Commit**
+
+```bash
+git add packages/admin/src packages/worker/src packages/worker/test README.md README.zh-TW.md
+git commit -m "refactor(copy): 驗證動作統一為「驗證」,刪除「核准」 (#46)"
+```
+
+---
+
+## Task 3: `paid` 狀態統一為「已繳待驗」
+
+**Files:**
+- Modify: `packages/admin/src/ui.tsx` (`STATUS_LABEL`), `packages/admin/src/views/Dashboard.tsx`, `packages/admin/src/views/Payments.tsx`, `README.zh-TW.md`
+- Test: worker suite (regression only — the admin has no test runner)
+
+**Interfaces:**
+- Consumes: Task 2's 驗證 vocabulary.
+- Produces: `已繳` never appears alone as a status label; `已繳待驗` / `待驗` are the only forms.
+
+- [ ] **Step 1: Regenerate the edit-site list**
+
+```bash
+git grep -n "已繳" -- packages README.md README.zh-TW.md
+```
+
+Hits that already read `已繳待驗` or `已繳／已驗證` are **correct** — do not touch them. You are hunting bare `已繳`.
+
+- [ ] **Step 2: Fix the badge — the single highest-value edit in this task**
+
+`packages/admin/src/ui.tsx`:
+
+```tsx
+const STATUS_LABEL: Record<string, string> = {
+  pending: "待繳", paid: "已繳待驗", verified: "已驗證", rejected: "已退回",
+};
+```
+
+- [ ] **Step 3: Fix the Dashboard**
+
+The 各方案 table header (7 columns — use the short form) and the no-proof stat (which counts `paid` **and** `verified`, per the reconcile SQL):
+
+```tsx
+                  <tr><th>方案</th><th className="right">筆數</th><th className="right">待繳</th><th className="right">待驗</th><th className="right">已驗證</th><th className="right">應收</th><th className="right">已驗證金額</th></tr>
+```
+
+```tsx
+            <Stat label="純聲明（已繳待驗、已驗證）" value={data.no_proof_count} />
+```
+
+(That stat also settles §A.8 — 無憑證 survives only as explanatory prose.)
+
+- [ ] **Step 4: Fix the two frozen-count labels and the retract success line**
+
+The frozen set is `paid` + `verified`, so the old `保留(已繳)` was inaccurate as well as inconsistent. In **both** `SyncModal` and `RetractModal`:
+
+```tsx
+            <Stat label="🔒 保留（已繳待驗、已驗證）" value={diff.frozen_count} />
+```
+
+```tsx
+            <Stat label="🔒 保留（已繳待驗、已驗證）" value={preview.frozen_count} />
+```
+
+and the retract success line:
+
+```tsx
+      setDone(`已收回 ${period}：刪除 ${r.applied.removed} 筆帳單、保留 ${r.applied.frozen} 筆已繳待驗／已驗證。此期已回到未開繳狀態。`);
+```
+
+(The `此期` here anticipates Task 4; if you write `本期` now, Task 4 will catch it — but write it right the first time.)
+
+- [ ] **Step 5: README**
+
+`README.zh-TW.md` — `把每筆 pending/rejected 標記為「已繳」` → `標記為「已繳待驗」`. Leave `誰欠／已繳／已驗證` in the intro paragraph: that sentence is about money in general, not the status label. Leave `已繳／已驗證凍結` and `已繳待驗` untouched.
+
+- [ ] **Step 6: Zero-hits assertion + gates**
+
+```bash
+git grep -n "已繳" -- packages README.md README.zh-TW.md | grep -v "已繳待驗" | grep -v "已繳／已驗證"
+echo "expect: only README.zh-TW's 誰欠／已繳／已驗證 intro line"
+pnpm --filter @chippot/worker test 2>&1 | tail -6
+pnpm --filter @chippot/admin run typecheck
+```
+
+- [ ] **Step 7: Commit**
+
+```bash
+git add packages/admin/src README.zh-TW.md
+git commit -m "refactor(copy): paid 狀態一律顯示「已繳待驗」,凍結筆數改為「已繳待驗、已驗證」 (#46)"
+```
+
+---
+
+## Task 4: 期別叢集 — 本期 → 此期／實際期別,開帳 → 開繳,按鈕名對齊
+
+The three findings the synthesis report deferred to batch E (D3, D5, D7). E is not happening, so they land here. They touch the same lines, so they ship as one commit.
+
+**Files:**
+- Modify: whatever `git grep -l "本期\|開帳"` reports — expected `admin/src/views/Payments.tsx`, `admin/src/views/Dashboard.tsx`, `admin/src/views/Settings.tsx`, `worker/src/adapters/discord/handler.ts`, `worker/src/adapters/discord/commands.ts`, `worker/scripts/register-commands.mjs`, `README.md`, `README.zh-TW.md`
+- Modify: `packages/worker/scripts/register-commands.mjs` — it duplicates `INITIATE_COMMAND.description` (same "keep in sync" duplication Task 1 hit for `PAY_COMMAND`)
+- Test: `packages/worker/test/adapters/discord-pay.test.ts` (asserts the old 本期 string)
+
+**Interfaces:**
+- Consumes: Tasks 1–3.
+- Produces: `本期` and `開帳` reach zero. The sync button's label is exactly `重新同步此期帳單`, which Settings' import warning quotes verbatim.
+
+- [ ] **Step 1: Regenerate both edit-site lists**
+
+```bash
+git grep -n "本期" -- packages README.md README.zh-TW.md
+git grep -n "開帳" -- packages README.md README.zh-TW.md
+```
+
+**Expect some 本期 hits to be already gone** — UX-A owns finding A5 (the 發起繳費 wording). Whatever A left behind, you fix.
+
+- [ ] **Step 2: Apply §A.3 to the Payments toolbar and its two modals**
+
+```tsx
+        <button className="btn" disabled={!effPeriod} title={effPeriod ? "對齊此期帳單到目前名單／現價" : "請先選擇單一期別"} onClick={() => setSync(true)}>重新同步此期帳單</button>
+        <button className="btn btn--danger" disabled={!effPeriod} title={effPeriod ? "刪除此期未繳／已退回帳單,期別回到未開繳" : "請先選擇單一期別"} onClick={() => setRetract(true)}>收回此期開繳</button>
+```
+
+**If UX-A already rewrote the retract tooltip** (its P0-4 adds the 已退回 + upload-link consequences), keep A's sentence and change only its `本期` → `此期`. Do not revert A's work.
+
+Modal titles:
+
+```tsx
+    <Modal title={`重新同步此期帳單 · ${period}`} onClose={onClose}>
+```
+
+```tsx
+    <Modal title={`收回此期開繳 · ${period}`} onClose={onClose}>
+```
+
+The remaining prose in those modals:
+
+```tsx
+            ? <p style={{ color: "var(--muted)" }}>此期已是最新，無需變更。</p>
+```
+
+```tsx
+            : <p style={{ color: "var(--muted)" }}>此期沒有可刪除的未繳／已退回帳單,收回只會把期別改回「未開繳」。</p>}
+```
+
+```tsx
+            收回後此期回到「未開繳」：刪掉的帳單不會被「重新同步此期帳單」補回來,日後可以再次發起繳費（屆時會重新發送開繳通知）。
+            {preview.frozen_count > 0 && `已繳／已驗證的 ${preview.frozen_count} 筆一律原樣保留,重開此期也不會重複產生帳單。`}
+            已經發出的 Discord 開繳通知不會撤回,必要時請自行到頻道說明。
+```
+
+(The last block also kills the final `開帳`. Note the commas above are the file's existing full-width `，` — keep whatever the file already uses; do not convert punctuation here, §A.10's rules cover separators, not commas.)
+
+- [ ] **Step 3: Dashboard empty states**
+
+```tsx
+                  {data.by_plan.length === 0 && <tr><td colSpan={7}><Empty>此期尚無資料</Empty></td></tr>}
+```
+
+```tsx
+                  {data.by_channel_tag.length === 0 && <tr><td colSpan={3}><Empty>此期尚無已驗證款項</Empty></td></tr>}
+```
+
+- [ ] **Step 4: Settings — the two 開帳 hints, the ActionRow description, and the button-name reference (D7)**
+
+```tsx
+            <Field label="每月結帳日"><span className="field__hint">每月幾號自動向所有成員開繳（1-28）。</span><input type="number" min={1} max={28} value={form.billing_day} onChange={(e) => set("billing_day")(e.target.value)} disabled={busy} /></Field>
+            <Field label="逾期天數"><span className="field__hint">開繳後幾天仍未繳就列入催繳。</span><input type="number" min={0} value={form.overdue_days} onChange={(e) => set("overdue_days")(e.target.value)} disabled={busy} /></Field>
+```
+
+(The `1–28` → `1-28` en-dash fix from §A.10 rule 2 rides along — it is the same string.)
+
+```tsx
+          <ActionRow title="發起繳費" tag="會改價＋發通知" warn desc="確認所選期別的金額並向所有成員發出開繳通知。"><InitiateBilling billingDay={savedBillingDay} dirty={dirty} /></ActionRow>
+```
+
+The import warning must now quote the button **exactly**:
+
+```tsx
+                被暫停的訂閱在 {diff.period} 還有 {diff.affected_pending_bills.length} 筆未繳帳單。匯入<b>不會</b>變更任何帳單；請到「繳費審核」按<b>「重新同步此期帳單」</b>清理。
+```
+
+- [ ] **Step 5: Discord — interpolate the real period everywhere**
+
+`commands.ts`:
+
+```ts
+export const INITIATE_COMMAND = {
+  name: "發起繳費",
+  type: 1,
+  description: "（管理員）確認指定期別各方案金額並發出開繳通知",
+  default_member_permissions: MANAGE_GUILD,
+};
+```
+
+and its duplicate in `scripts/register-commands.mjs`:
+
+```js
+    name: "發起繳費", type: 1,
+    description: "（管理員）確認指定期別各方案金額並發出開繳通知",
+    default_member_permissions: "32",
+```
+
+`handler.ts` — five replies. `period`/`current` is in scope at every one of them (verify with the grep before editing; if UX-A moved a block, the variable name may differ):
+
+```ts
+    return opened ? "✅ 你已登記繳費，目前沒有待繳項目。" : `${current} 的繳費尚未開放，待管理員發出開繳通知後即可繳費。`;
+```
+
+```ts
+  if (r.paidCount === 0) return `${period} 已登記繳費，無需重複操作。`;
+  const ignoredNote = screenshotIgnored ? "（本站未開啟截圖功能，已記錄你的繳費宣告）" : "";
+  return `✅ 已登記 ${period} 繳費 NT$${r.totalAmount.toLocaleString()}（共 ${r.paidCount} 筆）。管理員確認收款後完成。${ignoredNote}`;
+```
+
+```ts
+        : `✅ 已更新 ${period} 金額（更新 ${r.updatedPlans} 個方案、${r.updatedPayments} 筆待繳）。${period} 的通知先前已發送，未重複發送。`;
+```
+
+```ts
+      content: opened ? "✅ 你已登記繳費，目前沒有待繳項目。" : `${current} 的繳費尚未開放，待管理員發出開繳通知後即可繳費。`,
+```
+
+```ts
+  if (!(await isBillingOpened(env.DB, ws, period))) {
+    return updateErr(`${period} 的繳費尚未開放，待管理員發出開繳通知後即可繳費。`);
+  }
+```
+
+```ts
+      return json({ type: RT_UPDATE_MESSAGE, data: { content: `✅ ${period} 已登記繳費，無需重複操作。`, components: [] } });
+```
+
+- [ ] **Step 6: Update the test that asserts the old string**
+
+`packages/worker/test/adapters/discord-pay.test.ts` asserts `expect(captured).toContain("已登記本期")`. The reply now interpolates the period, so assert on the stable half:
+
+```ts
+    expect(captured).toContain("已登記");
+    expect(captured).toMatch(/\d{4}-\d{2}/);   // the reply now names the real period, not 「本期」
+    expect(captured).toContain("已記錄你的繳費宣告");
+```
+
+- [ ] **Step 7: Run the suite to confirm nothing else asserted these strings**
+
+```bash
+pnpm --filter @chippot/worker test 2>&1 | tail -20
+```
+
+Expected: PASS at the baseline count. **If a different test fails, read its assertion and update it in this task** — do not defer it.
+
+- [ ] **Step 8: READMEs**
+
+`README.md` — `重新同步本期帳單` ×2 → `重新同步此期帳單`; the 發起繳費 bullet's `confirm this period's per-plan amounts` → `confirm the selected period's per-plan amounts` (the English prose carries the same "this period" inaccuracy as the zh-TW copy — the default is often *next* month).
+`README.zh-TW.md` — `重新同步本期帳單` ×2 → `重新同步此期帳單`; `確認本期各方案金額` → `確認指定期別各方案金額`; `ephemeral：列出本期各方案 + 總額` → `列出該期各方案 + 總額`; `自動開帳` → `自動開繳`; the architecture diagram's `— 開帳 / 催繳 / 保存期` → `— 開繳 / 催繳 / 保存期`.
+
+- [ ] **Step 9: Zero-hits assertions + gates**
+
+```bash
+git grep -n "本期" -- packages README.md README.zh-TW.md ; echo "expect: no output"
+git grep -n "開帳" -- packages README.md README.zh-TW.md ; echo "expect: no output"
+pnpm --filter @chippot/worker test 2>&1 | tail -6
+pnpm -r typecheck
+```
+
+- [ ] **Step 10: Commit**
+
+```bash
+git add packages/admin/src packages/worker/src packages/worker/test README.md README.zh-TW.md
+git commit -m "refactor(copy): 期別標籤改「此期」／實際期別,開帳→開繳,按鈕名與文案對齊 (#46)"
+```
+
+---
+
+## Task 5: 期別（後台）vs 月份（成員面）
+
+**Files:**
+- Modify: `packages/web/src/App.tsx`
+- Test: worker suite (regression)
+
+**Interfaces:**
+- Consumes: Task 4.
+- Produces: `期別` exists only under `packages/admin` and `packages/worker`; `月份` on the member surfaces plus the two documented CSV-import exceptions.
+
+- [ ] **Step 1: Regenerate both lists**
+
+```bash
+git grep -n "期別" -- packages/web packages/worker/src/adapters
+git grep -n "月份" -- packages/admin
+```
+
+- [ ] **Step 2: The member pay page says 月份, like Discord already does**
+
+`packages/web/src/App.tsx`, in `Stub`:
+
+```tsx
+      <div className="stub__row">
+        <span className="stub__label">月份</span>
+        <span className="stub__period">{period}</span>
+      </div>
+```
+
+- [ ] **Step 3: Confirm the Discord side needs nothing**
+
+`git grep -n "期別" -- packages/worker/src/adapters` must print nothing — Discord already says 月份 (`選擇要繳的月份`, `你有多個月份待繳`, `這個月份已無待繳項目`). If a hit appears, it arrived from batch A or C; convert it to 月份 here.
+
+- [ ] **Step 4: Zero-hits assertion, with the documented exception spelled out**
+
+```bash
+git grep -n "期別" -- packages/web packages/worker/src/adapters ; echo "expect: no output"
+git grep -n "月份" -- packages/admin
+```
+
+The second grep must return **exactly two** `Settings.tsx` lines — the CSV import's `起算月份第一天（選填，YYYY-MM-DD）` field label and the `起算月份留空＝當月` prose. Those describe a `YYYY-MM-DD` **date**, not a billing period, so 期別 would be wrong (§A.4). Anything else is a leak; fix it.
+
+- [ ] **Step 5: Gates**
+
+```bash
+pnpm --filter @chippot/worker test 2>&1 | tail -6
+pnpm --filter @chippot/web run typecheck
+```
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add packages/web/src
+git commit -m "refactor(copy): 成員繳費頁改稱「月份」,與 Discord 一致（後台維持「期別」） (#46)"
+```
+
+---
+
+## Task 6: 支付渠道 → 繳費渠道
+
+**Files:**
+- Modify: `packages/admin/src/App.tsx`, `packages/admin/src/views/Manage.tsx`
+- Test: worker suite (regression)
+
+**Interfaces:**
+- Consumes: Task 5.
+- Produces: `支付渠道` reaches zero; `繳費渠道` is the full name, `渠道` stays as the table/field short form.
+
+- [ ] **Step 1: Regenerate**
+
+```bash
+git grep -n "支付渠道" -- packages README.md README.zh-TW.md
+```
+
+- [ ] **Step 2: Nav label**
+
+```tsx
+  { id: "tags", label: "繳費渠道", el: <ChannelTags /> },
+```
+
+- [ ] **Step 3: Card title and delete confirmation**
+
+```tsx
+      <Card title="繳費渠道（對帳分組）" action={<button className="btn btn--primary" onClick={() => setEdit(null)}>新增渠道…</button>}>
+```
+
+```tsx
+          message={`確定刪除此繳費渠道？此操作無法復原。`}
+```
+
+(The `…` on 新增渠道 is §A.10 rule 5 — a header action opening a modal. Task 13 sweeps the rest; doing this one here avoids touching the line twice.)
+
+- [ ] **Step 4: Zero-hits assertion + gates**
+
+```bash
+git grep -n "支付渠道" -- packages README.md README.zh-TW.md ; echo "expect: no output"
+pnpm --filter @chippot/admin run typecheck
+pnpm --filter @chippot/worker test 2>&1 | tail -6
+```
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add packages/admin/src
+git commit -m "refactor(copy): 後台「支付渠道」統一為「繳費渠道」 (#46)"
+```
+
+---
+
+## Task 7: 成員備註、純聲明、繳費頻道、去人稱
+
+Four one-line convergences that share no other task's files-of-record. One commit.
+
+**Files:**
+- Modify: `packages/admin/src/views/PaymentDetail.tsx`, `packages/admin/src/views/Manage.tsx`, `packages/admin/src/views/Settings.tsx`
+- Test: worker suite (regression)
+
+**Interfaces:**
+- Consumes: Task 6.
+- Produces: `使用者` and `帳單頻道` reach zero; no gendered pronoun refers to a member.
+
+- [ ] **Step 1: Regenerate all four lists**
+
+```bash
+git grep -n "使用者" -- packages
+git grep -n "帳單頻道" -- packages README.md README.zh-TW.md
+git grep -n "無憑證" -- packages
+git grep -nE "他可|到他|他的" -- packages
+```
+
+- [ ] **Step 2: 使用者備註 → 成員備註 (§A.7)**
+
+`PaymentDetail.tsx` — the same data is already called 成員備註 in `MemberReview.tsx`:
+
+```tsx
+        {payment.payment_note && (<><dt>成員備註</dt><dd>{payment.payment_note}</dd></>)}
+```
+
+- [ ] **Step 3: 帳單頻道 → 繳費頻道 (§A.6)**
+
+`Settings.tsx` — the bind-button ActionRow. This also drops the pronoun (§A.13):
+
+```tsx
+          <ActionRow title="張貼／更新綁定按鈕訊息" tag="立即執行" desc="在繳費頻道貼一則含「綁定 Discord」按鈕的公開訊息，讓成員主動綁定（開繳／催繳才 @ 得到）。"><RebuildBindMessage /></ActionRow>
+```
+
+- [ ] **Step 4: Drop the pronoun in the unbind confirmation (§A.13)**
+
+`Manage.tsx`:
+
+```tsx
+    if (!user || !window.confirm("確定解除這位成員的 Discord 綁定？解除後可重新用綁定按鈕／指令綁定。")) return;
+```
+
+- [ ] **Step 5: Confirm 無憑證 survives only as prose (§A.8)**
+
+The `無憑證` grep must now return exactly the two identical explanatory sentences — `無憑證，純聲明 — 請依備註與帳戶自行核對。` in `PaymentDetail.tsx` and `MemberReview.tsx`. The Dashboard stat label was already converted in Task 3. If a third hit exists, convert it to 純聲明.
+
+- [ ] **Step 6: Zero-hits assertions + gates**
+
+```bash
+git grep -n "使用者" -- packages ; echo "expect: no output"
+git grep -n "帳單頻道" -- packages README.md README.zh-TW.md ; echo "expect: no output"
+git grep -nE "他可|到他" -- packages ; echo "expect: no output"
+pnpm --filter @chippot/admin run typecheck
+pnpm --filter @chippot/worker test 2>&1 | tail -6
+```
+
+- [ ] **Step 7: Commit**
+
+```bash
+git add packages/admin/src
+git commit -m "refactor(copy): 成員備註／繳費頻道用詞收斂,並移除對成員的第三人稱 (#46)"
+```
+
+---
+
+## Task 8: enum 中文化（顯示層對映）
+
+The admin shows raw DB enums in four places and one sentence even teaches admins to pick `cancelled` by name. Add display maps following the `CHANNEL_TYPE_LABEL` precedent already in `Manage.tsx`.
+
+**READ THIS FIRST:** every `<option value=…>`, every request body, every SQL literal keeps its English value. Only the text between the tags changes. A diff that changes `value="active"` is wrong.
+
+**Files:**
+- Modify: `packages/admin/src/views/PaymentDetail.tsx`, `packages/admin/src/views/Manage.tsx`
+- Test: worker suite (regression — this task must not move a single assertion)
+
+**Interfaces:**
+- Consumes: Task 7.
+- Produces: `SOURCE_LABEL` (exported from `PaymentDetail.tsx`) and `SUB_STATUS_LABEL` (module-local in `Manage.tsx`), both `Record<string, string>` with a `?? raw` fallback.
+
+- [ ] **Step 1: Regenerate**
+
+```bash
+git grep -n "payment.source\|{s.status}\|>provider<\|cancelled" -- packages/admin/src
+```
+
+- [ ] **Step 2: `source` map in `PaymentDetail.tsx`**
+
+Place it above the component. The `?? payment.source` fallback matters: a future enum value must degrade to the raw string, never render blank.
+
+```tsx
+// payments.source is a DB enum (migrations/0001_init.sql). Display only — the stored value never changes.
+// 'user' is the schema default that no current code path writes, so it only appears on legacy rows;
+// 'cron' covers every bill the system creates (daily cron, 發起繳費 and 重新同步 all leave source unset).
+const SOURCE_LABEL: Record<string, string> = {
+  user: "Discord（舊版）",
+  user_slash: "Discord",
+  user_web: "網頁上傳",
+  admin_manual: "後台補登",
+  cron: "系統建立",
+};
+```
+
+```tsx
+        <dt>來源</dt><dd>{SOURCE_LABEL[payment.source] ?? payment.source}</dd>
+```
+
+- [ ] **Step 3: 訂閱狀態 map in `Manage.tsx`**
+
+Put it beside the existing `CHANNEL_TYPES` / `CHANNEL_TYPE_LABEL` pair so the two follow one shape:
+
+```tsx
+// subscriptions.status is a DB enum — display only, the <option value> below stays English.
+const SUB_STATUSES = [
+  { v: "active", label: "啟用中" },
+  { v: "paused", label: "暫停" },
+  { v: "cancelled", label: "已取消" },
+];
+const SUB_STATUS_LABEL: Record<string, string> = Object.fromEntries(SUB_STATUSES.map((s) => [s.v, s.label]));
+```
+
+The subscriptions table cell:
+
+```tsx
+                  <td>{s.user_name}</td><td>{s.plan_name}</td><td>{SUB_STATUS_LABEL[s.status] ?? s.status}</td><td className="mono">{s.start_date}</td><td className="right mono">{s.billing_day}</td>
+```
+
+The edit modal's `<select>` — **values stay English**:
+
+```tsx
+      <Field label="狀態"><select value={f.status} onChange={(e) => set("status", e.target.value)} disabled={busy}>{SUB_STATUSES.map((s) => <option key={s.v} value={s.v}>{s.label}</option>)}</select></Field>
+```
+
+- [ ] **Step 4: Stop teaching the raw enum, and translate the `provider` label**
+
+The delete-subscription confirmation:
+
+```tsx
+          message={`將一併刪除此訂閱的 ${del.payment_count ?? 0} 筆繳費紀錄。\n此操作無法復原。（若只想停收，可改用「編輯 → 狀態：已取消」）`}
+```
+
+The plans table header, the plan modal's field label, and its validation message:
+
+```tsx
+            <thead><tr><th>名稱</th><th>供應商</th><th className="right">月費</th><th>身分組 ID</th><th>啟用</th><th></th></tr></thead>
+```
+
+```tsx
+    if (!provider) { setErr("請填供應商"); return; }
+```
+
+```tsx
+      <Field label="供應商（選現有或直接輸入新的，如 gemini、glm）">
+```
+
+The `<datalist id="plan-providers">` id and the `provider` variable names are code, not copy — leave them.
+
+- [ ] **Step 5: Prove no DB value moved**
+
+```bash
+git diff -- packages/admin/src | grep -E '^\+.*value="(active|paused|cancelled|user|user_slash|user_web|admin_manual|cron)"'
+```
+
+Every line this prints must be an `<option>` whose `value` is unchanged from the line above it in the diff. If the grep shows a *changed* value, revert that hunk.
+
+- [ ] **Step 6: Zero-hits assertion + gates**
+
+```bash
+git grep -n ">provider<\|狀態 cancelled" -- packages/admin/src ; echo "expect: no output"
+pnpm --filter @chippot/admin run typecheck
+pnpm --filter @chippot/worker test 2>&1 | tail -6
+```
+
+The worker suite must be at the baseline count **and unchanged** — this task touches no worker file.
+
+- [ ] **Step 7: Commit**
+
+```bash
+git add packages/admin/src
+git commit -m "feat(admin-ui): 來源／訂閱狀態／供應商改顯示中文（顯示層對映,DB 值不變） (#46)"
+```
+
+---
+
+## Task 9: 「至少填一項」與成員面語氣
+
+**Files:**
+- Modify: `packages/worker/src/adapters/discord/handler.ts`, `packages/web/src/App.tsx`, `packages/web/src/api.ts`, `packages/web/index.html`, `packages/worker/src/env.ts`
+- Test: `packages/worker/test/adapters/discord-handler.test.ts` (asserts `至少`), `packages/worker/test/env.test.ts` (asserts the default template's shape)
+
+**Interfaces:**
+- Consumes: Task 8.
+- Produces: one canonical at-least-one sentence (§A.12) on all three member surfaces.
+
+- [ ] **Step 1: Regenerate**
+
+```bash
+git grep -n "至少" -- packages
+git grep -n "開始繳費" -- packages
+```
+
+- [ ] **Step 2: Discord — the rejection message**
+
+```ts
+    if (screenshotIgnored) return "本站未開啟截圖功能，請改用「渠道」或「備註」登記繳費。";
+    return "渠道、截圖、備註至少填一項。";
+```
+
+- [ ] **Step 3: Web pay page — both copies of the rule, same order, same punctuation**
+
+```tsx
+    if (!canSubmit) {
+      setError("渠道、截圖、備註至少填一項。");
+      return;
+    }
+```
+
+```tsx
+        <p className="muted small center">{info?.proof_enabled === false ? "渠道、備註至少填一項。" : "渠道、截圖、備註至少填一項。"}此連結僅限你本人本期使用，送出後即失效。</p>
+```
+
+Note that trailing sentence still says 本期 — it means "the period this link is for", and the link **is** single-period. Rewrite it to remove the word anyway, since Task 4 banned it:
+
+```tsx
+        <p className="muted small center">{info?.proof_enabled === false ? "渠道、備註至少填一項。" : "渠道、截圖、備註至少填一項。"}此連結僅限你本人、此月份使用，送出後即失效。</p>
+```
+
+- [ ] **Step 4: Web — sentence-final punctuation and the page title (§A.13)**
+
+`packages/web/src/api.ts`:
+
+```ts
+    return { ok: false, error: "連線失敗，請稍後再試。" };
+```
+
+`packages/web/index.html`:
+
+```html
+    <title>ChipPot · 繳費登記</title>
+```
+
+- [ ] **Step 5: The default 開繳 template's one-off wording (§A.5)**
+
+`packages/worker/src/env.ts`:
+
+```ts
+  billing_opened_template: "📢 **{period} 開繳**\n{plans}\n\n請點下方「繳費」按鈕，或使用 `/繳費` 指令（可附截圖）。",
+```
+
+This is a **default**; workspaces with a saved template are unaffected. `env.test.ts` asserts the default's shape (`toEqual(DEFAULT_SETTINGS)`, `toContain("{plans}")`), not its prose — Step 6 proves it.
+
+- [ ] **Step 6: Zero-hits assertion + suite**
+
+```bash
+git grep -n "開始繳費" -- packages ; echo "expect: no output"
+git grep -n "至少" -- packages/worker/src packages/web/src
+pnpm --filter @chippot/worker test 2>&1 | tail -20
+```
+
+The second grep must show the identical sentence `渠道、截圖、備註至少填一項。` (plus the no-R2 variant) and nothing else — no `請至少附上…`, no `請至少選擇…`. The suite must PASS: `discord-handler.test.ts` asserts `toContain("至少")`, which the new sentence still satisfies.
+
+- [ ] **Step 7: Gates + commit**
+
+```bash
+pnpm -r typecheck
+git add packages/worker/src packages/web
+git commit -m "refactor(copy): 「渠道、截圖、備註至少填一項。」統一三個成員入口,並修正頁面標題與句末標點 (#46)"
+```
+
+---
+
+## Task 10: 後台錯誤訊息中文化 (D14)
+
+These change **API response strings**, so they get real tests. TDD: write the assertions first, watch them fail against the English strings, then translate.
+
+**Files:**
+- Modify: `packages/worker/src/routes/admin.ts`
+- Test: `packages/worker/test/routes/admin.test.ts`
+
+**Interfaces:**
+- Consumes: Task 9.
+- Produces: every `errorResponse` in `routes/admin.ts` that an admin can reach by clicking now answers in zh-TW. The format-validator allowlist in §A.14 stays English **by design** — a later task must not "finish the job".
+
+- [ ] **Step 1: Write the failing tests**
+
+Append to `packages/worker/test/routes/admin.test.ts`. Read the file's existing `call(...)` helper and seeded fixtures first and match them — the helper's signature and the seeded ids are what the rest of the file uses, and this block must not introduce a second convention.
+
+Route paths verified against `buildAdminRouter()` at the bottom of `routes/admin.ts`: there is **no** `GET /admin/users/:id` (only the list), and initiate is `POST /admin/billing/initiate` with the period **in the body** — not a path param.
+
+```ts
+// #46: the admin SPA renders `data.error` straight into .error-banner, so anything reachable by
+// clicking must be zh-TW. Format validators behind type="month"/type="number" stay English on purpose.
+describe("admin error messages are zh-TW (#46)", () => {
+  it("404s in Chinese for an unknown member", async () => {
+    const res = await call("PATCH", "/admin/users/999999", { display_name: "x" });
+    expect(res!.status).toBe(404);
+    expect(((await res!.json()) as any).error).toContain("找不到這位成員");
+  });
+
+  it("names the missing Discord channel setting in Chinese", async () => {
+    const res = await call("POST", "/admin/discord/bind-message");
+    expect(res!.status).toBe(400);
+    expect(((await res!.json()) as any).error).toContain("繳費頻道 ID");
+  });
+
+  it("keeps format validators in English (unreachable from the UI)", async () => {
+    const res = await call("POST", "/admin/billing/initiate", { period: "not-a-period", amounts: [] });
+    expect(res!.status).toBe(400);
+    expect(((await res!.json()) as any).error).toBe("period must be YYYY-MM");
+  });
+});
+```
+
+Match the file's existing preconditions. The bind-message test needs `discord_billing_channel_id` **unset** and the bot token **set** (the handler checks the channel first, then the token) — `admin.test.ts` already has a save/restore pattern for `DISCORD_BOT_TOKEN` ("Supply the bot token locally (CI has no .dev.vars), then restore it"); reuse it rather than inventing a second approach. If the seed sets a billing channel, clear it in the test and restore it afterwards.
+
+- [ ] **Step 2: Run them and watch them fail**
+
+```bash
+pnpm --filter @chippot/worker test -- routes/admin 2>&1 | tail -25
+```
+
+Expected: the first two FAIL (`expected 'not found' to contain '找不到這位成員'`), the third PASSES (it asserts the status quo).
+
+- [ ] **Step 3: Translate — §A.14's in-scope table, and only it**
+
+```bash
+git grep -n 'errorResponse(4\|errorResponse(5' -- packages/worker/src/routes/admin.ts
+```
+
+Walk the list. For each hit, decide from §A.14: in the zh-TW table → translate; in the English allowlist → leave. For the six `not found` sites, pick the entity from the surrounding handler name (`getUserHandler` → `找不到這位成員`, `updateSubscriptionHandler` → `找不到這筆訂閱`, and so on) — a bare `找不到資料` for all of them is worse copy and this task rejects it.
+
+Do **not** introduce a `notFound(entity)` helper. Six literals in six handlers read better in review than one indirection, and the strings differ.
+
+- [ ] **Step 4: Run the whole worker suite**
+
+```bash
+pnpm --filter @chippot/worker test 2>&1 | tail -20
+```
+
+Expected: PASS, count = baseline **+3**. If a pre-existing test fails, it asserted an English string this task changed — update that assertion here, in this commit.
+
+- [ ] **Step 5: Assert the allowlist survived**
+
+```bash
+git grep -n "period must be YYYY-MM" -- packages/worker/src/routes/admin.ts | wc -l
+```
+
+Expected: **10** — the count on 2026-07-31, unchanged by this task. These are load-bearing English-by-design (§A.14's allowlist); if the number dropped, you over-translated. If batches A/B/C added or removed a period validator, run this grep **before** Step 3 too and compare against your own before-number rather than 10.
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add packages/worker/src/routes/admin.ts packages/worker/test/routes/admin.test.ts
+git commit -m "feat(worker): 後台可觸及的錯誤訊息改為中文（格式驗證維持英文） (#46)"
+```
+
+---
+
+## Task 11: 狀態競態錯誤中文化 (D15)
+
+`payment 1042 cannot transition to 'verified'` is a **reproducible race** (two admins, or a stale list), not a crash — but it reaches the admin's error banner looking like one.
+
+**Files:**
+- Modify: `packages/worker/src/core/payments.ts`
+- Test: `packages/worker/test/core/payments.test.ts`
+
+**Interfaces:**
+- Consumes: Task 10.
+- Produces: `InvalidPaymentTransition`'s `message` is zh-TW; its `paymentId` and `to` public readonly fields are unchanged, so logs and tests keep the detail the message no longer carries.
+
+- [ ] **Step 1: Write the failing test**
+
+Append to `packages/worker/test/core/payments.test.ts` (it already imports `InvalidPaymentTransition`):
+
+```ts
+// #46: this is a reproducible race (two admins, or a stale list), so the message the admin sees must
+// say what to do — while the id/target stay on the error object for logs.
+it("InvalidPaymentTransition explains the race in zh-TW and keeps its fields", () => {
+  const e = new InvalidPaymentTransition(1042, "verified");
+  expect(e.message).toBe("這筆的狀態已被變動（可能已由其他人處理），請重新載入後再試。");
+  expect(e.paymentId).toBe(1042);
+  expect(e.to).toBe("verified");
+  expect(e.name).toBe("InvalidPaymentTransition");
+});
+```
+
+- [ ] **Step 2: Run it and watch it fail**
+
+```bash
+pnpm --filter @chippot/worker test -- core/payments 2>&1 | tail -20
+```
+
+Expected: FAIL — `expected 'payment 1042 cannot transition to …' to be '這筆的狀態已被變動…'`.
+
+- [ ] **Step 3: Change the message, keep the fields**
+
+```ts
+export class InvalidPaymentTransition extends Error {
+  constructor(
+    public readonly paymentId: number,
+    public readonly to: PaymentStatus
+  ) {
+    // Surfaced verbatim in the admin error banner (routes/admin.ts returns e.message on 409), so it
+    // is copy, not a log line. paymentId/to stay on the instance for logs and tests.
+    super("這筆的狀態已被變動（可能已由其他人處理），請重新載入後再試。");
+    this.name = "InvalidPaymentTransition";
+  }
+}
+```
+
+- [ ] **Step 4: Run the whole suite**
+
+```bash
+pnpm --filter @chippot/worker test 2>&1 | tail -20
+```
+
+Expected: PASS, count = baseline **+4**. The three existing `rejects.toBeInstanceOf(InvalidPaymentTransition)` assertions are unaffected.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add packages/worker/src/core/payments.ts packages/worker/test/core/payments.test.ts
+git commit -m "feat(worker): 狀態競態改回中文說明,不再像 crash（id/目標狀態保留在錯誤物件上） (#46)"
+```
+
+---
+
+## Task 12: 千分位
+
+A member sees `NT$1,258` in Discord and `NT$1258` for the same bill on the pay page.
+
+**Files:**
+- Modify: `packages/web/src/App.tsx`, `packages/admin/src/views/Manage.tsx`
+- Test: worker suite (regression)
+
+**Interfaces:**
+- Consumes: Task 11.
+- Produces: no rendered TWD amount without `.toLocaleString()`.
+
+- [ ] **Step 1: Find every bare amount**
+
+```bash
+git grep -n 'NT\$\${' -- packages/web/src packages/admin/src
+git grep -n 'NT\$' -- packages/web/src packages/admin/src | grep -v toLocaleString | grep -v "Money"
+```
+
+- [ ] **Step 2: Web pay page — per-subscription and total**
+
+```tsx
+          <span className="stub__amt">NT${s.amount.toLocaleString()}</span>
+```
+
+```tsx
+          <span className="stub__amt">NT${total.toLocaleString()}</span>
+```
+
+- [ ] **Step 3: Admin — the plan `<select>` option and the plans table cell**
+
+```tsx
+      <Field label="方案"><select value={f.plan_id} onChange={(e) => set("plan_id", e.target.value)} disabled={busy}><option value="">選擇…</option>{plans.data?.plans.filter((p) => p.active).map((p) => <option key={p.id} value={p.id}>{p.name}（NT${p.monthly_amount.toLocaleString()}）</option>)}</select></Field>
+```
+
+```tsx
+                  <td>{p.name}</td><td>{p.provider}</td><td className="right mono">NT${p.monthly_amount.toLocaleString()}</td>
+```
+
+- [ ] **Step 4: Assertion + gates**
+
+```bash
+git grep -n 'NT\$' -- packages/web/src packages/admin/src | grep -v toLocaleString | grep -v "Money" | grep -v 'NT\$)'
+pnpm -r typecheck
+pnpm --filter @chippot/worker test 2>&1 | tail -6
+```
+
+The grep must return **only static literals with no interpolation** — as of 2026-07-31 that is exactly three `Settings.tsx` lines: the `DEFAULT_NOTIFY` template string (`NT${amount}` is a *placeholder*, not a number), and the two `sampleVars()` preview strings, which already hardcode `NT$1,258` / `NT$1,573` with separators. Any line containing `${` followed by a numeric field is a miss — go fix it.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add packages/web/src packages/admin/src
+git commit -m "fix(copy): 繳費頁與方案金額補上千分位,與 Discord／後台其他處一致 (#46)"
+```
+
+---
+
+## Task 13: 格式與標點統一
+
+Pure §A.10 work. Everything behaviour-adjacent has already shipped in Tasks 1–12; what remains is the `…` convention, the progress text, success prefixes and list separators.
+
+**Files:**
+- Modify: `packages/admin/src/views/Payments.tsx`, `packages/admin/src/views/Manage.tsx`, `packages/admin/src/views/Settings.tsx`
+- Test: worker suite (regression)
+
+**Interfaces:**
+- Consumes: Task 12.
+- Produces: §A.10 rules 4, 5 and 6 hold across the admin SPA.
+
+- [ ] **Step 1: Regenerate**
+
+```bash
+git grep -nE '計算中…|計算差異中…' -- packages/admin/src
+git grep -nE 'setDone\(|setMsg\(|setToast\(' -- packages/admin/src
+git grep -nE '新增成員|新增訂閱|新增方案|新增渠道|產生上傳連結|手動補登|匯入…|發起繳費…' -- packages/admin/src
+git grep -n ' / ' -- packages/admin/src
+```
+
+- [ ] **Step 2: `…` on dialog-opening toolbar/header actions (rule 5)**
+
+Add a trailing `…` to: `產生上傳連結…`, `手動補登…`, `重新同步此期帳單…`, `收回此期開繳…`, `新增成員…`, `新增訂閱…`, `新增方案…`. (`新增渠道…` shipped in Task 6; `匯入…` and `發起繳費…` already have it.)
+
+**Do not** add `…` to row-level `編輯`／`刪除`／`停用`／`啟用`. They open dialogs too, but they repeat once per row and UX-B turned those rows into mobile cards where the extra glyph is pure noise. This asymmetry is deliberate — state it in the PR body so a reviewer does not "fix" it.
+
+- [ ] **Step 3: Unify the preview progress text (rule 6)**
+
+The retract preview computes a diff just like the sync preview:
+
+```tsx
+      {busy && !preview && <Empty>計算差異中…</Empty>}
+```
+
+- [ ] **Step 4: `✓ ` prefix on admin success messages (rule 4)**
+
+`Payments.tsx` — the two that lack it:
+
+```tsx
+      setDone(`✓ 已套用：新增 ${r.applied.added}、移除 ${r.applied.removed}、改價 ${r.applied.repriced}、保留 ${r.applied.frozen}` + (r.notified ? `；已通知 ${r.notified} 位新成員` : ""));
+```
+
+```tsx
+      setDone(`✓ 已收回 ${period}：刪除 ${r.applied.removed} 筆帳單、保留 ${r.applied.frozen} 筆已繳待驗／已驗證。此期已回到未開繳狀態。`);
+```
+
+- [ ] **Step 5: 頓號 for enumerations (rule 3)**
+
+`Settings.tsx` — the import result line and the initiate result line, which use half-width slashes between Chinese items:
+
+```tsx
+      setDone(`✓ 已套用：新增 ${d.users_created.length} 人、新增 ${d.subs_added.length} 訂閱、恢復 ${d.subs_reactivated.length}、暫停 ${d.subs_paused.length}`);
+```
+
+```tsx
+      setMsg(r.sent ? `✓ 已發出通知（更新 ${r.updated_plans} 方案、${r.updated_payments} 筆）` : `✓ 已更新金額（通知先前已發送）`);
+```
+
+Leave `PNG / JPG / WebP`, `Discord／Google Chat／Slack`, `openai / anthropic / gemini …` and file-path-ish strings alone — rule 3 is about Chinese enumerations.
+
+- [ ] **Step 6: Assertions + gates**
+
+```bash
+git grep -n "計算中…" -- packages/admin/src ; echo "expect: no output"
+git grep -nE 'setDone\(`[^✓]' -- packages/admin/src ; echo "expect: no output — every admin success line starts ✓"
+pnpm --filter @chippot/admin run typecheck
+pnpm --filter @chippot/worker test 2>&1 | tail -6
+```
+
+- [ ] **Step 7: Commit**
+
+```bash
+git add packages/admin/src
+git commit -m "style(copy): 後台成功訊息前綴、中文頓號分隔、彈窗按鈕「…」與進度字統一 (#46)"
+```
+
+---
+
+## Task 14: 標註 — 死設定、身分組承諾、寫死訊息
+
+Three findings the audit raised where the honest resolution is *say what is true*, not rebuild. §A.15 explains why each stops here.
+
+**Files:**
+- Modify: `packages/worker/src/env.ts`, `packages/admin/src/views/Manage.tsx`, `packages/admin/src/views/Settings.tsx`, `packages/worker/src/adapters/discord/notify.ts`, `README.zh-TW.md`
+- Test: worker suite (regression — annotations must not move a single assertion)
+
+**Interfaces:**
+- Consumes: Task 13.
+- Produces: nothing other tasks depend on. This is the last content task.
+
+- [ ] **Step 1: D22 — annotate the dead `timezone` setting**
+
+There is **no admin UI field** for it; confirm before writing the comment:
+
+```bash
+git grep -n "timezone" -- packages
+```
+
+Expected: three hits, all in `packages/worker/src/env.ts`. Annotate the interface field:
+
+```ts
+export interface WorkspaceSettings {
+  /**
+   * Dead setting (#46): parsed and round-tripped, but nothing reads it — every date in the system is
+   * computed in Asia/Taipei, hardcoded in core/time.ts. Kept (not deleted) because removing it would
+   * change the settings schema and break the stored-settings round-trip env.test.ts asserts.
+   * There is deliberately no admin UI field for it: an editable control that changes nothing is worse
+   * than no control. Making the timezone real means changing core/time.ts, not this line.
+   */
+  timezone: string;
+```
+
+Add one line to `README.zh-TW.md` where settings are described: `` `timezone` 目前是死設定——時區固定為 Asia/Taipei（`core/time.ts`），改這個欄位沒有任何效果。``
+
+- [ ] **Step 2: D21 — stop implying automatic role management**
+
+`plans.discord_role_id` is only used to `@` a role in an announcement. `Manage.tsx`'s `PlanModal`:
+
+```tsx
+      <Field label="Discord 身分組 ID（僅用於通知時 @ 該身分組，不會自動發放或回收身分組）"><input value={f.discord_role_id} onChange={(e) => set("discord_role_id", e.target.value)} disabled={busy} /></Field>
+```
+
+- [ ] **Step 3: D16 — say which messages the template card actually covers**
+
+Only three messages are editable (開繳通知／逾期催繳／常駐繳費訊息). Two are hardcoded in the worker:
+
+```bash
+git grep -n "還沒綁定的成員\|已將你加入" -- packages/worker/src
+```
+
+- the bind-button message content — in **`packages/worker/src/routes/admin.ts`**, `discordBindMessage` (not in `adapters/discord/notify.ts`, which only builds the button row)
+- the new-member nudge — in **`packages/worker/src/adapters/discord/notify.ts`**, `sendPaymentNudge`
+
+Unifying them is batch-E scope, so state the boundary instead of hiding it. `Settings.tsx`:
+
+```tsx
+      <Card title="Discord 訊息文字" desc="機器人在頻道發出的訊息（支援 Discord markdown，即時預覽）。綁定按鈕訊息與新成員提醒目前寫死在程式中，不在這裡編輯。">
+```
+
+And the same comment above each hardcoded `content` literal:
+
+```ts
+// Hardcoded on purpose for now (#46): unlike 開繳／催繳／常駐繳費訊息, this message has no
+// workspace-settings template. 設定 → Discord 訊息文字 says so. Making it editable is a settings
+// schema change (deferred with the rest of the 期別 lifecycle work).
+```
+
+- [ ] **Step 4: Gates**
+
+```bash
+pnpm -r typecheck
+pnpm --filter @chippot/worker test 2>&1 | tail -6
+```
+
+Expected: PASS, count = baseline **+4** (unchanged from Task 11 — annotations add no tests).
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add packages/worker/src packages/admin/src README.zh-TW.md
+git commit -m "docs(copy): 標註死設定 timezone、身分組不自動發放、寫死訊息不受模板控制 (#46)"
+```
+
+---
+
+## Task 15: 全域殘留稽核、README、CI 閘門、PR
+
+**Files:**
+- Modify: `README.md`, `README.zh-TW.md` (test badge + any leftover the sweep surfaces)
+- Modify (local only, **never `git add`**): `docs/deploy-state.md`
+
+**Interfaces:**
+- Consumes: Tasks 1–14.
+- Produces: a PR closing #46, and an owner-facing note that Discord commands must be re-registered after deploy.
+
+- [ ] **Step 1: Run every zero-hits assertion at once**
+
+```bash
+cd /Users/poterpan/Documents/Coding/Project/chippot
+for t in 核准 本期 開帳 支付渠道 使用者 帳單頻道 已退訂 開始繳費; do
+  echo "── $t ──"
+  git grep -n "$t" -- packages README.md README.zh-TW.md
+done
+```
+
+Every section must be empty. A hit here means a task's sweep missed a site or a later task reintroduced the word — go fix it and amend that task's commit (or add a follow-up commit; do not ship a partial sweep).
+
+- [ ] **Step 2: Run the judgement-call greps and check each hit against §A**
+
+```bash
+git grep -n "已繳" -- packages README.md README.zh-TW.md | grep -v "已繳待驗" | grep -v "已繳／已驗證"
+git grep -n "月份" -- packages/admin
+git grep -n "期別" -- packages/web packages/worker/src/adapters
+git grep -n "無憑證" -- packages
+```
+
+Allowed, and nothing else:
+- `已繳`: the `README.zh-TW.md` intro sentence `誰欠／已繳／已驗證`, which describes money rather than the status label.
+- `月份` in admin: exactly the two CSV-import lines (§A.4).
+- `期別` in web/adapters: **nothing**.
+- `無憑證`: exactly the two identical `無憑證，純聲明 — 請依備註與帳戶自行核對。` sentences (§A.8).
+
+- [ ] **Step 2b: Prove the two Discord command payloads still agree**
+
+`scripts/register-commands.mjs` hand-duplicates `PAY_COMMAND` and `INITIATE_COMMAND` because a `.mjs` cannot import the TS module. Tasks 1 and 4 each edited both copies; confirm they did not drift:
+
+```bash
+for s in "登記繳費（一次涵蓋" "（管理員）確認指定期別"; do
+  echo "── $s ──"
+  git grep -h "$s" -- packages | sed 's/^ *//;s/^description: //' | sort -u
+done
+```
+
+Each block must print exactly **one** distinct description string. Two lines means the `.ts` and the `.mjs` disagree, and `pnpm --filter @chippot/worker register` would push the wrong text to Discord.
+
+- [ ] **Step 3: Full CI-parity gates, in CI's order**
+
+```bash
+pnpm install --frozen-lockfile
+pnpm -r typecheck
+pnpm -r test 2>&1 | tail -8
+pnpm -r build
+```
+
+`pnpm -r build` needs `VITE_API_BASE`; CI supplies a throwaway. Do the same:
+
+```bash
+VITE_API_BASE=https://example.invalid pnpm -r build
+```
+
+Then reproduce CI's fail-fast guard — the web build **must refuse** to build without it:
+
+```bash
+pnpm --filter @chippot/web build && echo "BROKEN: built without VITE_API_BASE" || echo "OK: refused, as intended"
+```
+
+Record the exact `Tests  N passed (N)` number. It should be the Task 1 baseline **+4**.
+
+- [ ] **Step 4: Update the test badge in both READMEs**
+
+Both files carry the same badge line and `README.zh-TW.md` repeats the count in prose:
+
+```
+![Vitest](https://img.shields.io/badge/tests-<N>%20passing-0f6e63?logo=vitest&logoColor=white)
+```
+
+and in `README.zh-TW.md`: `- 🧪 **真環境測試** — <N> 個 Vitest 案例跑在真正的 Miniflare D1 + R2…`
+
+Use the N from Step 3, not an arithmetic guess.
+
+- [ ] **Step 5: Push and open the PR**
+
+```bash
+git add README.md README.zh-TW.md
+git commit -m "docs(readme): 測試徽章更新為 <N>,並同步術語統一後的按鈕名 (#46)"
+git push -u origin ux/46-terminology
+```
+
+```bash
+gh pr create --title "refactor(copy): 術語與文案統一（驗證／已繳待驗／繳費渠道／此期／開繳）" --body "$(cat <<'EOF'
+Closes #46
+
+UX 健檢批次 D。幾乎全字串;不動任何 DB 值、enum、custom_id 或 API 形狀。
+
+## 正規用詞
+- 動作＝**驗證**（刪除「核准」,含程式註解與測試標題）;狀態＝已驗證;流程／佇列＝審核
+- `paid` 一律顯示 **已繳待驗**（表頭空間不足處用「待驗」）
+- **繳費渠道**（完整名）＋ 渠道（表格短名）;刪除「支付渠道」
+- **此期**／實際期別,刪除「本期」;**開繳**,刪除「開帳」
+- 後台＝期別,成員面（Discord＋繳費頁）＝月份
+- 成員（刪除唯一一處「使用者」）、純聲明（「無憑證」只留作解釋文字）
+
+## 一併收掉批次 E 遺留的期別標籤
+- D3 按鈕改「此期」;D5 開帳→開繳;D7 按鈕字面補成完整名 `重新同步此期帳單`,設定頁的指涉現在完全對得上
+
+## 行為相鄰的改動（有測試）
+- `routes/admin.ts` 可觸及的錯誤訊息改中文;純格式驗證（`period must be YYYY-MM` 等）**刻意保留英文**（UI 走不到）
+- `InvalidPaymentTransition` 訊息改中文,`paymentId`／`to` 欄位保留給日誌
+- 來源／訂閱狀態／供應商加中文顯示對映（**顯示層**,`<option value>` 與 DB 值不變）
+- 繳費頁與方案金額補千分位
+
+## 刻意不做
+- `settings.timezone` 死設定：標註,不移除（移除會改 settings schema）
+- 寫死訊息 vs 模板：標註邊界,不統一（屬期別生命週期重構範圍）
+- 列內 編輯／刪除 不加「…」（每列重複,行動版卡片上是噪音）;只有工具列／卡片頭的開窗動作加
+
+## ⚠️ 部署後必做
+`/繳費` 與 `/發起繳費` 的**指令描述**有變更。Discord 的指令描述是註冊時寫死的,**部署後必須到
+設定 → 工具 → 「註冊 Discord 指令」按一次**（或 `pnpm --filter @chippot/worker register`）,
+否則成員在 Discord 看到的仍是舊描述（包含 #46 P0-8 那句錯的「可選」）。
+
+Worker tests: <N> passed。typecheck / admin build / web build 皆綠。
+EOF
+)"
+```
+
+- [ ] **Step 6: Append the deploy-state entry — local only**
+
+`docs/deploy-state.md` is gitignored. Append one section at the **very end** (newest last, matching `## 收回已開繳的月份 (PR #41 + 徽章 #42, 2026-07-29)`), replacing `NN` with the PR number:
+
+```markdown
+## 術語與文案統一 (PR #NN, 2026-07-31)
+- issue #46（UX 健檢批次 D）。正規用詞：驗證（刪核准）／已繳待驗（刪已繳）／繳費渠道（刪支付渠道）／
+  此期（刪本期）／開繳（刪開帳）／成員（刪使用者）；後台＝期別、成員面＝月份。
+- 一併收掉原留給批次 E 的期別標籤三項（D3 按鈕、D5 開帳、D7 按鈕名與文案對齊）。
+- 行為相鄰：後台可觸及錯誤訊息中文化（格式驗證維持英文）、狀態競態訊息中文化（欄位保留）、
+  來源／訂閱狀態／供應商顯示層中文對映（DB 值不變）、繳費頁與方案金額千分位。
+- 標註而非改造：`settings.timezone` 死設定、身分組不自動發放、寫死訊息不受模板控制。
+- Worker tests **<N> passed**（baseline +4）；typecheck／admin build／web build 皆綠。
+- ⚠️ **部署後必須重新註冊 Discord 指令**（設定 → 工具 → 註冊 Discord 指令）：`/繳費` 與 `/發起繳費`
+  的描述有改，未重註冊的話成員看到的仍是舊描述。
+- Deploy（main `<sha>`, 2026-07-31）: Worker Version `<id>` + Admin Pages `<url>` + Web Pages `<url>`
+  （web 這次有動：頁面標題、月份、千分位、至少填一項）。
+```
+
+**Do not `git add` this file.** Every `git add` in this plan names explicit paths precisely so this cannot happen by accident.
+
+- [ ] **Step 7: Tell the owner what needs a human**
+
+The PR body already carries the re-registration warning, but say it in the handoff message too, because it is the one step no CI check will catch: **after merging and deploying, open 設定 → 工具 → 「註冊 Discord 指令」 and run it once.** Discord caches command descriptions from registration time; until that runs, members still see the old `/繳費` description — the exact P0 this batch set out to fix.
+
+---
+
+## Self-Review
+
+**1. Spec coverage — issue #46, item by item.**
+
+| Spec item | Task |
+|---|---|
+| P0-7 移除（訂閱已暫停／已取消） | Task 1 Step 3 |
+| P0-8 `/繳費` 至少填一項 | Task 1 Step 4 |
+| D1 核准→驗證 | Task 2 |
+| D2 paid→已繳待驗 | Task 3 |
+| D3 本期→實際期別／此期 | Task 4 (§A.3) |
+| D4 期別 vs 月份 | Task 5 |
+| D5 開帳→開繳 | Task 4 Step 4 + Task 9 Step 5 (`env.ts` default) |
+| D6 帳單頻道→繳費頻道 | Task 7 Step 3 |
+| D7 按鈕名與文案對齊 | Task 4 Steps 2, 4 |
+| D8 支付渠道→繳費渠道 | Task 6 |
+| D9 使用者備註→成員備註 | Task 7 Step 2 |
+| D10 無憑證→純聲明 | Task 3 Step 3 + Task 7 Step 5 |
+| D11 enum 中文化 | Task 8 |
+| D12 `/繳費` 訊息的「本期」 | Task 4 Step 5 |
+| D13 至少填一項 | Task 9 |
+| D14 後台錯誤中文化 | Task 10 |
+| D15 競態錯誤中文化 | Task 11 |
+| D16 寫死 vs 模板（標註） | Task 14 Step 3 |
+| D17 格式（括號／破折號／…／進度字） | 括號 in Tasks 3, 6; 破折號 in Task 4 Step 4; `…`＋進度字 in Task 13 |
+| D18 前綴與分隔符 | Task 13 Steps 4, 5 (+ `admin.ts:665` in Task 2 Step 3) |
+| D19 千分位 | Task 12 |
+| D20 語氣（他／開始繳費／title／句末標點） | Task 7 Step 4, Task 9 Steps 4, 5 |
+| D21 身分組不自動發放 | Task 14 Step 2 |
+| D22 timezone 死設定（標註） | Task 14 Step 1 |
+| 測試斷言與 README 同步 | folded into every sweep; final audit + badge in Task 15 |
+
+**2. Placeholder scan.** `<N>` in Task 15 and `NN` in the deploy-state entry are *runtime-measured* values, each with the command that produces them named in the step immediately above — not TBDs. The baseline count is deliberately unspecified for the same reason: it depends on what A/B/C landed, and Task 1 Step 2 measures it. Every code step carries the actual code.
+
+**3. Type consistency.** Two new identifiers, both defined once and referenced nowhere else: `SOURCE_LABEL` (`Record<string, string>`, `PaymentDetail.tsx`) and `SUB_STATUSES` / `SUB_STATUS_LABEL` (`Manage.tsx`, shaped exactly like the file's existing `CHANNEL_TYPES` / `CHANNEL_TYPE_LABEL`). No task references a symbol another task did not define. `InvalidPaymentTransition` keeps its constructor signature `(paymentId: number, to: PaymentStatus)`, so its three existing call sites and four test references compile unchanged.
+
+**4. Two cross-batch hazards, both handled.** UX-A owns finding A5 (發起繳費's 「本期」) — Task 4 Step 1 tells the implementer to expect those hits to be already gone and to fix whatever survived. UX-C owns P0-6 (`routes/upload.ts` English errors on the member page) — §A.14 marks it explicitly out of scope so Task 10 does not widen into C's files.
+
+**5. Verified against the tree on 2026-07-31** (pre-A/B/C, so counts will move — the shape will not). Route paths confirmed against `buildAdminRouter()`: there is no `GET /admin/users/:id`, and initiate is `POST /admin/billing/initiate` with the period in the body. The hardcoded bind-message content lives in `routes/admin.ts`'s `discordBindMessage`, not in `adapters/discord/notify.ts` (which holds the *other* hardcoded message, `sendPaymentNudge`). `pnpm --filter <pkg> run typecheck` verified working. `settings.timezone` confirmed to have three occurrences, all in `env.ts`, and no admin UI control. `no_proof_count` confirmed as `status IN ('paid','verified') AND has_proof = 0`, which is why §A.8's label names both states. **Two things the audit's file list missed and this plan adds:** `packages/worker/scripts/register-commands.mjs` duplicates both Discord command descriptions (so P0-8 would have shipped half-fixed and `pnpm register` would have undone it), and both READMEs repeat the 已退訂 inaccuracy in their 重新同步 bullet.

From 6d95606dc699a7a01f13d91ff825d6c7509e04b1 Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:21:55 +0800
Subject: [PATCH 02/20] =?UTF-8?q?fix(admin-ui):=20=E5=90=8C=E6=AD=A5?=
 =?UTF-8?q?=E9=A0=90=E8=A6=BD=E7=9A=84=E3=80=8C=E7=A7=BB=E9=99=A4=E3=80=8D?=
 =?UTF-8?q?=E6=A8=99=E9=A1=8C=E4=B8=8D=E5=86=8D=E8=AA=A4=E5=B0=8E=20(#46?=
 =?UTF-8?q?=20P0-7)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

「移除（已退訂）」會讓管理員以為那些人主動退訂了，但實際條件是
訂閱狀態不是 active——包含被暫停（CSV 匯入填 FALSE）與已取消兩種，
兩者的處理方式完全不同。改為「移除（訂閱已暫停／已取消）」。

P0-8（/繳費 指令描述的「可選」）已由 #45 的 payCommand 工廠修掉，
本批次依計劃跳過。
---
 packages/admin/src/views/Payments.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/admin/src/views/Payments.tsx b/packages/admin/src/views/Payments.tsx
index 5e0e7f7..a1fea92 100644
--- a/packages/admin/src/views/Payments.tsx
+++ b/packages/admin/src/views/Payments.tsx
@@ -244,7 +244,7 @@ function SyncModal({ period, onClose, onDone }: { period: string; onClose: () =>
             <Stat label="🔒 保留(已繳)" value={diff.frozen_count} />
           </div>
           {diff.add.length > 0 && <DiffList title="新增" rows={diff.add.map((a) => `${a.user_name}·${a.plan_name} NT$${a.amount.toLocaleString()}`)} />}
-          {diff.remove.length > 0 && <DiffList title="移除（已退訂）" rows={diff.remove.map((a) => `${a.user_name}·${a.plan_name} NT$${a.amount.toLocaleString()}`)} />}
+          {diff.remove.length > 0 && <DiffList title="移除（訂閱已暫停／已取消）" rows={diff.remove.map((a) => `${a.user_name}·${a.plan_name} NT$${a.amount.toLocaleString()}`)} />}
           {diff.reprice.length > 0 && <DiffList title="改價" rows={diff.reprice.map((a) => `${a.user_name}·${a.plan_name} ${a.from}→${a.to}`)} />}
           {boundAdds.length > 0 && (
             <label style={{ display: "flex", gap: 8, alignItems: "center", margin: "12px 0" }}>

From ba26fd766ef07ef31ce252cb9d736cf309b88c3f Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:24:15 +0800
Subject: [PATCH 03/20] =?UTF-8?q?refactor(copy):=20=E6=A0=B8=E5=87=86=20?=
 =?UTF-8?q?=E2=86=92=20=E9=A9=97=E8=AD=89=EF=BC=8C=E5=8B=95=E4=BD=9C?=
 =?UTF-8?q?=E8=88=87=E7=8B=80=E6=85=8B=E7=94=A8=E8=A9=9E=E7=B5=B1=E4=B8=80?=
 =?UTF-8?q?=20(#46=20D1)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                        |  6 +++---
 README.zh-TW.md                                  |  8 ++++----
 packages/admin/src/views/MemberReview.tsx        | 16 ++++++++--------
 packages/admin/src/views/PaymentDetail.tsx       |  2 +-
 packages/admin/src/views/Payments.tsx            |  2 +-
 packages/worker/src/core/payments.ts             |  2 +-
 packages/worker/src/core/receipt.ts              |  4 ++--
 packages/worker/src/routes/admin.ts              |  4 ++--
 .../worker/test/core/payments-verify-all.test.ts |  2 +-
 .../worker/test/routes/payments-review.test.ts   |  4 ++--
 10 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/README.md b/README.md
index 9cf062d..26d7341 100644
--- a/README.md
+++ b/README.md
@@ -68,14 +68,14 @@ pre-wired) and a multi-workspace-ready data model, so it generalizes well beyond
   amounts (price changes never rewrite history). A **重新同步本期帳單** action re-aligns an opened
   period's bills to the current roster/price (preview before applying), optionally pinging newly-added members.
   Tapping a member's name (or a submission alert) opens the **成員×期別合併審核**: the shared
-  screenshot once, every settled row, and one 一鍵全部核准 button. The queue, that view and the
+  screenshot once, every settled row, and one 一鍵全部驗證 button. The queue, that view and the
   review dialog all work on a phone.
 - 🔔 **Customizable notifications** — editable templates (with live preview + validation) for the
   billing-opened notice, the batched overdue reminder, and the persistent pay message.
 - 📲 **Submission alerts** — when a member submits a payment, push the owner a Bark and/or webhook
   notice (Discord / Google Chat / Slack — body shape auto-detected by host) with a deep link
   straight to that member's period review — one submit settles every subscription, so the link
-  opens all of them together with a 一鍵全部核准 button.
+  opens all of them together with a 一鍵全部驗證 button.
 - ⏰ **Daily cron, idempotent** — opens billing, sends an overdue reminder **every day** until a
   period has no unpaid bills left, and enforces screenshot retention — all deduped through
   `notification_logs`.
@@ -248,7 +248,7 @@ payment screenshots) and fill in `wrangler.toml` accordingly — `database_id`,
   the payments page, not here.
 - **Submission alerts** — set a Bark device key and/or a webhook (Discord / Google Chat / Slack) under
   Settings → 繳費通知; each new submission then pushes you a notice that opens that member's whole
-  period for review (shared screenshot once, every row listed, 一鍵全部核准), phone-friendly. Both
+  period for review (shared screenshot once, every row listed, 一鍵全部驗證), phone-friendly. Both
   are optional and best-effort (a slow or failing endpoint never blocks the payment).
 - **Daily cron** (01:00 UTC = 09:00 Asia/Taipei) — idempotently opens each period's bills, posts the
   billing-opened notice (tagging plan roles), sends **an overdue reminder every day** listing the
diff --git a/README.zh-TW.md b/README.zh-TW.md
index 581f06e..3afa06d 100644
--- a/README.zh-TW.md
+++ b/README.zh-TW.md
@@ -62,11 +62,11 @@ ChipPot 解決的是一個很具體的痛點：社團大量採購 OpenAI / Anthr
   **撤回驗證**（誤按的驗證可還原），且**當期金額凍結**（改價不會回頭改歷史帳）。**重新同步本期帳單**
   會把已開期別的帳單重新對齊目前名單／現價（先看差異預覽再套用），並可順便 @ 通知新加進來的成員。
   點成員名字（或從繳費推播點進來）會開啟**成員×期別合併審核**：共用截圖只出現一次、當期每一筆都列出，
-  已繳待驗的可一鍵全部核准。佇列、這個畫面與審核彈窗在手機上都能用。
+  已繳待驗的可一鍵全部驗證。佇列、這個畫面與審核彈窗在手機上都能用。
 - 🔔 **可自訂通知** — 開繳通知、整批逾期催繳、常駐繳費訊息三種文字皆可自訂模板（含即時預覽 + 格式驗證）。
 - 📲 **繳費推播** — 成員送出繳費時，可推一則 Bark 和／或 webhook（Discord／Google Chat／Slack，body
   格式依主機自動判斷）給擁有者，並帶上直接跳到該成員該期審核的深連結——一次送出會結清所有訂閱，
-  所以連結會把它們一起打開，可一鍵全部核准。
+  所以連結會把它們一起打開，可一鍵全部驗證。
 - ⏰ **每日 cron、冪等** — 自動開帳、進入催繳後**每天發一則**整批催繳（直到全部繳完）、執行
   截圖保存期清理，全部經 `notification_logs` 去重。
 - 🛡️ **Access 保護的後台** — 整個後台主機在 Cloudflare Access 後（email OTP）；SPA 與其 API 同源，
@@ -208,7 +208,7 @@ pnpm --filter @chippot/worker register
   **申報渠道**（對帳最常看的一欄，不必再點進詳情；「來源」移到詳情彈窗），沒設定 R2 時整欄隱藏「憑證」。
   點開某筆可看截圖、渠道、退回、改金額、刪截圖，也可**撤回驗證**（還原誤按的驗證）或**刪除整筆帳單**。
 - **成員×期別合併審核** — 點表格裡的成員名字（或從繳費推播的深連結進來），把該成員當期的帳單收在
-  同一頁：共用截圖只顯示一次、每一筆都列出且可單筆核准／退回，已繳待驗的可一鍵掃過去核准（還有
+  同一頁：共用截圖只顯示一次、每一筆都列出且可單筆驗證／退回，已繳待驗的可一鍵掃過去驗證（還有
   待繳／已退回的會明講需要逐筆處理）。手機版把繳費表改成堆疊卡片、彈窗改成底部抽屜。
 - **重新同步本期帳單** — 在繳費審核頁，把目前篩選的**已開期別**帳單對齊現在的名單／價格
   （補缺漏 · 移除已退訂 · 待繳改現價 · 已繳／已驗證凍結）；先出差異預覽再套用，並可勾選用繳費按鈕
@@ -227,7 +227,7 @@ pnpm --filter @chippot/worker register
   下次（含每日 cron）才送得出去。
   要把期別改回未開繳請用「繳費審核 → 收回本期開繳」。
 - **繳費通知** — 在設定 → 繳費通知填 Bark 裝置金鑰和／或 webhook（Discord／Google Chat／Slack），
-  之後每筆新送出都會推你一則，點開就是該成員當期的合併審核（共用截圖一次、每筆列出、可一鍵核准），
+  之後每筆新送出都會推你一則，點開就是該成員當期的合併審核（共用截圖一次、每筆列出、可一鍵驗證），
   手機上也好操作。存檔前可先按**送出測試**確認打得通。兩者都選填、best-effort（端點慢或掛掉都不會
   卡住成員繳費）。
 - **每日 cron**（01:00 UTC = 台北 09:00）— 冪等地開出各期帳單、發開繳通知（tag 方案身分組）、
diff --git a/packages/admin/src/views/MemberReview.tsx b/packages/admin/src/views/MemberReview.tsx
index 4cf1514..1bebf56 100644
--- a/packages/admin/src/views/MemberReview.tsx
+++ b/packages/admin/src/views/MemberReview.tsx
@@ -7,7 +7,7 @@ import { PaymentDetail } from "./PaymentDetail";
  * Aggregate review for ONE member × ONE period — where a payment-submission notification lands
  * (#payments?user=<id>&period=<YYYY-MM>). One member submit settles one payment row per active
  * subscription, all sharing one screenshot, so this shows the screenshot once and lets the owner
- * approve the whole period with a single tap (一鍵全部核准); per-row 核准／退回 stay available for
+ * approve the whole period with a single tap (一鍵全部驗證); per-row 驗證／退回 stay available for
  * the mixed cases. Laid out mobile-first: everything stacks, actions are thumb-sized.
  */
 export function MemberReview({ userId, period, tags, onBack }: {
@@ -39,7 +39,7 @@ export function MemberReview({ userId, period, tags, onBack }: {
     setBusy(true); setErr(null); setDone(null);
     try { setDone(await fn()); }
     catch (e) { setErr((e as Error).message); }
-    // Reload on failure too: 一鍵全部核准 commits row by row, so an aborted batch really did verify
+    // Reload on failure too: 一鍵全部驗證 commits row by row, so an aborted batch really did verify
     // part of the list (the banner says how many) and the rows must not stay stale.
     list.reload();
     setBusy(false);
@@ -84,14 +84,14 @@ export function MemberReview({ userId, period, tags, onBack }: {
               onClick={() => run(async () => {
                 const r = await api.verifyAll(userId, period);
                 return outstanding.length > 0
-                  ? `已核准 ${r.verified} 筆，另 ${outstanding.length} 筆（待繳／已退回）需逐筆處理`
-                  : `已核准 ${r.verified} 筆`;
+                  ? `已驗證 ${r.verified} 筆，另 ${outstanding.length} 筆（待繳／已退回）需逐筆處理`
+                  : `已驗證 ${r.verified} 筆`;
               })}
             >
               {/* 全部 is only true when every row is 已繳待驗; otherwise name the subset the sweep covers. */}
               <IconCheck />{busy ? "處理中…" : outstanding.length > 0
-                ? `核准已繳待驗（${reviewable.length} 筆）`
-                : `一鍵全部核准（${reviewable.length} 筆）`}
+                ? `驗證已繳待驗（${reviewable.length} 筆）`
+                : `一鍵全部驗證（${reviewable.length} 筆）`}
             </button>
             {outstanding.length > 0 && (
               <button
@@ -130,9 +130,9 @@ export function MemberReview({ userId, period, tags, onBack }: {
                 </div>
                 <div className="mrow__acts">
                   {["pending", "paid", "rejected"].includes(p.status) && (
-                    <button className="btn iconlbl" disabled={busy} title="標記已驗證（帶入申報渠道）"
+                    <button className="btn iconlbl" disabled={busy} title="標記為「已驗證」（帶入申報渠道）"
                       onClick={() => run(async () => { await api.verify(p.id, null); return null; })}>
-                      <IconCheck />核准
+                      <IconCheck />驗證
                     </button>
                   )}
                   {["pending", "paid"].includes(p.status) && (
diff --git a/packages/admin/src/views/PaymentDetail.tsx b/packages/admin/src/views/PaymentDetail.tsx
index e497102..4adaf76 100644
--- a/packages/admin/src/views/PaymentDetail.tsx
+++ b/packages/admin/src/views/PaymentDetail.tsx
@@ -53,7 +53,7 @@ export function PaymentDetail({ payment, tags, onClose, onDone }: { payment: Pay
       )}
 
       <div className="btn-row">
-        {canVerify && <button className="btn btn--primary" disabled={busy} onClick={() => run(() => api.verify(payment.id, tagId === "" ? null : Number(tagId)))}>標記已驗證</button>}
+        {canVerify && <button className="btn btn--primary" disabled={busy} onClick={() => run(() => api.verify(payment.id, tagId === "" ? null : Number(tagId)))}>驗證</button>}
         {payment.status === "verified" && <button className="btn" disabled={busy} onClick={() => run(() => api.unverify(payment.id))}>撤回驗證</button>}
         {payment.screenshot_key && <button className="btn btn--danger" disabled={busy} onClick={() => run(() => api.deleteProof(payment.id))}>刪除截圖</button>}
       </div>
diff --git a/packages/admin/src/views/Payments.tsx b/packages/admin/src/views/Payments.tsx
index a1fea92..1c607df 100644
--- a/packages/admin/src/views/Payments.tsx
+++ b/packages/admin/src/views/Payments.tsx
@@ -335,7 +335,7 @@ function QuickVerify({ id, onDone }: { id: number; onDone: () => void }) {
     catch { setErr(true); setBusy(false); }
   }
   return (
-    <button className="btn iconlbl" disabled={busy} onClick={run} title="標記已驗證（帶入申報渠道）">
+    <button className="btn iconlbl" disabled={busy} onClick={run} title="標記為「已驗證」（帶入申報渠道）">
       {busy ? "…" : err ? <><IconX />重試</> : <><IconCheck />驗證</>}
     </button>
   );
diff --git a/packages/worker/src/core/payments.ts b/packages/worker/src/core/payments.ts
index 6b191bd..8ee73eb 100644
--- a/packages/worker/src/core/payments.ts
+++ b/packages/worker/src/core/payments.ts
@@ -163,7 +163,7 @@ export interface VerifyUserPeriodResult {
 }
 
 /**
- * 一鍵全部核准: verify every payment this member has in the period that is waiting for review
+ * 一鍵全部驗證: verify every payment this member has in the period that is waiting for review
  * (status 'paid' — the 已繳待驗 queue). One member submit settles one row per active subscription
  * sharing one screenshot, so the owner should be able to approve them together.
  *
diff --git a/packages/worker/src/core/receipt.ts b/packages/worker/src/core/receipt.ts
index 67e8018..eea1b7a 100644
--- a/packages/worker/src/core/receipt.ts
+++ b/packages/worker/src/core/receipt.ts
@@ -8,7 +8,7 @@ import {
 export interface ReceiptRequest {
   workspaceId: number;
   kind: ReceiptKind;
-  /** Bills to announce. Callers pass one member's rows: a 退回 is one bill, 一鍵全部核准 is one
+  /** Bills to announce. Callers pass one member's rows: a 退回 is one bill, 一鍵全部驗證 is one
    *  member × one period. Anything outside the first row's (user, period) is dropped. */
   paymentIds: number[];
   reason?: string | null;
@@ -60,7 +60,7 @@ export async function announcePaymentReceipt(
   const head = rows[0]!;
   const mine = rows.filter((r) => r.user_id === head.user_id && r.period === head.period);
 
-  // Claim per bill, send once: 一鍵全部核准 verifies N rows and must produce ONE message, not N.
+  // Claim per bill, send once: 一鍵全部驗證 verifies N rows and must produce ONE message, not N.
   const claimed: ReceiptRow[] = [];
   for (const r of mine) {
     const won = await claimNotification(env.DB, {
diff --git a/packages/worker/src/routes/admin.ts b/packages/worker/src/routes/admin.ts
index 1362dea..5912322 100644
--- a/packages/worker/src/routes/admin.ts
+++ b/packages/worker/src/routes/admin.ts
@@ -667,7 +667,7 @@ async function verifyPaymentHandler(req: Request, env: Env, ctx: RouteCtx): Prom
 }
 
 /**
- * 一鍵全部核准: verify every reviewable payment this member has in the period. A single member
+ * 一鍵全部驗證: verify every reviewable payment this member has in the period. A single member
  * submit settles one row per active subscription (one shared screenshot), so the review that used
  * to take N clicks is one call. Channel defaulting and the state machine match single verify — see
  * verifyUserPeriod. Audit trail: one payment.verify per row (identical to single verify) plus one
@@ -719,7 +719,7 @@ async function verifyAllHandler(req: Request, env: Env, ctx: RouteCtx): Promise<
     // matters more than the summary row (the per-row audits above are already committed).
     await writeSummary({ partial: true, error: message })
       .catch((err) => console.error("verify_all partial summary audit failed", err));
-    return errorResponse(500, `批次核准中斷，已核准 ${paymentIds.length} 筆：${message}`, {
+    return errorResponse(500, `批次驗證中斷，已驗證 ${paymentIds.length} 筆：${message}`, {
       verified: paymentIds.length, payment_ids: paymentIds,
     });
   }
diff --git a/packages/worker/test/core/payments-verify-all.test.ts b/packages/worker/test/core/payments-verify-all.test.ts
index f34f86a..02c64d8 100644
--- a/packages/worker/test/core/payments-verify-all.test.ts
+++ b/packages/worker/test/core/payments-verify-all.test.ts
@@ -66,7 +66,7 @@ beforeAll(async () => {
   ]);
 });
 
-describe("verifyUserPeriod (一鍵全部核准)", () => {
+describe("verifyUserPeriod (一鍵全部驗證)", () => {
   it("verifies every 'paid' row of that member × period, each keeping its own declared channel", async () => {
     const r = await verifyUserPeriod(env.DB, { workspaceId: WS, userId: U, period: PERIOD, verifiedBy: ACTOR });
     expect(r.verified.map((v) => v.after.id).sort()).toEqual([P_TAG, P_NOTAG, P_FOREIGN, P_TAG2].sort());
diff --git a/packages/worker/test/routes/payments-review.test.ts b/packages/worker/test/routes/payments-review.test.ts
index 459952b..28c5344 100644
--- a/packages/worker/test/routes/payments-review.test.ts
+++ b/packages/worker/test/routes/payments-review.test.ts
@@ -316,7 +316,7 @@ describe("POST /admin/payments/:id/reject 會發回條", () => {
 });
 
 /**
- * Task 4: 一鍵全部核准 verifies N bills but must post ONE receipt, not N — and only when the
+ * Task 4: 一鍵全部驗證 verifies N bills but must post ONE receipt, not N — and only when the
  * workspace opted into verify receipts.
  */
 describe("POST /admin/payments/verify-all 的回條只發一則", () => {
@@ -336,7 +336,7 @@ describe("POST /admin/payments/verify-all 的回條只發一則", () => {
     ]);
   });
 
-  it("兩筆一起核准，只送出一則回條，但兩筆的 slot 都佔用", async () => {
+  it("兩筆一起驗證，只送出一則回條，但兩筆的 slot 都佔用", async () => {
     const posts = vi.fn(async () => new Response(JSON.stringify({ id: "m-9405" }), { status: 200 }));
     vi.stubGlobal("fetch", posts);
     const res = await call("POST", "/admin/payments/verify-all", { user_id: U_V, period: PERIOD_V });

From 47868a9fc1a3b890bd84cd93b790e817e90e5be8 Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:25:47 +0800
Subject: [PATCH 04/20] =?UTF-8?q?refactor(copy):=20paid=20=E7=8B=80?=
 =?UTF-8?q?=E6=85=8B=E4=B8=80=E5=BE=8B=E9=A1=AF=E7=A4=BA=E3=80=8C=E5=B7=B2?=
 =?UTF-8?q?=E7=B9=B3=E5=BE=85=E9=A9=97=E3=80=8D=EF=BC=8C=E5=87=8D=E7=B5=90?=
 =?UTF-8?q?=E7=AD=86=E6=95=B8=E6=94=B9=E7=82=BA=E3=80=8C=E5=B7=B2=E7=B9=B3?=
 =?UTF-8?q?=E5=BE=85=E9=A9=97=E3=80=81=E5=B7=B2=E9=A9=97=E8=AD=89=E3=80=8D?=
 =?UTF-8?q?=20(#46=20D2)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.zh-TW.md                                            | 2 +-
 packages/admin/src/ui.tsx                                  | 2 +-
 packages/admin/src/views/Dashboard.tsx                     | 4 ++--
 packages/admin/src/views/Payments.tsx                      | 6 +++---
 packages/admin/src/views/Settings.tsx                      | 2 +-
 packages/worker/test/core/billing-initiate-preview.test.ts | 2 +-
 6 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/README.zh-TW.md b/README.zh-TW.md
index 3afa06d..c389041 100644
--- a/README.zh-TW.md
+++ b/README.zh-TW.md
@@ -84,7 +84,7 @@ ChipPot 解決的是一個很具體的痛點：社團大量採購 OpenAI / Anthr
   ephemeral：列出本期各方案 + 總額 + 渠道下拉
         │  （/繳費 或網頁可另附截圖／備註）
         ▼
-  settleUserPeriod() — 把每筆 pending/rejected 標記為「已繳」，共用同一張截圖 key
+  settleUserPeriod() — 把每筆 pending/rejected 標記為「已繳待驗」，共用同一張截圖 key
         │
         ▼
   後台看板 → 審核佇列 → ✅ 驗證（自動帶入申報渠道）
diff --git a/packages/admin/src/ui.tsx b/packages/admin/src/ui.tsx
index 8b7b4ef..46aae00 100644
--- a/packages/admin/src/ui.tsx
+++ b/packages/admin/src/ui.tsx
@@ -21,7 +21,7 @@ export function useAsync<T>(fn: () => Promise<T>, deps: unknown[]) {
 }
 
 const STATUS_LABEL: Record<string, string> = {
-  pending: "待繳", paid: "已繳", verified: "已驗證", rejected: "已退回",
+  pending: "待繳", paid: "已繳待驗", verified: "已驗證", rejected: "已退回",
 };
 export function StatusBadge({ status }: { status: string }) {
   return <span className={`badge badge--${status}`}>{STATUS_LABEL[status] ?? status}</span>;
diff --git a/packages/admin/src/views/Dashboard.tsx b/packages/admin/src/views/Dashboard.tsx
index 0d6f67f..a57569a 100644
--- a/packages/admin/src/views/Dashboard.tsx
+++ b/packages/admin/src/views/Dashboard.tsx
@@ -30,7 +30,7 @@ export function Dashboard() {
             <Stat label="已退回" value={data.status_counts.rejected} />
             <Stat label="應收總額" value={`NT$${data.total_amount_due.toLocaleString()}`} />
             <Stat label="已驗證金額" value={`NT$${data.verified_amount.toLocaleString()}`} accent />
-            <Stat label="無憑證(已繳)" value={data.no_proof_count} />
+            <Stat label="純聲明（已繳待驗、已驗證）" value={data.no_proof_count} />
           </div>
 
           <Card title="各方案">
@@ -38,7 +38,7 @@ export function Dashboard() {
               <table>
                 <caption className="sr-only">各方案本期收款統計</caption>
                 <thead>
-                  <tr><th scope="col">方案</th><th scope="col" className="right">筆數</th><th scope="col" className="right">待繳</th><th scope="col" className="right">已繳</th><th scope="col" className="right">已驗證</th><th scope="col" className="right">應收</th><th scope="col" className="right">已驗證金額</th></tr>
+                  <tr><th scope="col">方案</th><th scope="col" className="right">筆數</th><th scope="col" className="right">待繳</th><th scope="col" className="right">待驗</th><th scope="col" className="right">已驗證</th><th scope="col" className="right">應收</th><th scope="col" className="right">已驗證金額</th></tr>
                 </thead>
                 <tbody>
                   {data.by_plan.length === 0 && <tr><td colSpan={7}><Empty>本期尚無資料</Empty></td></tr>}
diff --git a/packages/admin/src/views/Payments.tsx b/packages/admin/src/views/Payments.tsx
index 1c607df..b17203a 100644
--- a/packages/admin/src/views/Payments.tsx
+++ b/packages/admin/src/views/Payments.tsx
@@ -241,7 +241,7 @@ function SyncModal({ period, onClose, onDone }: { period: string; onClose: () =>
             <Stat label="➕ 新增" value={diff.add.length} />
             <Stat label="➖ 移除" value={diff.remove.length} />
             <Stat label="🔄 改價" value={diff.reprice.length} />
-            <Stat label="🔒 保留(已繳)" value={diff.frozen_count} />
+            <Stat label="🔒 保留（已繳待驗、已驗證）" value={diff.frozen_count} />
           </div>
           {diff.add.length > 0 && <DiffList title="新增" rows={diff.add.map((a) => `${a.user_name}·${a.plan_name} NT$${a.amount.toLocaleString()}`)} />}
           {diff.remove.length > 0 && <DiffList title="移除（訂閱已暫停／已取消）" rows={diff.remove.map((a) => `${a.user_name}·${a.plan_name} NT$${a.amount.toLocaleString()}`)} />}
@@ -291,7 +291,7 @@ function RetractModal({ period, onClose, onDone }: { period: string; onClose: ()
     setBusy(true); setErr(null);
     try {
       const r = await api.retractPeriodBilling(period, { dry_run: false }) as RetractApplied;
-      setDone(`已收回 ${period}：刪除 ${r.applied.removed} 筆帳單、保留 ${r.applied.frozen} 筆已繳。此期已回到未開繳狀態。`);
+      setDone(`已收回 ${period}：刪除 ${r.applied.removed} 筆帳單、保留 ${r.applied.frozen} 筆已繳待驗／已驗證。此期已回到未開繳狀態。`);
       onDone();
     } catch (e) { setErr((e as Error).message); setBusy(false); }
   }
@@ -306,7 +306,7 @@ function RetractModal({ period, onClose, onDone }: { period: string; onClose: ()
         <>
           <div className="stats">
             <Stat label="🗑️ 將刪除" value={preview.removed.length} />
-            <Stat label="🔒 保留(已繳)" value={preview.frozen_count} />
+            <Stat label="🔒 保留（已繳待驗、已驗證）" value={preview.frozen_count} />
           </div>
           {preview.removed.length > 0
             ? <DiffList title="將刪除的帳單（未繳／已退回）" rows={preview.removed.map((a) => `${a.user_name}·${a.plan_name} NT$${a.amount.toLocaleString()}`)} />
diff --git a/packages/admin/src/views/Settings.tsx b/packages/admin/src/views/Settings.tsx
index 68f7359..6e79890 100644
--- a/packages/admin/src/views/Settings.tsx
+++ b/packages/admin/src/views/Settings.tsx
@@ -575,7 +575,7 @@ function InitiateModal({ plans, billingDay, dirty, onClose }: { plans: { id: num
             <Stat label="➕ 新增帳單" value={preview.create.length} />
             <Stat label="🔄 改價" value={preview.reprice.length} />
             <Stat label="🏷️ 方案改價" value={preview.plan_changes.length} />
-            <Stat label="🔒 保留(已繳)" value={preview.frozen_count} />
+            <Stat label="🔒 保留（已繳待驗、已驗證）" value={preview.frozen_count} />
           </div>
           {preview.plan_changes.length > 0 && (
             <DiffList title="方案定價（永久生效）" rows={preview.plan_changes.map((c) => `${c.plan_name} NT$${c.from.toLocaleString()} → NT$${c.to.toLocaleString()}`)} />
diff --git a/packages/worker/test/core/billing-initiate-preview.test.ts b/packages/worker/test/core/billing-initiate-preview.test.ts
index 899ced4..16a11a0 100644
--- a/packages/worker/test/core/billing-initiate-preview.test.ts
+++ b/packages/worker/test/core/billing-initiate-preview.test.ts
@@ -69,7 +69,7 @@ describe("previewBillingInitiate", () => {
     expect(p.plan_changes).toEqual([]); // 價格已在上一步寫入，現在沒有差異
   });
 
-  it("已繳的帳單算進 frozen_count，不出現在 reprice", async () => {
+  it("已繳待驗的帳單算進 frozen_count，不出現在 reprice", async () => {
     await env.DB.prepare("UPDATE payments SET status='paid' WHERE workspace_id=? AND period=? AND subscription_id=?")
       .bind(WS, PERIOD, SUB_B).run();
     const p = await previewBillingInitiate(env, WS, PERIOD, { amounts: [{ plan_id: PLAN_B, amount: 999 }] });

From 22818d858efb79e1e13aaf198880ee69a06e6cae Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:28:12 +0800
Subject: [PATCH 05/20] =?UTF-8?q?refactor(copy):=20=E6=94=AF=E4=BB=98?=
 =?UTF-8?q?=E6=B8=A0=E9=81=93=E2=86=92=E7=B9=B3=E8=B2=BB=E6=B8=A0=E9=81=93?=
 =?UTF-8?q?=E3=80=81=E5=B8=B3=E5=96=AE=E9=A0=BB=E9=81=93=E2=86=92=E7=B9=B3?=
 =?UTF-8?q?=E8=B2=BB=E9=A0=BB=E9=81=93=E3=80=81=E4=BD=BF=E7=94=A8=E8=80=85?=
 =?UTF-8?q?=E2=86=92=E6=88=90=E5=93=A1=20(#46=20D6/D8/D9)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

三個詞在同一組正規用詞裡，一次掃齊（§A.6、§A.7）：

- 支付渠道 → 繳費渠道（導覽標籤、Card 標題、刪除確認、caption）共 6 處。
  表格短欄名「渠道」是 §A.6 明訂的合法簡稱，維持不動。
- 帳單頻道 → 繳費頻道（4 處）。兩個名字指的都是同一個
  discord_billing_channel_id，而設定頁的欄位標籤本來就叫「繳費頻道 ID」。
- 使用者備註 → 成員備註（1 處，與 MemberReview 的「成員備註：」對齊）。
  packages/** 的「使用者」歸零。

「夥伴」依 §A.7 保留——那是成員面的招呼語（web 的「嗨，{name}」與預設催繳模板），
稽核明確允許。
---
 README.zh-TW.md                            | 4 ++--
 packages/admin/src/App.tsx                 | 4 ++--
 packages/admin/src/views/Dashboard.tsx     | 2 +-
 packages/admin/src/views/Manage.tsx        | 6 +++---
 packages/admin/src/views/MemberReview.tsx  | 2 +-
 packages/admin/src/views/PaymentDetail.tsx | 2 +-
 packages/admin/src/views/Settings.tsx      | 2 +-
 7 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/README.zh-TW.md b/README.zh-TW.md
index c389041..74e4a9e 100644
--- a/README.zh-TW.md
+++ b/README.zh-TW.md
@@ -45,7 +45,7 @@ ChipPot 解決的是一個很具體的痛點：社團大量採購 OpenAI / Anthr
 
 - 💳 **Discord 內繳費** — 常駐「繳費」按鈕 → 選渠道 → 完成。一次送出就把該成員**當期所有訂閱**
   一起結清（多方案加總）。
-- 🔗 **自助綁定** — 成員自己把 Discord 帳號接到名單：`/綁定`、繳費按鈕，或帳單頻道裡常駐的公開
+- 🔗 **自助綁定** — 成員自己把 Discord 帳號接到名單：`/綁定`、繳費按鈕，或繳費頻道裡常駐的公開
   **綁定 Discord** 按鈕。名單超過 Discord 選單的 25 筆上限時改用搜尋（`/綁定` 的「名字」自動完成，
   或按鈕跳出的搜尋彈窗）。管理員也能手動指定 ID，或**解除綁定**讓成員重新綁。
 - 🧾 **審核結果會回到成員手上** — 退回一定在頻道 @ 當事人並附上原因（成員唯一知道要重繳的管道，
@@ -218,7 +218,7 @@ pnpm --filter @chippot/worker register
   「預開下期」是要自己勾的次要選項。可從後台「設定」或 Discord 的 `/發起繳費` 觸發
   （後者可帶 `期別`，方案超過 5 個時會直接請你改用後台——開表單與送出表單都會重驗一次）。
   Discord 沒有回應成功時回報的是「通知發送失敗」而不是已發送：帳單與開繳狀態照實留著，可到推播狀態補送。
-- **綁定按鈕** — 設定 → 工具 → 在帳單頻道張貼一則常駐的公開**綁定 Discord** 按鈕，讓成員主動綁
+- **綁定按鈕** — 設定 → 工具 → 在繳費頻道張貼一則常駐的公開**綁定 Discord** 按鈕，讓成員主動綁
   （第一次繳費時綁定仍然保留為 fallback）。
 - **推播狀態** — 看板顯示開繳／逾期通知是否已發，並提供 **重發開繳通知**（只重貼公告，不建帳單、
   不會讓期別短暫變回未開繳）、**催繳未繳成員**（@ 全部未繳者，與只 @ 逾期者的每日 cron 不同）
diff --git a/packages/admin/src/App.tsx b/packages/admin/src/App.tsx
index 7f705cd..360b13b 100644
--- a/packages/admin/src/App.tsx
+++ b/packages/admin/src/App.tsx
@@ -12,7 +12,7 @@ const VIEWS = [
   { id: "users", label: "成員", el: <Users /> },
   { id: "subscriptions", label: "訂閱", el: <Subscriptions /> },
   { id: "plans", label: "方案", el: <Plans /> },
-  { id: "tags", label: "支付渠道", el: <ChannelTags /> },
+  { id: "tags", label: "繳費渠道", el: <ChannelTags /> },
   { id: "settings", label: "設定", el: <Settings /> },
 ];
 
@@ -53,7 +53,7 @@ export default function App() {
   }, []);
 
   // The mobile tab strip hides 41% of its tabs at 375px; without this the highlighted tab for
-  // 方案 / 支付渠道 / 設定 sits past the right edge, so the strip never shows where you are.
+  // 方案 / 繳費渠道 / 設定 sits past the right edge, so the strip never shows where you are.
   // scrollLeft rather than scrollIntoView: the latter can also scroll the document vertically.
   const navRef = useRef<HTMLElement>(null);
   useEffect(() => {
diff --git a/packages/admin/src/views/Dashboard.tsx b/packages/admin/src/views/Dashboard.tsx
index a57569a..d572820 100644
--- a/packages/admin/src/views/Dashboard.tsx
+++ b/packages/admin/src/views/Dashboard.tsx
@@ -63,7 +63,7 @@ export function Dashboard() {
           <Card title="依渠道分組（已驗證）">
             <div className="tbl">
               <table>
-                <caption className="sr-only">依支付渠道分組的已驗證款項</caption>
+                <caption className="sr-only">依繳費渠道分組的已驗證款項</caption>
                 <thead><tr><th scope="col">渠道</th><th scope="col" className="right">筆數</th><th scope="col" className="right">金額</th></tr></thead>
                 <tbody>
                   {data.by_channel_tag.length === 0 && <tr><td colSpan={3}><Empty>本期尚無已驗證款項</Empty></td></tr>}
diff --git a/packages/admin/src/views/Manage.tsx b/packages/admin/src/views/Manage.tsx
index 754d0f3..58ed37d 100644
--- a/packages/admin/src/views/Manage.tsx
+++ b/packages/admin/src/views/Manage.tsx
@@ -360,10 +360,10 @@ export function ChannelTags() {
   return (
     <>
       {(error || actErr) && <ErrorNote message={(error || actErr)!} onRetry={reload} />}
-      <Card title="支付渠道（對帳分組）" action={<button className="btn btn--primary" onClick={() => setEdit(null)}>新增渠道</button>}>
+      <Card title="繳費渠道（對帳分組）" action={<button className="btn btn--primary" onClick={() => setEdit(null)}>新增渠道</button>}>
         <div className="tbl tbl--pin-first tbl--pin-last">
           <table className="tbl-cards">
-            <caption className="sr-only">支付渠道清單</caption>
+            <caption className="sr-only">繳費渠道清單</caption>
             <thead><tr><th scope="col">名稱</th><th scope="col">類型</th><th scope="col" className="right">排序</th><th scope="col">狀態</th><th scope="col"><span className="sr-only">操作</span></th></tr></thead>
             <tbody>
               {loading && <tr><td colSpan={5}><Empty>載入中…</Empty></td></tr>}
@@ -393,7 +393,7 @@ export function ChannelTags() {
       {del && (
         <ConfirmDanger
           title={`刪除渠道 · ${del.name}`}
-          message={`確定刪除此支付渠道？此操作無法復原。`}
+          message={`確定刪除此繳費渠道？此操作無法復原。`}
           onClose={() => setDel(null)}
           onConfirm={async () => { await api.deleteChannelTag(del.id); setDel(null); reload(); }}
         />
diff --git a/packages/admin/src/views/MemberReview.tsx b/packages/admin/src/views/MemberReview.tsx
index 1bebf56..aeb12f5 100644
--- a/packages/admin/src/views/MemberReview.tsx
+++ b/packages/admin/src/views/MemberReview.tsx
@@ -97,7 +97,7 @@ export function MemberReview({ userId, period, tags, onBack }: {
               <button
                 className="btn"
                 disabled={busy}
-                title="在帳單頻道 @ 這位成員，列出他這一期還沒繳的項目"
+                title="在繳費頻道 @ 這位成員，列出他這一期還沒繳的項目"
                 onClick={() => run(async () => {
                   // force: the admin is deliberately asking for another ping, which is the one
                   // sanctioned way past the per-period nudge dedup (core/nudge.ts).
diff --git a/packages/admin/src/views/PaymentDetail.tsx b/packages/admin/src/views/PaymentDetail.tsx
index 4adaf76..816415b 100644
--- a/packages/admin/src/views/PaymentDetail.tsx
+++ b/packages/admin/src/views/PaymentDetail.tsx
@@ -27,7 +27,7 @@ export function PaymentDetail({ payment, tags, onClose, onDone }: { payment: Pay
         <dt>金額</dt><dd><Money v={payment.amount} /></dd>
         <dt>應繳日</dt><dd className="mono">{payment.due_date}</dd>
         <dt>來源</dt><dd>{payment.source}</dd>
-        {payment.payment_note && (<><dt>使用者備註</dt><dd>{payment.payment_note}</dd></>)}
+        {payment.payment_note && (<><dt>成員備註</dt><dd>{payment.payment_note}</dd></>)}
         {payment.declared_channel_tag_name && (<><dt>申報渠道</dt><dd>{payment.declared_channel_tag_name}</dd></>)}
         {payment.channel_tag_name && (<><dt>認定渠道</dt><dd>{payment.channel_tag_name}</dd></>)}
         {payment.rejected_reason && (<><dt>退回原因</dt><dd>{payment.rejected_reason}</dd></>)}
diff --git a/packages/admin/src/views/Settings.tsx b/packages/admin/src/views/Settings.tsx
index 6e79890..4204fa7 100644
--- a/packages/admin/src/views/Settings.tsx
+++ b/packages/admin/src/views/Settings.tsx
@@ -285,7 +285,7 @@ export function Settings() {
       <Card title="工具" desc="點下去立即執行，不受上面的「儲存」控制">
         <div className="card__body">
           <ActionRow title="重建常駐繳費訊息" tag="立即執行" desc="在繳費頻道重新貼一則含「繳費」按鈕的常駐訊息。" state={payMsgState}><RebuildMessage onDone={(id) => setLive((s) => ({ ...s, pay: id }))} /></ActionRow>
-          <ActionRow title="張貼／更新綁定按鈕訊息" tag="立即執行" desc="在帳單頻道貼一則含「綁定 Discord」按鈕的公開訊息，讓成員主動綁定（開繳／催繳才能 @ 到他）。" state={bindMsgState}><RebuildBindMessage onDone={(id) => setLive((s) => ({ ...s, bind: id }))} /></ActionRow>
+          <ActionRow title="張貼／更新綁定按鈕訊息" tag="立即執行" desc="在繳費頻道貼一則含「綁定 Discord」按鈕的公開訊息，讓成員主動綁定（開繳／催繳才能 @ 到他）。" state={bindMsgState}><RebuildBindMessage onDone={(id) => setLive((s) => ({ ...s, bind: id }))} /></ActionRow>
           <ActionRow title="註冊 Discord 指令" tag="立即執行" desc="更新 /繳費、/發起繳費、/綁定 指令到你的伺服器。" state={cmdState}><RegisterCommands onDone={(at) => setLive((s) => ({ ...s, cmd: at }))} /></ActionRow>
           <ActionRow title="發起繳費" tag="會改價＋發通知" warn desc="確認指定期別的各方案金額，建立該期帳單並向所有成員發出開繳通知。送出前會先看影響預覽。"><InitiateBilling billingDay={savedBillingDay} dirty={dirty} /></ActionRow>
           <ActionRow title="匯入名單 CSV" tag="會新增/暫停訂閱" warn desc="用 CSV 批次建立或更新成員與訂閱；FALSE 的方案會暫停該訂閱。套用前先看差異預覽。"><ImportRoster /></ActionRow>

From a7ddbe995eca0beff35720f0e8f8e20e861d25b0 Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:29:17 +0800
Subject: [PATCH 06/20] =?UTF-8?q?feat(admin-ui):=20payments.source=20?=
 =?UTF-8?q?=E5=8A=A0=E4=B8=AD=E6=96=87=E9=A1=AF=E7=A4=BA=E5=B0=8D=E6=98=A0?=
 =?UTF-8?q?=20(#46=20D11=20=E4=B9=8B=E4=B8=80)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

繳費詳情的「來源」原本直接印出 enum 值（user_slash / admin_manual / cron），
管理員要自己翻譯。新增 SOURCE_LABEL，沿用 Manage.tsx 的 CHANNEL_TYPE_LABEL
先例（Record + ?? raw fallback，未知值降級成自己）。

**顯示層而已**——DB 值、SQL、request body 一律沒動。

用詞說明：cron 標為「系統建立」而非「排程」，因為 billing.ts 的預設 source 也是
cron，發起繳費與重新同步都走它；user 標「Discord（舊版）」——今天沒有任何程式寫入
這個值，它是 schema 預設，只有舊資料才有。
---
 packages/admin/src/ui.tsx                  | 12 ++++++++++++
 packages/admin/src/views/PaymentDetail.tsx |  4 ++--
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/packages/admin/src/ui.tsx b/packages/admin/src/ui.tsx
index 46aae00..006a27e 100644
--- a/packages/admin/src/ui.tsx
+++ b/packages/admin/src/ui.tsx
@@ -27,6 +27,18 @@ export function StatusBadge({ status }: { status: string }) {
   return <span className={`badge badge--${status}`}>{STATUS_LABEL[status] ?? status}</span>;
 }
 
+/**
+ * payments.source → what a human calls it. DISPLAY ONLY — the stored values stay English
+ * (schema CHECK: user / user_slash / user_web / admin_manual / cron). `?? raw` fallback matches
+ * the CHANNEL_TYPE_LABEL precedent in Manage.tsx, so an unknown value degrades to itself.
+ * `user` is written by nobody today — it is the schema default, so only legacy rows carry it.
+ * `cron` covers the daily job AND 發起繳費／同步 (they pass no source), hence 系統建立 not 排程.
+ */
+export const SOURCE_LABEL: Record<string, string> = {
+  user: "Discord（舊版）", user_slash: "Discord", user_web: "網頁上傳",
+  admin_manual: "後台補登", cron: "系統建立",
+};
+
 export function Money({ v }: { v: number }) {
   return <span className="mono">NT${v.toLocaleString()}</span>;
 }
diff --git a/packages/admin/src/views/PaymentDetail.tsx b/packages/admin/src/views/PaymentDetail.tsx
index 816415b..6b9b7b7 100644
--- a/packages/admin/src/views/PaymentDetail.tsx
+++ b/packages/admin/src/views/PaymentDetail.tsx
@@ -1,6 +1,6 @@
 import { useState } from "react";
 import { api, type ChannelTag, type Payment } from "../api";
-import { Modal, Field, Money, StatusBadge, IconWarning, ConfirmDanger } from "../ui";
+import { Modal, Field, Money, StatusBadge, IconWarning, ConfirmDanger, SOURCE_LABEL } from "../ui";
 
 export function PaymentDetail({ payment, tags, onClose, onDone }: { payment: Payment; tags: ChannelTag[]; onClose: () => void; onDone: () => void }) {
   const [busy, setBusy] = useState(false);
@@ -26,7 +26,7 @@ export function PaymentDetail({ payment, tags, onClose, onDone }: { payment: Pay
         <dt>狀態</dt><dd><StatusBadge status={payment.status} /></dd>
         <dt>金額</dt><dd><Money v={payment.amount} /></dd>
         <dt>應繳日</dt><dd className="mono">{payment.due_date}</dd>
-        <dt>來源</dt><dd>{payment.source}</dd>
+        <dt>來源</dt><dd>{SOURCE_LABEL[payment.source] ?? payment.source}</dd>
         {payment.payment_note && (<><dt>成員備註</dt><dd>{payment.payment_note}</dd></>)}
         {payment.declared_channel_tag_name && (<><dt>申報渠道</dt><dd>{payment.declared_channel_tag_name}</dd></>)}
         {payment.channel_tag_name && (<><dt>認定渠道</dt><dd>{payment.channel_tag_name}</dd></>)}

From f240d73919c45f31ad94895cd9a00b29045b0b6e Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:32:37 +0800
Subject: [PATCH 07/20] =?UTF-8?q?refactor(copy):=20=E6=9C=AC=E6=9C=9F=20?=
 =?UTF-8?q?=E2=86=92=20=E6=AD=A4=E6=9C=9F=EF=BC=8F=E5=AF=A6=E9=9A=9B?=
 =?UTF-8?q?=E6=9C=9F=E5=88=A5=EF=BC=8C=E9=96=8B=E5=B8=B3=20=E2=86=92=20?=
 =?UTF-8?q?=E9=96=8B=E7=B9=B3=EF=BC=8C=E6=8C=89=E9=88=95=E5=90=8D=E8=88=87?=
 =?UTF-8?q?=E6=96=87=E6=A1=88=E5=B0=8D=E9=BD=8A=20(#46=20D3/D5/D7)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                     |  6 +++---
 README.zh-TW.md                               | 12 +++++------
 packages/admin/src/api.ts                     | 10 +++++-----
 packages/admin/src/components/DiffList.tsx    |  2 +-
 packages/admin/src/views/Dashboard.tsx        |  6 +++---
 packages/admin/src/views/MemberReview.tsx     |  2 +-
 packages/admin/src/views/PaymentDetail.tsx    |  2 +-
 packages/admin/src/views/Payments.tsx         | 20 +++++++++----------
 packages/admin/src/views/PushStatus.tsx       | 10 +++++-----
 packages/admin/src/views/Settings.tsx         |  8 ++++----
 packages/web/src/App.tsx                      |  2 +-
 packages/worker/scripts/register-commands.mjs |  2 +-
 .../worker/src/adapters/discord/handler.ts    | 16 +++++++--------
 packages/worker/src/core/billing.ts           | 10 +++++-----
 packages/worker/src/core/import.ts            |  6 +++---
 packages/worker/src/core/notify.ts            |  2 +-
 packages/worker/src/core/scheduled.ts         |  2 +-
 packages/worker/src/env.ts                    |  2 +-
 packages/worker/src/routes/admin.ts           |  8 ++++----
 packages/worker/src/routes/upload.ts          |  4 ++--
 .../adapters/discord-initiate-cap.test.ts     |  2 +-
 .../worker/test/adapters/discord-pay.test.ts  |  3 ++-
 .../core/billing-initiate-no-plans.test.ts    |  8 ++++----
 packages/worker/test/core/import.test.ts      |  2 +-
 .../test/core/notify-send-failure.test.ts     |  4 ++--
 .../test/routes/notifications-danger.test.ts  |  4 ++--
 26 files changed, 78 insertions(+), 77 deletions(-)

diff --git a/README.md b/README.md
index 26d7341..ae5f78b 100644
--- a/README.md
+++ b/README.md
@@ -65,7 +65,7 @@ pre-wired) and a multi-workspace-ready data model, so it generalizes well beyond
   plans it couldn't match, cancelled subs that need a human) before you apply it; idempotent re-runs.
 - 🧾 **Review queue + reconciliation** — an admin dashboard with per-plan / per-channel totals, a
   one-click verify queue, manual back-fill, single-payment delete, undo-verify, and frozen period
-  amounts (price changes never rewrite history). A **重新同步本期帳單** action re-aligns an opened
+  amounts (price changes never rewrite history). A **重新同步此期帳單** action re-aligns an opened
   period's bills to the current roster/price (preview before applying), optionally pinging newly-added members.
   Tapping a member's name (or a submission alert) opens the **成員×期別合併審核**: the shared
   screenshot once, every settled row, and one 一鍵全部驗證 button. The queue, that view and the
@@ -226,7 +226,7 @@ payment screenshots) and fill in `wrangler.toml` accordingly — `database_id`,
 - **Review queue** — Payments → status pills → the **已繳待驗** queue floats to the top → one-click
   ✅ verify (or open a row for screenshots, channel, reject, amount override, delete proof, **撤回驗證**
   to undo a mistaken verify, or **delete the whole bill**).
-- **重新同步本期帳單** — on Payments, re-align the selected opened period's bills to the current
+- **重新同步此期帳單** — on Payments, re-align the selected opened period's bills to the current
   roster/price (add missing · remove de-subscribed · reprice pending · freeze settled), with a preview
   before applying and an option to ping newly-added members with the pay button.
 - **發起繳費** — confirm the selected period's per-plan amounts (any change becomes the plan's new
@@ -244,7 +244,7 @@ payment screenshots) and fill in `wrangler.toml` accordingly — `database_id`,
   **重置催繳發送紀錄**. The first two show the exact recipients before sending; all three take a
   confirmation step and report the real counts — a non-2xx from Discord is reported as a failed
   send, so the billing notice's `sent_at` is never moved forward and the overdue dedup slot is
-  released so the next run (cron included) can try again. Reopening/closing a period lives in 收回本期開繳 on
+  released so the next run (cron included) can try again. Reopening/closing a period lives in 收回此期開繳 on
   the payments page, not here.
 - **Submission alerts** — set a Bark device key and/or a webhook (Discord / Google Chat / Slack) under
   Settings → 繳費通知; each new submission then pushes you a notice that opens that member's whole
diff --git a/README.zh-TW.md b/README.zh-TW.md
index 74e4a9e..9b53fe2 100644
--- a/README.zh-TW.md
+++ b/README.zh-TW.md
@@ -59,7 +59,7 @@ ChipPot 解決的是一個很具體的痛點：社團大量採購 OpenAI / Anthr
   代表訂閱（或恢復暫停中的訂閱），`FALSE` 代表暫停該訂閱，留空則完全不動。每次上傳都會先顯示完整
   差異預覽（新成員、新增／暫停／恢復的訂閱、對不到的方案、需人工處理的已取消訂閱）再套用，可冪等重跑。
 - 🧾 **審核佇列 + 對帳** — 後台看板有各方案／各渠道金額、一鍵驗證佇列、手動補登、單筆繳費刪除、
-  **撤回驗證**（誤按的驗證可還原），且**當期金額凍結**（改價不會回頭改歷史帳）。**重新同步本期帳單**
+  **撤回驗證**（誤按的驗證可還原），且**當期金額凍結**（改價不會回頭改歷史帳）。**重新同步此期帳單**
   會把已開期別的帳單重新對齊目前名單／現價（先看差異預覽再套用），並可順便 @ 通知新加進來的成員。
   點成員名字（或從繳費推播點進來）會開啟**成員×期別合併審核**：共用截圖只出現一次、當期每一筆都列出，
   已繳待驗的可一鍵全部驗證。佇列、這個畫面與審核彈窗在手機上都能用。
@@ -67,7 +67,7 @@ ChipPot 解決的是一個很具體的痛點：社團大量採購 OpenAI / Anthr
 - 📲 **繳費推播** — 成員送出繳費時，可推一則 Bark 和／或 webhook（Discord／Google Chat／Slack，body
   格式依主機自動判斷）給擁有者，並帶上直接跳到該成員該期審核的深連結——一次送出會結清所有訂閱，
   所以連結會把它們一起打開，可一鍵全部驗證。
-- ⏰ **每日 cron、冪等** — 自動開帳、進入催繳後**每天發一則**整批催繳（直到全部繳完）、執行
+- ⏰ **每日 cron、冪等** — 自動開繳、進入催繳後**每天發一則**整批催繳（直到全部繳完）、執行
   截圖保存期清理，全部經 `notification_logs` 去重。
 - 🛡️ **Access 保護的後台** — 整個後台主機在 Cloudflare Access 後（email OTP）；SPA 與其 API 同源，
   Access JWT 因此能到達 Worker。
@@ -81,7 +81,7 @@ ChipPot 解決的是一個很具體的痛點：社團大量採購 OpenAI / Anthr
         ├─ 還沒綁定？ → 「選你的名字」下拉 → 綁定 Discord id 後，接著繳費
         │
         ▼
-  ephemeral：列出本期各方案 + 總額 + 渠道下拉
+  ephemeral：列出該期各方案 + 總額 + 渠道下拉
         │  （/繳費 或網頁可另附截圖／備註）
         ▼
   settleUserPeriod() — 把每筆 pending/rejected 標記為「已繳待驗」，共用同一張截圖 key
@@ -98,7 +98,7 @@ ChipPot 解決的是一個很具體的痛點：社團大量採購 OpenAI / Anthr
 ```
 Discord  ─┐                              ┌─ D1  (chippot-db)         — SQLite 帳本
 網頁上傳 ─┼─►  Cloudflare Worker  ───────┤─ R2  (chippot-proofs)     — 私有截圖
-後台 UI  ─┤    core + adapters           └─ Cron（每日 01:00 UTC）   — 開帳 / 催繳 / 保存期
+後台 UI  ─┤    core + adapters           └─ Cron（每日 01:00 UTC）   — 開繳 / 催繳 / 保存期
 Cron     ─┘
 ```
 
@@ -210,7 +210,7 @@ pnpm --filter @chippot/worker register
 - **成員×期別合併審核** — 點表格裡的成員名字（或從繳費推播的深連結進來），把該成員當期的帳單收在
   同一頁：共用截圖只顯示一次、每一筆都列出且可單筆驗證／退回，已繳待驗的可一鍵掃過去驗證（還有
   待繳／已退回的會明講需要逐筆處理）。手機版把繳費表改成堆疊卡片、彈窗改成底部抽屜。
-- **重新同步本期帳單** — 在繳費審核頁，把目前篩選的**已開期別**帳單對齊現在的名單／價格
+- **重新同步此期帳單** — 在繳費審核頁，把目前篩選的**已開期別**帳單對齊現在的名單／價格
   （補缺漏 · 移除已退訂 · 待繳改現價 · 已繳／已驗證凍結）；先出差異預覽再套用，並可勾選用繳費按鈕
   @ 通知新加進來的成員。選「全部期別」時按鈕停用。
 - **發起繳費** — 確認所選期別各方案金額（任何更動就是該方案的新定價），先看「會建立／改價哪些帳單、
@@ -225,7 +225,7 @@ pnpm --filter @chippot/worker register
   與 **重置催繳發送紀錄**。前兩者送出前會先列出實際名單，三者都要再確認一次，並回報真實筆數：
   Discord 沒回成功就說發送失敗——開繳通知的 `sent_at` 不會被往前推，催繳也會把佔用的去重名額還回去，
   下次（含每日 cron）才送得出去。
-  要把期別改回未開繳請用「繳費審核 → 收回本期開繳」。
+  要把期別改回未開繳請用「繳費審核 → 收回此期開繳」。
 - **繳費通知** — 在設定 → 繳費通知填 Bark 裝置金鑰和／或 webhook（Discord／Google Chat／Slack），
   之後每筆新送出都會推你一則，點開就是該成員當期的合併審核（共用截圖一次、每筆列出、可一鍵驗證），
   手機上也好操作。存檔前可先按**送出測試**確認打得通。兩者都選填、best-effort（端點慢或掛掉都不會
diff --git a/packages/admin/src/api.ts b/packages/admin/src/api.ts
index 8d96ee1..2ac9cf8 100644
--- a/packages/admin/src/api.ts
+++ b/packages/admin/src/api.ts
@@ -56,7 +56,7 @@ export interface Subscription { id: number; user_name: string; plan_name: string
 export interface ReconcileLine { payment_id?: number; subscription_id: number; user_id: number; user_name: string; plan_name: string; amount: number; from?: number; to?: number; discord_id: string | null }
 export interface ReconcileDiff { opened: boolean; add: ReconcileLine[]; remove: ReconcileLine[]; reprice: ReconcileLine[]; frozen_count: number }
 export interface ReconcileApplied { ok: boolean; applied: { added: number; removed: number; repriced: number; frozen: number }; notified: number }
-/** 收回本期開繳 — preview and apply share `opened`/counts; `removed` only comes back on the preview. */
+/** 收回此期開繳 — preview and apply share `opened`/counts; `removed` only comes back on the preview. */
 export interface RetractPreview { opened: boolean; removed: ReconcileLine[]; frozen_count: number }
 export interface RetractApplied { ok: boolean; opened: boolean; applied: { removed: number; frozen: number } }
 /**
@@ -105,10 +105,10 @@ export interface InitiateApplied {
 export const NOTIFY_REASON_TEXT: Record<string, string> = {
   no_channel: "尚未設定繳費頻道 ID（設定 → Discord 串接）",
   no_bot_token: "尚未設定 Discord bot token",
-  no_plans: "本期沒有任何有啟用訂閱的方案",
-  already_sent: "本期開繳通知先前已發送，不會重複發送",
+  no_plans: "此期沒有任何有啟用訂閱的方案",
+  already_sent: "此期開繳通知先前已發送，不會重複發送",
   not_opened: "此期尚未開繳",
-  none_due: "本期沒有未繳的成員",
+  none_due: "此期沒有未繳的成員",
   // Discord did not answer 2xx. Deliberately says nothing about what was written: the three callers
   // (發起繳費 / 重發開繳通知 / 催繳) leave very different states behind, so each adds its own clause.
   send_failed: "Discord 沒有回應成功（發送失敗），可稍後再試一次",
@@ -257,7 +257,7 @@ export function nudgeSummary(r: NudgeResult): string {
   }
   const parts: string[] = [];
   parts.push(r.notified > 0 ? `已在頻道 @ 通知 ${r.notified} 位` : "沒有需要通知的人");
-  if (r.skipped > 0) parts.push(`${r.skipped} 位本期已通知過`);
+  if (r.skipped > 0) parts.push(`${r.skipped} 位此期已通知過`);
   if (r.unbound > 0) parts.push(`另 ${r.unbound} 位尚未綁定 Discord、通知不到（${r.unbound_names.join("、")}）`);
   return parts.join("；") + "。";
 }
diff --git a/packages/admin/src/components/DiffList.tsx b/packages/admin/src/components/DiffList.tsx
index db66a15..2bd9a30 100644
--- a/packages/admin/src/components/DiffList.tsx
+++ b/packages/admin/src/components/DiffList.tsx
@@ -1,6 +1,6 @@
 /**
  * Collapsible "N changed rows" list for a diff preview — shared by the CSV import preview
- * (views/Settings.tsx) and the 重新同步本期帳單 modal (views/Payments.tsx).
+ * (views/Settings.tsx) and the 重新同步此期帳單 modal (views/Payments.tsx).
  */
 export function DiffList({ title, rows }: { title: string; rows: string[] }) {
   return (
diff --git a/packages/admin/src/views/Dashboard.tsx b/packages/admin/src/views/Dashboard.tsx
index d572820..5b834fe 100644
--- a/packages/admin/src/views/Dashboard.tsx
+++ b/packages/admin/src/views/Dashboard.tsx
@@ -36,12 +36,12 @@ export function Dashboard() {
           <Card title="各方案">
             <div className="tbl tbl--pin-first">
               <table>
-                <caption className="sr-only">各方案本期收款統計</caption>
+                <caption className="sr-only">{effPeriod} 各方案收款統計</caption>
                 <thead>
                   <tr><th scope="col">方案</th><th scope="col" className="right">筆數</th><th scope="col" className="right">待繳</th><th scope="col" className="right">待驗</th><th scope="col" className="right">已驗證</th><th scope="col" className="right">應收</th><th scope="col" className="right">已驗證金額</th></tr>
                 </thead>
                 <tbody>
-                  {data.by_plan.length === 0 && <tr><td colSpan={7}><Empty>本期尚無資料</Empty></td></tr>}
+                  {data.by_plan.length === 0 && <tr><td colSpan={7}><Empty>此期尚無資料</Empty></td></tr>}
                   {data.by_plan.map((p) => (
                     <tr key={p.plan_id}>
                       <td>{p.plan_name}</td>
@@ -66,7 +66,7 @@ export function Dashboard() {
                 <caption className="sr-only">依繳費渠道分組的已驗證款項</caption>
                 <thead><tr><th scope="col">渠道</th><th scope="col" className="right">筆數</th><th scope="col" className="right">金額</th></tr></thead>
                 <tbody>
-                  {data.by_channel_tag.length === 0 && <tr><td colSpan={3}><Empty>本期尚無已驗證款項</Empty></td></tr>}
+                  {data.by_channel_tag.length === 0 && <tr><td colSpan={3}><Empty>此期尚無已驗證款項</Empty></td></tr>}
                   {data.by_channel_tag.map((t, i) => (
                     <tr key={i}>
                       <td>{t.channel_tag_name ?? "（未指定）"}</td>
diff --git a/packages/admin/src/views/MemberReview.tsx b/packages/admin/src/views/MemberReview.tsx
index aeb12f5..babbbd1 100644
--- a/packages/admin/src/views/MemberReview.tsx
+++ b/packages/admin/src/views/MemberReview.tsx
@@ -71,7 +71,7 @@ export function MemberReview({ userId, period, tags, onBack }: {
               {proofKeys.length === 0 && !proofExpired && (
                 submitted
                   ? <p className="mreview__note mreview__note--warn"><IconWarning /> 無憑證，純聲明 — 請依備註與帳戶自行核對。</p>
-                  : <p className="mreview__note">本期尚未回報繳費。</p>
+                  : <p className="mreview__note">此期尚未回報繳費。</p>
               )}
               {notes.length > 0 && <p className="mreview__note">成員備註：{notes.join("；")}</p>}
             </div>
diff --git a/packages/admin/src/views/PaymentDetail.tsx b/packages/admin/src/views/PaymentDetail.tsx
index 6b9b7b7..9b3dc48 100644
--- a/packages/admin/src/views/PaymentDetail.tsx
+++ b/packages/admin/src/views/PaymentDetail.tsx
@@ -78,7 +78,7 @@ export function PaymentDetail({ payment, tags, onClose, onDone }: { payment: Pay
           // paid/verified/rejected all carry real activity; only pending is re-creatable by a resync.
           message={payment.status !== "pending"
             ? "這筆已有繳費／審核紀錄，刪除後將從對帳與紀錄中消失且無法復原（稽核紀錄仍會保留）。"
-            : "刪除這筆待繳紀錄後，「重新同步本期」會在該訂閱仍為啟用時把它補回來（稽核紀錄仍會保留）。"}
+            : "刪除這筆待繳紀錄後，「重新同步此期帳單」會在該訂閱仍為啟用時把它補回來（稽核紀錄仍會保留）。"}
           confirmLabel="確認刪除"
           busyLabel="刪除中…"
           onClose={() => setConfirmDel(false)}
diff --git a/packages/admin/src/views/Payments.tsx b/packages/admin/src/views/Payments.tsx
index b17203a..bae3440 100644
--- a/packages/admin/src/views/Payments.tsx
+++ b/packages/admin/src/views/Payments.tsx
@@ -120,8 +120,8 @@ export function Payments() {
             phone instead of four stacked bands. Below 1000px .toolbar__acts is a nowrap scroller
             with an edge fade; above it, it is a plain flex row and looks unchanged. */}
         <div className="toolbar__acts">
-          <button className="btn" disabled={!effPeriod} title={effPeriod ? "對齊本期帳單到目前名單／現價" : "請先選擇單一期別"} onClick={() => setSync(true)}>重新同步本期</button>
-          <button className="btn btn--danger" disabled={!effPeriod} title={effPeriod ? "刪除本期未繳／已退回帳單，期別回到未開繳" : "請先選擇單一期別"} onClick={() => setRetract(true)}>收回本期開繳</button>
+          <button className="btn" disabled={!effPeriod} title={effPeriod ? "對齊此期帳單到目前名單／現價" : "請先選擇單一期別"} onClick={() => setSync(true)}>重新同步此期帳單</button>
+          <button className="btn btn--danger" disabled={!effPeriod} title={effPeriod ? "刪除此期未繳／已退回帳單，期別回到未開繳" : "請先選擇單一期別"} onClick={() => setRetract(true)}>收回此期開繳</button>
           <button className="btn" onClick={() => setShowLink(true)}>產生上傳連結</button>
           <button className="btn btn--primary" onClick={() => setShowManual(true)}>手動補登</button>
         </div>
@@ -154,7 +154,7 @@ export function Payments() {
                   }}
                 >
                   <td data-label="成員">
-                    <button className="linkbtn" title="檢視這位成員本期的合併審核"
+                    <button className="linkbtn" title="檢視這位成員此期的合併審核"
                       onClick={(e) => { e.stopPropagation(); window.location.hash = `payments?user=${p.user_id}&period=${p.period}`; }}>
                       {p.user_name}
                     </button>
@@ -230,7 +230,7 @@ function SyncModal({ period, onClose, onDone }: { period: string; onClose: () =>
   }
 
   return (
-    <Modal title={`重新同步本期帳單 · ${period}`} onClose={onClose}>
+    <Modal title={`重新同步此期帳單 · ${period}`} onClose={onClose}>
       {err && <div className="error-banner">{err}</div>}
       {busy && !diff && <Empty>計算差異中…</Empty>}
       {done && <div style={{ color: "var(--teal)", padding: "8px 0" }}>{done}</div>}
@@ -259,7 +259,7 @@ function SyncModal({ period, onClose, onDone }: { period: string; onClose: () =>
             </div>
           )}
           {changes === 0
-            ? <p style={{ color: "var(--muted)" }}>本期已是最新，無需變更。</p>
+            ? <p style={{ color: "var(--muted)" }}>此期已是最新，無需變更。</p>
             : <button className="btn btn--primary" disabled={busy} onClick={apply}>確認套用</button>}
         </>
       )}
@@ -268,7 +268,7 @@ function SyncModal({ period, onClose, onDone }: { period: string; onClose: () =>
 }
 
 /**
- * 收回本期開繳 — the way back from a mis-opened month. Two steps like SyncModal: a preview of what
+ * 收回此期開繳 — the way back from a mis-opened month. Two steps like SyncModal: a preview of what
  * the retract would delete, then a red confirm. The frozen (paid/verified) count is spelled out
  * because "收回" easily reads as "wipe the month", which is exactly what it does NOT do.
  */
@@ -297,7 +297,7 @@ function RetractModal({ period, onClose, onDone }: { period: string; onClose: ()
   }
 
   return (
-    <Modal title={`收回本期開繳 · ${period}`} onClose={onClose}>
+    <Modal title={`收回此期開繳 · ${period}`} onClose={onClose}>
       {err && <div className="error-banner">{err}</div>}
       {busy && !preview && <Empty>計算中…</Empty>}
       {done && <div style={{ color: "var(--teal)", padding: "8px 0" }}>{done}</div>}
@@ -311,12 +311,12 @@ function RetractModal({ period, onClose, onDone }: { period: string; onClose: ()
           {preview.removed.length > 0
             ? <DiffList title="將刪除的帳單（未繳／已退回）" rows={preview.removed.map((a) => `${a.user_name}·${a.plan_name} NT$${a.amount.toLocaleString()}`)} />
             /* Still worth doing: the marker alone is what keeps the period "opened". */
-            : <p style={{ color: "var(--muted)" }}>本期沒有可刪除的未繳／已退回帳單，收回只會把期別改回「未開繳」。</p>}
+            : <p style={{ color: "var(--muted)" }}>此期沒有可刪除的未繳／已退回帳單，收回只會把期別改回「未開繳」。</p>}
           <p style={{ color: "var(--muted)", fontSize: 13, lineHeight: 1.7, margin: "12px 0" }}>
             {/* One source line per sentence would render an ASCII space between them (JSX joins
                 adjacent text lines), which reads as a gap in a run of CJK. */}
-            收回後本期回到「未開繳」：刪掉的帳單不會被「重新同步本期」補回來，日後可以再次發起繳費（屆時會重新發送開繳通知）。此期先前用「產生上傳連結」發出去的一次性連結會<b>立即失效</b>，對方點開只會看到連結無效。
-            {preview.frozen_count > 0 && `已繳／已驗證的 ${preview.frozen_count} 筆一律原樣保留，重開本期也不會重複開帳單。`}
+            收回後此期回到「未開繳」：刪掉的帳單不會被「重新同步此期帳單」補回來，日後可以再次發起繳費（屆時會重新發送開繳通知）。此期先前用「產生上傳連結」發出去的一次性連結會<b>立即失效</b>，對方點開只會看到連結無效。
+            {preview.frozen_count > 0 && `已繳／已驗證的 ${preview.frozen_count} 筆一律原樣保留，重開此期也不會重複產生帳單。`}
             已經發出的 Discord 開繳通知不會撤回，必要時請自行到頻道說明。
           </p>
           <button className="btn btn--danger" disabled={busy} onClick={apply}>確認收回</button>
diff --git a/packages/admin/src/views/PushStatus.tsx b/packages/admin/src/views/PushStatus.tsx
index b25c5c4..37b519a 100644
--- a/packages/admin/src/views/PushStatus.tsx
+++ b/packages/admin/src/views/PushStatus.tsx
@@ -10,7 +10,7 @@ import { DiffList } from "../components/DiffList";
  *
  * There is deliberately NO "重置" for 開繳通知: that row IS the definition of "this period is open"
  * (worker core/notify.ts isBillingOpened), so deleting it alone leaves every bill standing in a
- * period nobody can pay. The whole operation is 收回本期開繳 on the payments page; the note below
+ * period nobody can pay. The whole operation is 收回此期開繳 on the payments page; the note below
  * the table points there, and the API returns 409 if anything tries anyway.
  */
 export function PushStatus({ period }: { period: string }) {
@@ -42,7 +42,7 @@ export function PushStatus({ period }: { period: string }) {
       )}
       <div className="tbl tbl--pin-last">
         <table className="tbl-cards">
-          <caption className="sr-only">本期推播通知狀態</caption>
+          <caption className="sr-only">{period} 推播通知狀態</caption>
           <thead><tr><th scope="col">通知</th><th scope="col">狀態</th><th scope="col"><span className="sr-only">操作</span></th></tr></thead>
           <tbody>
             <tr>
@@ -64,7 +64,7 @@ export function PushStatus({ period }: { period: string }) {
         </table>
       </div>
       <p style={{ color: "var(--muted-strong)", fontSize: 12.5, lineHeight: 1.7, padding: "10px 20px 16px", margin: 0 }}>
-        要把 {period} 改回「未開繳」（成員暫時無法繳費）？請到「繳費審核」使用<b>收回本期開繳</b> ——
+        要把 {period} 改回「未開繳」（成員暫時無法繳費）？請到「繳費審核」使用<b>收回此期開繳</b> ——
         它會一併刪掉未繳／已退回的帳單，不會只留下對不起來的半套狀態。
       </p>
 
@@ -220,7 +220,7 @@ function OverdueModal({ period, onClose, onDone }: { period: string; onClose: ()
           <DiffList title="會被 @ 的成員" rows={view.p.people.map((p) => `${p.user_name} NT$${p.total.toLocaleString()}${p.discord_id ? "" : "（未綁定，@ 不到）"}`)} />
           <p style={{ color: "var(--muted)", fontSize: 13, lineHeight: 1.7, margin: "12px 0" }}>
             這會在繳費頻道公開 @ {period} <b>所有</b>未繳成員（含已退回的），<b>不受</b>「逾期天數（{view.p.overdue_days} 天）」限制；
-            每日自動催繳只會 @ 已超過逾期天數的人，所以這份名單通常比較長。送出後本期的催繳發送紀錄會更新為現在。
+            每日自動催繳只會 @ 已超過逾期天數的人，所以這份名單通常比較長。送出後此期的催繳發送紀錄會更新為現在。
           </p>
           <button className="btn btn--danger" disabled={busy} onClick={apply}>確認催繳這 {view.p.people.length} 位</button>
         </>
@@ -245,7 +245,7 @@ function ResetOverdueModal({ period, onClose, onDone }: { period: string; onClos
   return (
     <ConfirmDanger
       title={`重置催繳發送紀錄 · ${period}`}
-      message={`刪除 ${period} 的「逾期催繳」發送紀錄後，每日自動催繳會在下次符合逾期條件時再送一次（同一批人可能被重複 @）。\n\n這只影響催繳的去重紀錄：不會變更任何帳單，也不會影響本期的開繳狀態。`}
+      message={`刪除 ${period} 的「逾期催繳」發送紀錄後，每日自動催繳會在下次符合逾期條件時再送一次（同一批人可能被重複 @）。\n\n這只影響催繳的去重紀錄：不會變更任何帳單，也不會影響此期的開繳狀態。`}
       confirmLabel="確認重置"
       busyLabel="重置中…"
       onClose={onClose}
diff --git a/packages/admin/src/views/Settings.tsx b/packages/admin/src/views/Settings.tsx
index 4204fa7..a203338 100644
--- a/packages/admin/src/views/Settings.tsx
+++ b/packages/admin/src/views/Settings.tsx
@@ -195,8 +195,8 @@ export function Settings() {
           : <span className="chip chip--off"><IconWarning /> 截圖未啟用</span>)}>
         <div className="card__body">
           <div className="grid2">
-            <Field label="每月結帳日"><span className="field__hint">每月幾號向所有成員開帳收費（1–28）。</span><input type="number" min={1} max={28} value={form.billing_day} onChange={(e) => set("billing_day")(e.target.value)} disabled={busy} /></Field>
-            <Field label="逾期天數"><span className="field__hint">開帳後幾天仍未繳就列入催繳。</span><input type="number" min={0} value={form.overdue_days} onChange={(e) => set("overdue_days")(e.target.value)} disabled={busy} /></Field>
+            <Field label="每月結帳日"><span className="field__hint">每月幾號自動向所有成員開繳（1-28）。</span><input type="number" min={1} max={28} value={form.billing_day} onChange={(e) => set("billing_day")(e.target.value)} disabled={busy} /></Field>
+            <Field label="逾期天數"><span className="field__hint">開繳後幾天仍未繳就列入催繳。</span><input type="number" min={0} value={form.overdue_days} onChange={(e) => set("overdue_days")(e.target.value)} disabled={busy} /></Field>
             <Field label="截圖保存月數"><span className="field__hint">超過月數的繳費截圖自動清除（對帳資料保留）。</span><input type="number" min={1} value={form.proof_retention_months} onChange={(e) => set("proof_retention_months")(e.target.value)} disabled={busy} /></Field>
           </div>
         </div>
@@ -441,7 +441,7 @@ function ImportModal({ onClose }: { onClose: () => void }) {
           {diff.affected_pending_bills.length > 0 && (
             <>
               <div className="warnnote">
-                被暫停的訂閱在 {diff.period} 還有 {diff.affected_pending_bills.length} 筆未繳帳單。匯入<b>不會</b>變更任何帳單；請到「繳費審核」按<b>重新同步本期帳單</b>清理。
+                被暫停的訂閱在 {diff.period} 還有 {diff.affected_pending_bills.length} 筆未繳帳單。匯入<b>不會</b>變更任何帳單；請到「繳費審核」按<b>「重新同步此期帳單」</b>清理。
               </div>
               <DiffList
                 title={`${diff.period} 未繳帳單（匯入不會變更）`}
@@ -530,7 +530,7 @@ function InitiateModal({ plans, billingDay, dirty, onClose }: { plans: { id: num
           ? "已在頻道發出開繳通知。"
           : `未發送通知：${NOTIFY_REASON_TEXT[r.notify_reason] ?? "通知未送出"}。` +
             (r.notify_reason === "send_failed"
-              ? "本期已開繳、帳單已建立，可到「儀表板 → 推播狀態 → 重發開繳通知」補送。"
+              ? "此期已開繳、帳單已建立，可到「儀表板 → 推播狀態 → 重發開繳通知」補送。"
               : ""))
       );
     } catch (e) { setErr((e as Error).message); }
diff --git a/packages/web/src/App.tsx b/packages/web/src/App.tsx
index e97301c..2717e0f 100644
--- a/packages/web/src/App.tsx
+++ b/packages/web/src/App.tsx
@@ -157,7 +157,7 @@ export default function App() {
         <button className="submit" onClick={submit} disabled={busy || !canSubmit}>
           {busy ? "上傳中…" : "送出繳費"}
         </button>
-        <p className="muted small center">{info?.proof_enabled === false ? "渠道或備註至少填一項。" : "渠道、截圖或備註至少填一項。"}此連結僅限你本人本期使用，送出後即失效。</p>
+        <p className="muted small center">{info?.proof_enabled === false ? "渠道或備註至少填一項。" : "渠道、截圖或備註至少填一項。"}此連結僅限你本人、此月份使用，送出後即失效。</p>
       </div>
     </Shell>
   );
diff --git a/packages/worker/scripts/register-commands.mjs b/packages/worker/scripts/register-commands.mjs
index c76aeb9..6bb57fe 100644
--- a/packages/worker/scripts/register-commands.mjs
+++ b/packages/worker/scripts/register-commands.mjs
@@ -53,7 +53,7 @@ const commands = [
   },
   {
     name: "發起繳費", type: 1,
-    description: "（管理員）確認本期各方案金額並發出開繳通知",
+    description: "（管理員）確認指定期別各方案金額並發出開繳通知",
     default_member_permissions: "32",
   },
   {
diff --git a/packages/worker/src/adapters/discord/handler.ts b/packages/worker/src/adapters/discord/handler.ts
index dbefe9d..09fcbe3 100644
--- a/packages/worker/src/adapters/discord/handler.ts
+++ b/packages/worker/src/adapters/discord/handler.ts
@@ -173,7 +173,7 @@ async function computePayResult(i: DiscordInteraction, env: Env, ctx: ExecutionC
   // command settles one period, so if several are owed we send them to the button (which can pick).
   const periods = await listOpenPayablePeriods(env.DB, ws, userId);
   if (periods.length === 0) {
-    return opened ? "✅ 你已登記繳費，目前沒有待繳項目。" : `本期（${current}）繳費尚未開放，待管理員發出開繳通知後即可繳費。`;
+    return opened ? "✅ 你已登記繳費，目前沒有待繳項目。" : `${current} 的繳費尚未開放，待管理員發出開繳通知後即可繳費。`;
   }
   if (periods.length > 1) return `你有多個月份待繳：${periods.join("、")}。請改用下方「繳費」按鈕選擇要繳的月份。`;
   const period = periods[0]!;
@@ -217,9 +217,9 @@ async function computePayResult(i: DiscordInteraction, env: Env, ctx: ExecutionC
     declaredChannelTagId, paymentNote: note, proof,
     waitUntil: (p) => ctx.waitUntil(p), // notify in the background (followup reply stays snappy)
   });
-  if (r.paidCount === 0) return `本期（${period}）已登記繳費，無需重複操作。`;
+  if (r.paidCount === 0) return `${period} 已登記繳費，無需重複操作。`;
   const ignoredNote = screenshotIgnored ? "（本站未開啟截圖功能，已記錄你的繳費宣告）" : "";
-  return `✅ 已登記本期（${period}）繳費 NT$${r.totalAmount.toLocaleString()}（共 ${r.paidCount} 筆）。管理員確認收款後完成。${ignoredNote}`;
+  return `✅ 已登記 ${period} 繳費 NT$${r.totalAmount.toLocaleString()}（共 ${r.paidCount} 筆）。管理員確認收款後完成。${ignoredNote}`;
 }
 
 // ── 發起繳費 (admin): modal open + modal submit ──────────────────────────────
@@ -297,8 +297,8 @@ function initiateNoticeNote(reason: string, period: string): string {
     case "already_sent": return `${period} 的開繳通知先前已發送，未重複發送。`;
     case "no_channel": return "尚未設定繳費頻道 ID，未發出開繳通知。";
     case "no_bot_token": return "尚未設定 Discord bot token，未發出開繳通知。";
-    case "no_plans": return "沒有任何「啟用中方案 × 有效訂閱」，未發出開繳通知（本期仍維持未開繳）。";
-    case "send_failed": return "開繳通知發送失敗（本期已開繳、帳單已建立），請稍後到後台「推播狀態 → 重發開繳通知」再試一次。";
+    case "no_plans": return `沒有任何「啟用中方案 × 有效訂閱」，未發出開繳通知（${period} 仍維持未開繳）。`;
+    case "send_failed": return `開繳通知發送失敗（${period} 已開繳、帳單已建立），請稍後到後台「推播狀態 → 重發開繳通知」再試一次。`;
     default: return "未發出開繳通知。";
   }
 }
@@ -575,7 +575,7 @@ async function buildPayPrompt(
   const periods = await listOpenPayablePeriods(env.DB, ws, userId);
   if (periods.length === 0) {
     return {
-      content: opened ? "✅ 你已登記繳費，目前沒有待繳項目。" : `本期（${current}）繳費尚未開放，待管理員發出開繳通知後即可繳費。`,
+      content: opened ? "✅ 你已登記繳費，目前沒有待繳項目。" : `${current} 的繳費尚未開放，待管理員發出開繳通知後即可繳費。`,
       components: [],
     };
   }
@@ -712,7 +712,7 @@ async function handlePaySelect(i: DiscordInteraction, env: Env, ctx: ExecutionCo
   }
   // Defense in depth: even with a crafted select, don't settle before billing is opened.
   if (!(await isBillingOpened(env.DB, ws, period))) {
-    return updateErr("本期繳費尚未開放，待管理員發出開繳通知後即可繳費。");
+    return updateErr(`${period} 的繳費尚未開放，待管理員發出開繳通知後即可繳費。`);
   }
 
   try {
@@ -721,7 +721,7 @@ async function handlePaySelect(i: DiscordInteraction, env: Env, ctx: ExecutionCo
       waitUntil: (p) => ctx.waitUntil(p), // notify in the background — keep the interaction < 3s
     });
     if (r.paidCount === 0) {
-      return json({ type: RT_UPDATE_MESSAGE, data: { content: "✅ 你本期已登記繳費，無需重複操作。", components: [] } });
+      return json({ type: RT_UPDATE_MESSAGE, data: { content: `✅ ${period} 已登記繳費，無需重複操作。`, components: [] } });
     }
     return json({
       type: RT_UPDATE_MESSAGE,
diff --git a/packages/worker/src/core/billing.ts b/packages/worker/src/core/billing.ts
index 6dd1949..241cfcc 100644
--- a/packages/worker/src/core/billing.ts
+++ b/packages/worker/src/core/billing.ts
@@ -199,7 +199,7 @@ export async function initiateBillingOpened(
 
   // The notice lines are computed BEFORE anything is claimed. The billing_opened row is not a send
   // log — it IS "this period is open" — so a call with nothing to announce must never leave one
-  // behind: that state ("opened, but nobody was ever told") is only undoable via 收回本期開繳.
+  // behind: that state ("opened, but nobody was ever told") is only undoable via 收回此期開繳.
   // previewBillingInitiate already calls this case no_plans, and the two must say the same thing.
   const lines: PlanOpenLine[] = subs.results
     .map((s) => planById.get(s.plan_id))
@@ -407,7 +407,7 @@ export async function previewBillingInitiate(
   return { period, opened, will_notify: notify_reason === "ok", notify_reason, plan_changes, create, reprice, frozen_count };
 }
 
-// ── "重新同步本期帳單" (reconcile a period's bills to the current roster) ──────────
+// ── "重新同步此期帳單" (reconcile a period's bills to the current roster) ──────────
 
 export interface ReconcileLine {
   payment_id?: number;
@@ -445,7 +445,7 @@ async function sweepOrphanProofs(env: Env, removed: ReconcileLine[]): Promise<vo
 }
 
 /**
- * Reconcile a period's bills against the current active roster (manual "重新同步本期帳單").
+ * Reconcile a period's bills against the current active roster (manual "重新同步此期帳單").
  * add: an active sub with no bill → pending @ current plan price. remove: a pending/rejected bill of
  * a non-active sub → delete (+ R2 proof + matching upload_token cleanup). reprice: an active sub's
  * PENDING bill → current plan price. paid/verified are frozen. Only "opened" periods (those with a
@@ -524,7 +524,7 @@ export async function reconcilePeriodBills(
   return { opened: true, add, remove, reprice, frozen_count };
 }
 
-// ── "收回本期開繳" (retract a period that should never have been opened) ────────
+// ── "收回此期開繳" (retract a period that should never have been opened) ────────
 
 /** What the apply batch actually did, read back from each statement's meta.changes. */
 export interface RetractEffects {
@@ -544,7 +544,7 @@ export interface RetractResult {
 }
 
 /**
- * Retract a period's billing (manual "收回本期開繳") — the way back from a mis-opened month (a
+ * Retract a period's billing (manual "收回此期開繳") — the way back from a mis-opened month (a
  * slipped 發起繳費, or the cron running on a month nobody meant to bill). Deletes every
  * pending/rejected bill of the period (+ its upload_tokens and orphaned R2 proofs, same as
  * reconcile's remove path) and drops the period's billing_opened AND overdue notification slots, so
diff --git a/packages/worker/src/core/import.ts b/packages/worker/src/core/import.ts
index 30a36ab..c2a9f05 100644
--- a/packages/worker/src/core/import.ts
+++ b/packages/worker/src/core/import.ts
@@ -88,7 +88,7 @@ export interface ImportDiff {
   rows_skipped: number; // CSV rows with no email
   unmatched_plans: string[];
   /** REPORT-ONLY: this period's still-unpaid bills of the subs being paused. Import never
-   *  touches payments here — the admin clears them with 重新同步本期帳單. */
+   *  touches payments here — the admin clears them with 重新同步此期帳單. */
   affected_pending_bills: ImportBillLine[];
 }
 
@@ -129,7 +129,7 @@ interface RowPlan {
  *
  * Reactivation deliberately writes NO payment row: ensureFirstPayment bills the subscription's
  * ORIGINAL start_date month, which for a months-old paused sub would open a bill in a closed past
- * period. The current period's bill is exactly what 重新同步本期帳單 (reconcilePeriodBills) creates
+ * period. The current period's bill is exactly what 重新同步此期帳單 (reconcilePeriodBills) creates
  * for every active sub that lacks one — and only for periods that are actually open. Pausing is the
  * mirror image: the stale bills are reported in affected_pending_bills and removed by that same
  * action. So the whole period-bill story stays in one place.
@@ -274,7 +274,7 @@ export async function importRoster(
 /**
  * REPORT-ONLY: the period's still-unpaid (pending/rejected) bills of the subscriptions this import
  * is about to pause. Import never writes to payments — pausing a sub leaves its bills exactly where
- * they are, and the admin clears them with 重新同步本期帳單 (reconcilePeriodBills), which already
+ * they are, and the admin clears them with 重新同步此期帳單 (reconcilePeriodBills), which already
  * knows how to delete a non-active sub's unpaid bill plus its R2 proof and upload token. Bills from
  * OLDER periods are deliberately not listed: they are real unpaid debt, not a stale bill.
  */
diff --git a/packages/worker/src/core/notify.ts b/packages/worker/src/core/notify.ts
index 491cd07..75e0da4 100644
--- a/packages/worker/src/core/notify.ts
+++ b/packages/worker/src/core/notify.ts
@@ -125,7 +125,7 @@ export async function releaseSlot(db: D1Database, id: number): Promise<number> {
  * log, it IS the definition of "this period is open" (isBillingOpened, core/db.ts
  * listOpenPayablePeriods), so deleting it alone leaves pending bills standing in a period members
  * can no longer pay — a half retract. routes/admin.ts:250 409s the same request for the same
- * reason; releasing it is only ever correct as part of 收回本期開繳 (core/billing.ts).
+ * reason; releasing it is only ever correct as part of 收回此期開繳 (core/billing.ts).
  */
 export type ReleasableKey = NotificationKey & { type: Exclude<NotificationKey["type"], "billing_opened"> };
 
diff --git a/packages/worker/src/core/scheduled.ts b/packages/worker/src/core/scheduled.ts
index 2c793b8..be676c5 100644
--- a/packages/worker/src/core/scheduled.ts
+++ b/packages/worker/src/core/scheduled.ts
@@ -194,7 +194,7 @@ export async function sendOverdueForPeriod(
     // says only "these people have already been reminded", and after a refused send nobody was.
     // Keeping it would mute this period's reminders permanently: every later claim (cron included)
     // would just lose and report already_sent, with no error surfacing anywhere. That is the exact
-    // trap 收回本期開繳 avoids by deleting this row, so a failed send releases it for the same reason.
+    // trap 收回此期開繳 avoids by deleting this row, so a failed send releases it for the same reason.
     // The release goes by the row id we won, so it can never delete a concurrent claim's row.
     await releaseSlot(env.DB, slot.id!);
     return { notified: 0, outcome: "send_failed", overdue_days: settings.overdue_days, people };
diff --git a/packages/worker/src/env.ts b/packages/worker/src/env.ts
index d461137..43c7891 100644
--- a/packages/worker/src/env.ts
+++ b/packages/worker/src/env.ts
@@ -49,7 +49,7 @@ export const DEFAULT_SETTINGS: WorkspaceSettings = {
   overdue_days: 3,
   proof_retention_months: 24,
   admin_discord_ids: [],
-  overdue_template: "⏰ **{period} 催繳**\n以下夥伴本期尚有未繳（共 {count} 位），請儘速處理 🙏\n{list}",
+  overdue_template: "⏰ **{period} 催繳**\n以下夥伴尚有未繳（共 {count} 位），請儘速處理 🙏\n{list}",
   billing_opened_template: "📢 **{period} 開始繳費**\n{plans}\n\n請點下方「繳費」按鈕，或使用 `/繳費` 指令（可附截圖）。",
   payment_message_template: "💳 **AI 訂閱繳費**\n點下方「繳費」按鈕選擇繳費渠道送出（一次涵蓋你所有訂閱），或使用 `/繳費` 指令（可附截圖／備註）。",
   payment_bark_key: "",
diff --git a/packages/worker/src/routes/admin.ts b/packages/worker/src/routes/admin.ts
index 5912322..006801c 100644
--- a/packages/worker/src/routes/admin.ts
+++ b/packages/worker/src/routes/admin.ts
@@ -111,7 +111,7 @@ async function billingInitiate(req: Request, env: Env, ctx: RouteCtx): Promise<R
 }
 
 /**
- * "重新同步本期帳單": reconcile a period's bills to the current roster. dry_run defaults to true (safe
+ * "重新同步此期帳單": reconcile a period's bills to the current roster. dry_run defaults to true (safe
  * preview) — only an explicit { dry_run: false } applies. With { notify_added: true }, after applying it
  * pings the newly-added BOUND members in the billing channel with a pay button.
  */
@@ -147,7 +147,7 @@ async function syncPeriodBills(req: Request, env: Env, ctx: RouteCtx): Promise<R
 }
 
 /**
- * "收回本期開繳": undo a mis-opened period — drop its pending/rejected bills (paid/verified stay
+ * "收回此期開繳": undo a mis-opened period — drop its pending/rejected bills (paid/verified stay
  * frozen) and its billing_opened marker, putting the period back to "unopened" so it can be opened
  * again later. dry_run defaults to true (safe preview), matching /sync. A period that is not open
  * is a 200 no-op; the audit records only real retracts, so `billing.retract` never claims a change
@@ -238,9 +238,9 @@ async function notificationsReset(req: Request, env: Env, ctx: RouteCtx): Promis
   // The billing_opened row is not a send log — it IS the definition of "this period is open"
   // (core/notify.ts isBillingOpened, core/db.ts listOpenPayablePeriods). Deleting it alone leaves
   // every pending bill standing in a period members can no longer pay: a half retract. The whole
-  // operation lives in 收回本期開繳, which also deletes the bills and the upload tokens.
+  // operation lives in 收回此期開繳, which also deletes the bills and the upload tokens.
   if (b.type === "billing_opened") {
-    return errorResponse(409, "開繳紀錄不能單獨重置（那會讓本期回到未開繳、帳單卻全留著）。請到「繳費審核」使用「收回本期開繳」。");
+    return errorResponse(409, "開繳紀錄不能單獨重置（那會讓此期回到未開繳、帳單卻全留著）。請到「繳費審核」使用「收回此期開繳」。");
   }
   const res = await env.DB.prepare("DELETE FROM notification_logs WHERE workspace_id = ? AND type = ? AND period = ?")
     .bind(ws, b.type, period).run();
diff --git a/packages/worker/src/routes/upload.ts b/packages/worker/src/routes/upload.ts
index fc45623..cdfd973 100644
--- a/packages/worker/src/routes/upload.ts
+++ b/packages/worker/src/routes/upload.ts
@@ -83,9 +83,9 @@ export async function handleUpload(req: Request, env: Env, ctx: RouteCtx): Promi
   // Same gate the Discord path enforces (adapters/discord/handler.ts): a one-time link must not
   // settle a period members cannot otherwise pay. createUploadLink mints a token for any period,
   // opened or not, so without this an admin-issued link would settle the cron-created bills of a
-  // period that was never opened — or one that 收回本期開繳 has since closed.
+  // period that was never opened — or one that 收回此期開繳 has since closed.
   if (!(await isBillingOpened(env.DB, tok.workspace_id, tok.period))) {
-    return errorResponse(409, "本期繳費尚未開放，待管理員發出開繳通知後即可繳費。", { code: "payment" });
+    return errorResponse(409, `${tok.period} 的繳費尚未開放，待管理員發出開繳通知後即可繳費。`, { code: "payment" });
   }
 
   try {
diff --git a/packages/worker/test/adapters/discord-initiate-cap.test.ts b/packages/worker/test/adapters/discord-initiate-cap.test.ts
index 001f8d6..a86b655 100644
--- a/packages/worker/test/adapters/discord-initiate-cap.test.ts
+++ b/packages/worker/test/adapters/discord-initiate-cap.test.ts
@@ -57,7 +57,7 @@ describe("/發起繳費 的方案數上限", () => {
 
     expect(replied).toContain("6");
     expect(replied).toContain("後台");
-    // 拒絕就要是真的拒絕：定價沒被改、本期沒被開繳、也沒有半張帳單。
+    // 拒絕就要是真的拒絕：定價沒被改、此期沒被開繳、也沒有半張帳單。
     const p = await env.DB.prepare("SELECT monthly_amount FROM plans WHERE id = ?").bind(98500).first<{ monthly_amount: number }>();
     expect(p!.monthly_amount).toBe(100);
     const marker = await env.DB.prepare(
diff --git a/packages/worker/test/adapters/discord-pay.test.ts b/packages/worker/test/adapters/discord-pay.test.ts
index ab4b6ff..42f6935 100644
--- a/packages/worker/test/adapters/discord-pay.test.ts
+++ b/packages/worker/test/adapters/discord-pay.test.ts
@@ -144,7 +144,8 @@ describe("/繳費 with no R2 ignores the screenshot", () => {
     vi.unstubAllGlobals();
     (env as any).BUCKET = prevB;
     (env as any).DISCORD_APPLICATION_ID = prevApp;
-    expect(captured).toContain("已登記本期");
+    expect(captured).toContain("已登記");
+    expect(captured).toMatch(/\d{4}-\d{2}/);   // 回覆改成報實際期別（YYYY-MM）
     expect(captured).toContain("已記錄你的繳費宣告");
   });
 });
diff --git a/packages/worker/test/core/billing-initiate-no-plans.test.ts b/packages/worker/test/core/billing-initiate-no-plans.test.ts
index c5ed0dc..1fa2a45 100644
--- a/packages/worker/test/core/billing-initiate-no-plans.test.ts
+++ b/packages/worker/test/core/billing-initiate-no-plans.test.ts
@@ -4,10 +4,10 @@ import { initiateBillingOpened, previewBillingInitiate } from "../../src/core/bi
 import type { Notifier } from "../../src/core/notify";
 
 /**
- * 沒有任何「會出現在公告裡」的方案時，發起繳費不能把本期標記成已開繳。
+ * 沒有任何「會出現在公告裡」的方案時，發起繳費不能把此期標記成已開繳。
  * 公告名單只收「啟用中的方案」，所以訂閱掛在停用方案上的 workspace 會落在這個洞裡：
- * 舊實作先搶下 billing_opened 名額、才發現沒東西可公告，結果本期永遠是「已開繳但從沒通知過」，
- * 只能靠收回本期開繳救回來。預覽早就把這個情況叫做 no_plans，apply 必須說同一句話。
+ * 舊實作先搶下 billing_opened 名額、才發現沒東西可公告，結果此期永遠是「已開繳但從沒通知過」，
+ * 只能靠收回此期開繳救回來。預覽早就把這個情況叫做 no_plans，apply 必須說同一句話。
  */
 const TS = "2026-05-01T00:00:00.000Z";
 const WS = 9870, PLAN_OFF = 9870, USER = 9870, SUB = 9870;
@@ -51,7 +51,7 @@ describe("發起繳費：沒有可公告的方案時", () => {
     const r = await initiateBillingOpened(env, WS, PERIOD, { amounts: [] }, "owner@x", notifier);
     expect(r).toMatchObject({ sent: false, notifyReason: "no_plans" });
     expect(sends).toBe(before);
-    // 這是這個修正的重點：沒有公告 = 沒有開繳紀錄，本期仍然是「未開繳」，可以修好方案後重來一次。
+    // 這是這個修正的重點：沒有公告 = 沒有開繳紀錄，此期仍然是「未開繳」，可以修好方案後重來一次。
     expect(await markerRows(WS, PERIOD)).toBe(0);
   });
 
diff --git a/packages/worker/test/core/import.test.ts b/packages/worker/test/core/import.test.ts
index 8d58a59..4cea066 100644
--- a/packages/worker/test/core/import.test.ts
+++ b/packages/worker/test/core/import.test.ts
@@ -247,7 +247,7 @@ describe("importRoster TRUE on paused / cancelled subscriptions", () => {
     const st = await env.DB.prepare("SELECT status FROM subscriptions WHERE id=?").bind(S_PAUSED).first<{ status: string }>();
     expect(st?.status).toBe("active");
     // No bill anywhere: not for the sub's old start month, not for the import period. The current
-    // period's bill is 重新同步本期帳單's job (reconcilePeriodBills).
+    // period's bill is 重新同步此期帳單's job (reconcilePeriodBills).
     const pays = await env.DB.prepare("SELECT COUNT(*) c FROM payments WHERE subscription_id=?").bind(S_PAUSED).first<{ c: number }>();
     expect(pays?.c).toBe(0);
   });
diff --git a/packages/worker/test/core/notify-send-failure.test.ts b/packages/worker/test/core/notify-send-failure.test.ts
index 0d7fe0b..7d47160 100644
--- a/packages/worker/test/core/notify-send-failure.test.ts
+++ b/packages/worker/test/core/notify-send-failure.test.ts
@@ -55,7 +55,7 @@ describe("發起繳費：通知送不出去時", () => {
     // 寫入的部分照樣發生，而且照實回報 —— 這通呼叫真的建了帳單、真的改了定價。
     expect(r.createdPayments).toBe(1);
     expect(r.updatedPlans).toBe(1);
-    // marker 不回收：帳單已經在那裡了，回收會讓本期變成「有帳單卻不能繳」的半套狀態
+    // marker 不回收：帳單已經在那裡了，回收會讓此期變成「有帳單卻不能繳」的半套狀態
     // （同 routes/admin.ts notificationsReset 的 409 所擋的情況）。補救路徑是「重發開繳通知」。
     expect(await isBillingOpened(env.DB, WS, P_INIT)).toBe(true);
     expect(await lastAudit("billing.initiate")).toMatchObject({ period: P_INIT, sent: false, notify_reason: "send_failed" });
@@ -109,7 +109,7 @@ describe("催繳：通知送不出去時", () => {
     expect(r.outcome).toBe("send_failed");
     expect(r.notified).toBe(0);
     // 名額若留著，這期就永遠不會再被催繳（claimNotification 之後只會回 already_sent，
-    // 而且沒有任何地方會報錯）—— 跟收回本期開繳釋放 overdue slot 是同一個理由。
+    // 而且沒有任何地方會報錯）—— 跟收回此期開繳釋放 overdue slot 是同一個理由。
     expect(await overdueSlots(P_OVERDUE)).toBe(0);
   });
 
diff --git a/packages/worker/test/routes/notifications-danger.test.ts b/packages/worker/test/routes/notifications-danger.test.ts
index 9f7fb8b..877c31a 100644
--- a/packages/worker/test/routes/notifications-danger.test.ts
+++ b/packages/worker/test/routes/notifications-danger.test.ts
@@ -108,10 +108,10 @@ describe("POST /admin/notifications/resend", () => {
 });
 
 describe("POST /admin/notifications/reset", () => {
-  it("拒絕重置 billing_opened，並指向收回本期開繳", async () => {
+  it("拒絕重置 billing_opened，並指向收回此期開繳", async () => {
     const r = await call("POST", "/admin/notifications/reset", { type: "billing_opened", period: OPENED });
     expect(r!.status).toBe(409);
-    expect(((await r!.json()) as any).error).toContain("收回本期開繳");
+    expect(((await r!.json()) as any).error).toContain("收回此期開繳");
     // marker 必須還在 —— 這正是這個 409 要保護的東西
     const row = await env.DB.prepare(
       "SELECT 1 AS ok FROM notification_logs WHERE workspace_id = 1 AND type = 'billing_opened' AND period = ?"

From 6e6c32393f2072615bab09ce4ec61bd17e79ca1b Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:33:22 +0800
Subject: [PATCH 08/20] =?UTF-8?q?refactor(copy):=20=E6=88=90=E5=93=A1?=
 =?UTF-8?q?=E7=B9=B3=E8=B2=BB=E9=A0=81=E6=94=B9=E7=A8=B1=E3=80=8C=E6=9C=88?=
 =?UTF-8?q?=E4=BB=BD=E3=80=8D=EF=BC=8C=E8=88=87=20Discord=20=E4=B8=80?=
 =?UTF-8?q?=E8=87=B4=EF=BC=88=E5=BE=8C=E5=8F=B0=E7=B6=AD=E6=8C=81=E3=80=8C?=
 =?UTF-8?q?=E6=9C=9F=E5=88=A5=E3=80=8D=EF=BC=89=20(#46=20D4)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 packages/web/src/App.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/web/src/App.tsx b/packages/web/src/App.tsx
index 2717e0f..b20fe1b 100644
--- a/packages/web/src/App.tsx
+++ b/packages/web/src/App.tsx
@@ -189,7 +189,7 @@ function Stub({
   return (
     <header className="stub">
       <div className="stub__row">
-        <span className="stub__label">期別</span>
+        <span className="stub__label">月份</span>
         <span className="stub__period">{period}</span>
       </div>
       <h2 className="stub__hi">嗨，{name || "夥伴"}</h2>

From 7cdc833553f248dc086ce10dd3c88c2dcb5a6b88 Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:35:38 +0800
Subject: [PATCH 09/20] =?UTF-8?q?fix(web):=20=E7=B9=B3=E8=B2=BB=E9=A0=81?=
 =?UTF-8?q?=E9=87=91=E9=A1=8D=E8=A3=9C=E5=8D=83=E5=88=86=E4=BD=8D=EF=BC=8C?=
 =?UTF-8?q?=E8=88=87=20Discord=20=E4=B8=80=E8=87=B4=20(#46=20D19=20web=20?=
 =?UTF-8?q?=E5=8D=8A=E9=82=8A)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

同一筆帳單，成員在 Discord 看到 NT$1,258、在繳費頁看到 NT$1258。
Discord 端（adapters/discord/notify.ts）一直都有 toLocaleString，
只有這一頁沒有。

admin 半邊（Manage.tsx 的方案選單與月費欄）留待 Task 8 的並行工作結束後再補，
避免與正在改同一檔的工作衝突。
---
 packages/web/src/App.tsx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/web/src/App.tsx b/packages/web/src/App.tsx
index b20fe1b..e9f035e 100644
--- a/packages/web/src/App.tsx
+++ b/packages/web/src/App.tsx
@@ -196,13 +196,13 @@ function Stub({
       {subs.map((s) => (
         <div key={s.payment_id} className="stub__row stub__row--amt">
           <span className="stub__plan">{s.plan_name}</span>
-          <span className="stub__amt">NT${s.amount}</span>
+          <span className="stub__amt">NT${s.amount.toLocaleString()}</span>
         </div>
       ))}
       {subs.length > 0 && (
         <div className="stub__row stub__row--amt">
           <span className="stub__plan">合計</span>
-          <span className="stub__amt">NT${total}</span>
+          <span className="stub__amt">NT${total.toLocaleString()}</span>
         </div>
       )}
     </header>

From 53a020c5c3ec641bfeacf47d388c9964814dce92 Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:36:30 +0800
Subject: [PATCH 10/20] =?UTF-8?q?docs(worker):=20=E6=A8=99=E8=A8=BB=20time?=
 =?UTF-8?q?zone=20=E6=98=AF=E6=AD=BB=E8=A8=AD=E5=AE=9A=20(#46=20D22)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

parseSettings 會讀它、也會原樣存回，但系統裡沒有任何一處使用——
所有日期都在 core/time.ts 寫死用 Asia/Taipei 計算。

保留而非刪除：刪掉會改動 settings schema，破壞 env.test.ts 斷言的
「存進去什麼、讀出來就是什麼」往返。後台也刻意沒有這個欄位——
一個改了不會有任何效果的控制項，比沒有控制項更糟。

要讓時區真的可設定，該改的是 core/time.ts，不是這一行。
---
 packages/worker/src/env.ts | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/worker/src/env.ts b/packages/worker/src/env.ts
index 43c7891..b7e47a7 100644
--- a/packages/worker/src/env.ts
+++ b/packages/worker/src/env.ts
@@ -16,6 +16,13 @@ export interface Env {
 }
 
 export interface WorkspaceSettings {
+  /**
+   * Dead setting (#46): parsed and round-tripped, but nothing reads it — every date in the system is
+   * computed in Asia/Taipei, hardcoded in core/time.ts. Kept (not deleted) because removing it would
+   * change the settings schema and break the stored-settings round-trip env.test.ts asserts.
+   * There is deliberately no admin UI field for it: an editable control that changes nothing is worse
+   * than no control. Making the timezone real means changing core/time.ts, not this line.
+   */
   timezone: string;
   discord_guild_id: string;
   discord_billing_channel_id: string;

From 6809f064da7a228c313b47fafdbe71b4cdab673a Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:36:35 +0800
Subject: [PATCH 11/20] =?UTF-8?q?feat(admin-ui):=20=E8=A8=82=E9=96=B1?=
 =?UTF-8?q?=E7=8B=80=E6=85=8B=EF=BC=8F=E4=BE=9B=E6=87=89=E5=95=86=E6=94=B9?=
 =?UTF-8?q?=E9=A1=AF=E7=A4=BA=E4=B8=AD=E6=96=87=EF=BC=88=E9=A1=AF=E7=A4=BA?=
 =?UTF-8?q?=E5=B1=A4=E5=B0=8D=E6=98=A0=EF=BC=8CDB=20=E5=80=BC=E4=B8=8D?=
 =?UTF-8?q?=E8=AE=8A=EF=BC=89=20(#46=20D11)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 packages/admin/src/views/Manage.tsx | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/packages/admin/src/views/Manage.tsx b/packages/admin/src/views/Manage.tsx
index 58ed37d..08b5519 100644
--- a/packages/admin/src/views/Manage.tsx
+++ b/packages/admin/src/views/Manage.tsx
@@ -122,6 +122,14 @@ function UserModal({ user, onClose, onDone }: { user: User | null; onClose: () =
 }
 
 // ── Subscriptions ─────────────────────────────────────────────────────────────
+// subscriptions.status is a DB enum — display only, the <option value> below stays English.
+const SUB_STATUSES = [
+  { v: "active", label: "啟用中" },
+  { v: "paused", label: "暫停" },
+  { v: "cancelled", label: "已取消" },
+];
+const SUB_STATUS_LABEL: Record<string, string> = Object.fromEntries(SUB_STATUSES.map((s) => [s.v, s.label]));
+
 export function Subscriptions() {
   const { data, loading, error, reload } = useAsync(() => api.subscriptions(), []);
   const [add, setAdd] = useState(false);
@@ -131,7 +139,7 @@ export function Subscriptions() {
   const all = data?.subscriptions ?? [];
   const needle = q.trim().toLowerCase();
   const shown = needle
-    ? all.filter((s) => [s.user_name, s.plan_name, s.status].some((x) => String(x).toLowerCase().includes(needle)))
+    ? all.filter((s) => [s.user_name, s.plan_name, s.status, SUB_STATUS_LABEL[s.status] ?? ""].some((x) => String(x).toLowerCase().includes(needle)))
     : all;
   return (
     <>
@@ -153,7 +161,7 @@ export function Subscriptions() {
                 <tr key={s.id}>
                   <td data-label="成員">{s.user_name}</td>
                   <td data-label="方案">{s.plan_name}</td>
-                  <td data-label="狀態">{s.status}</td>
+                  <td data-label="狀態">{SUB_STATUS_LABEL[s.status] ?? s.status}</td>
                   <td data-label="起算日" className="mono">{s.start_date}</td>
                   <td data-label="結帳日" className="right mono">{s.billing_day}</td>
                   <td className="right">
@@ -171,7 +179,7 @@ export function Subscriptions() {
       {del && (
         <ConfirmDanger
           title={`刪除訂閱 · ${del.user_name} · ${del.plan_name}`}
-          message={`將一併刪除此訂閱的 ${del.payment_count ?? 0} 筆繳費紀錄。\n此操作無法復原。（若只想停收可改用「編輯 → 狀態 cancelled」）`}
+          message={`將一併刪除此訂閱的 ${del.payment_count ?? 0} 筆繳費紀錄。\n此操作無法復原。（若只想停收，可改用「編輯 → 狀態：已取消」）`}
           onClose={() => setDel(null)}
           onConfirm={async () => { await api.deleteSubscription(del.id); setDel(null); reload(); }}
         />
@@ -231,7 +239,7 @@ function SubEditModal({ sub, onClose, onDone }: { sub: Subscription; onClose: ()
   return (
     <Modal title={`編輯訂閱 · ${sub.user_name} · ${sub.plan_name}`} onClose={onClose}>
       {err && <div className="error-banner">{err}</div>}
-      <Field label="狀態"><select value={f.status} onChange={(e) => set("status", e.target.value)} disabled={busy}><option value="active">active</option><option value="paused">paused</option><option value="cancelled">cancelled</option></select></Field>
+      <Field label="狀態"><select value={f.status} onChange={(e) => set("status", e.target.value)} disabled={busy}>{SUB_STATUSES.map((st) => <option key={st.v} value={st.v}>{st.label}</option>)}</select></Field>
       <Field label="起算日"><input type="date" value={f.start_date} onChange={(e) => set("start_date", e.target.value)} disabled={busy} /></Field>
       <Field label="結帳日 (1-28)">
         <span className="field__hint">每月幾號為這個訂閱結帳。29–31 在短月會落空，所以上限是 28。</span>
@@ -271,13 +279,13 @@ export function Plans() {
         <div className="tbl tbl--pin-first tbl--pin-last">
           <table className="tbl-cards">
             <caption className="sr-only">方案清單</caption>
-            <thead><tr><th scope="col">名稱</th><th scope="col">provider</th><th scope="col" className="right">月費</th><th scope="col">身分組 ID</th><th scope="col">啟用</th><th scope="col"><span className="sr-only">操作</span></th></tr></thead>
+            <thead><tr><th scope="col">名稱</th><th scope="col">供應商</th><th scope="col" className="right">月費</th><th scope="col">身分組 ID</th><th scope="col">啟用</th><th scope="col"><span className="sr-only">操作</span></th></tr></thead>
             <tbody>
               {loading && <tr><td colSpan={6}><Empty>載入中…</Empty></td></tr>}
               {shown.map((p) => (
                 <tr key={p.id}>
                   <td data-label="名稱">{p.name}</td>
-                  <td data-label="provider">{p.provider}</td>
+                  <td data-label="供應商">{p.provider}</td>
                   <td data-label="月費" className="right mono">NT${p.monthly_amount}</td>
                   <td data-label="身分組 ID" className="mono" style={{ fontSize: 12 }}>{p.discord_role_id ?? "—"}</td>
                   <td data-label="啟用">{p.active ? "✓" : "—"}</td>
@@ -309,7 +317,7 @@ function PlanModal({ plan, providers, onClose, onDone }: { plan: Plan | null; pr
   async function save() {
     const provider = f.provider.trim().toLowerCase();
     if (!f.name || !f.monthly_amount) { setErr("請填名稱與月費"); return; }
-    if (!provider) { setErr("請填 provider"); return; }
+    if (!provider) { setErr("請填供應商"); return; }
     setBusy(true); setErr(null);
     try {
       const body: any = { name: f.name, provider, monthly_amount: Number(f.monthly_amount), discord_role_id: f.discord_role_id || undefined, active: f.active ? 1 : 0 };
@@ -321,7 +329,7 @@ function PlanModal({ plan, providers, onClose, onDone }: { plan: Plan | null; pr
     <Modal title={plan ? "編輯方案" : "新增方案"} onClose={onClose}>
       {err && <div className="error-banner">{err}</div>}
       <Field label="名稱"><input value={f.name} onChange={(e) => set("name", e.target.value)} disabled={busy} /></Field>
-      <Field label="provider（選現有或直接輸入新的，如 gemini、glm）">
+      <Field label="供應商（選現有或直接輸入新的，如 gemini、glm）">
         <input list="plan-providers" value={f.provider} onChange={(e) => set("provider", e.target.value)} disabled={busy} placeholder="openai / anthropic / gemini …" />
         <datalist id="plan-providers">{providers.map((pv) => <option key={pv} value={pv} />)}</datalist>
       </Field>

From 2ac3ab4afc2d4564f51726dac4b89337321cf2aa Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:38:23 +0800
Subject: [PATCH 12/20] =?UTF-8?q?refactor(copy):=20=E3=80=8C=E6=B8=A0?=
 =?UTF-8?q?=E9=81=93=E3=80=81=E6=88=AA=E5=9C=96=E3=80=81=E5=82=99=E8=A8=BB?=
 =?UTF-8?q?=E8=87=B3=E5=B0=91=E5=A1=AB=E4=B8=80=E9=A0=85=E3=80=82=E3=80=8D?=
 =?UTF-8?q?=E7=B5=B1=E4=B8=80=E4=B8=89=E5=80=8B=E6=88=90=E5=93=A1=E5=85=A5?=
 =?UTF-8?q?=E5=8F=A3=EF=BC=8C=E4=B8=A6=E4=BF=AE=E6=AD=A3=E9=A0=81=E9=9D=A2?=
 =?UTF-8?q?=E6=A8=99=E9=A1=8C=E8=88=87=E5=8F=A5=E6=9C=AB=E6=A8=99=E9=BB=9E?=
 =?UTF-8?q?=20(#46=20D13/D20)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 packages/web/index.html                         | 2 +-
 packages/web/src/App.tsx                        | 9 +++++++--
 packages/web/src/api.ts                         | 2 +-
 packages/worker/src/adapters/discord/handler.ts | 2 +-
 packages/worker/src/env.ts                      | 2 +-
 packages/worker/src/routes/upload.ts            | 3 ++-
 packages/worker/test/routes/upload.test.ts      | 3 ++-
 7 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/packages/web/index.html b/packages/web/index.html
index cc3d9e3..79f1bc4 100644
--- a/packages/web/index.html
+++ b/packages/web/index.html
@@ -7,7 +7,7 @@
     <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
     <link rel="icon" href="/favicon-32.png" sizes="32x32" type="image/png" />
     <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
-    <title>ChipPot · 繳費上傳</title>
+    <title>ChipPot · 繳費登記</title>
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link
diff --git a/packages/web/src/App.tsx b/packages/web/src/App.tsx
index e9f035e..7b32369 100644
--- a/packages/web/src/App.tsx
+++ b/packages/web/src/App.tsx
@@ -46,10 +46,15 @@ export default function App() {
   const tags = info?.channel_tags ?? [];
   const total = subs.reduce((s, x) => s + x.amount, 0);
   const canSubmit = !!file || !!note.trim() || channelId != null;
+  // §A.12 的正規句：欄位順序固定為 渠道 → 截圖 → 備註；沒有 R2 時截圖欄整個不存在，句子也跟著少一項。
+  const atLeastOne = info?.proof_enabled === false ? "渠道、備註至少填一項。" : "渠道、截圖、備註至少填一項。";
 
   async function submit() {
     if (!token) return;
-    if (!canSubmit) return; // the button is disabled on the same condition (:158) — belt only
+    if (!canSubmit) {
+      setError(atLeastOne); // the submit button is disabled on the same condition — belt only
+      return;
+    }
     setError(null);
     setStage("submitting");
     const blob = file ? await compressImage(file) : null;
@@ -157,7 +162,7 @@ export default function App() {
         <button className="submit" onClick={submit} disabled={busy || !canSubmit}>
           {busy ? "上傳中…" : "送出繳費"}
         </button>
-        <p className="muted small center">{info?.proof_enabled === false ? "渠道或備註至少填一項。" : "渠道、截圖或備註至少填一項。"}此連結僅限你本人、此月份使用，送出後即失效。</p>
+        <p className="muted small center">{atLeastOne}此連結僅限你本人、此月份使用，送出後即失效。</p>
       </div>
     </Shell>
   );
diff --git a/packages/web/src/api.ts b/packages/web/src/api.ts
index a0446f9..df5767e 100644
--- a/packages/web/src/api.ts
+++ b/packages/web/src/api.ts
@@ -58,6 +58,6 @@ export async function submitPayment(
     const body = (await res.json().catch(() => ({}))) as { error?: string };
     return res.ok ? { ok: true } : { ok: false, error: body.error ?? `錯誤 ${res.status}` };
   } catch {
-    return { ok: false, error: "連線失敗，請稍後再試" };
+    return { ok: false, error: "連線失敗，請稍後再試。" };
   }
 }
diff --git a/packages/worker/src/adapters/discord/handler.ts b/packages/worker/src/adapters/discord/handler.ts
index 09fcbe3..d89504f 100644
--- a/packages/worker/src/adapters/discord/handler.ts
+++ b/packages/worker/src/adapters/discord/handler.ts
@@ -209,7 +209,7 @@ async function computePayResult(i: DiscordInteraction, env: Env, ctx: ExecutionC
   // At-least-one rule (slash): 渠道 / 截圖 / 備註.
   if (!declaredChannelTagId && !proof && !note) {
     if (screenshotIgnored) return "本站未開啟截圖功能，請改用「渠道」或「備註」登記繳費。";
-    return "請至少選擇「渠道」、附上「截圖」或填寫「備註」其中一項。";
+    return "渠道、截圖、備註至少填一項。";
   }
 
   const r = await settleUserPeriod(env, {
diff --git a/packages/worker/src/env.ts b/packages/worker/src/env.ts
index b7e47a7..817f96e 100644
--- a/packages/worker/src/env.ts
+++ b/packages/worker/src/env.ts
@@ -57,7 +57,7 @@ export const DEFAULT_SETTINGS: WorkspaceSettings = {
   proof_retention_months: 24,
   admin_discord_ids: [],
   overdue_template: "⏰ **{period} 催繳**\n以下夥伴尚有未繳（共 {count} 位），請儘速處理 🙏\n{list}",
-  billing_opened_template: "📢 **{period} 開始繳費**\n{plans}\n\n請點下方「繳費」按鈕，或使用 `/繳費` 指令（可附截圖）。",
+  billing_opened_template: "📢 **{period} 開繳**\n{plans}\n\n請點下方「繳費」按鈕，或使用 `/繳費` 指令（可附截圖）。",
   payment_message_template: "💳 **AI 訂閱繳費**\n點下方「繳費」按鈕選擇繳費渠道送出（一次涵蓋你所有訂閱），或使用 `/繳費` 指令（可附截圖／備註）。",
   payment_bark_key: "",
   payment_bark_server: "https://api.day.app",
diff --git a/packages/worker/src/routes/upload.ts b/packages/worker/src/routes/upload.ts
index cdfd973..71e6ba8 100644
--- a/packages/worker/src/routes/upload.ts
+++ b/packages/worker/src/routes/upload.ts
@@ -68,7 +68,8 @@ export async function handleUpload(req: Request, env: Env, ctx: RouteCtx): Promi
   }
 
   if (!hasFile && !note && declaredChannelTagId === null) {
-    return errorResponse(400, "請至少附上截圖、填寫備註，或選擇渠道。");
+    // §A.12 的正規句，與網頁與 Discord 三處同一句、同一欄位順序；沒有 R2 時頁面沒有截圖欄。
+    return errorResponse(400, env.BUCKET ? "渠道、截圖、備註至少填一項。" : "渠道、備註至少填一項。");
   }
 
   let proof: { body: ArrayBuffer; ext: string; contentType: string } | null = null;
diff --git a/packages/worker/test/routes/upload.test.ts b/packages/worker/test/routes/upload.test.ts
index be31c38..f00d360 100644
--- a/packages/worker/test/routes/upload.test.ts
+++ b/packages/worker/test/routes/upload.test.ts
@@ -130,7 +130,8 @@ describe("upload submit", () => {
 
   it("answers an empty submission in zh-TW", async () => {
     const res = await handleUpload(uploadReq(RAW_OK, {}), env, ctxFor(RAW_OK));
-    expect(((await res.json()) as any).error).toBe("請至少附上截圖、填寫備註，或選擇渠道。");
+    // §A.12 的正規句；沒有 R2 的部署少一項（測試環境依 BUCKET 是否綁定而定）。
+    expect(((await res.json()) as any).error).toBe(env.BUCKET ? "渠道、截圖、備註至少填一項。" : "渠道、備註至少填一項。");
   });
 
   it("rejects an empty submission (no screenshot, note, or channel)", async () => {

From fb5315e583f4c8357909cdaee8a271c6d3da8afd Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:40:46 +0800
Subject: [PATCH 13/20] =?UTF-8?q?feat(worker):=20=E5=BE=8C=E5=8F=B0?=
 =?UTF-8?q?=E5=8F=AF=E8=A7=B8=E5=8F=8A=E7=9A=84=E9=8C=AF=E8=AA=A4=E8=A8=8A?=
 =?UTF-8?q?=E6=81=AF=E6=94=B9=E7=82=BA=E4=B8=AD=E6=96=87=EF=BC=88=E6=A0=BC?=
 =?UTF-8?q?=E5=BC=8F=E9=A9=97=E8=AD=89=E7=B6=AD=E6=8C=81=E8=8B=B1=E6=96=87?=
 =?UTF-8?q?=EF=BC=89=20(#46=20D14)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 packages/worker/src/routes/admin.ts       | 85 ++++++++++++-----------
 packages/worker/test/routes/admin.test.ts | 46 ++++++++++++
 2 files changed, 92 insertions(+), 39 deletions(-)

diff --git a/packages/worker/src/routes/admin.ts b/packages/worker/src/routes/admin.ts
index 006801c..d7aea3f 100644
--- a/packages/worker/src/routes/admin.ts
+++ b/packages/worker/src/routes/admin.ts
@@ -18,6 +18,13 @@ import { sendOverdueForPeriod } from "../core/scheduled";
 import { renderTemplate } from "../core/templates";
 import { sendTestNotification } from "../core/payment-notify";
 
+// Error copy (#46 / §A.14): the admin SPA renders `data.error` straight into .error-banner, so
+// every message an admin can reach BY CLICKING answers in zh-TW. The ASCII ones left below are
+// English BY DESIGN, not an oversight: they guard shapes the UI cannot produce — `period` sits
+// behind <input type="month">, `billing_day`/amounts behind <input type="number">, the required-
+// field checks behind client-side validation, and the nudge/import body shapes are built by our
+// own code. They only ever surface to someone calling the API by hand, so they stay diagnostic.
+// Do not "finish the job" by translating them.
 // Single-workspace MVP: default to the seeded workspace, overridable via ?workspace_id=.
 const DEFAULT_WORKSPACE_ID = 1;
 const UPLOAD_TOKEN_TTL_MS = 30 * 60 * 1000;
@@ -51,7 +58,7 @@ async function readJson<T>(req: Request): Promise<T | null> {
 async function getWorkspace(_req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const row = await env.DB.prepare("SELECT * FROM workspaces WHERE id = ?").bind(wsId(ctx))
     .first<{ id: number; name: string; billing_day: number; settings: string }>();
-  if (!row) return errorResponse(404, "not found");
+  if (!row) return errorResponse(404, "找不到工作區設定");
   return json({ workspace: { ...row, settings: parseSettings(row.settings) }, r2_configured: !!env.BUCKET });
 }
 
@@ -59,7 +66,7 @@ async function updateWorkspace(req: Request, env: Env, ctx: RouteCtx): Promise<R
   const ws = wsId(ctx);
   const before = await env.DB.prepare("SELECT billing_day, settings FROM workspaces WHERE id = ?")
     .bind(ws).first<{ billing_day: number; settings: string }>();
-  if (!before) return errorResponse(404, "not found");
+  if (!before) return errorResponse(404, "找不到工作區設定");
   const b = await readJson<{ billing_day?: number; settings?: Record<string, unknown> }>(req) ?? {};
   if (b.billing_day !== undefined && (!Number.isInteger(b.billing_day) || b.billing_day < 1 || b.billing_day > 28)) {
     return errorResponse(400, "billing_day must be 1..28");
@@ -373,7 +380,7 @@ async function createUser(req: Request, env: Env, ctx: RouteCtx): Promise<Respon
 async function updateUser(req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const id = Number(ctx.params.id);
   const before = await env.DB.prepare("SELECT * FROM users WHERE id = ?").bind(id).first();
-  if (!before) return errorResponse(404, "not found");
+  if (!before) return errorResponse(404, "找不到這位成員");
   const b = await readJson<{ display_name?: string; discord_id?: string; email?: string; note?: string }>(req) ?? {};
   // Distinguish "field omitted" (keep current binding) from "field present-and-empty" (explicit
   // unbind). Without this, a display-name-only PATCH would silently null discord_id.
@@ -404,7 +411,7 @@ async function deleteUser(_req: Request, env: Env, ctx: RouteCtx): Promise<Respo
   const id = Number(ctx.params.id);
   const ws = wsId(ctx);
   const user = await env.DB.prepare("SELECT * FROM users WHERE id = ? AND workspace_id = ?").bind(id, ws).first();
-  if (!user) return errorResponse(404, "not found");
+  if (!user) return errorResponse(404, "找不到這位成員");
 
   if (env.BUCKET) {
     const keys = await env.DB.prepare(
@@ -435,7 +442,7 @@ async function deleteSubscription(_req: Request, env: Env, ctx: RouteCtx): Promi
   const id = Number(ctx.params.id);
   const ws = wsId(ctx);
   const sub = await env.DB.prepare("SELECT * FROM subscriptions WHERE id = ? AND workspace_id = ?").bind(id, ws).first();
-  if (!sub) return errorResponse(404, "not found");
+  if (!sub) return errorResponse(404, "找不到這筆訂閱");
 
   if (env.BUCKET) {
     const keys = await env.DB.prepare("SELECT DISTINCT screenshot_key AS k FROM payments WHERE subscription_id = ? AND workspace_id = ? AND screenshot_key IS NOT NULL").bind(id, ws).all<{ k: string }>();
@@ -481,7 +488,7 @@ async function createPlan(req: Request, env: Env, ctx: RouteCtx): Promise<Respon
 async function updatePlan(req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const id = Number(ctx.params.id);
   const before = await env.DB.prepare("SELECT * FROM plans WHERE id = ?").bind(id).first();
-  if (!before) return errorResponse(404, "not found");
+  if (!before) return errorResponse(404, "找不到這個方案");
   const b = await readJson<{ name?: string; provider?: string; monthly_amount?: number; discord_role_id?: string; active?: number }>(req) ?? {};
   await env.DB.prepare(
     `UPDATE plans SET name = COALESCE(?, name), provider = COALESCE(?, provider), monthly_amount = COALESCE(?, monthly_amount),
@@ -496,7 +503,7 @@ async function deletePlan(_req: Request, env: Env, ctx: RouteCtx): Promise<Respo
   const id = Number(ctx.params.id);
   const ws = wsId(ctx);
   const plan = await env.DB.prepare("SELECT * FROM plans WHERE id = ? AND workspace_id = ?").bind(id, ws).first();
-  if (!plan) return errorResponse(404, "not found");
+  if (!plan) return errorResponse(404, "找不到這個方案");
   const ref = await env.DB.prepare("SELECT COUNT(*) AS c FROM subscriptions WHERE plan_id = ? AND workspace_id = ?").bind(id, ws).first<{ c: number }>();
   if ((ref?.c ?? 0) > 0) return errorResponse(409, "此方案仍有訂閱（含已取消的歷史訂閱）：請先刪除這些訂閱，或將方案改為「停用」以保留歷史");
   await env.DB.prepare("DELETE FROM plans WHERE id = ? AND workspace_id = ?").bind(id, ws).run();
@@ -538,10 +545,10 @@ async function createSubscription(req: Request, env: Env, ctx: RouteCtx): Promis
 async function updateSubscription(req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const id = Number(ctx.params.id);
   const before = await env.DB.prepare("SELECT * FROM subscriptions WHERE id = ?").bind(id).first();
-  if (!before) return errorResponse(404, "not found");
+  if (!before) return errorResponse(404, "找不到這筆訂閱");
   const b = await readJson<{ status?: string; start_date?: string; billing_day?: number; custom_cycle?: number }>(req) ?? {};
   if (b.status && !["active", "paused", "cancelled"].includes(b.status)) {
-    return errorResponse(400, "invalid status");
+    return errorResponse(400, "狀態無效。");
   }
   await env.DB.prepare(
     `UPDATE subscriptions SET status = COALESCE(?, status), start_date = COALESCE(?, start_date),
@@ -576,7 +583,7 @@ async function createChannelTag(req: Request, env: Env, ctx: RouteCtx): Promise<
 async function updateChannelTag(req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const id = Number(ctx.params.id);
   const before = await env.DB.prepare("SELECT * FROM channel_tags WHERE id = ?").bind(id).first();
-  if (!before) return errorResponse(404, "not found");
+  if (!before) return errorResponse(404, "找不到這個渠道");
   const b = await readJson<{ name?: string; type?: string; active?: number; sort_order?: number }>(req) ?? {};
   await env.DB.prepare(
     `UPDATE channel_tags SET name = COALESCE(?, name), type = COALESCE(?, type),
@@ -591,7 +598,7 @@ async function deleteChannelTag(_req: Request, env: Env, ctx: RouteCtx): Promise
   const id = Number(ctx.params.id);
   const ws = wsId(ctx);
   const tag = await env.DB.prepare("SELECT * FROM channel_tags WHERE id = ? AND workspace_id = ?").bind(id, ws).first();
-  if (!tag) return errorResponse(404, "not found");
+  if (!tag) return errorResponse(404, "找不到這個渠道");
   const ref = await env.DB.prepare(
     "SELECT COUNT(*) AS c FROM payments WHERE workspace_id = ? AND (verified_channel_tag_id = ? OR declared_channel_tag_id = ?)"
   ).bind(ws, id, id).first<{ c: number }>();
@@ -645,12 +652,12 @@ async function listPayments(_req: Request, env: Env, ctx: RouteCtx): Promise<Res
 async function verifyPaymentHandler(req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const id = Number(ctx.params.id);
   const before = await getPayment(env.DB, id);
-  if (!before || before.workspace_id !== wsId(ctx)) return errorResponse(404, "not found");
+  if (!before || before.workspace_id !== wsId(ctx)) return errorResponse(404, "找不到這筆繳費紀錄");
   const b = await readJson<{ verified_channel_tag_id?: number }>(req) ?? {};
   // Default the verified channel to the user's declared channel when the admin doesn't override.
   const tagId = b.verified_channel_tag_id ?? before.declared_channel_tag_id ?? null;
   if (tagId != null && !(await tagBelongsToWorkspace(env, before.workspace_id, tagId))) {
-    return errorResponse(400, "invalid channel tag");
+    return errorResponse(400, "渠道無效，請重新選擇。");
   }
   try {
     const after = await verifyPayment(env.DB, id, { verifiedBy: actorOf(ctx), verifiedChannelTagId: tagId });
@@ -691,7 +698,7 @@ async function verifyAllHandler(req: Request, env: Env, ctx: RouteCtx): Promise<
   const period = b.period;
   const user = await env.DB.prepare("SELECT id FROM users WHERE id = ? AND workspace_id = ?")
     .bind(userId, ws).first<{ id: number }>();
-  if (!user) return errorResponse(404, "not found");
+  if (!user) return errorResponse(404, "找不到這位成員");
 
   const actor = actorOf(ctx);
   const paymentIds: number[] = [];
@@ -735,7 +742,7 @@ async function verifyAllHandler(req: Request, env: Env, ctx: RouteCtx): Promise<
 async function rejectPaymentHandler(req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const id = Number(ctx.params.id);
   const before = await getPayment(env.DB, id);
-  if (!before || before.workspace_id !== wsId(ctx)) return errorResponse(404, "not found");
+  if (!before || before.workspace_id !== wsId(ctx)) return errorResponse(404, "找不到這筆繳費紀錄");
   const b = await readJson<{ rejected_reason?: string }>(req) ?? {};
   try {
     const after = await rejectPayment(env.DB, id, { rejectedReason: b.rejected_reason ?? null, verifiedBy: actorOf(ctx) });
@@ -757,10 +764,10 @@ async function rejectPaymentHandler(req: Request, env: Env, ctx: RouteCtx): Prom
 async function overrideAmountHandler(req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const id = Number(ctx.params.id);
   const before = await getPayment(env.DB, id);
-  if (!before || before.workspace_id !== wsId(ctx)) return errorResponse(404, "not found");
+  if (!before || before.workspace_id !== wsId(ctx)) return errorResponse(404, "找不到這筆繳費紀錄");
   const b = await readJson<{ amount?: number }>(req);
   if (typeof b?.amount !== "number" || !Number.isInteger(b.amount) || b.amount < 0) {
-    return errorResponse(400, "integer amount required");
+    return errorResponse(400, "金額必須是整數。");
   }
   const after = await overrideAmount(env.DB, id, b.amount);
   await writeAudit(env.DB, { workspaceId: before.workspace_id, actor: actorOf(ctx), action: "amount.override", entityType: "payment", entityId: id, before: { amount: before.amount }, after: { amount: after.amount } });
@@ -770,7 +777,7 @@ async function overrideAmountHandler(req: Request, env: Env, ctx: RouteCtx): Pro
 async function unverifyPaymentHandler(_req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const id = Number(ctx.params.id);
   const before = await getPayment(env.DB, id);
-  if (!before || before.workspace_id !== wsId(ctx)) return errorResponse(404, "not found");
+  if (!before || before.workspace_id !== wsId(ctx)) return errorResponse(404, "找不到這筆繳費紀錄");
   try {
     const after = await unverifyPayment(env.DB, id);
     await writeAudit(env.DB, { workspaceId: before.workspace_id, actor: actorOf(ctx), action: "payment.unverify", entityType: "payment", entityId: id, before, after });
@@ -789,18 +796,18 @@ async function manualPayment(req: Request, env: Env, ctx: RouteCtx): Promise<Res
   if (!b?.subscription_id || !b.period) return errorResponse(400, "subscription_id and period are required");
   if (!PERIOD_RE.test(b.period)) return errorResponse(400, "period must be YYYY-MM");
   const status = b.status ?? "verified";
-  if (!["pending", "paid", "verified", "rejected"].includes(status)) return errorResponse(400, "invalid status");
+  if (!["pending", "paid", "verified", "rejected"].includes(status)) return errorResponse(400, "狀態無效。");
   if (b.amount !== undefined && (!Number.isInteger(b.amount) || b.amount < 0)) {
-    return errorResponse(400, "amount must be a non-negative integer");
+    return errorResponse(400, "金額必須是 0 或正整數。");
   }
   const ws = wsId(ctx);
   if (b.verified_channel_tag_id != null && !(await tagBelongsToWorkspace(env, ws, b.verified_channel_tag_id))) {
-    return errorResponse(400, "invalid channel tag");
+    return errorResponse(400, "渠道無效，請重新選擇。");
   }
   const sub = await env.DB.prepare(
     `SELECT s.billing_day AS billing_day, pl.monthly_amount AS amount FROM subscriptions s JOIN plans pl ON pl.id = s.plan_id WHERE s.id = ? AND s.workspace_id = ?`
   ).bind(b.subscription_id, ws).first<{ billing_day: number; amount: number }>();
-  if (!sub) return errorResponse(400, "invalid subscription");
+  if (!sub) return errorResponse(400, "找不到這筆訂閱。");
   const amount = b.amount ?? sub.amount;
   const now = nowUtcIso();
   const period_start = `${b.period}-01`;
@@ -830,7 +837,7 @@ async function manualPayment(req: Request, env: Env, ctx: RouteCtx): Promise<Res
 async function deleteProof(_req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const id = Number(ctx.params.id);
   const p = await getPayment(env.DB, id);
-  if (!p || p.workspace_id !== wsId(ctx)) return errorResponse(404, "not found");
+  if (!p || p.workspace_id !== wsId(ctx)) return errorResponse(404, "找不到這筆繳費紀錄");
   if (p.screenshot_key && env.BUCKET) await env.BUCKET.delete(p.screenshot_key);
   await env.DB.prepare("UPDATE payments SET screenshot_key = NULL, proof_deleted_at = ?, updated_at = ? WHERE id = ?")
     .bind(taipeiDate(), nowUtcIso(), id).run();
@@ -841,7 +848,7 @@ async function deleteProof(_req: Request, env: Env, ctx: RouteCtx): Promise<Resp
 async function deletePayment(_req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const id = Number(ctx.params.id);
   const p = await getPayment(env.DB, id);
-  if (!p || p.workspace_id !== wsId(ctx)) return errorResponse(404, "not found");
+  if (!p || p.workspace_id !== wsId(ctx)) return errorResponse(404, "找不到這筆繳費紀錄");
   await env.DB.batch([
     env.DB.prepare("DELETE FROM upload_tokens WHERE workspace_id = ? AND subscription_id = ? AND period = ?").bind(p.workspace_id, p.subscription_id, p.period),
     env.DB.prepare("DELETE FROM payments WHERE id = ?").bind(id),
@@ -864,9 +871,9 @@ async function createUploadLink(req: Request, env: Env, ctx: RouteCtx): Promise<
   if (!PERIOD_RE.test(b.period)) return errorResponse(400, "period must be YYYY-MM");
   const ws = wsId(ctx);
   const user = await env.DB.prepare("SELECT id FROM users WHERE id = ? AND workspace_id = ?").bind(b.user_id, ws).first();
-  if (!user) return errorResponse(400, "invalid user");
+  if (!user) return errorResponse(400, "找不到這位成員。");
   // Fail loud rather than mint a token only to hand back a broken relative link.
-  if (!env.WEB_ORIGIN) return errorResponse(500, "WEB_ORIGIN is not configured");
+  if (!env.WEB_ORIGIN) return errorResponse(500, "尚未設定 WEB_ORIGIN，無法產生上傳連結；請在 Worker 環境變數設定後重新部署。");
   const { raw, expiresAt } = await issueUploadToken(env.DB, {
     workspaceId: ws, userId: b.user_id, period: b.period, subscriptionId: b.subscription_id ?? null,
     ttlMs: UPLOAD_TOKEN_TTL_MS,
@@ -882,11 +889,11 @@ async function createUploadLink(req: Request, env: Env, ctx: RouteCtx): Promise<
 async function discordPaymentMessage(_req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const ws = wsId(ctx);
   const row = await env.DB.prepare("SELECT settings FROM workspaces WHERE id = ?").bind(ws).first<{ settings: string }>();
-  if (!row) return errorResponse(404, "not found");
+  if (!row) return errorResponse(404, "找不到工作區設定");
   const settings = parseSettings(row.settings);
   const channelId = settings.discord_billing_channel_id;
-  if (!channelId) return errorResponse(400, "discord_billing_channel_id is not set");
-  if (!env.DISCORD_BOT_TOKEN) return errorResponse(400, "bot token not configured");
+  if (!channelId) return errorResponse(400, "尚未設定繳費頻道 ID，請到「設定 → Discord 串接」填入。");
+  if (!env.DISCORD_BOT_TOKEN) return errorResponse(400, "尚未設定 Discord Bot Token，請在 Worker 環境變數設定後重新部署。");
 
   const body = {
     content: renderTemplate(settings.payment_message_template, { period: taipeiPeriod() }),
@@ -900,7 +907,7 @@ async function discordPaymentMessage(_req: Request, env: Env, ctx: RouteCtx): Pr
     messageId = created.id ?? "";
     ok = created.ok && !!messageId; // the id is what we persist, so a 2xx without one is still a failure here
   }
-  if (!ok) return errorResponse(502, "failed to post Discord message");
+  if (!ok) return errorResponse(502, "Discord 訊息張貼失敗，請確認機器人在該頻道有發言權限。");
 
   await env.DB.prepare("UPDATE workspaces SET settings = json_set(settings, '$.discord_payment_message_id', ?), updated_at = ? WHERE id = ?")
     .bind(messageId, nowUtcIso(), ws).run();
@@ -911,11 +918,11 @@ async function discordPaymentMessage(_req: Request, env: Env, ctx: RouteCtx): Pr
 async function discordBindMessage(_req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const ws = wsId(ctx);
   const row = await env.DB.prepare("SELECT settings FROM workspaces WHERE id = ?").bind(ws).first<{ settings: string }>();
-  if (!row) return errorResponse(404, "not found");
+  if (!row) return errorResponse(404, "找不到工作區設定");
   const settings = parseSettings(row.settings);
   const channelId = settings.discord_billing_channel_id;
-  if (!channelId) return errorResponse(400, "discord_billing_channel_id is not set");
-  if (!env.DISCORD_BOT_TOKEN) return errorResponse(400, "bot token not configured");
+  if (!channelId) return errorResponse(400, "尚未設定繳費頻道 ID，請到「設定 → Discord 串接」填入。");
+  if (!env.DISCORD_BOT_TOKEN) return errorResponse(400, "尚未設定 Discord Bot Token，請在 Worker 環境變數設定後重新部署。");
 
   const body = {
     content: "👋 還沒綁定的成員，點下方按鈕綁定你的 Discord 帳號；綁定後開繳／催繳才能 @ 到你。",
@@ -929,7 +936,7 @@ async function discordBindMessage(_req: Request, env: Env, ctx: RouteCtx): Promi
     messageId = created.id ?? "";
     ok = created.ok && !!messageId; // the id is what we persist, so a 2xx without one is still a failure here
   }
-  if (!ok) return errorResponse(502, "failed to post Discord message");
+  if (!ok) return errorResponse(502, "Discord 訊息張貼失敗，請確認機器人在該頻道有發言權限。");
 
   await env.DB.prepare("UPDATE workspaces SET settings = json_set(settings, '$.discord_bind_message_id', ?), updated_at = ? WHERE id = ?")
     .bind(messageId, nowUtcIso(), ws).run();
@@ -940,17 +947,17 @@ async function discordBindMessage(_req: Request, env: Env, ctx: RouteCtx): Promi
 async function discordRegisterCommands(_req: Request, env: Env, ctx: RouteCtx): Promise<Response> {
   const ws = wsId(ctx);
   const row = await env.DB.prepare("SELECT settings FROM workspaces WHERE id = ?").bind(ws).first<{ settings: string }>();
-  if (!row) return errorResponse(404, "not found");
+  if (!row) return errorResponse(404, "找不到工作區設定");
   const settings = parseSettings(row.settings);
   const guildId = settings.discord_guild_id;
-  if (!guildId) return errorResponse(400, "discord_guild_id is not set");
-  if (!env.DISCORD_APPLICATION_ID) return errorResponse(400, "DISCORD_APPLICATION_ID is not set");
-  if (!env.DISCORD_BOT_TOKEN) return errorResponse(400, "bot token not configured");
+  if (!guildId) return errorResponse(400, "尚未設定伺服器 ID（Guild），請到「設定 → Discord 串接」填入。");
+  if (!env.DISCORD_APPLICATION_ID) return errorResponse(400, "尚未設定 DISCORD_APPLICATION_ID，請在 Worker 環境變數設定後重新部署。");
+  if (!env.DISCORD_BOT_TOKEN) return errorResponse(400, "尚未設定 Discord Bot Token，請在 Worker 環境變數設定後重新部署。");
 
   // The registered payload mirrors this deployment: no R2 → no 截圖 option to offer.
   const commands = [payCommand(!!env.BUCKET), MY_BILLS_COMMAND, INITIATE_COMMAND, BIND_COMMAND];
   const res = await registerGuildCommands(env.DISCORD_BOT_TOKEN, env.DISCORD_APPLICATION_ID, guildId, commands);
-  if (!res.ok) return errorResponse(502, "failed to register commands");
+  if (!res.ok) return errorResponse(502, "指令註冊失敗，請確認 Bot Token 與伺服器 ID 是否正確。");
 
   const registeredAt = nowUtcIso();
   await env.DB.prepare("UPDATE workspaces SET settings = json_set(settings, '$.discord_commands_registered_at', ?), updated_at = ? WHERE id = ?")
diff --git a/packages/worker/test/routes/admin.test.ts b/packages/worker/test/routes/admin.test.ts
index 860860f..2d5d722 100644
--- a/packages/worker/test/routes/admin.test.ts
+++ b/packages/worker/test/routes/admin.test.ts
@@ -657,3 +657,49 @@ describe("POST /admin/discord/bind-message", () => {
     expect(s?.m).toBe("msg-bind-1");
   });
 });
+
+// #46: the admin SPA renders `data.error` straight into .error-banner, so anything reachable by
+// clicking must be zh-TW. Format validators behind type="month"/type="number" stay English on purpose.
+describe("admin error messages are zh-TW (#46)", () => {
+  it("404s in Chinese for an unknown member", async () => {
+    const res = await call("PATCH", "/admin/users/999999", { display_name: "x" });
+    expect(res!.status).toBe(404);
+    expect(((await res!.json()) as any).error).toContain("找不到這位成員");
+  });
+
+  it("404s in Chinese for an unknown subscription, plan, channel and payment", async () => {
+    const cases: [string, string, string][] = [
+      ["PATCH", "/admin/subscriptions/999999", "找不到這筆訂閱"],
+      ["PATCH", "/admin/plans/999999", "找不到這個方案"],
+      ["PATCH", "/admin/channel-tags/999999", "找不到這個渠道"],
+      ["POST", "/admin/payments/999999/unverify", "找不到這筆繳費紀錄"],
+    ];
+    for (const [method, path, expected] of cases) {
+      const res = await call(method, path, {});
+      expect(res!.status, path).toBe(404);
+      expect(((await res!.json()) as any).error, path).toContain(expected);
+    }
+  });
+
+  it("names the missing Discord channel setting in Chinese", async () => {
+    // The handler checks the channel first, then the token — so the token must be present for the
+    // channel branch to be the one that answers. Same save/restore pattern the file uses elsewhere.
+    const prevToken = (env as any).DISCORD_BOT_TOKEN;
+    (env as any).DISCORD_BOT_TOKEN = "test-bot-token";
+    const prev = await env.DB.prepare(
+      "SELECT json_extract(settings,'$.discord_billing_channel_id') AS c FROM workspaces WHERE id = 1"
+    ).first<{ c: string | null }>();
+    await env.DB.prepare("UPDATE workspaces SET settings = json_set(settings, '$.discord_billing_channel_id', '') WHERE id = 1").run();
+    const res = await call("POST", "/admin/discord/bind-message");
+    await env.DB.prepare("UPDATE workspaces SET settings = json_set(settings, '$.discord_billing_channel_id', ?) WHERE id = 1").bind(prev?.c ?? "").run();
+    if (prevToken === undefined) delete (env as any).DISCORD_BOT_TOKEN; else (env as any).DISCORD_BOT_TOKEN = prevToken;
+    expect(res!.status).toBe(400);
+    expect(((await res!.json()) as any).error).toContain("繳費頻道 ID");
+  });
+
+  it("keeps format validators in English (unreachable from the UI)", async () => {
+    const res = await call("POST", "/admin/billing/initiate", { period: "not-a-period", amounts: [] });
+    expect(res!.status).toBe(400);
+    expect(((await res!.json()) as any).error).toBe("period must be YYYY-MM");
+  });
+});

From 25061753afd664921583362c11fb4b8f89bc006e Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:41:33 +0800
Subject: [PATCH 14/20] =?UTF-8?q?feat(worker):=20=E7=8B=80=E6=85=8B?=
 =?UTF-8?q?=E7=AB=B6=E6=85=8B=E6=94=B9=E5=9B=9E=E4=B8=AD=E6=96=87=E8=AA=AA?=
 =?UTF-8?q?=E6=98=8E=EF=BC=8C=E4=B8=8D=E5=86=8D=E5=83=8F=20crash=EF=BC=88i?=
 =?UTF-8?q?d=EF=BC=8F=E7=9B=AE=E6=A8=99=E7=8B=80=E6=85=8B=E4=BF=9D?=
 =?UTF-8?q?=E7=95=99=E5=9C=A8=E9=8C=AF=E8=AA=A4=E7=89=A9=E4=BB=B6=E4=B8=8A?=
 =?UTF-8?q?=EF=BC=89=20(#46=20D15)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 packages/worker/src/core/payments.ts       |  4 +++-
 packages/worker/test/core/payments.test.ts | 12 ++++++++++++
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/packages/worker/src/core/payments.ts b/packages/worker/src/core/payments.ts
index 8ee73eb..137546c 100644
--- a/packages/worker/src/core/payments.ts
+++ b/packages/worker/src/core/payments.ts
@@ -52,7 +52,9 @@ export class InvalidPaymentTransition extends Error {
     public readonly paymentId: number,
     public readonly to: PaymentStatus
   ) {
-    super(`payment ${paymentId} cannot transition to '${to}'`);
+    // Surfaced verbatim in the admin error banner (routes/admin.ts returns e.message on 409), so it
+    // is copy, not a log line. paymentId/to stay on the instance for logs and tests.
+    super("這筆的狀態已被變動（可能已由其他人處理），請重新載入後再試。");
     this.name = "InvalidPaymentTransition";
   }
 }
diff --git a/packages/worker/test/core/payments.test.ts b/packages/worker/test/core/payments.test.ts
index 6f0616f..00fc4a0 100644
--- a/packages/worker/test/core/payments.test.ts
+++ b/packages/worker/test/core/payments.test.ts
@@ -102,3 +102,15 @@ describe("payment state machine", () => {
     expect(p.amount).toBe(300);
   });
 });
+
+// #46: this is a reproducible race (two admins, or a stale list), so the message the admin sees must
+// say what to do — while the id/target stay on the error object for logs.
+describe("InvalidPaymentTransition copy (#46)", () => {
+  it("explains the race in zh-TW and keeps its fields", () => {
+    const e = new InvalidPaymentTransition(1042, "verified");
+    expect(e.message).toBe("這筆的狀態已被變動（可能已由其他人處理），請重新載入後再試。");
+    expect(e.paymentId).toBe(1042);
+    expect(e.to).toBe("verified");
+    expect(e.name).toBe("InvalidPaymentTransition");
+  });
+});

From 7c794bed5f9e53a68a899b5b3cab2bba564b7f34 Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:42:58 +0800
Subject: [PATCH 15/20] =?UTF-8?q?fix(admin-ui):=20=E6=96=B9=E6=A1=88?=
 =?UTF-8?q?=E9=87=91=E9=A1=8D=E8=A3=9C=E5=8D=83=E5=88=86=E4=BD=8D=EF=BC=9B?=
 =?UTF-8?q?=E8=BA=AB=E5=88=86=E7=B5=84=E6=AC=84=E4=BD=8D=E4=B8=8D=E5=86=8D?=
 =?UTF-8?q?=E6=9A=97=E7=A4=BA=E8=87=AA=E5=8B=95=E7=99=BC=E6=94=BE=20(#46?=
 =?UTF-8?q?=20D19/D21)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

D19 admin 半邊：方案選單與月費欄的 NT$ 金額補上 toLocaleString，
與 Discord、繳費頁一致。

D21：欄位標籤原本只寫「（通知 tag 用）」，容易被讀成系統會管理身分組。
實際上 plans.discord_role_id 只用來在公告裡 @ 那個身分組——
不會自動發放、也不會在退訂時回收。標籤改為明講這件事。
---
 packages/admin/src/views/Manage.tsx | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/admin/src/views/Manage.tsx b/packages/admin/src/views/Manage.tsx
index 08b5519..258aab5 100644
--- a/packages/admin/src/views/Manage.tsx
+++ b/packages/admin/src/views/Manage.tsx
@@ -216,7 +216,7 @@ function SubAddModal({ onClose, onDone }: { onClose: () => void; onDone: () => v
         options={(users.data?.users ?? []).map((u) => ({ value: String(u.id), label: u.display_name }))} />
       <FilterSelect label="方案" value={f.plan_id} disabled={busy}
         onChange={(v) => set("plan_id", v)}
-        options={(plans.data?.plans ?? []).filter((p) => p.active).map((p) => ({ value: String(p.id), label: `${p.name}（NT$${p.monthly_amount}）` }))} />
+        options={(plans.data?.plans ?? []).filter((p) => p.active).map((p) => ({ value: String(p.id), label: `${p.name}（NT$${p.monthly_amount.toLocaleString()}）` }))} />
       {/* type=date, not a bare text box with a placeholder: everywhere else in the app a date is
           picked (Settings and the payment modals all use type="month"). */}
       <Field label="起算日"><input type="date" value={f.start_date} onChange={(e) => set("start_date", e.target.value)} disabled={busy} /></Field>
@@ -286,7 +286,7 @@ export function Plans() {
                 <tr key={p.id}>
                   <td data-label="名稱">{p.name}</td>
                   <td data-label="供應商">{p.provider}</td>
-                  <td data-label="月費" className="right mono">NT${p.monthly_amount}</td>
+                  <td data-label="月費" className="right mono">NT${p.monthly_amount.toLocaleString()}</td>
                   <td data-label="身分組 ID" className="mono" style={{ fontSize: 12 }}>{p.discord_role_id ?? "—"}</td>
                   <td data-label="啟用">{p.active ? "✓" : "—"}</td>
                   <td className="right">
@@ -334,7 +334,7 @@ function PlanModal({ plan, providers, onClose, onDone }: { plan: Plan | null; pr
         <datalist id="plan-providers">{providers.map((pv) => <option key={pv} value={pv} />)}</datalist>
       </Field>
       <Field label="月費 (TWD)"><input type="number" value={f.monthly_amount} onChange={(e) => set("monthly_amount", e.target.value)} disabled={busy} /></Field>
-      <Field label="Discord 身分組 ID（通知 tag 用）"><input value={f.discord_role_id} onChange={(e) => set("discord_role_id", e.target.value)} disabled={busy} /></Field>
+      <Field label="Discord 身分組 ID（僅用於通知時 @ 該身分組，不會自動發放或回收身分組）"><input value={f.discord_role_id} onChange={(e) => set("discord_role_id", e.target.value)} disabled={busy} /></Field>
       <label style={{ display: "flex", gap: 8, alignItems: "center", marginBottom: 14 }}><input type="checkbox" checked={!!f.active} onChange={(e) => set("active", e.target.checked ? 1 : 0)} disabled={busy} /> 啟用</label>
       <button className="btn btn--primary" onClick={save} disabled={busy}>儲存</button>
     </Modal>

From dd6ba7657941c81e7c68015efdb2ae9edb0dfb17 Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:43:56 +0800
Subject: [PATCH 16/20] =?UTF-8?q?docs(copy):=20=E6=A8=99=E8=A8=BB=E8=BA=AB?=
 =?UTF-8?q?=E5=88=86=E7=B5=84=E4=B8=8D=E8=87=AA=E5=8B=95=E7=99=BC=E6=94=BE?=
 =?UTF-8?q?=E3=80=81=E5=AF=AB=E6=AD=BB=E8=A8=8A=E6=81=AF=E4=B8=8D=E5=8F=97?=
 =?UTF-8?q?=E6=A8=A1=E6=9D=BF=E6=8E=A7=E5=88=B6=E3=80=81timezone=20?=
 =?UTF-8?q?=E6=AD=BB=E8=A8=AD=E5=AE=9A=20(#46=20D16/D22)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

三件事的誠實解法是「把實情講出來」，而不是重建（§A.15）：

- 設定頁「Discord 訊息文字」卡片原本讓人以為所有機器人訊息都能改，
  實際只有開繳／催繳／常駐繳費訊息三則。卡片說明改為明講，
  並在兩則寫死的訊息（綁定提示、個別催繳）上加註為什麼還沒模板化——
  要模板化就得改 settings schema，屬期別生命週期重構的範圍。
- README 補一行說明 timezone 是死設定。

測試維持 431，沒有任何斷言因註解而移動。
---
 README.zh-TW.md                                | 1 +
 packages/admin/src/views/Settings.tsx          | 2 +-
 packages/worker/src/adapters/discord/notify.ts | 3 +++
 packages/worker/src/routes/admin.ts            | 3 +++
 4 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/README.zh-TW.md b/README.zh-TW.md
index 9b53fe2..53230b0 100644
--- a/README.zh-TW.md
+++ b/README.zh-TW.md
@@ -199,6 +199,7 @@ pnpm --filter @chippot/worker register
   Discord guild／頻道 id、可發起繳費的管理員白名單（`admin_discord_ids`）、三種可自訂的通知模板，
   以及選填的**繳費推播**（Bark 裝置金鑰和／或 incoming webhook；推播裡的審核深連結由 `ADMIN_ORIGIN`
   組出，不必另外設定）。
+  `timezone` 目前是死設定——時區固定為 Asia/Taipei（`core/time.ts`），改這個欄位沒有任何效果。
 - **Discord** — 把 app 的 Interactions Endpoint 設成 Worker 的 `/interactions`，再用上面的腳本註冊 guild 指令。
 
 ## 後台與營運
diff --git a/packages/admin/src/views/Settings.tsx b/packages/admin/src/views/Settings.tsx
index a203338..6c341db 100644
--- a/packages/admin/src/views/Settings.tsx
+++ b/packages/admin/src/views/Settings.tsx
@@ -274,7 +274,7 @@ export function Settings() {
         </div>
       </Card>
 
-      <Card title="Discord 訊息文字" desc="機器人在頻道發出的訊息（支援 Discord markdown，即時預覽）">
+      <Card title="Discord 訊息文字" desc="只有這三則可自訂（支援 Discord markdown，即時預覽）。回條、個別催繳、綁定提示等訊息目前寫死在程式裡。">
         <div className="card__body">
           <TemplateField label="開繳通知（{period} {plans} {total}）" value={form.billing_opened_template} onChange={set("billing_opened_template")} allowed={BILLING_KEYS} sample={samples.billing} disabled={busy} rows={4} />
           <TemplateField label="逾期催繳（{period} {count} {list}）" value={form.overdue_template} onChange={set("overdue_template")} allowed={OVERDUE_KEYS} sample={samples.overdue} disabled={busy} rows={4} />
diff --git a/packages/worker/src/adapters/discord/notify.ts b/packages/worker/src/adapters/discord/notify.ts
index 9a44816..bf0008f 100644
--- a/packages/worker/src/adapters/discord/notify.ts
+++ b/packages/worker/src/adapters/discord/notify.ts
@@ -53,6 +53,9 @@ export const discordNotifier: Notifier = {
         return `・${mention} ${plans}（合計 NT$${p.total.toLocaleString()}）`;
       })
       .join("\n");
+    // Hardcoded on purpose for now (#46): unlike 開繳／催繳／常駐繳費訊息, this message has no
+    // workspace-settings template. 設定 → Discord 訊息文字 says so. Making it editable is a settings
+    // schema change (deferred with the rest of the 期別 lifecycle work).
     const head = kind === "remind" ? `🔔 ${period} 繳費提醒：` : `📋 已將你加入 ${period} 繳費名單：`;
     const content = `${head}\n${list}\n請點下方按鈕繳費。`;
     // Pin mentions to exactly the added members' ids — template/display-name text can't ping.
diff --git a/packages/worker/src/routes/admin.ts b/packages/worker/src/routes/admin.ts
index d7aea3f..f1eda40 100644
--- a/packages/worker/src/routes/admin.ts
+++ b/packages/worker/src/routes/admin.ts
@@ -925,6 +925,9 @@ async function discordBindMessage(_req: Request, env: Env, ctx: RouteCtx): Promi
   if (!env.DISCORD_BOT_TOKEN) return errorResponse(400, "尚未設定 Discord Bot Token，請在 Worker 環境變數設定後重新部署。");
 
   const body = {
+    // Hardcoded on purpose for now (#46): unlike 開繳／催繳／常駐繳費訊息, this message has no
+    // workspace-settings template. 設定 → Discord 訊息文字 says so. Making it editable is a settings
+    // schema change (deferred with the rest of the 期別 lifecycle work).
     content: "👋 還沒綁定的成員，點下方按鈕綁定你的 Discord 帳號；綁定後開繳／催繳才能 @ 到你。",
     components: [bindButtonRow(ws)],
   };

From 5a9c6833780b0e79d733b00c34541a55823bd63c Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:45:04 +0800
Subject: [PATCH 17/20] =?UTF-8?q?docs(readme):=20=E5=90=8C=E6=AD=A5=20P0-7?=
 =?UTF-8?q?=20=E7=9A=84=E7=94=A8=E8=A9=9E=EF=BC=88=E7=A7=BB=E9=99=A4?=
 =?UTF-8?q?=E5=B7=B2=E9=80=80=E8=A8=82=20=E2=86=92=20=E8=A8=82=E9=96=B1?=
 =?UTF-8?q?=E5=B7=B2=E6=9A=AB=E5=81=9C=EF=BC=8F=E5=B7=B2=E5=8F=96=E6=B6=88?=
 =?UTF-8?q?=EF=BC=89=20(#46)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Task 15 的全域稽核抓到的殘留：UI 的標題在 P0-7 已改，README 還寫著舊的。
順帶把同一行的「已繳」補成「已繳待驗」（D2 的用詞）。
---
 README.zh-TW.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.zh-TW.md b/README.zh-TW.md
index 53230b0..454aed9 100644
--- a/README.zh-TW.md
+++ b/README.zh-TW.md
@@ -212,7 +212,7 @@ pnpm --filter @chippot/worker register
   同一頁：共用截圖只顯示一次、每一筆都列出且可單筆驗證／退回，已繳待驗的可一鍵掃過去驗證（還有
   待繳／已退回的會明講需要逐筆處理）。手機版把繳費表改成堆疊卡片、彈窗改成底部抽屜。
 - **重新同步此期帳單** — 在繳費審核頁，把目前篩選的**已開期別**帳單對齊現在的名單／價格
-  （補缺漏 · 移除已退訂 · 待繳改現價 · 已繳／已驗證凍結）；先出差異預覽再套用，並可勾選用繳費按鈕
+  （補缺漏 · 移除訂閱已暫停／已取消者 · 待繳改現價 · 已繳待驗／已驗證凍結）；先出差異預覽再套用，並可勾選用繳費按鈕
   @ 通知新加進來的成員。選「全部期別」時按鈕停用。
 - **發起繳費** — 確認所選期別各方案金額（任何更動就是該方案的新定價），先看「會建立／改價哪些帳單、
   定價 before→after、是否會發通知」的預覽，確認後才送出。預設期別是**目前收款中的那一期**，

From b6c53e303ad5fa6277ee697434c740804e378329 Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:47:14 +0800
Subject: [PATCH 18/20] =?UTF-8?q?style(copy):=20=E7=B5=B1=E4=B8=80?=
 =?UTF-8?q?=E3=80=8C=E2=80=A6=E3=80=8D=E6=85=A3=E4=BE=8B=E3=80=81=E6=88=90?=
 =?UTF-8?q?=E5=8A=9F=E8=A8=8A=E6=81=AF=E5=89=8D=E7=B6=B4=E8=88=87=E5=88=97?=
 =?UTF-8?q?=E8=A1=A8=E5=88=86=E9=9A=94=20(#46=20D17/D18)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

§A.10 的純格式收尾（Task 13）：

- 規則 5：開窗的工具列／卡片頭動作補上 `…`
  （重新同步此期帳單…、收回此期開繳…、產生上傳連結…、手動補登…、
   新增成員…、新增訂閱…、新增方案…、新增渠道…）。
  列內的 編輯／刪除／停用／啟用 **刻意不加** —— 它們每列重複一次，
  UX-B 已把那些列在行動版變成卡片，多一個字元純粹是噪音。
- 規則 6：收回預覽的進度字 `計算中…` → `計算差異中…`，與同步預覽一致。
- 規則 4：SyncModal／RetractModal 兩則成功訊息補 `✓ ` 前綴。
- 規則 3：匯入結果的半形 `/` 改頓號；「會新增/暫停訂閱」標籤改全形 `／`。
- 規則 2：結帳日提示的 `29–31` en-dash 改 ASCII `29-31`。

行為零變動；worker 431 tests / 57 files 全綠。
---
 packages/admin/src/views/Manage.tsx   | 10 +++++-----
 packages/admin/src/views/Payments.tsx | 14 +++++++-------
 packages/admin/src/views/Settings.tsx |  4 ++--
 3 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/packages/admin/src/views/Manage.tsx b/packages/admin/src/views/Manage.tsx
index 258aab5..6f75d91 100644
--- a/packages/admin/src/views/Manage.tsx
+++ b/packages/admin/src/views/Manage.tsx
@@ -29,7 +29,7 @@ export function Users() {
       <Card title="成員名單" action={
         <>
           <TableFilter value={q} onChange={setQ} placeholder="搜尋名稱／Email／Discord ID" shown={shown.length} total={all.length} />
-          <button className="btn btn--primary" onClick={() => setEdit(null)}>新增成員</button>
+          <button className="btn btn--primary" onClick={() => setEdit(null)}>新增成員…</button>
         </>
       }>
         {unboundCount > 0 && (
@@ -147,7 +147,7 @@ export function Subscriptions() {
       <Card title="訂閱清單" action={
         <>
           <TableFilter value={q} onChange={setQ} placeholder="搜尋成員／方案" shown={shown.length} total={all.length} />
-          <button className="btn btn--primary" onClick={() => setAdd(true)}>新增訂閱</button>
+          <button className="btn btn--primary" onClick={() => setAdd(true)}>新增訂閱…</button>
         </>
       }>
         <div className="tbl tbl--pin-first tbl--pin-last">
@@ -242,7 +242,7 @@ function SubEditModal({ sub, onClose, onDone }: { sub: Subscription; onClose: ()
       <Field label="狀態"><select value={f.status} onChange={(e) => set("status", e.target.value)} disabled={busy}>{SUB_STATUSES.map((st) => <option key={st.v} value={st.v}>{st.label}</option>)}</select></Field>
       <Field label="起算日"><input type="date" value={f.start_date} onChange={(e) => set("start_date", e.target.value)} disabled={busy} /></Field>
       <Field label="結帳日 (1-28)">
-        <span className="field__hint">每月幾號為這個訂閱結帳。29–31 在短月會落空，所以上限是 28。</span>
+        <span className="field__hint">每月幾號為這個訂閱結帳。29-31 在短月會落空，所以上限是 28。</span>
         <input type="number" min={1} max={28} value={f.billing_day} onChange={(e) => set("billing_day", e.target.value)} disabled={busy} />
       </Field>
       <label style={{ display: "flex", gap: 8, alignItems: "center", marginBottom: 4 }}>
@@ -267,7 +267,7 @@ export function Plans() {
   return (
     <>
       {error && <ErrorNote message={error} onRetry={reload} />}
-      <Card title="方案清單" action={<button className="btn btn--primary" onClick={() => setEdit(null)}>新增方案</button>}>
+      <Card title="方案清單" action={<button className="btn btn--primary" onClick={() => setEdit(null)}>新增方案…</button>}>
         {providers.length > 1 && (
           <div className="pills" style={{ padding: "12px 18px 0" }}>
             <button className={`pill ${pFilter === "" ? "pill--on" : ""}`} onClick={() => setPFilter("")}>全部</button>
@@ -368,7 +368,7 @@ export function ChannelTags() {
   return (
     <>
       {(error || actErr) && <ErrorNote message={(error || actErr)!} onRetry={reload} />}
-      <Card title="繳費渠道（對帳分組）" action={<button className="btn btn--primary" onClick={() => setEdit(null)}>新增渠道</button>}>
+      <Card title="繳費渠道（對帳分組）" action={<button className="btn btn--primary" onClick={() => setEdit(null)}>新增渠道…</button>}>
         <div className="tbl tbl--pin-first tbl--pin-last">
           <table className="tbl-cards">
             <caption className="sr-only">繳費渠道清單</caption>
diff --git a/packages/admin/src/views/Payments.tsx b/packages/admin/src/views/Payments.tsx
index bae3440..6e443ba 100644
--- a/packages/admin/src/views/Payments.tsx
+++ b/packages/admin/src/views/Payments.tsx
@@ -120,10 +120,10 @@ export function Payments() {
             phone instead of four stacked bands. Below 1000px .toolbar__acts is a nowrap scroller
             with an edge fade; above it, it is a plain flex row and looks unchanged. */}
         <div className="toolbar__acts">
-          <button className="btn" disabled={!effPeriod} title={effPeriod ? "對齊此期帳單到目前名單／現價" : "請先選擇單一期別"} onClick={() => setSync(true)}>重新同步此期帳單</button>
-          <button className="btn btn--danger" disabled={!effPeriod} title={effPeriod ? "刪除此期未繳／已退回帳單，期別回到未開繳" : "請先選擇單一期別"} onClick={() => setRetract(true)}>收回此期開繳</button>
-          <button className="btn" onClick={() => setShowLink(true)}>產生上傳連結</button>
-          <button className="btn btn--primary" onClick={() => setShowManual(true)}>手動補登</button>
+          <button className="btn" disabled={!effPeriod} title={effPeriod ? "對齊此期帳單到目前名單／現價" : "請先選擇單一期別"} onClick={() => setSync(true)}>重新同步此期帳單…</button>
+          <button className="btn btn--danger" disabled={!effPeriod} title={effPeriod ? "刪除此期未繳／已退回帳單，期別回到未開繳" : "請先選擇單一期別"} onClick={() => setRetract(true)}>收回此期開繳…</button>
+          <button className="btn" onClick={() => setShowLink(true)}>產生上傳連結…</button>
+          <button className="btn btn--primary" onClick={() => setShowManual(true)}>手動補登…</button>
         </div>
       </div>
 
@@ -221,7 +221,7 @@ function SyncModal({ period, onClose, onDone }: { period: string; onClose: () =>
     try {
       const r = await api.syncPeriodBills(period, { dry_run: false, notify_added: notify && boundAdds.length > 0 }) as any;
       setDone(
-        `已套用：新增 ${r.applied.added}、移除 ${r.applied.removed}、改價 ${r.applied.repriced}、保留 ${r.applied.frozen}`
+        `✓ 已套用：新增 ${r.applied.added}、移除 ${r.applied.removed}、改價 ${r.applied.repriced}、保留 ${r.applied.frozen}`
         + (r.notified ? `；已通知 ${r.notified} 位` : "")
         + (r.unbound ? `；${r.unbound} 位未綁定、通知不到` : "")
       );
@@ -291,7 +291,7 @@ function RetractModal({ period, onClose, onDone }: { period: string; onClose: ()
     setBusy(true); setErr(null);
     try {
       const r = await api.retractPeriodBilling(period, { dry_run: false }) as RetractApplied;
-      setDone(`已收回 ${period}：刪除 ${r.applied.removed} 筆帳單、保留 ${r.applied.frozen} 筆已繳待驗／已驗證。此期已回到未開繳狀態。`);
+      setDone(`✓ 已收回 ${period}：刪除 ${r.applied.removed} 筆帳單、保留 ${r.applied.frozen} 筆已繳待驗／已驗證。此期已回到未開繳狀態。`);
       onDone();
     } catch (e) { setErr((e as Error).message); setBusy(false); }
   }
@@ -299,7 +299,7 @@ function RetractModal({ period, onClose, onDone }: { period: string; onClose: ()
   return (
     <Modal title={`收回此期開繳 · ${period}`} onClose={onClose}>
       {err && <div className="error-banner">{err}</div>}
-      {busy && !preview && <Empty>計算中…</Empty>}
+      {busy && !preview && <Empty>計算差異中…</Empty>}
       {done && <div style={{ color: "var(--teal)", padding: "8px 0" }}>{done}</div>}
       {preview && !preview.opened && !done && <p style={{ color: "var(--muted)" }}>此期尚未發起繳費，無需收回。</p>}
       {preview && preview.opened && !done && (
diff --git a/packages/admin/src/views/Settings.tsx b/packages/admin/src/views/Settings.tsx
index 6c341db..8d616df 100644
--- a/packages/admin/src/views/Settings.tsx
+++ b/packages/admin/src/views/Settings.tsx
@@ -288,7 +288,7 @@ export function Settings() {
           <ActionRow title="張貼／更新綁定按鈕訊息" tag="立即執行" desc="在繳費頻道貼一則含「綁定 Discord」按鈕的公開訊息，讓成員主動綁定（開繳／催繳才能 @ 到他）。" state={bindMsgState}><RebuildBindMessage onDone={(id) => setLive((s) => ({ ...s, bind: id }))} /></ActionRow>
           <ActionRow title="註冊 Discord 指令" tag="立即執行" desc="更新 /繳費、/發起繳費、/綁定 指令到你的伺服器。" state={cmdState}><RegisterCommands onDone={(at) => setLive((s) => ({ ...s, cmd: at }))} /></ActionRow>
           <ActionRow title="發起繳費" tag="會改價＋發通知" warn desc="確認指定期別的各方案金額，建立該期帳單並向所有成員發出開繳通知。送出前會先看影響預覽。"><InitiateBilling billingDay={savedBillingDay} dirty={dirty} /></ActionRow>
-          <ActionRow title="匯入名單 CSV" tag="會新增/暫停訂閱" warn desc="用 CSV 批次建立或更新成員與訂閱；FALSE 的方案會暫停該訂閱。套用前先看差異預覽。"><ImportRoster /></ActionRow>
+          <ActionRow title="匯入名單 CSV" tag="會新增／暫停訂閱" warn desc="用 CSV 批次建立或更新成員與訂閱；FALSE 的方案會暫停該訂閱。套用前先看差異預覽。"><ImportRoster /></ActionRow>
         </div>
       </Card>
 
@@ -384,7 +384,7 @@ function ImportModal({ onClose }: { onClose: () => void }) {
       const r = await api.importMembers(file, { startDate: start || undefined, dryRun: false });
       const d = r.diff;
       setDiff(d);
-      setDone(`✓ 已套用：新增 ${d.users_created.length} 人 / 新增 ${d.subs_added.length} 訂閱 / 恢復 ${d.subs_reactivated.length} / 暫停 ${d.subs_paused.length}`);
+      setDone(`✓ 已套用：新增 ${d.users_created.length} 人、新增 ${d.subs_added.length} 訂閱、恢復 ${d.subs_reactivated.length}、暫停 ${d.subs_paused.length}`);
       // 匯入建立的帳單來自 ensureFirstPayment，不會出現在之後的同步 diff —— 通知要在這裡發，
       // 否則新成員從頭到尾不會收到任何訊息 (C1)。
       const ids = [...new Set(

From ad15701136b33217bf1872304846de7a0c1f2070 Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:48:24 +0800
Subject: [PATCH 19/20] =?UTF-8?q?docs(readme):=20=E6=B8=AC=E8=A9=A6?=
 =?UTF-8?q?=E5=BE=BD=E7=AB=A0=20426=20=E2=86=92=20431=20(#46)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

D14/D15 的錯誤訊息中文化各補了測試（+5）。
---
 README.md       | 4 ++--
 README.zh-TW.md | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index ae5f78b..64f3a24 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@
 ![Cloudflare Workers](https://img.shields.io/badge/Cloudflare-Workers-F38020?logo=cloudflare&logoColor=white)
 ![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript&logoColor=white)
 ![React](https://img.shields.io/badge/React-18-61DAFB?logo=react&logoColor=black)
-![Vitest](https://img.shields.io/badge/tests-426%20passing-0f6e63?logo=vitest&logoColor=white)
+![Vitest](https://img.shields.io/badge/tests-431%20passing-0f6e63?logo=vitest&logoColor=white)
 ![Serverless](https://img.shields.io/badge/100%25-serverless-074340)
 
 <br/>
@@ -81,7 +81,7 @@ pre-wired) and a multi-workspace-ready data model, so it generalizes well beyond
   `notification_logs`.
 - 🛡️ **Access-gated admin** — the whole admin host sits behind Cloudflare Access (email OTP); the
   SPA and its API are same-origin so the Access JWT reaches the Worker.
-- 🧪 **Real-runtime tests** — 426 Vitest cases run against actual Miniflare D1 + R2 (FK constraints
+- 🧪 **Real-runtime tests** — 431 Vitest cases run against actual Miniflare D1 + R2 (FK constraints
   enforced), not mocks.
 
 ## How a payment flows
diff --git a/README.zh-TW.md b/README.zh-TW.md
index 454aed9..0b45bea 100644
--- a/README.zh-TW.md
+++ b/README.zh-TW.md
@@ -9,7 +9,7 @@
 ![Cloudflare Workers](https://img.shields.io/badge/Cloudflare-Workers-F38020?logo=cloudflare&logoColor=white)
 ![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript&logoColor=white)
 ![React](https://img.shields.io/badge/React-18-61DAFB?logo=react&logoColor=black)
-![Vitest](https://img.shields.io/badge/tests-426%20passing-0f6e63?logo=vitest&logoColor=white)
+![Vitest](https://img.shields.io/badge/tests-431%20passing-0f6e63?logo=vitest&logoColor=white)
 ![Serverless](https://img.shields.io/badge/100%25-serverless-074340)
 
 <br/>
@@ -71,7 +71,7 @@ ChipPot 解決的是一個很具體的痛點：社團大量採購 OpenAI / Anthr
   截圖保存期清理，全部經 `notification_logs` 去重。
 - 🛡️ **Access 保護的後台** — 整個後台主機在 Cloudflare Access 後（email OTP）；SPA 與其 API 同源，
   Access JWT 因此能到達 Worker。
-- 🧪 **真環境測試** — 426 個 Vitest 案例跑在真正的 Miniflare D1 + R2（強制 FK 約束），不是 mock。
+- 🧪 **真環境測試** — 431 個 Vitest 案例跑在真正的 Miniflare D1 + R2（強制 FK 約束），不是 mock。
 
 ## 一筆繳費怎麼跑
 

From 00d8de19879c42552182664473c30be46d9ab19c Mon Sep 17 00:00:00 2001
From: PoterPan <poterpan5466@gmail.com>
Date: Sun, 30 Aug 2026 13:59:25 +0800
Subject: [PATCH 20/20] =?UTF-8?q?fix:=20=E4=BE=9D=20Codex=20=E5=AF=A9?=
 =?UTF-8?q?=E6=9F=A5=E4=BF=AE=E6=AD=A3=E4=BA=94=E9=A0=85=20(#46)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

**1. 被弱化的測試斷言**（discord-pay.test.ts）
掃描期別用詞時，斷言從 `已登記本期` 改成 `已登記` + /\d{4}-\d{2}/。
那個正規表達式匹配任何月份——回報錯月份的 bug 也會通過。
改為 `已登記 ${PERIOD}`，並實測：注入回報 2099-01 的 bug，測試確實會紅。

**2-5. 四處「UI 走不到」的宣稱其實走得到**
§A.14 允許那些錯誤訊息維持英文，前提是前端會先擋下來。Codex 抓到四個前提不成立：

- 每月結帳日的 min/max 只是提示，打 29 按儲存就會送出 → 補 client 驗證（含逾期天數、保存月數）
- CSV 起算日是自由文字框，打錯格式直接撞後端 → 改 type="date"（與 #44 B14 一致）
- 發起繳費的期別可以清空，invalid 只檢查金額 → 期別納入 invalid
- 手動補登與產生上傳連結的期別同樣可清空 → 兩處都補 PERIOD_RE 檢查

修的是「讓前提成立」而不是把訊息翻成中文——那些訊息本來就該是使用者看不到的。

測試維持 431。
---
 packages/admin/src/views/Payments.tsx         |  4 ++++
 packages/admin/src/views/Settings.tsx         | 19 +++++++++++++++++--
 .../worker/test/adapters/discord-pay.test.ts  |  5 +++--
 3 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/packages/admin/src/views/Payments.tsx b/packages/admin/src/views/Payments.tsx
index 6e443ba..af2799c 100644
--- a/packages/admin/src/views/Payments.tsx
+++ b/packages/admin/src/views/Payments.tsx
@@ -354,6 +354,9 @@ function ManualModal({ tags, onClose, onDone }: { tags: ChannelTag[]; onClose: (
 
   async function submit() {
     if (!subId) { setErr("請選擇訂閱"); return; }
+    // <input type="month"> can be cleared; an empty period reaches the worker's English guard
+    // (§A.14 only lets that string stay English because the UI is supposed to prevent it).
+    if (!PERIOD_RE.test(period)) { setErr("請選擇期別。"); return; }
     setBusy(true); setErr(null);
     try {
       await api.manualPayment({ subscription_id: Number(subId), period, amount: amount ? Number(amount) : undefined, status: statusV, verified_channel_tag_id: tagId ? Number(tagId) : undefined, payment_note: note || undefined });
@@ -398,6 +401,7 @@ function LinkModal({ onClose }: { onClose: () => void }) {
 
   async function gen() {
     if (!userId) { setErr("請選擇成員"); return; }
+    if (!PERIOD_RE.test(period)) { setErr("請選擇期別。"); return; }
     setBusy(true); setErr(null);
     try {
       const r = await api.uploadLink({ user_id: Number(userId), period });
diff --git a/packages/admin/src/views/Settings.tsx b/packages/admin/src/views/Settings.tsx
index 8d616df..6ea4aad 100644
--- a/packages/admin/src/views/Settings.tsx
+++ b/packages/admin/src/views/Settings.tsx
@@ -141,6 +141,15 @@ export function Settings() {
 
   function flash(msg: string) { setToast(msg); window.setTimeout(() => setToast(null), 2400); }
   async function save() {
+    // min/max on <input type="number"> are only hints — nothing stops a typed 29 from being
+    // submitted, and the worker's guard answers in English (routes/admin.ts, §A.14 allowlist:
+    // that string is only allowed to stay English because the UI is supposed to block it first).
+    const bd = Number(form.billing_day);
+    if (!Number.isInteger(bd) || bd < 1 || bd > 28) { setErr("每月結帳日請填 1-28 的整數。"); return; }
+    const od = Number(form.overdue_days);
+    if (!Number.isInteger(od) || od < 0) { setErr("逾期天數請填 0 或正整數。"); return; }
+    const rm = Number(form.proof_retention_months);
+    if (!Number.isInteger(rm) || rm < 1) { setErr("截圖保存月數請填 1 以上的整數。"); return; }
     setBusy(true); setErr(null);
     try {
       await api.updateWorkspace({
@@ -413,7 +422,10 @@ function ImportModal({ onClose }: { onClose: () => void }) {
             欄位需為「姓名, 帳號, 方案名…」；方案名須與系統方案一致。方案格 <b>TRUE</b>＝訂閱、<b>FALSE</b>＝暫停該訂閱、<b>留空</b>＝不變動。起算月份留空＝當月。
           </p>
           <Field label="CSV 檔"><input type="file" accept=".csv,text/csv" onChange={(e) => setFile(e.target.files?.[0] ?? null)} disabled={busy} /></Field>
-          <Field label="起算月份第一天（選填，YYYY-MM-DD）"><input value={start} onChange={(e) => setStart(e.target.value)} placeholder="2026-06-01" disabled={busy} /></Field>
+          {/* type=date, like every other date in the app (#44 B14): a free-text box here let a typo reach
+              the worker, whose guard answers in English — a string the §A.14 allowlist only permits to
+              stay English because the UI is supposed to make it unreachable. */}
+          <Field label="起算月份第一天（選填）"><input type="date" value={start} onChange={(e) => setStart(e.target.value)} disabled={busy} /></Field>
           <button className="btn btn--primary" onClick={preview} disabled={busy}>{busy ? "計算差異中…" : "預覽差異"}</button>
         </>
       )}
@@ -507,7 +519,10 @@ function InitiateModal({ plans, billingDay, dirty, onClose }: { plans: { id: num
   const [err, setErr] = useState<string | null>(null);
 
   const payload = () => ({ period, amounts: plans.map((p) => ({ plan_id: p.id, amount: Number(amounts[p.id]) })) });
-  const invalid = plans.some((p) => !/^\d+$/.test((amounts[p.id] ?? "").trim()));
+  // <input type="month"> can be CLEARED, and an empty period reaches the worker's English guard
+  // (§A.14 only lets that string stay English because the UI is supposed to prevent it).
+  const invalid = !/^\d{4}-(0[1-9]|1[0-2])$/.test(period)
+    || plans.some((p) => !/^\d+$/.test((amounts[p.id] ?? "").trim()));
 
   async function runPreview() {
     setBusy(true); setErr(null);
diff --git a/packages/worker/test/adapters/discord-pay.test.ts b/packages/worker/test/adapters/discord-pay.test.ts
index 42f6935..cb6a129 100644
--- a/packages/worker/test/adapters/discord-pay.test.ts
+++ b/packages/worker/test/adapters/discord-pay.test.ts
@@ -144,8 +144,9 @@ describe("/繳費 with no R2 ignores the screenshot", () => {
     vi.unstubAllGlobals();
     (env as any).BUCKET = prevB;
     (env as any).DISCORD_APPLICATION_ID = prevApp;
-    expect(captured).toContain("已登記");
-    expect(captured).toMatch(/\d{4}-\d{2}/);   // 回覆改成報實際期別（YYYY-MM）
+    // 報的必須是「這一期」，不是任何一個看起來像 YYYY-MM 的字串——
+    // 只斷言格式的話，回報錯月份的 bug 也會通過。
+    expect(captured).toContain(`已登記 ${PERIOD}`);
     expect(captured).toContain("已記錄你的繳費宣告");
   });
 });