Merge pull request 'Dev' (#47) from dev into main

Reviewed-on: https://git.yqidian.com/jacy/dukang/pulls/47

.cursor/rules/dukang-core.mdc

@@ -1,55 +0,0 @@
----
-description: 杜康好客全局约束 — Monorepo 布局、文档优先级、2 人 OWNER 边界
-alwaysApply: true
----
-
-# 杜康好客 · 核心规则
-
-## Monorepo 布局
-
-- `apps/` — preV1：`h5-user`、`h5-shop`、`h5-partner`、`admin-web`
-- `packages/` — `shared-types`、`domain`、`shared-ui`
-- `server/dukang-api/` — NestJS 单体 API
-- `pages/` — UI 原型（**只读参照**）
-
-> V2 目标为 Taro 四端（`mini-user` 等），编码以 **当前实际目录** 为准。
-
-## 文档
-
-- **V3.0 业务事实源**：`杜康好客-v3-PRD.md`
-- V3 实现验收：`杜康好客-v3编码手册.md`
-- V2 蓝图：`杜康好客-V2编码手册.md`（与 V3 冲突时 V3 PRD 优先）
-- preV1 裁剪：`杜康好客-preV1编码手册.md`
-- 协作：`conventions.md` · AI 入口：`AGENTS.md`
-
-**禁止**：编码时修改业务规则；需求变更只改 `杜康好客-v3-PRD.md`。
-
-## 边界（2 人团队）
-
-> **临时（2026-07）**：刘京尧任务由 `jacy-dukang` 代管，B+D 路径可改。
-
-| 负责人 | 路径 |
-|--------|------|
-| jacy-dukang | `apps/*`, `packages/`, `callbacks/`, `jobs/`, `common/`, `integrations/`, 全部 `modules/*` |
-| ~~刘京尧~~ | ~~`apps/h5-partner/`, `apps/h5-shop/`, `modules/{store,redeem}/`~~（暂代管） |
-
-- 跨模块只 inject **exported Service**，禁止 `prisma` 写他人表
-- `apps/*` 禁止 import `server/*` 或其他 app
-- Mock 只在 `integrations/*`，不在业务 Service 散落
-
-## 共享契约
-
-- 枚举/DTO → `packages/shared-types`
-- 纯规则 → `packages/domain`（无 IO）
-
-## 核心业务常量
-
-- 权益额 = `benefit_amount ?? price`
-- 核销：直接核销 `0 < amount ≤ 全部 ACTIVE 权益总余额`；带单据核销 `0 < amount ≤ 该单据可用金额`；Redis 码 3 分钟
-- 订单 Tab（V3.0）：`待付款 | 已付款 | 已完成`
-- API：`/api/v1`，响应 `{ code, message, data }`
-
-## 提交
-
-- Conventional Commits：`feat(trade):` 等
-- 不提交 `.env`

.cursor/rules/git-conventions.mdc

@@ -1,33 +1,11 @@
 ---
-description: Git 提交与 PR 协作规范
+description: 杜康提交 scope 与发版默认（生产）
 alwaysApply: true
 ---
 
-# Git 规范
+# Git / 发版（杜康专属）
 
-## 提交格式
-
-Conventional Commits，scope = 端或模块名：
-
-```
-feat(trade): add order preview API
-fix(redeem): validate redeem amount against balance
-chore(shared-types): add OrderStatus enum
-```
-
-## 禁止提交
-
-- `.env`、`.env.local` 等敏感配置
-- `node_modules/`、`dist/`（已在 .gitignore）
-
-## PR 与 Review
-
-- feature 分支 + 小步 PR
-- 跨模块改动需相关双 Owner Review
-- Prisma 迁移必须多 Owner Review
-
-## Agent 行为
-
-- **仅用户明确要求时** 才执行 git commit / push
-- 不 amend 已推送的 commit，不 force push main/master/dev
-- 发版：`dev`→测试(staging)，`main`→生产；用户只说「发布/发版」默认发**生产**（见 dukang-release skill）；明确说「发测试」才发 staging
+- Conventional Commits，scope = 端或模块：`feat(trade):`、`fix(redeem):`
+- 只说「发布/发版」→ 生产（`main` + `deploy-prod.sh`）；明确说「发测试」才 staging。流程见 `/dukang-release`
+- 改 API/表 → 同步 v3-PRD + v3编码手册 + `shared-types`
+- Prisma 迁移须 Review

.cursor/skills/dukang-coding/SKILL.md

@@ -21,7 +21,7 @@ disable-model-invocation: true
 ## 会话启动（按序）
 
 1. 确认阶段：**V3.0** → 读 `杜康好客-v3-PRD.md` + `@dukang-v3`；preV1 → preV1 手册；V2 蓝图 → V2 手册
-2. 读 [`AGENTS.md`](../../AGENTS.md) OWNER 表 → **只改本 OWNER 路径**
+2. 读 [`AGENTS.md`](../../AGENTS.md) OWNER 段 + 对应 `apps/` 或 `server/dukang-api/AGENTS.md` → **只改本 OWNER 路径**
 3. 有任务卡 ID → 配合 `dukang-task-card` skill 或查 preV1 §9 / V2 §七
 4. UI 任务 → `pages/ROUTE_MAP.md` + 对应 `pages/{端}/` 原型
 5. 编码前过一遍下方 Checklist

.cursor/skills/dukang-prev1/SKILL.md

@@ -5,6 +5,7 @@ description: >-
   MOCK_SMS/MOCK_PAY/MOCK_DELIVERY flags, Seed data, and V2 upgrade path.
   Use when working on Mock providers, feature flags, preV1 task cards P1-*,
   or smoke tests — not for V2 WeChat/payment production integration.
+disable-model-invocation: true
 ---
 
 # 杜康好客 · preV1 Mock Skill

.cursor/skills/dukang-release/SKILL.md

@@ -4,6 +4,7 @@ description: >-
   杜康好客发布流程：dev→测试(staging)，main→生产；同机双栈。
   Use when the user says 发布、上传、deploy、上线、发版、发测试、发生产,
   or @杜康发布 / @dukang-release.
+disable-model-invocation: true
 ---
 
 # 杜康发布

.cursor/skills/dukang-task-card/SKILL.md

@@ -4,6 +4,7 @@ description: >-
   Executes Dukang Haoke task cards (P1-M* or M0-M6) one at a time with DoD
   verification. Use when the user provides a task ID like P1-M2-002 or M2-FE-U-003,
   or asks to start/implement a milestone card from the coding manuals.
+disable-model-invocation: true
 ---
 
 # 杜康好客 · 任务卡 Skill

.gitignore

@@ -21,4 +21,8 @@ coverage/
 server/dukang-api/prisma/migrations/
 debug_v3.xlsx
 ~$debug_v3.xlsx
+server/dukang-api/assets/fonts/*.ttf
+server/dukang-api/assets/fonts/*.ttc
+server/dukang-api/assets/fonts/*.otf
 deploy/auto-release.env
+deploy/backups/

AGENTS.md

@@ -1,133 +1,37 @@
 # 杜康好客 · AGENTS.md
 
-> AI 编码入口。人类协作者仍读 [`agent.md`](./agent.md)；本文件供 Cursor / Codex / Copilot 等自动加载。
+> AI 编码入口。人类读 [`agent.md`](./agent.md)。启动、端口、测试账号见 [`README.md`](./README.md)。
 
-## 项目概览
+杜康酒业 O2O：**购酒 → 发券 → 门店核销**。Monorepo + NestJS 单体（`/api/v1`，`{ code, message, data }`）。
 
-杜康酒业 O2O 平台：**购酒 → 发券 → 门店核销**。Monorepo + 单体 NestJS（方案三：模块 OWNER）。
+| 路径 | 说明 |
+|------|------|
+| `apps/` | `h5-user` · `h5-shop` · `h5-partner` · `admin-web` · `mini-user` |
+| `packages/` | `shared-types`（枚举/DTO）· `domain`（纯规则，无 IO）· `shared-ui` |
+| `server/dukang-api/` | 唯一 API |
+| `pages/` | UI 原型，只读 |
 
-| 阶段 | 手册 | 说明 |
-|------|------|------|
-| **V3.0 唯一需求源** | [`杜康好客-v3-PRD.md`](./杜康好客-v3-PRD.md) | 产品需求与三波交付（**只看这个**） |
-| **现状对照** | [`杜康好客-v3-现状对照.md`](./杜康好客-v3-现状对照.md) | 已完成 / 冲突 / 缺口审计 |
-| **V3 实现验收** | [`杜康好客-v3编码手册.md`](./杜康好客-v3编码手册.md) | 核销规则、分工、闭环 |
-| ~~V2 / preV1~~ | 历史参考（**已压缩**；V2 全文见 git 2026-08-06 前） | **不再作为需求依据** |
+前端：[`apps/AGENTS.md`](./apps/AGENTS.md)。后端模块/表 OWNER：[`server/dukang-api/AGENTS.md`](./server/dukang-api/AGENTS.md)。
 
-**禁止**：臆造 PRD 未定义规则；依赖 `doc/` 下过时文档；跨 OWNER 直写他人 Prisma 表。
+## 文档（冲突时）
 
-## 启动命令
-
-```bash
-# 基础设施
-cd deploy && docker compose up -d   # dukang-v1：MySQL :6016 Redis :6017
-
-# 依赖与数据库
-pnpm install
-cp server/dukang-api/.env.example server/dukang-api/.env
-pnpm db:generate && pnpm db:validate
-cd server/dukang-api && npx prisma db push && pnpm prisma:seed
-
-# 开发（分终端）
-pnpm dev:api      # http://localhost:3010/api/v1
-pnpm dev:user     # :5173
-pnpm dev:shop     # :5174
-pnpm dev:partner  # :5175
-pnpm dev:admin    # preV1 HQ 替代（内部工具，非 V2 小程序）
-
-# 验证
-node scripts/smoke-v3.mjs
-node scripts/smoke-prev1.mjs
-pnpm lint && pnpm test
-```
-
-Mock 验证码：`999888`。测试账号见 [`README.md`](./README.md)。
-
-> **端口冲突**：`h5-partner` 与 `admin-web` 同为 5175，勿同时 `dev:partner` + `dev:admin`。
-
-## 文档优先级（冲突时）
-
-1. `杜康好客-v3-PRD.md` — **唯一需求事实源**
-2. `杜康好客-v3-现状对照.md` — 实现进度审计
-3. `杜康好客-v3编码手册.md` — 实现验收、核销、分工
-4. `conventions.md` — 协作与模块边界
-5. V2 手册 §四 §五 §六 — 仅作架构/DB/API **参考**（与 V3 冲突时忽略）
+1. `杜康好客-v3-PRD.md` — **唯一需求事实源**（编码时禁止改业务规则；需求变更只改它）
+2. `杜康好客-v3-现状对照.md` — 进度
+3. `杜康好客-v3编码手册.md` — 验收、核销、分工
+4. `conventions.md` — 协作边界
+5. V2 手册 §四–§六 — 架构/DB/API **参考**（与 V3 冲突则忽略）
 6. `pages/{user,shop,partner,hq}/` — UI 参照
 
-> **V2 / preV1 手册不再作为需求依据。**
+**禁止**：臆造 PRD 未定义规则；依赖 `doc/` 过时文档；`apps/*` import `server/*`；跨模块 `prisma` 写他人表。V2 / preV1 手册不再作需求依据。
 
-## 团队与 OWNER 边界（2 人）
+## OWNER（2026-07 起暂由 jacy 代管全部）
 
-| 负责人 | Git 账号 | 职责 |
-|--------|----------|------|
-| **Jacy**（管理员） | `jacy-dukang` | C 端、admin-web、后端主模块、packages、Prisma 迁移主 Review |
-| **刘景尧** | `刘景尧` | 合伙人 H5、门店 H5、`store` / `redeem` 模块（**暂由 jacy-dukang 代管**） |
+`jacy-dukang` 可改 `apps/*`、`packages/*`、全部后端模块。逻辑边界仍按 A/B/C/D，便于子 Agent 隔离。Prisma 迁移由 jacy 主导。
 
-> **临时分工（2026-07）**：刘景尧任务暂由 `jacy-dukang` 全权负责；逻辑 OWNER B+D 路径可改，Prisma 迁移由 jacy 主导。
+- 跨模块只 inject 对方 **exported Service**
+- Mock 只在 `integrations/*`；微信/配送回调只进 `callbacks/`
 
-逻辑模块边界仍按 A/B/C/D 划分（便于 Agent 隔离），**当前人员合并**如下：
-
-| 逻辑 OWNER | 负责人 | 可改路径 | 后端 Module |
-|------------|--------|----------|-------------|
-| **A + C + Lead + B + D** | jacy-dukang | `apps/*`, `packages/*`, `callbacks/`, `jobs/`, `common/`, `integrations/` | 全部后端模块 |
-| ~~B + D~~ | ~~刘景尧~~ | — | 恢复分工前由 jacy 代管 |
-
-**Prisma 迁移**：jacy-dukang 主导 Review；涉及 `store_*` / 核销表时仍建议刘景尧知会（恢复分工后共同 Review）。
-
-### 跨模块规则（R1–R8 摘要）
-
-- 只 inject 对方 Module **exports 的 Service**，禁止 `prisma.xxx` 写他人表
-- `apps/*` 禁止 import `server/*` 源码；只走 HTTP + `packages/shared-types`
-- 业务纯规则 → `packages/domain`；枚举/DTO → `packages/shared-types`
-- 微信/配送回调入口 **仅** `callbacks/`；Mock 实现 **仅** `integrations/*`
-
-## Cursor 规范
-
-| 类型 | 路径 | 说明 |
-|------|------|------|
-| Rules | `.cursor/rules/` | 自动加载的编码规范 |
-| 编码 Skill | `.cursor/skills/dukang-coding/` | @dukang-coding |
-| V3.0 需求 Skill | `.cursor/skills/dukang-v3/` | @dukang-v3（PRD、Wave、REQ/ACC） |
-| 需求 Skill | `.cursor/skills/dukang-project/` | @dukang-project |
-| preV1 Skill | `.cursor/skills/dukang-prev1/` | Mock / Feature Flag |
-| 任务卡 Skill | `.cursor/skills/dukang-task-card/` | DLV-W* / P1-* / M*-* |
-| 发布 Skill | `.cursor/skills/dukang-release/` | @杜康发布 / @dukang-release |
-
-## 子 Agent（按职责选用）
-
-在 Cursor Agent 输入 `/` 选择：
-
-| 子 Agent | 负责人 | 适用场景 |
-|----------|--------|----------|
-| `v3-delivery-lead` | jacy-dukang | V3.0 三波交付统筹、DLV 拆分、跨 Owner 协调 |
-| `v3-req-reviewer` | — | V3.0 需求只读审查、REQ/ACC 缺口分析 |
-| `owner-a-user-trade` | jacy-dukang | C 端、订单、支付、权益、埋点 |
-| `owner-c-catalog-ops` | jacy-dukang | admin-web、开城商品、结算、运营 |
-| `backend-lead` | jacy-dukang | packages、callbacks、jobs、Prisma 横切 |
-| `owner-b-partner-store` | 刘景尧 | 合伙人 H5、门店 CRUD/审核 |
-| `owner-d-shop-redeem` | 刘景尧 | 门店 H5、核销 |
-| `boundary-reviewer` | — | PR 前只读审查跨模块违规 |
-
-## Skills（按需 @）
-
-| Skill | 何时用 |
-|-------|--------|
-| `dukang-v3` | V3.0 PRD、现状对照、Wave/REQ/ACC |
-| `dukang-coding` | 实现功能、修 Bug（通用编码流程） |
-| `dukang-project` | PRD/需求评审、原型对照、任务卡规划（**不用于日常编码**） |
-| `dukang-prev1` | Mock 开关、preV1 裁剪、Feature Flag |
-| `dukang-task-card` | 领取任务卡 `DLV-W*-*` / `P1-*` / `M*-*` 并按 DoD 交付 |
-| `dukang-release`（杜康发布） | `dev_jacy`→`dev` 合并 + `deploy.sh` 发版 |
-
-## 快速指令
-
-- 现状审计：`@dukang-v3` + [`杜康好客-v3-现状对照.md`](./杜康好客-v3-现状对照.md)
-- 实现 DLV 任务：`@dukang-coding 实现 DLV-W1-M2`
-- 波次规划：`/v3-delivery-lead 拆分 Wave 2 任务`
-- 需求缺口审查：`/v3-req-reviewer 审查门店提现`
-- PR 前审查：`/boundary-reviewer`
-- 原型参照：`pages/{user,shop,partner}/`（只读）
-
-## 核心业务常量（不可偏离）
+## 不可偏离
 
 ```
 权益额 = benefit_amount ?? price
@@ -137,38 +41,10 @@ C 端门店仅 status=OPEN
 订单 Tab：待付款 | 已付款 | 已完成
 ```
 
-**iOS 微信 H5 JSSDK**：登录/OAuth 后禁止仅 SPA 跳转再调扫码；见 `packages/weixin-sdk/GOTCHAS.md`、知识库「门店端 · 踩坑」。
-**微信小程序 open-type**：`chooseAvatar` 等 Button 的祖先禁止 `stopPropagation`（会编成 catchtap）；见知识库「C 端 · 踩坑」、`.cursor/rules/mini-user-weapp-opentype.mdc`。
-**微信小程序页面标题**：weapp 只用原生 `navigationBarTitleText`，不要再画一层与导航栏重复的 `SubPageHeader` title；见 `.cursor/rules/mini-user-weapp-nav-title.mdc`。
+微信：iOS H5 登录后禁止仅 SPA 跳转再扫码（`packages/weixin-sdk/GOTCHAS.md`）。小程序 `open-type` 按钮祖先禁止 `stopPropagation`；weapp 标题只用 `navigationBarTitleText`。`h5-partner` 与 `admin-web` 同端口 5175，勿同时开。
 
-## 环境与发版
+## 按需加载
 
-| 环境 | 分支 | 目录 | 端口 | 域名 |
-|------|------|------|------|------|
-| local | `dev_jacy` | 本机 Docker 6016/6017 | API `:3010` | — |
-| **staging 测试** | `dev` | `/opt/dukang-staging` | 8190–8194 | `*-test.dukanghaoke.com` |
-| **production 生产** | `main` | `/opt/dukang` | 8090–8094 | `*.dukanghaoke.com` |
-
-- 日常发布 → `deploy/deploy-staging.sh`（`dev`）
-- 生产发布 → `deploy/deploy-prod.sh`（`main`，验收后）
-- Staging：正式微信 + 全 Mock；配置见 `.env.staging.example`
-- 详情：`@dukang-release` / `.cursor/skills/dukang-release/SKILL.md`
-
-## 提交与 PR
-
-- Conventional Commits：`feat(trade):`、`fix(redeem):`；scope = 端或模块
-- 跨模块 PR → jacy-dukang + 刘景尧 共同 Review（若涉及双方模块）
-- 改 API/表 → 同步 v3-PRD + v3编码手册 + `shared-types`
-- 不提交 `.env`、`dist/`、`node_modules/`
-
-## 完成定义（DoD）
-
-- [ ] 任务卡验收项全部满足
-- [ ] 未跨模块直写 Prisma 表
-- [ ] 枚举/DTO 在 `shared-types`；纯规则在 `domain`
-- [ ] `pnpm lint` 无新增错误；相关 domain 单测通过
-
-## 嵌套指引
-
-- 后端细节：[`server/dukang-api/AGENTS.md`](./server/dukang-api/AGENTS.md)
-- 前端四 App：[`apps/AGENTS.md`](./apps/AGENTS.md)
+- 编码 `/dukang-coding` · V3 需求 `/dukang-v3` · 发版 `/dukang-release`（只说「发版」= 生产）
+- 子 Agent：`/owner-a-user-trade` 等（见 `.cursor/agents/`）
+- DoD：验收项满足；不跨模块直写表；类型在 `shared-types`、规则在 `domain`；相关 lint/单测过

apps/admin-web/src/admin.css

@@ -16,37 +16,37 @@ body,
 }
 
 /*
- * 后台内容行：不换行 + 超出省略
- * 覆盖主内容区、Drawer、Modal 内的表格与描述列表
+ * 后台表格：不换行、完整展示（v3.5.9 去掉省略号）
+ * 描述列表仍省略，避免详情抽屉被长字段撑破
  */
 .admin-layout .ant-table-cell,
 .ant-drawer .ant-table-cell,
-.ant-modal .ant-table-cell,
+.ant-modal .ant-table-cell {
+  white-space: nowrap;
+  overflow: visible;
+  text-overflow: clip;
+  max-width: none;
+}
+
 .admin-layout .ant-descriptions-item-content,
 .ant-drawer .ant-descriptions-item-content,
 .ant-modal .ant-descriptions-item-content {
   white-space: nowrap;
   overflow: hidden;
   text-overflow: ellipsis;
-  max-width: 0;
-}
-
-.admin-layout .ant-descriptions-item-content,
-.ant-drawer .ant-descriptions-item-content,
-.ant-modal .ant-descriptions-item-content {
   max-width: 100%;
 }
 
-/* 表头同样不换行 */
+/* 表头不换行 */
 .admin-layout .ant-table-thead > tr > th,
 .ant-drawer .ant-table-thead > tr > th,
 .ant-modal .ant-table-thead > tr > th {
   white-space: nowrap;
-  overflow: hidden;
-  text-overflow: ellipsis;
+  overflow: visible;
+  text-overflow: clip;
 }
 
-/* 操作列、含交互控件的不截断 */
+/* 操作列保持可见 */
 .admin-layout .ant-table-cell:has(.ant-btn),
 .ant-drawer .ant-table-cell:has(.ant-btn),
 .ant-modal .ant-table-cell:has(.ant-btn),
@@ -71,10 +71,9 @@ body,
   max-width: none;
 }
 
-/* 表格单元格双行信息合并为单行省略 */
+/* 表格单元格主/副信息同一行 */
 .admin-cell-line {
-  display: block;
-  max-width: 100%;
+  display: inline;
 }
 
 .admin-cell-line-secondary {

apps/admin-web/src/components/AdminCellLine.tsx

@@ -1,12 +1,10 @@
-import { Typography } from 'antd';
-
 type AdminCellLineProps = {
   primary?: string | null;
   secondary?: string | null;
   separator?: string;
 };
 
-/** 表格单元格：主/副信息同一行展示，超出省略，hover 显示全文 */
+/** 表格单元格：主/副信息同一行完整展示 */
 export function AdminCellLine({
   primary,
   secondary,
@@ -14,14 +12,9 @@ export function AdminCellLine({
 }: AdminCellLineProps) {
   const main = primary?.trim() || '—';
   const sub = secondary?.trim();
-  const full = sub ? `${main}${separator}${sub}` : main;
 
   return (
-    <Typography.Text
-      className="admin-cell-line"
-      ellipsis={{ tooltip: full }}
-      style={{ maxWidth: '100%' }}
-    >
+    <span className="admin-cell-line">
       {main}
       {sub ? (
         <span className="admin-cell-line-secondary">
@@ -29,6 +22,6 @@ export function AdminCellLine({
           {sub}
         </span>
       ) : null}
-    </Typography.Text>
+    </span>
   );
 }

apps/admin-web/src/components/AdminListColumnsModal.tsx

@@ -0,0 +1,102 @@
+import { useEffect, useState } from 'react';
+import { Button, Checkbox, Modal, Space, Typography } from 'antd';
+import { HolderOutlined } from '@ant-design/icons';
+import type { ListColumnSettingItem } from '../lib/list-column-prefs';
+
+type Props = {
+  open: boolean;
+  items: ListColumnSettingItem[];
+  saving?: boolean;
+  onCancel: () => void;
+  onReset: () => void;
+  onSave: (items: ListColumnSettingItem[]) => void;
+};
+
+export function AdminListColumnsModal({ open, items, saving, onCancel, onReset, onSave }: Props) {
+  const [draft, setDraft] = useState<ListColumnSettingItem[]>(items);
+  const [dragKey, setDragKey] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (open) setDraft(items);
+  }, [open, items]);
+
+  function move(from: number, to: number) {
+    if (to < 0 || to >= draft.length) return;
+    const next = [...draft];
+    const [row] = next.splice(from, 1);
+    next.splice(to, 0, row);
+    setDraft(next);
+  }
+
+  return (
+    <Modal
+      title="列设置"
+      open={open}
+      onCancel={onCancel}
+      footer={
+        <Space style={{ width: '100%', justifyContent: 'space-between' }}>
+          <Button onClick={onReset}>重置默认</Button>
+          <Space>
+            <Button onClick={onCancel}>取消</Button>
+            <Button type="primary" loading={saving} onClick={() => onSave(draft)}>
+              保存
+            </Button>
+          </Space>
+        </Space>
+      }
+    >
+      <Typography.Paragraph type="secondary" style={{ marginTop: 0 }}>
+        勾选显示列，拖拽或上下箭头调整顺序。序号与操作列固定，不在此列表中。
+      </Typography.Paragraph>
+      <div>
+        {draft.map((item, index) => (
+          <div
+            key={item.key}
+            draggable
+            onDragStart={() => setDragKey(item.key)}
+            onDragOver={(e) => e.preventDefault()}
+            onDrop={() => {
+              if (!dragKey || dragKey === item.key) return;
+              const from = draft.findIndex((r) => r.key === dragKey);
+              if (from >= 0) move(from, index);
+              setDragKey(null);
+            }}
+            style={{
+              display: 'flex',
+              alignItems: 'center',
+              gap: 8,
+              padding: '6px 0',
+              borderBottom: '1px solid #f0f0f0',
+              cursor: 'move',
+            }}
+          >
+            <HolderOutlined style={{ color: '#999' }} />
+            <Checkbox
+              checked={item.visible}
+              onChange={(e) => {
+                const next = [...draft];
+                next[index] = { ...item, visible: e.target.checked };
+                setDraft(next);
+              }}
+            >
+              {item.title}
+            </Checkbox>
+            <span style={{ marginLeft: 'auto' }}>
+              <Button type="link" size="small" disabled={index === 0} onClick={() => move(index, index - 1)}>
+                上移
+              </Button>
+              <Button
+                type="link"
+                size="small"
+                disabled={index === draft.length - 1}
+                onClick={() => move(index, index + 1)}
+              >
+                下移
+              </Button>
+            </span>
+          </div>
+        ))}
+      </div>
+    </Modal>
+  );
+}

apps/admin-web/src/components/CityPartnersPanel.tsx

@@ -1,459 +1,458 @@
-import { useCallback, useEffect, useState } from 'react';
-import {
-  Button,
-  Checkbox,
-  Drawer,
-  Form,
-  Input,
-  InputNumber,
-  Modal,
-  Select,
-  Space,
-  Table,
-  Tabs,
-  Typography,
-  message,
-} from 'antd';
-import type { ColumnsType } from 'antd/es/table';
-import {
-  CITY_PARTNER_SCOPE_LABELS,
-  CITY_PARTNER_STATUS_LABELS,
-  CityPartnerScopeType,
-  CityPartnerStatus,
-  PARTNER_PERMISSION_KEYS,
-  PARTNER_PERMISSION_LABELS,
-  PARTNER_STAFF_ROLE_LABELS,
-  type PartnerPermissionKey,
-} from '@dukang/shared-types';
-import { request, type Paginated } from '../lib/api';
-import { districtCodeLabel, formatDistrictLabels } from '../lib/china-region';
-import { fmtTime } from '../lib/constants';
-import CityDistrictMultiSelect from './CityDistrictMultiSelect';
-import PartnerSubAccountList from './PartnerSubAccountList';
-
-type PartnerRow = {
-  id: string;
-  companyName: string;
-  phone: string;
-  name: string;
-  scopeType?: string;
-  districtCodes?: string[] | null;
-  orderCommissionRate?: number;
-  redeemCommissionRate?: number;
-  accountCount: number;
-  createdAt: string;
-};
-
-type PartnerDetail = PartnerRow & {
-  address?: string;
-  districtCodes?: string[] | null;
-  bindingStatus?: string;
-  bankAccountName?: string | null;
-  bankAccountNo?: string | null;
-  bankBranch?: string | null;
-  managedWarehouseId?: string | null;
-  managedWarehouseName?: string | null;
-  contactPhone?: string | null;
-  children?: Array<{
-    id: string;
-    phone: string;
-    name: string;
-    staffRole?: string;
-    permissions?: string[];
-    status: string;
-  }>;
-};
-
-type Props = {
-  cityId: string;
-  cityCode?: string;
-  maxPartnerCommissionRate?: number;
-  onChanged?: () => void;
-};
-
-const SCOPE_OPTIONS = Object.entries(CITY_PARTNER_SCOPE_LABELS).map(([value, label]) => ({ value, label }));
-const BINDING_OPTIONS = Object.entries(CITY_PARTNER_STATUS_LABELS).map(([value, label]) => ({ value, label }));
-const PERM_OPTIONS = PARTNER_PERMISSION_KEYS.map((k: PartnerPermissionKey) => ({
-  value: k,
-  label: PARTNER_PERMISSION_LABELS[k],
-}));
-const STAFF_ROLE_OPTIONS = Object.entries(PARTNER_STAFF_ROLE_LABELS)
-  .filter(([value]) => value !== 'PARTNER')
-  .map(([value, label]) => ({ value, label }));
-
-function flattenDistrictCodes(values: string[] | string[][] | undefined): string[] {
-  if (!values?.length) return [];
-  if (Array.isArray(values[0])) {
-    return (values as string[][]).map((path) => path[path.length - 1]).filter(Boolean);
-  }
-  return values as string[];
-}
-
-function commissionSumError(
-  orderPercent: number,
-  redeemPercent: number,
-  maxRate: number,
-): string | null {
-  // API 可能把 Prisma Decimal 序列化为字符串；`"0.05" + 1e-9` 会变成字符串拼接导致误判超限
-  const max = Number(maxRate);
-  const sum = Number(orderPercent) / 100 + Number(redeemPercent) / 100;
-  if (!Number.isFinite(max) || !Number.isFinite(sum)) return '佣金比例无效';
-  if (sum > max + 1e-9) {
-    return `订单佣金与核销佣金合计不得超过 ${(max * 100).toFixed(2)}%（当前 ${(sum * 100).toFixed(2)}%）`;
-  }
-  return null;
-}
-
-function formatApiError(err: unknown): string | null {
-  if (err && typeof err === 'object' && 'errorFields' in err) return null;
-  if (!(err instanceof Error)) return '操作失败';
-  return err.message.replace(/\b(\d{6})\b/g, (code) => {
-    const label = districtCodeLabel(code);
-    return label !== code ? `${label}(${code})` : code;
-  });
-}
-
-export default function CityPartnersPanel({
-  cityId,
-  cityCode,
-  maxPartnerCommissionRate = 0.05,
-  onChanged,
-}: Props) {
-  const [editForm] = Form.useForm();
-  const [createForm] = Form.useForm();
-  const [subForm] = Form.useForm();
-  const [subEditForm] = Form.useForm();
-  const [partners, setPartners] = useState<PartnerRow[]>([]);
-  const [loading, setLoading] = useState(false);
-  const [detail, setDetail] = useState<PartnerDetail | null>(null);
-  const [drawerOpen, setDrawerOpen] = useState(false);
-  const [createOpen, setCreateOpen] = useState(false);
-  const [subOpen, setSubOpen] = useState(false);
-  const [subEditOpen, setSubEditOpen] = useState(false);
-  const [subEditId, setSubEditId] = useState<string | null>(null);
-  const [createScopeType, setCreateScopeType] = useState<CityPartnerScopeType>(CityPartnerScopeType.CITY_WIDE);
-  const [editScopeType, setEditScopeType] = useState<CityPartnerScopeType>(CityPartnerScopeType.CITY_WIDE);
-
-  const loadPartners = useCallback(async () => {
-    setLoading(true);
-    try {
-      const res = await request<Paginated<PartnerRow>>(`/admin/partners?cityId=${cityId}&pageSize=100`);
-      setPartners(res.items);
-    } finally {
-      setLoading(false);
-    }
-  }, [cityId]);
-
-  useEffect(() => {
-    void loadPartners();
-  }, [loadPartners]);
-
-  async function openPartner(id: string) {
-    const d = await request<PartnerDetail>(`/admin/partners/${id}`);
-    setDetail(d);
-    setEditScopeType((d.scopeType as CityPartnerScopeType) || CityPartnerScopeType.CITY_WIDE);
-    editForm.setFieldsValue({
-      name: d.name,
-      phone: d.phone,
-      companyName: d.companyName,
-      contactPhone: d.contactPhone ?? d.phone,
-      address: d.address ?? '',
-      scopeType: d.scopeType,
-      districtCodes: d.districtCodes ?? [],
-      orderCommissionRate: (d.orderCommissionRate ?? 0) * 100,
-      redeemCommissionRate: (d.redeemCommissionRate ?? 0.03) * 100,
-      bindingStatus: d.bindingStatus ?? CityPartnerStatus.ACTIVE,
-      bankAccountName: d.bankAccountName ?? '',
-      bankAccountNo: d.bankAccountNo ?? '',
-      bankBranch: d.bankBranch ?? '',
-    });
-    setDrawerOpen(true);
-  }
-
-  async function savePartner() {
-    if (!detail) return;
-    try {
-      const v = await editForm.validateFields();
-      const err = commissionSumError(
-        Number(v.orderCommissionRate ?? 0),
-        Number(v.redeemCommissionRate ?? 0),
-        maxPartnerCommissionRate,
-      );
-      if (err) {
-        message.error(err);
-        return;
-      }
-      await request(`/admin/partners/${detail.id}`, {
-        method: 'PUT',
-        body: JSON.stringify({
-          ...v,
-          orderCommissionRate: Number(v.orderCommissionRate ?? 0) / 100,
-          redeemCommissionRate: Number(v.redeemCommissionRate ?? 3) / 100,
-          districtCodes: editScopeType === CityPartnerScopeType.DISTRICT ? flattenDistrictCodes(v.districtCodes) : undefined,
-        }),
-      });
-      message.success('已保存');
-      setDrawerOpen(false);
-      void loadPartners();
-      onChanged?.();
-    } catch (e) {
-      const msg = formatApiError(e);
-      if (msg) message.error(msg);
-    }
-  }
-
-  async function deleteSubAccount(subId: string) {
-    await request(`/admin/partner-accounts/${subId}`, { method: 'DELETE' });
-    message.success('子账号已删除');
-    if (detail) void openPartner(detail.id);
-    void loadPartners();
-    onChanged?.();
-  }
-
-  const columns: ColumnsType<PartnerRow> = [
-    {
-      title: '区县',
-      dataIndex: 'districtCodes',
-      width: 160,
-      ellipsis: true,
-      render: (codes: string[] | null | undefined, row) =>
-        row.scopeType === CityPartnerScopeType.CITY_WIDE ? '全城' : formatDistrictLabels(codes),
-    },
-    { title: '公司名', dataIndex: 'companyName', ellipsis: true },
-    { title: '主账号', dataIndex: 'phone', width: 120 },
-    {
-      title: '管辖',
-      dataIndex: 'scopeType',
-      width: 100,
-      render: (v) => (v ? CITY_PARTNER_SCOPE_LABELS[v as keyof typeof CITY_PARTNER_SCOPE_LABELS] || v : '—'),
-    },
-    {
-      title: '佣金',
-      width: 120,
-      render: (_, row) => `${Math.round((row.orderCommissionRate ?? 0) * 100)}% / ${Math.round((row.redeemCommissionRate ?? 0.03) * 100)}%`,
-    },
-    { title: '子账号', dataIndex: 'accountCount', width: 70, render: (n) => Math.max(0, n - 1) },
-    { title: '创建', dataIndex: 'createdAt', width: 150, render: fmtTime },
-    {
-      title: '操作',
-      width: 80,
-      render: (_, row) => (
-        <Button type="link" size="small" onClick={() => void openPartner(row.id)}>
-          管理
-        </Button>
-      ),
-    },
-  ];
-
-  return (
-    <>
-      <Button
-        type="primary"
-        style={{ marginBottom: 12 }}
-        onClick={() => {
-          createForm.resetFields();
-          createForm.setFieldsValue({
-            cityId,
-            orderCommissionRate: 0,
-            redeemCommissionRate: 3,
-            scopeType: CityPartnerScopeType.CITY_WIDE,
-          });
-          setCreateScopeType(CityPartnerScopeType.CITY_WIDE);
-          setCreateOpen(true);
-        }}
-      >
-        新建合伙人
-      </Button>
-      <Table rowKey="id" size="small" loading={loading} columns={columns} dataSource={partners} pagination={false} />
-
-      <Drawer
-        title="城市合伙人"
-        width={640}
-        open={drawerOpen}
-        onClose={() => setDrawerOpen(false)}
-        extra={<Button type="primary" onClick={() => void savePartner()}>保存</Button>}
-      >
-        {detail && (
-          <Tabs
-            items={[
-              {
-                key: 'info',
-                label: '主账号',
-                children: (
-                  <Form form={editForm} layout="vertical">
-                    <Form.Item name="companyName" label="公司名"><Input placeholder="选填" /></Form.Item>
-                    <Form.Item name="name" label="主账号姓名" rules={[{ required: true }]}><Input /></Form.Item>
-                    <Form.Item name="phone" label="登录手机号" rules={[{ required: true }]}><Input /></Form.Item>
-                    <Form.Item name="contactPhone" label="业务联系电话"><Input /></Form.Item>
-                    <Form.Item name="address" label="地址"><Input placeholder="选填" /></Form.Item>
-                    <Form.Item name="bindingStatus" label="绑定状态" rules={[{ required: true }]}>
-                      <Select options={BINDING_OPTIONS} />
-                    </Form.Item>
-                    <Form.Item name="scopeType" label="管辖类型" rules={[{ required: true }]}>
-                      <Select options={SCOPE_OPTIONS} onChange={(v) => setEditScopeType(v)} />
-                    </Form.Item>
-                    {editScopeType === CityPartnerScopeType.DISTRICT && (
-                      <Form.Item
-                        name="districtCodes"
-                        label="区县"
-                        extra="仅作标识，可多选当前城市下的区县（不做互斥）"
-                      >
-                        <CityDistrictMultiSelect cityCode={cityCode} />
-                      </Form.Item>
-                    )}
-                    <Space style={{ width: '100%' }} size="large">
-                      <Form.Item name="orderCommissionRate" label="订单佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
-                      <Form.Item name="redeemCommissionRate" label="核销佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
-                    </Space>
-                    <Typography.Text type="secondary" style={{ display: 'block', marginBottom: 12 }}>
-                      订单 + 核销合计不得超过 {(maxPartnerCommissionRate * 100).toFixed(2)}%（可在城市基本信息中调整）
-                    </Typography.Text>
-                    <Form.Item label="管仓仓库">
-                      <Input
-                        disabled
-                        value={detail.managedWarehouseName ?? '未分配（请在仓库管理中设置）'}
-                      />
-                    </Form.Item>
-                    <Form.Item name="bankAccountName" label="户名"><Input /></Form.Item>
-                    <Form.Item name="bankAccountNo" label="账号"><Input /></Form.Item>
-                    <Form.Item name="bankBranch" label="开户行"><Input /></Form.Item>
-                  </Form>
-                ),
-              },
-              {
-                key: 'staff',
-                label: `子账号 (${Math.max(0, (detail.accountCount ?? 1) - 1)})`,
-                children: (
-                  <PartnerSubAccountList
-                    subs={detail.children ?? []}
-                    onAdd={() => {
-                      subForm.resetFields();
-                      subForm.setFieldsValue({ staffRole: 'INTERNAL', permissions: ['store:create', 'store:manage'] });
-                      setSubOpen(true);
-                    }}
-                    onEdit={(row) => {
-                      setSubEditId(row.id);
-                      subEditForm.setFieldsValue({
-                        name: row.name,
-                        phone: row.phone,
-                        staffRole: row.staffRole ?? 'INTERNAL',
-                        permissions: row.permissions ?? [],
-                        status: row.status,
-                      });
-                      setSubEditOpen(true);
-                    }}
-                    onDelete={(subId) => void deleteSubAccount(subId)}
-                  />
-                ),
-              },
-            ]}
-          />
-        )}
-      </Drawer>
-
-      <Modal title="新建城市合伙人" open={createOpen} width={560} onCancel={() => setCreateOpen(false)} onOk={async () => {
-        try {
-          const v = await createForm.validateFields();
-          const err = commissionSumError(
-            Number(v.orderCommissionRate ?? 0),
-            Number(v.redeemCommissionRate ?? 3),
-            maxPartnerCommissionRate,
-          );
-          if (err) {
-            message.error(err);
-            return;
-          }
-          await request('/admin/partners', {
-            method: 'POST',
-            body: JSON.stringify({
-              ...v,
-              cityId,
-              orderCommissionRate: Number(v.orderCommissionRate ?? 0) / 100,
-              redeemCommissionRate: Number(v.redeemCommissionRate ?? 3) / 100,
-              districtCodes: createScopeType === CityPartnerScopeType.DISTRICT ? flattenDistrictCodes(v.districtCodes) : undefined,
-            }),
-          });
-          message.success('已创建');
-          setCreateOpen(false);
-          void loadPartners();
-          onChanged?.();
-        } catch (e) {
-          const msg = formatApiError(e);
-          if (msg) message.error(msg);
-        }
-      }}>
-        <Form form={createForm} layout="vertical">
-          <Form.Item name="companyName" label="公司名"><Input placeholder="选填" /></Form.Item>
-          <Form.Item name="name" label="主账号姓名" rules={[{ required: true }]}><Input /></Form.Item>
-          <Form.Item name="phone" label="登录手机号" rules={[{ required: true }]}><Input /></Form.Item>
-          <Form.Item name="address" label="地址"><Input placeholder="选填" /></Form.Item>
-          <Form.Item name="scopeType" label="管辖类型" rules={[{ required: true }]}>
-            <Select options={SCOPE_OPTIONS} onChange={(v) => setCreateScopeType(v)} />
-          </Form.Item>
-          {createScopeType === CityPartnerScopeType.DISTRICT && (
-            <Form.Item
-              name="districtCodes"
-              label="区县"
-              extra="选填；仅作标识，可多选当前城市下的区县（不做互斥）"
-            >
-              <CityDistrictMultiSelect cityCode={cityCode} />
-            </Form.Item>
-          )}
-          <Space style={{ width: '100%' }} size="large">
-            <Form.Item name="orderCommissionRate" label="订单佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
-            <Form.Item name="redeemCommissionRate" label="核销佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
-          </Space>
-          <Typography.Text type="secondary" style={{ display: 'block', marginBottom: 12 }}>
-            订单 + 核销合计不得超过 {(maxPartnerCommissionRate * 100).toFixed(2)}%
-          </Typography.Text>
-        </Form>
-      </Modal>
-
-      <Modal title="添加子账号" open={subOpen} onCancel={() => setSubOpen(false)} onOk={async () => {
-        if (!detail) return;
-        const v = await subForm.validateFields();
-        await request('/admin/partner-accounts', {
-          method: 'POST',
-          body: JSON.stringify({ ...v, parentAccountId: detail.id }),
-        });
-        message.success('已创建');
-        setSubOpen(false);
-        void openPartner(detail.id);
-        void loadPartners();
-        onChanged?.();
-      }}>
-        <Form form={subForm} layout="vertical">
-          <Form.Item name="name" label="姓名" rules={[{ required: true }]}><Input /></Form.Item>
-          <Form.Item name="phone" label="手机号" rules={[{ required: true }]}><Input /></Form.Item>
-          <Form.Item name="staffRole" label="角色" initialValue="INTERNAL">
-            <Select options={STAFF_ROLE_OPTIONS} />
-          </Form.Item>
-          <Form.Item name="permissions" label="权限">
-            <Checkbox.Group options={PERM_OPTIONS} />
-          </Form.Item>
-        </Form>
-      </Modal>
-
-      <Modal title="编辑子账号" open={subEditOpen} onCancel={() => setSubEditOpen(false)} onOk={async () => {
-        if (!subEditId || !detail) return;
-        const v = await subEditForm.validateFields();
-        await request(`/admin/partner-accounts/${subEditId}`, { method: 'PUT', body: JSON.stringify(v) });
-        message.success('已更新');
-        setSubEditOpen(false);
-        void openPartner(detail.id);
-      }}>
-        <Form form={subEditForm} layout="vertical">
-          <Form.Item name="name" label="姓名" rules={[{ required: true }]}><Input /></Form.Item>
-          <Form.Item name="phone" label="手机号" rules={[{ required: true }]}><Input /></Form.Item>
-          <Form.Item name="staffRole" label="角色"><Select options={STAFF_ROLE_OPTIONS} /></Form.Item>
-          <Form.Item name="status" label="状态">
-            <Select options={[{ value: 'ACTIVE', label: '启用' }, { value: 'DISABLED', label: '停用' }]} />
-          </Form.Item>
-          <Form.Item name="permissions" label="权限">
-            <Checkbox.Group options={PERM_OPTIONS} />
-          </Form.Item>
-        </Form>
-      </Modal>
-    </>
-  );
-}
+import { useCallback, useEffect, useState } from 'react';
+import {
+  Button,
+  Checkbox,
+  Drawer,
+  Form,
+  Input,
+  InputNumber,
+  Modal,
+  Select,
+  Space,
+  Table,
+  Tabs,
+  Typography,
+  message,
+} from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import {
+  CITY_PARTNER_SCOPE_LABELS,
+  CITY_PARTNER_STATUS_LABELS,
+  CityPartnerScopeType,
+  CityPartnerStatus,
+  PARTNER_PERMISSION_KEYS,
+  PARTNER_PERMISSION_LABELS,
+  PARTNER_STAFF_ROLE_LABELS,
+  type PartnerPermissionKey,
+} from '@dukang/shared-types';
+import { request, type Paginated } from '../lib/api';
+import { districtCodeLabel, formatDistrictLabels } from '../lib/china-region';
+import { fmtTime } from '../lib/constants';
+import CityDistrictMultiSelect from './CityDistrictMultiSelect';
+import PartnerSubAccountList from './PartnerSubAccountList';
+
+type PartnerRow = {
+  id: string;
+  companyName: string;
+  phone: string;
+  name: string;
+  scopeType?: string;
+  districtCodes?: string[] | null;
+  orderCommissionRate?: number;
+  redeemCommissionRate?: number;
+  accountCount: number;
+  createdAt: string;
+};
+
+type PartnerDetail = PartnerRow & {
+  address?: string;
+  districtCodes?: string[] | null;
+  bindingStatus?: string;
+  bankAccountName?: string | null;
+  bankAccountNo?: string | null;
+  bankBranch?: string | null;
+  managedWarehouseId?: string | null;
+  managedWarehouseName?: string | null;
+  contactPhone?: string | null;
+  children?: Array<{
+    id: string;
+    phone: string;
+    name: string;
+    staffRole?: string;
+    permissions?: string[];
+    status: string;
+  }>;
+};
+
+type Props = {
+  cityId: string;
+  cityCode?: string;
+  maxPartnerCommissionRate?: number;
+  onChanged?: () => void;
+};
+
+const SCOPE_OPTIONS = Object.entries(CITY_PARTNER_SCOPE_LABELS).map(([value, label]) => ({ value, label }));
+const BINDING_OPTIONS = Object.entries(CITY_PARTNER_STATUS_LABELS).map(([value, label]) => ({ value, label }));
+const PERM_OPTIONS = PARTNER_PERMISSION_KEYS.map((k: PartnerPermissionKey) => ({
+  value: k,
+  label: PARTNER_PERMISSION_LABELS[k],
+}));
+const STAFF_ROLE_OPTIONS = Object.entries(PARTNER_STAFF_ROLE_LABELS)
+  .filter(([value]) => value !== 'PARTNER')
+  .map(([value, label]) => ({ value, label }));
+
+function flattenDistrictCodes(values: string[] | string[][] | undefined): string[] {
+  if (!values?.length) return [];
+  if (Array.isArray(values[0])) {
+    return (values as string[][]).map((path) => path[path.length - 1]).filter(Boolean);
+  }
+  return values as string[];
+}
+
+function commissionSumError(
+  orderPercent: number,
+  redeemPercent: number,
+  maxRate: number,
+): string | null {
+  // API 可能把 Prisma Decimal 序列化为字符串；`"0.05" + 1e-9` 会变成字符串拼接导致误判超限
+  const max = Number(maxRate);
+  const sum = Number(orderPercent) / 100 + Number(redeemPercent) / 100;
+  if (!Number.isFinite(max) || !Number.isFinite(sum)) return '佣金比例无效';
+  if (sum > max + 1e-9) {
+    return `订单佣金与核销佣金合计不得超过 ${(max * 100).toFixed(2)}%（当前 ${(sum * 100).toFixed(2)}%）`;
+  }
+  return null;
+}
+
+function formatApiError(err: unknown): string | null {
+  if (err && typeof err === 'object' && 'errorFields' in err) return null;
+  if (!(err instanceof Error)) return '操作失败';
+  return err.message.replace(/\b(\d{6})\b/g, (code) => {
+    const label = districtCodeLabel(code);
+    return label !== code ? `${label}(${code})` : code;
+  });
+}
+
+export default function CityPartnersPanel({
+  cityId,
+  cityCode,
+  maxPartnerCommissionRate = 0.05,
+  onChanged,
+}: Props) {
+  const [editForm] = Form.useForm();
+  const [createForm] = Form.useForm();
+  const [subForm] = Form.useForm();
+  const [subEditForm] = Form.useForm();
+  const [partners, setPartners] = useState<PartnerRow[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [detail, setDetail] = useState<PartnerDetail | null>(null);
+  const [drawerOpen, setDrawerOpen] = useState(false);
+  const [createOpen, setCreateOpen] = useState(false);
+  const [subOpen, setSubOpen] = useState(false);
+  const [subEditOpen, setSubEditOpen] = useState(false);
+  const [subEditId, setSubEditId] = useState<string | null>(null);
+  const [createScopeType, setCreateScopeType] = useState<CityPartnerScopeType>(CityPartnerScopeType.CITY_WIDE);
+  const [editScopeType, setEditScopeType] = useState<CityPartnerScopeType>(CityPartnerScopeType.CITY_WIDE);
+
+  const loadPartners = useCallback(async () => {
+    setLoading(true);
+    try {
+      const res = await request<Paginated<PartnerRow>>(`/admin/partners?cityId=${cityId}&pageSize=100`);
+      setPartners(res.items);
+    } finally {
+      setLoading(false);
+    }
+  }, [cityId]);
+
+  useEffect(() => {
+    void loadPartners();
+  }, [loadPartners]);
+
+  async function openPartner(id: string) {
+    const d = await request<PartnerDetail>(`/admin/partners/${id}`);
+    setDetail(d);
+    setEditScopeType((d.scopeType as CityPartnerScopeType) || CityPartnerScopeType.CITY_WIDE);
+    editForm.setFieldsValue({
+      name: d.name,
+      phone: d.phone,
+      companyName: d.companyName,
+      contactPhone: d.contactPhone ?? d.phone,
+      address: d.address ?? '',
+      scopeType: d.scopeType,
+      districtCodes: d.districtCodes ?? [],
+      orderCommissionRate: (d.orderCommissionRate ?? 0) * 100,
+      redeemCommissionRate: (d.redeemCommissionRate ?? 0.03) * 100,
+      bindingStatus: d.bindingStatus ?? CityPartnerStatus.ACTIVE,
+      bankAccountName: d.bankAccountName ?? '',
+      bankAccountNo: d.bankAccountNo ?? '',
+      bankBranch: d.bankBranch ?? '',
+    });
+    setDrawerOpen(true);
+  }
+
+  async function savePartner() {
+    if (!detail) return;
+    try {
+      const v = await editForm.validateFields();
+      const err = commissionSumError(
+        Number(v.orderCommissionRate ?? 0),
+        Number(v.redeemCommissionRate ?? 0),
+        maxPartnerCommissionRate,
+      );
+      if (err) {
+        message.error(err);
+        return;
+      }
+      await request(`/admin/partners/${detail.id}`, {
+        method: 'PUT',
+        body: JSON.stringify({
+          ...v,
+          orderCommissionRate: Number(v.orderCommissionRate ?? 0) / 100,
+          redeemCommissionRate: Number(v.redeemCommissionRate ?? 3) / 100,
+          districtCodes: editScopeType === CityPartnerScopeType.DISTRICT ? flattenDistrictCodes(v.districtCodes) : undefined,
+        }),
+      });
+      message.success('已保存');
+      setDrawerOpen(false);
+      void loadPartners();
+      onChanged?.();
+    } catch (e) {
+      const msg = formatApiError(e);
+      if (msg) message.error(msg);
+    }
+  }
+
+  async function deleteSubAccount(subId: string) {
+    await request(`/admin/partner-accounts/${subId}`, { method: 'DELETE' });
+    message.success('子账号已删除');
+    if (detail) void openPartner(detail.id);
+    void loadPartners();
+    onChanged?.();
+  }
+
+  const columns: ColumnsType<PartnerRow> = [
+    {
+      title: '区县',
+      dataIndex: 'districtCodes',
+      width: 160,
+
+      render: (codes: string[] | null | undefined, row) =>
+        row.scopeType === CityPartnerScopeType.CITY_WIDE ? '全城' : formatDistrictLabels(codes),
+    },
+    { title: '公司名', dataIndex: 'companyName' },
+    { title: '主账号', dataIndex: 'phone', width: 120 },
+    {
+      title: '管辖',
+      dataIndex: 'scopeType',
+      width: 100,
+      render: (v) => (v ? CITY_PARTNER_SCOPE_LABELS[v as keyof typeof CITY_PARTNER_SCOPE_LABELS] || v : '—'),
+    },
+    {
+      title: '佣金',
+      width: 120,
+      render: (_, row) => `${Math.round((row.orderCommissionRate ?? 0) * 100)}% / ${Math.round((row.redeemCommissionRate ?? 0.03) * 100)}%`,
+    },
+    { title: '子账号', dataIndex: 'accountCount', width: 70, render: (n) => Math.max(0, n - 1) },
+    { title: '创建', dataIndex: 'createdAt', width: 150, render: fmtTime },
+    {
+      title: '操作',
+      width: 80,
+      render: (_, row) => (
+        <Button type="link" size="small" onClick={() => void openPartner(row.id)}>
+          管理
+        </Button>
+      ),
+    },
+  ];
+
+  return (
+    <>
+      <Button
+        type="primary"
+        style={{ marginBottom: 12 }}
+        onClick={() => {
+          createForm.resetFields();
+          createForm.setFieldsValue({
+            cityId,
+            orderCommissionRate: 0,
+            redeemCommissionRate: 3,
+            scopeType: CityPartnerScopeType.CITY_WIDE,
+          });
+          setCreateScopeType(CityPartnerScopeType.CITY_WIDE);
+          setCreateOpen(true);
+        }}
+      >
+        新建合伙人
+      </Button>
+      <Table rowKey="id" size="small" loading={loading} columns={columns} dataSource={partners} pagination={false} />
+
+      <Drawer
+        title="城市合伙人"
+        width={640}
+        open={drawerOpen}
+        onClose={() => setDrawerOpen(false)}
+        extra={<Button type="primary" onClick={() => void savePartner()}>保存</Button>}
+      >
+        {detail && (
+          <Tabs
+            items={[
+              {
+                key: 'info',
+                label: '主账号',
+                children: (
+                  <Form form={editForm} layout="vertical">
+                    <Form.Item name="companyName" label="公司名"><Input placeholder="选填" /></Form.Item>
+                    <Form.Item name="name" label="主账号姓名" rules={[{ required: true }]}><Input /></Form.Item>
+                    <Form.Item name="phone" label="登录手机号" rules={[{ required: true }]}><Input /></Form.Item>
+                    <Form.Item name="contactPhone" label="业务联系电话"><Input /></Form.Item>
+                    <Form.Item name="address" label="地址"><Input placeholder="选填" /></Form.Item>
+                    <Form.Item name="bindingStatus" label="绑定状态" rules={[{ required: true }]}>
+                      <Select options={BINDING_OPTIONS} />
+                    </Form.Item>
+                    <Form.Item name="scopeType" label="管辖类型" rules={[{ required: true }]}>
+                      <Select options={SCOPE_OPTIONS} onChange={(v) => setEditScopeType(v)} />
+                    </Form.Item>
+                    {editScopeType === CityPartnerScopeType.DISTRICT && (
+                      <Form.Item
+                        name="districtCodes"
+                        label="区县"
+                        extra="仅作标识，可多选当前城市下的区县（不做互斥）"
+                      >
+                        <CityDistrictMultiSelect cityCode={cityCode} />
+                      </Form.Item>
+                    )}
+                    <Space style={{ width: '100%' }} size="large">
+                      <Form.Item name="orderCommissionRate" label="订单佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
+                      <Form.Item name="redeemCommissionRate" label="核销佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
+                    </Space>
+                    <Typography.Text type="secondary" style={{ display: 'block', marginBottom: 12 }}>
+                      订单 + 核销合计不得超过 {(maxPartnerCommissionRate * 100).toFixed(2)}%（可在城市基本信息中调整）
+                    </Typography.Text>
+                    <Form.Item label="管仓仓库">
+                      <Input
+                        disabled
+                        value={detail.managedWarehouseName ?? '未分配（请在仓库管理中设置）'}
+                      />
+                    </Form.Item>
+                    <Form.Item name="bankAccountName" label="户名"><Input /></Form.Item>
+                    <Form.Item name="bankAccountNo" label="账号"><Input /></Form.Item>
+                    <Form.Item name="bankBranch" label="开户行"><Input /></Form.Item>
+                  </Form>
+                ),
+              },
+              {
+                key: 'staff',
+                label: `子账号 (${Math.max(0, (detail.accountCount ?? 1) - 1)})`,
+                children: (
+                  <PartnerSubAccountList
+                    subs={detail.children ?? []}
+                    onAdd={() => {
+                      subForm.resetFields();
+                      subForm.setFieldsValue({ staffRole: 'INTERNAL', permissions: ['store:create', 'store:manage'] });
+                      setSubOpen(true);
+                    }}
+                    onEdit={(row) => {
+                      setSubEditId(row.id);
+                      subEditForm.setFieldsValue({
+                        name: row.name,
+                        phone: row.phone,
+                        staffRole: row.staffRole ?? 'INTERNAL',
+                        permissions: row.permissions ?? [],
+                        status: row.status,
+                      });
+                      setSubEditOpen(true);
+                    }}
+                    onDelete={(subId) => void deleteSubAccount(subId)}
+                  />
+                ),
+              },
+            ]}
+          />
+        )}
+      </Drawer>
+
+      <Modal title="新建城市合伙人" open={createOpen} width={560} onCancel={() => setCreateOpen(false)} onOk={async () => {
+        try {
+          const v = await createForm.validateFields();
+          const err = commissionSumError(
+            Number(v.orderCommissionRate ?? 0),
+            Number(v.redeemCommissionRate ?? 3),
+            maxPartnerCommissionRate,
+          );
+          if (err) {
+            message.error(err);
+            return;
+          }
+          await request('/admin/partners', {
+            method: 'POST',
+            body: JSON.stringify({
+              ...v,
+              cityId,
+              orderCommissionRate: Number(v.orderCommissionRate ?? 0) / 100,
+              redeemCommissionRate: Number(v.redeemCommissionRate ?? 3) / 100,
+              districtCodes: createScopeType === CityPartnerScopeType.DISTRICT ? flattenDistrictCodes(v.districtCodes) : undefined,
+            }),
+          });
+          message.success('已创建');
+          setCreateOpen(false);
+          void loadPartners();
+          onChanged?.();
+        } catch (e) {
+          const msg = formatApiError(e);
+          if (msg) message.error(msg);
+        }
+      }}>
+        <Form form={createForm} layout="vertical">
+          <Form.Item name="companyName" label="公司名"><Input placeholder="选填" /></Form.Item>
+          <Form.Item name="name" label="主账号姓名" rules={[{ required: true }]}><Input /></Form.Item>
+          <Form.Item name="phone" label="登录手机号" rules={[{ required: true }]}><Input /></Form.Item>
+          <Form.Item name="address" label="地址"><Input placeholder="选填" /></Form.Item>
+          <Form.Item name="scopeType" label="管辖类型" rules={[{ required: true }]}>
+            <Select options={SCOPE_OPTIONS} onChange={(v) => setCreateScopeType(v)} />
+          </Form.Item>
+          {createScopeType === CityPartnerScopeType.DISTRICT && (
+            <Form.Item
+              name="districtCodes"
+              label="区县"
+              extra="选填；仅作标识，可多选当前城市下的区县（不做互斥）"
+            >
+              <CityDistrictMultiSelect cityCode={cityCode} />
+            </Form.Item>
+          )}
+          <Space style={{ width: '100%' }} size="large">
+            <Form.Item name="orderCommissionRate" label="订单佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
+            <Form.Item name="redeemCommissionRate" label="核销佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
+          </Space>
+          <Typography.Text type="secondary" style={{ display: 'block', marginBottom: 12 }}>
+            订单 + 核销合计不得超过 {(maxPartnerCommissionRate * 100).toFixed(2)}%
+          </Typography.Text>
+        </Form>
+      </Modal>
+
+      <Modal title="添加子账号" open={subOpen} onCancel={() => setSubOpen(false)} onOk={async () => {
+        if (!detail) return;
+        const v = await subForm.validateFields();
+        await request('/admin/partner-accounts', {
+          method: 'POST',
+          body: JSON.stringify({ ...v, parentAccountId: detail.id }),
+        });
+        message.success('已创建');
+        setSubOpen(false);
+        void openPartner(detail.id);
+        void loadPartners();
+        onChanged?.();
+      }}>
+        <Form form={subForm} layout="vertical">
+          <Form.Item name="name" label="姓名" rules={[{ required: true }]}><Input /></Form.Item>
+          <Form.Item name="phone" label="手机号" rules={[{ required: true }]}><Input /></Form.Item>
+          <Form.Item name="staffRole" label="角色" initialValue="INTERNAL">
+            <Select options={STAFF_ROLE_OPTIONS} />
+          </Form.Item>
+          <Form.Item name="permissions" label="权限">
+            <Checkbox.Group options={PERM_OPTIONS} />
+          </Form.Item>
+        </Form>
+      </Modal>
+
+      <Modal title="编辑子账号" open={subEditOpen} onCancel={() => setSubEditOpen(false)} onOk={async () => {
+        if (!subEditId || !detail) return;
+        const v = await subEditForm.validateFields();
+        await request(`/admin/partner-accounts/${subEditId}`, { method: 'PUT', body: JSON.stringify(v) });
+        message.success('已更新');
+        setSubEditOpen(false);
+        void openPartner(detail.id);
+      }}>
+        <Form form={subEditForm} layout="vertical">
+          <Form.Item name="name" label="姓名" rules={[{ required: true }]}><Input /></Form.Item>
+          <Form.Item name="phone" label="手机号" rules={[{ required: true }]}><Input /></Form.Item>
+          <Form.Item name="staffRole" label="角色"><Select options={STAFF_ROLE_OPTIONS} /></Form.Item>
+          <Form.Item name="status" label="状态">
+            <Select options={[{ value: 'ACTIVE', label: '启用' }, { value: 'DISABLED', label: '停用' }]} />
+          </Form.Item>
+          <Form.Item name="permissions" label="权限">
+            <Checkbox.Group options={PERM_OPTIONS} />
+          </Form.Item>
+        </Form>
+      </Modal>
+    </>
+  );

apps/admin-web/src/components/PartnerSubAccountList.tsx

@@ -1,92 +1,91 @@
-import { Button, Popconfirm, Space, Table, Tag, Typography } from 'antd';
-import type { ColumnsType } from 'antd/es/table';
-import {
-  PARTNER_PERMISSION_LABELS,
-  PARTNER_STAFF_ROLE_LABELS,
-  type PartnerPermissionKey,
-} from '@dukang/shared-types';
-
-export type PartnerSubAccountRow = {
-  id: string;
-  phone: string;
-  name: string;
-  staffRole?: string;
-  permissions?: string[];
-  status: string;
-};
-
-function formatPermissions(permissions?: string[]) {
-  return permissions?.map((k) => PARTNER_PERMISSION_LABELS[k as PartnerPermissionKey] || k).join('、') || '—';
-}
-
-type Props = {
-  subs: PartnerSubAccountRow[];
-  onAdd: () => void;
-  onEdit: (sub: PartnerSubAccountRow) => void;
-  onDelete: (subId: string) => void;
-};
-
-export default function PartnerSubAccountList({ subs, onAdd, onEdit, onDelete }: Props) {
-  const columns: ColumnsType<PartnerSubAccountRow> = [
-    { title: '姓名', dataIndex: 'name', width: 100 },
-    { title: '手机', dataIndex: 'phone', width: 120 },
-    {
-      title: '角色',
-      dataIndex: 'staffRole',
-      width: 90,
-      render: (v) =>
-        v ? PARTNER_STAFF_ROLE_LABELS[v as keyof typeof PARTNER_STAFF_ROLE_LABELS] || v : '—',
-    },
-    {
-      title: '状态',
-      dataIndex: 'status',
-      width: 80,
-      render: (s) => (
-        <Tag color={s === 'ACTIVE' ? 'green' : 'default'}>{s === 'ACTIVE' ? '启用' : '停用'}</Tag>
-      ),
-    },
-    {
-      title: '权限',
-      dataIndex: 'permissions',
-      ellipsis: true,
-      render: (p: string[] | undefined) => formatPermissions(p),
-    },
-    {
-      title: '操作',
-      width: 120,
-      render: (_, row) => (
-        <Space size={0}>
-          <Button type="link" size="small" onClick={() => onEdit(row)}>
-            编辑
-          </Button>
-          <Popconfirm title="确定删除该子账号？" onConfirm={() => onDelete(row.id)}>
-            <Button type="link" size="small" danger>
-              删除
-            </Button>
-          </Popconfirm>
-        </Space>
-      ),
-    },
-  ];
-
-  return (
-    <>
-      <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 8 }}>
-        <Typography.Text type="secondary" style={{ fontSize: 12 }}>
-          子账号（{subs.length}）· 仅主账号可添加，不可多级
-        </Typography.Text>
-        <Button size="small" type="primary" onClick={onAdd}>
-          添加子账号
-        </Button>
-      </div>
-      <Table
-        size="small"
-        rowKey="id"
-        pagination={false}
-        columns={columns}
-        dataSource={subs}
-        locale={{ emptyText: '暂无子账号' }}
-      />
-    </>
-  );
-}
+import { Button, Popconfirm, Space, Table, Tag, Typography } from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import {
+  PARTNER_PERMISSION_LABELS,
+  PARTNER_STAFF_ROLE_LABELS,
+  type PartnerPermissionKey,
+} from '@dukang/shared-types';
+
+export type PartnerSubAccountRow = {
+  id: string;
+  phone: string;
+  name: string;
+  staffRole?: string;
+  permissions?: string[];
+  status: string;
+};
+
+function formatPermissions(permissions?: string[]) {
+  return permissions?.map((k) => PARTNER_PERMISSION_LABELS[k as PartnerPermissionKey] || k).join('、') || '—';
+}
+
+type Props = {
+  subs: PartnerSubAccountRow[];
+  onAdd: () => void;
+  onEdit: (sub: PartnerSubAccountRow) => void;
+  onDelete: (subId: string) => void;
+};
+
+export default function PartnerSubAccountList({ subs, onAdd, onEdit, onDelete }: Props) {
+  const columns: ColumnsType<PartnerSubAccountRow> = [
+    { title: '姓名', dataIndex: 'name', width: 100 },
+    { title: '手机', dataIndex: 'phone', width: 120 },
+    {
+      title: '角色',
+      dataIndex: 'staffRole',
+      width: 90,
+      render: (v) =>
+        v ? PARTNER_STAFF_ROLE_LABELS[v as keyof typeof PARTNER_STAFF_ROLE_LABELS] || v : '—',
+    },
+    {
+      title: '状态',
+      dataIndex: 'status',
+      width: 80,
+      render: (s) => (
+        <Tag color={s === 'ACTIVE' ? 'green' : 'default'}>{s === 'ACTIVE' ? '启用' : '停用'}</Tag>
+      ),
+    },
+    {
+      title: '权限',
+      dataIndex: 'permissions',
+
+      render: (p: string[] | undefined) => formatPermissions(p),
+    },
+    {
+      title: '操作',
+      width: 120,
+      render: (_, row) => (
+        <Space size={0}>
+          <Button type="link" size="small" onClick={() => onEdit(row)}>
+            编辑
+          </Button>
+          <Popconfirm title="确定删除该子账号？" onConfirm={() => onDelete(row.id)}>
+            <Button type="link" size="small" danger>
+              删除
+            </Button>
+          </Popconfirm>
+        </Space>
+      ),
+    },
+  ];
+
+  return (
+    <>
+      <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 8 }}>
+        <Typography.Text type="secondary" style={{ fontSize: 12 }}>
+          子账号（{subs.length}）· 仅主账号可添加，不可多级
+        </Typography.Text>
+        <Button size="small" type="primary" onClick={onAdd}>
+          添加子账号
+        </Button>
+      </div>
+      <Table
+        size="small"
+        rowKey="id"
+        pagination={false}
+        columns={columns}
+        dataSource={subs}
+        locale={{ emptyText: '暂无子账号' }}
+      />
+    </>
+  );

apps/admin-web/src/components/ProductSpecsEditor.tsx

@@ -0,0 +1,616 @@
+import { useMemo, useState } from 'react';
+import {
+  Button, Image, Input, InputNumber, Modal, Radio, Select, Space, Switch, Table, Typography, message,
+} from 'antd';
+import { EditOutlined, MinusCircleOutlined, PlusOutlined } from '@ant-design/icons';
+import { request } from '../lib/api';
+import { PRODUCT_STATUS_LABELS } from '../lib/constants';
+import OssUpload from './OssUpload';
+
+type SpecValue = { id?: string; name: string; sortOrder?: number };
+type SpecAttr = { id?: string; name: string; sortOrder?: number; values: SpecValue[] };
+type SkuRow = {
+  id?: string;
+  specValueIds: string[];
+  skuCode?: string;
+  barcode69: string;
+  price: number;
+  benefitAmount?: number;
+  status: string;
+  allowOnlinePurchase: boolean;
+  allowCrossCityDelivery: boolean;
+  allowOnSitePickup: boolean;
+  saleUnit: 'BOTTLE' | 'BOX';
+  bottlesPerUnit: number;
+  isDefault: boolean;
+  sortOrder?: number;
+  specText?: string;
+  imageUrl?: string | null;
+};
+
+function cartesian(attrs: SpecAttr[]): string[][] {
+  if (!attrs.length) return [[]];
+  return attrs.reduce<string[][]>(
+    (acc, attr) => {
+      const next: string[][] = [];
+      const values = attr.values.filter((v) => v.name?.trim());
+      for (const prev of acc) {
+        for (const v of values) {
+          const vid = v.id || `__new__:${attr.name}:${v.name}`;
+          next.push([...prev, vid]);
+        }
+      }
+      return next.length ? next : acc;
+    },
+    [[]],
+  );
+}
+
+function keyOf(ids: string[]) {
+  return [...ids].sort().join('_');
+}
+
+type Props = {
+  productId: string;
+  initialAttrs: SpecAttr[];
+  initialSkus: SkuRow[];
+  onSaved: () => void;
+};
+
+export default function ProductSpecsEditor({ productId, initialAttrs, initialSkus, onSaved }: Props) {
+  const [attrs, setAttrs] = useState<SpecAttr[]>(
+    initialAttrs.length
+      ? initialAttrs
+      : [],
+  );
+  const [skus, setSkus] = useState<SkuRow[]>(
+    initialSkus.length
+      ? initialSkus.map((s) => ({
+          ...s,
+          specValueIds: s.specValueIds ?? [],
+          status: s.status || 'ON_SALE',
+          allowOnlinePurchase: s.allowOnlinePurchase !== false,
+          allowCrossCityDelivery: s.allowCrossCityDelivery !== false,
+          allowOnSitePickup: !!s.allowOnSitePickup,
+          saleUnit: s.saleUnit === 'BOX' ? 'BOX' : 'BOTTLE',
+          bottlesPerUnit: s.bottlesPerUnit || (s.saleUnit === 'BOX' ? 6 : 1),
+          isDefault: !!s.isDefault,
+          imageUrl: s.imageUrl ?? '',
+        }))
+      : [
+          {
+            specValueIds: [],
+            barcode69: '',
+            price: 0,
+            status: 'ON_SALE',
+            allowOnlinePurchase: true,
+            allowCrossCityDelivery: true,
+            allowOnSitePickup: false,
+            saleUnit: 'BOTTLE',
+            bottlesPerUnit: 1,
+            isDefault: true,
+            imageUrl: '',
+          },
+        ],
+  );
+  const [saving, setSaving] = useState(false);
+  const [editIndex, setEditIndex] = useState<number | null>(null);
+
+  const combos = useMemo(() => cartesian(attrs.filter((a) => a.name.trim() && a.values.some((v) => v.name.trim()))), [attrs]);
+
+  function regenerateMatrix() {
+    const byKey = new Map(skus.map((s) => [keyOf(s.specValueIds ?? []), s]));
+    const next: SkuRow[] = combos.map((ids, i) => {
+      const existing = byKey.get(keyOf(ids));
+      if (existing) return { ...existing, specValueIds: ids, sortOrder: i };
+      return {
+        specValueIds: ids,
+        barcode69: '',
+        price: skus[0]?.price ?? 0,
+        benefitAmount: skus[0]?.benefitAmount,
+        status: 'DRAFT',
+        allowOnlinePurchase: true,
+        allowCrossCityDelivery: true,
+        allowOnSitePickup: false,
+        saleUnit: 'BOTTLE',
+        bottlesPerUnit: 1,
+        isDefault: i === 0,
+        sortOrder: i,
+        imageUrl: '',
+      };
+    });
+    if (next.length && !next.some((s) => s.isDefault)) next[0].isDefault = true;
+    setSkus(next.length ? next : skus);
+  }
+
+  function patchSku(index: number, patch: Partial<SkuRow>) {
+    setSkus((prev) => {
+      const next = [...prev];
+      next[index] = { ...next[index], ...patch };
+      return next;
+    });
+  }
+
+  async function handleSave() {
+    setSaving(true);
+    try {
+      // 1) 保存规格轴（新建值尚无 id，先提交 attrs）
+      const specsRes = await request<{
+        specAttrs: SpecAttr[];
+        skus: SkuRow[];
+      }>(`/admin/products/${productId}/specs`, {
+        method: 'PUT',
+        body: JSON.stringify({
+          attrs: attrs.map((a, i) => ({
+            id: a.id,
+            name: a.name.trim(),
+            sortOrder: i,
+            values: a.values
+              .filter((v) => v.name.trim())
+              .map((v, j) => ({ id: v.id, name: v.name.trim(), sortOrder: j })),
+          })),
+        }),
+      });
+
+      // 映射临时 id → 真实 id
+      const nameToId = new Map<string, string>();
+      for (const a of specsRes.specAttrs ?? []) {
+        for (const v of a.values ?? []) {
+          nameToId.set(`${a.name}:${v.name}`, v.id!);
+        }
+      }
+      const resolveIds = (ids: string[]) =>
+        ids.map((id) => {
+          if (!id.startsWith('__new__:')) return id;
+          const [, attrName, valueName] = id.split(':');
+          const real = nameToId.get(`${attrName}:${valueName}`);
+          if (!real) throw new Error(`规格值未创建：${attrName}/${valueName}`);
+          return real;
+        });
+
+      const payloadSkus = skus.map((s, i) => ({
+        id: s.id,
+        specValueIds: resolveIds(s.specValueIds ?? []),
+        barcode69: s.barcode69.trim(),
+        price: s.price,
+        benefitAmount: s.benefitAmount,
+        status: s.status,
+        allowOnlinePurchase: s.allowOnlinePurchase,
+        allowCrossCityDelivery: s.allowCrossCityDelivery,
+        allowOnSitePickup: s.allowOnSitePickup,
+        saleUnit: s.saleUnit,
+        bottlesPerUnit: s.saleUnit === 'BOX' ? s.bottlesPerUnit || 6 : 1,
+        isDefault: !!s.isDefault,
+        sortOrder: i,
+        imageUrl: s.imageUrl?.trim() || null,
+      }));
+
+      const barcodes = payloadSkus.map((row) => row.barcode69);
+      if (barcodes.some((b) => !b)) throw new Error('每个规格须填写独立 69 码');
+      if (new Set(barcodes).size !== barcodes.length) {
+        throw new Error('同一商品内 69 码不可重复，每个规格请填写不同 69 码');
+      }
+
+      await request(`/admin/products/${productId}/skus`, {
+        method: 'PUT',
+        body: JSON.stringify({ skus: payloadSkus }),
+      });
+      message.success('规格与 SKU 已保存');
+      onSaved();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '保存失败');
+    } finally {
+      setSaving(false);
+    }
+  }
+
+  const editing = editIndex != null ? skus[editIndex] : null;
+
+  return (
+    <div>
+      <Typography.Paragraph type="secondary">
+        SKU 码由系统自动生成（DK 开头），无需填写。每个规格必须填写<strong>互不相同</strong>的 69 码，并可单独上传主图。
+        点「填写」在弹窗中编辑。先配置销售规格轴（如「包装」），再生成 SKU 矩阵。
+      </Typography.Paragraph>
+
+      <Typography.Title level={5}>规格轴</Typography.Title>
+      {attrs.map((attr, ai) => (
+        <div key={ai} style={{ marginBottom: 12, padding: 12, border: '1px solid #f0f0f0', borderRadius: 8 }}>
+          <Space align="start" style={{ width: '100%' }} wrap>
+            <Input
+              style={{ width: 140 }}
+              placeholder="规格名"
+              value={attr.name}
+              onChange={(e) => {
+                const next = [...attrs];
+                next[ai] = { ...attr, name: e.target.value };
+                setAttrs(next);
+              }}
+            />
+            <Button
+              type="text"
+              danger
+              icon={<MinusCircleOutlined />}
+              onClick={() => setAttrs(attrs.filter((_, i) => i !== ai))}
+            />
+          </Space>
+          <div style={{ marginTop: 8 }}>
+            {attr.values.map((val, vi) => (
+              <Space key={vi} style={{ display: 'flex', marginBottom: 6 }}>
+                <Input
+                  placeholder="规格值"
+                  value={val.name}
+                  onChange={(e) => {
+                    const next = [...attrs];
+                    const values = [...attr.values];
+                    values[vi] = { ...val, name: e.target.value };
+                    next[ai] = { ...attr, values };
+                    setAttrs(next);
+                  }}
+                />
+                <Button
+                  type="text"
+                  danger
+                  icon={<MinusCircleOutlined />}
+                  onClick={() => {
+                    const next = [...attrs];
+                    next[ai] = { ...attr, values: attr.values.filter((_, j) => j !== vi) };
+                    setAttrs(next);
+                  }}
+                />
+              </Space>
+            ))}
+            <Button
+              type="dashed"
+              size="small"
+              icon={<PlusOutlined />}
+              onClick={() => {
+                const next = [...attrs];
+                next[ai] = { ...attr, values: [...attr.values, { name: '' }] };
+                setAttrs(next);
+              }}
+            >
+              添加规格值
+            </Button>
+          </div>
+        </div>
+      ))}
+      <Space style={{ marginBottom: 16 }}>
+        <Button
+          icon={<PlusOutlined />}
+          disabled={attrs.length >= 3}
+          onClick={() => setAttrs([...attrs, { name: '', values: [{ name: '' }] }])}
+        >
+          添加规格轴
+        </Button>
+        <Button onClick={regenerateMatrix}>按规格生成 SKU 矩阵</Button>
+      </Space>
+
+      <Typography.Title level={5}>SKU 列表</Typography.Title>
+      <Table
+        size="small"
+        rowKey={(_, i) => String(i)}
+        pagination={false}
+        scroll={{ x: 1240 }}
+        dataSource={skus}
+        columns={[
+          {
+            title: '规格',
+            width: 140,
+            render: (_, row) => row.specText || (row.specValueIds?.length ? row.specValueIds.join(',') : '默认'),
+          },
+          {
+            title: 'SKU',
+            width: 110,
+            render: (_, row) => (
+              <Typography.Text type="secondary">
+                {row.skuCode || '保存后自动生成'}
+              </Typography.Text>
+            ),
+          },
+          {
+            title: <span>69码 <Typography.Text type="danger">*</Typography.Text></span>,
+            width: 180,
+            render: (_, row, index) => (
+              <Input
+                placeholder="本规格独立 69 码"
+                value={row.barcode69}
+                onChange={(e) => {
+                  const next = [...skus];
+                  next[index] = { ...row, barcode69: e.target.value };
+                  setSkus(next);
+                }}
+              />
+            ),
+          },
+          {
+            title: '售价',
+            width: 100,
+            render: (_, row, index) => (
+              <InputNumber
+                min={0}
+                style={{ width: '100%' }}
+                value={row.price}
+                onChange={(v) => {
+                  const next = [...skus];
+                  next[index] = { ...row, price: Number(v) || 0 };
+                  setSkus(next);
+                }}
+              />
+            ),
+          },
+          {
+            title: '权益',
+            width: 100,
+            render: (_, row, index) => (
+              <InputNumber
+                min={0}
+                style={{ width: '100%' }}
+                value={row.benefitAmount}
+                onChange={(v) => {
+                  const next = [...skus];
+                  next[index] = { ...row, benefitAmount: v == null ? undefined : Number(v) };
+                  setSkus(next);
+                }}
+              />
+            ),
+          },
+          {
+            title: '状态',
+            width: 110,
+            render: (_, row, index) => (
+              <Select
+                style={{ width: '100%' }}
+                value={row.status}
+                options={Object.entries(PRODUCT_STATUS_LABELS).map(([value, label]) => ({ value, label }))}
+                onChange={(status) => {
+                  const next = [...skus];
+                  next[index] = { ...row, status };
+                  setSkus(next);
+                }}
+              />
+            ),
+          },
+          {
+            title: '单位',
+            width: 160,
+            render: (_, row, index) => (
+              <Space>
+                <Select
+                  style={{ width: 80 }}
+                  value={row.saleUnit}
+                  options={[
+                    { value: 'BOTTLE', label: '瓶' },
+                    { value: 'BOX', label: '箱' },
+                  ]}
+                  onChange={(saleUnit) => {
+                    const next = [...skus];
+                    next[index] = {
+                      ...row,
+                      saleUnit,
+                      bottlesPerUnit: saleUnit === 'BOX' ? row.bottlesPerUnit || 6 : 1,
+                    };
+                    setSkus(next);
+                  }}
+                />
+                {row.saleUnit === 'BOX' ? (
+                  <InputNumber
+                    min={1}
+                    style={{ width: 70 }}
+                    value={row.bottlesPerUnit}
+                    onChange={(v) => {
+                      const next = [...skus];
+                      next[index] = { ...row, bottlesPerUnit: Number(v) || 6 };
+                      setSkus(next);
+                    }}
+                  />
+                ) : null}
+              </Space>
+            ),
+          },
+          {
+            title: '履约',
+            width: 200,
+            render: (_, row, index) => (
+              <Space direction="vertical" size={0}>
+                <Switch
+                  checkedChildren="线上"
+                  unCheckedChildren="线上"
+                  checked={row.allowOnlinePurchase}
+                  onChange={(checked) => {
+                    const next = [...skus];
+                    next[index] = {
+                      ...row,
+                      allowOnlinePurchase: checked,
+                      allowCrossCityDelivery: checked ? row.allowCrossCityDelivery : false,
+                    };
+                    setSkus(next);
+                  }}
+                />
+                <Switch
+                  checkedChildren="跨城"
+                  unCheckedChildren="跨城"
+                  disabled={!row.allowOnlinePurchase}
+                  checked={row.allowCrossCityDelivery}
+                  onChange={(checked) => {
+                    const next = [...skus];
+                    next[index] = { ...row, allowCrossCityDelivery: checked };
+                    setSkus(next);
+                  }}
+                />
+                <Switch
+                  checkedChildren="现场"
+                  unCheckedChildren="现场"
+                  checked={row.allowOnSitePickup}
+                  onChange={(checked) => {
+                    const next = [...skus];
+                    next[index] = { ...row, allowOnSitePickup: checked };
+                    setSkus(next);
+                  }}
+                />
+              </Space>
+            ),
+          },
+          {
+            title: '默认',
+            width: 70,
+            render: (_, row, index) => (
+              <Radio
+                checked={row.isDefault}
+                onChange={() => {
+                  setSkus(skus.map((s, i) => ({ ...s, isDefault: i === index })));
+                }}
+              />
+            ),
+          },
+          {
+            title: '主图',
+            width: 72,
+            render: (_, row) =>
+              row.imageUrl ? (
+                <Image src={row.imageUrl} width={40} height={40} style={{ objectFit: 'cover', borderRadius: 4 }} />
+              ) : (
+                <Typography.Text type="secondary">无</Typography.Text>
+              ),
+          },
+          {
+            title: '编辑',
+            width: 80,
+            fixed: 'right',
+            render: (_, row, index) => (
+              <Button type="link" size="small" icon={<EditOutlined />} onClick={() => setEditIndex(index)}>
+                填写
+              </Button>
+            ),
+          },
+        ]}
+      />
+
+      <Button type="primary" loading={saving} style={{ marginTop: 16 }} onClick={() => void handleSave()}>
+        保存规格与 SKU
+      </Button>
+
+      <Modal
+        title={`编辑规格${editing?.specText ? ` · ${editing.specText}` : editing?.skuCode ? ` · ${editing.skuCode}` : ''}`}
+        open={editIndex != null}
+        onCancel={() => setEditIndex(null)}
+        onOk={() => setEditIndex(null)}
+        okText="完成"
+        width={560}
+        destroyOnClose
+      >
+        {editing && editIndex != null ? (
+          <Space direction="vertical" size={14} style={{ width: '100%' }}>
+            <div>
+              <Typography.Text type="secondary">SKU</Typography.Text>
+              <div>{editing.skuCode || '保存后自动生成'}</div>
+            </div>
+            <div>
+              <Typography.Text>69 码 <Typography.Text type="danger">*</Typography.Text></Typography.Text>
+              <Input
+                placeholder="本规格独立 69 码"
+                value={editing.barcode69}
+                onChange={(e) => patchSku(editIndex, { barcode69: e.target.value })}
+              />
+            </div>
+            <div>
+              <Typography.Text>主图</Typography.Text>
+              <OssUpload
+                bizType="COVER"
+                value={editing.imageUrl || ''}
+                onChange={(url) => patchSku(editIndex, { imageUrl: url })}
+              />
+            </div>
+            <Space>
+              <div>
+                <Typography.Text>售价</Typography.Text>
+                <InputNumber
+                  min={0}
+                  style={{ width: 140 }}
+                  value={editing.price}
+                  onChange={(v) => patchSku(editIndex, { price: Number(v) || 0 })}
+                />
+              </div>
+              <div>
+                <Typography.Text>权益</Typography.Text>
+                <InputNumber
+                  min={0}
+                  style={{ width: 140 }}
+                  value={editing.benefitAmount}
+                  onChange={(v) => patchSku(editIndex, { benefitAmount: v == null ? undefined : Number(v) })}
+                />
+              </div>
+            </Space>
+            <div>
+              <Typography.Text>状态</Typography.Text>
+              <Select
+                style={{ width: '100%' }}
+                value={editing.status}
+                options={Object.entries(PRODUCT_STATUS_LABELS).map(([value, label]) => ({ value, label }))}
+                onChange={(status) => patchSku(editIndex, { status })}
+              />
+            </div>
+            <Space>
+              <Select
+                style={{ width: 100 }}
+                value={editing.saleUnit}
+                options={[
+                  { value: 'BOTTLE', label: '瓶' },
+                  { value: 'BOX', label: '箱' },
+                ]}
+                onChange={(saleUnit) =>
+                  patchSku(editIndex, {
+                    saleUnit,
+                    bottlesPerUnit: saleUnit === 'BOX' ? editing.bottlesPerUnit || 6 : 1,
+                  })
+                }
+              />
+              {editing.saleUnit === 'BOX' ? (
+                <InputNumber
+                  min={1}
+                  value={editing.bottlesPerUnit}
+                  onChange={(v) => patchSku(editIndex, { bottlesPerUnit: Number(v) || 6 })}
+                />
+              ) : null}
+            </Space>
+            <Space>
+              <Switch
+                checkedChildren="线上"
+                unCheckedChildren="线上"
+                checked={editing.allowOnlinePurchase}
+                onChange={(checked) =>
+                  patchSku(editIndex, {
+                    allowOnlinePurchase: checked,
+                    allowCrossCityDelivery: checked ? editing.allowCrossCityDelivery : false,
+                  })
+                }
+              />
+              <Switch
+                checkedChildren="跨城"
+                unCheckedChildren="跨城"
+                disabled={!editing.allowOnlinePurchase}
+                checked={editing.allowCrossCityDelivery}
+                onChange={(checked) => patchSku(editIndex, { allowCrossCityDelivery: checked })}
+              />
+              <Switch
+                checkedChildren="现场"
+                unCheckedChildren="现场"
+                checked={editing.allowOnSitePickup}
+                onChange={(checked) => patchSku(editIndex, { allowOnSitePickup: checked })}
+              />
+              <Switch
+                checkedChildren="默认"
+                unCheckedChildren="默认"
+                checked={editing.isDefault}
+                onChange={(checked) => {
+                  if (!checked) return;
+                  setSkus((prev) => prev.map((s, i) => ({ ...s, isDefault: i === editIndex })));
+                }}
+              />
+            </Space>
+          </Space>
+        ) : null}
+      </Modal>
+    </div>
+  );
+}

apps/admin-web/src/components/ProxyOrderModal.tsx

@@ -51,6 +51,7 @@ export default function ProxyOrderModal({ open, onClose, onSuccess }: ProxyOrder
   const [regionCodes, setRegionCodes] = useState<string[]>([]);
   const [addressDetail, setAddressDetail] = useState('');
   const [productId, setProductId] = useState<string>();
+  const [skuId, setSkuId] = useState<string>();
   const [quantity, setQuantity] = useState(2);
   const [promoCodeId, setPromoCodeId] = useState<string>();
   const [deliveryMode, setDeliveryMode] = useState<PartnerProxyDeliveryMode>('ADDRESS');
@@ -87,9 +88,37 @@ export default function ProxyOrderModal({ open, onClose, onSuccess }: ProxyOrder
   }, [open]);
 
   const selectedProduct = options?.products.find((p) => p.id === productId);
-  const allowOnline = selectedProduct ? selectedProduct.allowOnlinePurchase !== false : true;
-  const allowOnSite = !!selectedProduct?.allowOnSitePickup;
-  const allowCrossCity = selectedProduct ? selectedProduct.allowCrossCityDelivery !== false : true;
+  const skuOptions = (selectedProduct?.skus ?? []).filter((s) => s.status === 'ON_SALE');
+  const selectedSku =
+    skuOptions.find((s) => s.id === skuId) ||
+    skuOptions.find((s) => s.id === selectedProduct?.defaultSkuId) ||
+    skuOptions[0];
+  const allowOnline = selectedSku
+    ? selectedSku.allowOnlinePurchase !== false
+    : selectedProduct
+      ? selectedProduct.allowOnlinePurchase !== false
+      : true;
+  const allowOnSite = selectedSku
+    ? !!selectedSku.allowOnSitePickup
+    : !!selectedProduct?.allowOnSitePickup;
+  const allowCrossCity = selectedSku
+    ? selectedSku.allowCrossCityDelivery !== false
+    : selectedProduct
+      ? selectedProduct.allowCrossCityDelivery !== false
+      : true;
+
+  useEffect(() => {
+    if (!open || !selectedProduct) return;
+    const def =
+      skuOptions.find((s) => s.id === selectedProduct.defaultSkuId) ||
+      skuOptions.find((s) => s.isDefault) ||
+      skuOptions[0];
+    if (def && skuId !== def.id && (!skuId || !skuOptions.some((s) => s.id === skuId))) {
+      setSkuId(def.id);
+      setQuantity(def.saleUnit === 'BOX' ? 1 : Math.max(quantity, 2));
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [open, productId, selectedProduct?.id]);
 
   useEffect(() => {
     if (!open || !selectedProduct) return;
@@ -115,6 +144,7 @@ export default function ProxyOrderModal({ open, onClose, onSuccess }: ProxyOrder
           productId,
           quantity,
           deliveryMode,
+          skuId: skuId || undefined,
           receiverCity: deliveryMode === 'ADDRESS' ? region?.city || undefined : undefined,
           receiverDistrict: deliveryMode === 'ADDRESS' ? region?.district || undefined : undefined,
         }),
@@ -124,7 +154,7 @@ export default function ProxyOrderModal({ open, onClose, onSuccess }: ProxyOrder
         .finally(() => setPreviewLoading(false));
     }, 300);
     return () => window.clearTimeout(timer);
-  }, [open, productId, quantity, deliveryMode, region?.city, region?.district, step]);
+  }, [open, productId, skuId, quantity, deliveryMode, region?.city, region?.district, step]);
 
   useEffect(() => () => stopPoll(), []);
 
@@ -135,6 +165,8 @@ export default function ProxyOrderModal({ open, onClose, onSuccess }: ProxyOrder
     setRegionCodes([]);
     setAddressDetail('');
     setQuantity(2);
+    setProductId(undefined);
+    setSkuId(undefined);
     setPromoCodeId(undefined);
     setDeliveryMode('ADDRESS');
     setAutoReceive(false);
@@ -202,6 +234,7 @@ export default function ProxyOrderModal({ open, onClose, onSuccess }: ProxyOrder
       productId: productId!,
       quantity,
       promoCodeId: promoCodeId || undefined,
+      skuId: skuId || undefined,
     };
 
     setSubmitting(true);
@@ -317,7 +350,10 @@ export default function ProxyOrderModal({ open, onClose, onSuccess }: ProxyOrder
                 loading={loadingOptions}
                 placeholder="选择商品"
                 value={productId}
-                onChange={setProductId}
+                onChange={(id) => {
+                  setProductId(id);
+                  setSkuId(undefined);
+                }}
                 options={(options?.products ?? []).map((p) => ({
                   value: p.id,
                   label: `${p.name} · ${p.spec} · ¥${fmtMoney(p.price)}`,
@@ -325,7 +361,25 @@ export default function ProxyOrderModal({ open, onClose, onSuccess }: ProxyOrder
               />
             </Form.Item>
 
-            <Form.Item label="数量" required>
+            {skuOptions.length > 1 || selectedProduct?.specEnabled ? (
+              <Form.Item label="规格" required>
+                <Select
+                  placeholder="选择规格"
+                  value={skuId}
+                  onChange={(id) => {
+                    setSkuId(id);
+                    const sku = skuOptions.find((s) => s.id === id);
+                    if (sku?.saleUnit === 'BOX') setQuantity(1);
+                  }}
+                  options={skuOptions.map((s) => ({
+                    value: s.id,
+                    label: `${s.specText || '默认'} · ¥${fmtMoney(s.price)} · ${s.saleUnit === 'BOX' ? `${s.bottlesPerUnit}瓶/箱` : '瓶'}`,
+                  }))}
+                />
+              </Form.Item>
+            ) : null}
+
+            <Form.Item label={selectedSku?.saleUnit === 'BOX' ? '数量（箱）' : '数量（瓶）'} required>
               <InputNumber
                 min={1}
                 value={quantity}

apps/admin-web/src/components/RedeemRecordDetailDescriptions.tsx

@@ -23,6 +23,11 @@ export default function RedeemRecordDetailDescriptions({ detail, maskUserPhone =
         cityName?: string;
         address?: string;
         partnerAccount?: { companyName?: string };
+        primaryAccount?: {
+          bankAccountName?: string | null;
+          bankAccountNo?: string | null;
+          bankBranch?: string | null;
+        } | null;
       }
     | undefined;
   const coupon = detail.coupon as { couponNo?: string; order?: { orderNo?: string } } | undefined;
@@ -46,6 +51,15 @@ export default function RedeemRecordDetailDescriptions({ detail, maskUserPhone =
       </Descriptions.Item>
       <Descriptions.Item label="门店地址">{store?.address ?? '—'}</Descriptions.Item>
       <Descriptions.Item label="合伙人">{store?.partnerAccount?.companyName ?? '—'}</Descriptions.Item>
+      <Descriptions.Item label="收款户名">
+        {store?.primaryAccount?.bankAccountName || '—'}
+      </Descriptions.Item>
+      <Descriptions.Item label="收款账号">
+        {store?.primaryAccount?.bankAccountNo || '—'}
+      </Descriptions.Item>
+      <Descriptions.Item label="开户行">
+        {store?.primaryAccount?.bankBranch || '—'}
+      </Descriptions.Item>
       <Descriptions.Item label="权益券号">{coupon?.couponNo ?? '—'}</Descriptions.Item>
       <Descriptions.Item label="关联订单">{coupon?.order?.orderNo ?? '—'}</Descriptions.Item>
       {Array.isArray(detail.allocations) && (detail.allocations as unknown[]).length > 0 ? (

apps/admin-web/src/components/StorePackageAuditPanel.tsx

@@ -174,11 +174,13 @@ function PackageDetailCard({
   pkg,
   change,
   changes,
+  imageSize = 72,
 }: {
   title?: string;
   pkg: StorePackageItemDto | StorePackageViewDto;
   change?: keyof typeof CHANGE_LABELS;
   changes?: FieldChange[];
+  imageSize?: number;
 }) {
   const images = normalizeStorePackageImageUrls(pkg);
   const meta = change ? CHANGE_LABELS[change] : null;
@@ -217,7 +219,7 @@ function PackageDetailCard({
         <Image.PreviewGroup>
           <Space wrap size={8}>
             {images.map((url) => (
-              <Image key={url} src={url} width={72} height={72} style={{ objectFit: 'cover', borderRadius: 4 }} />
+              <Image key={url} src={url} width={imageSize} height={imageSize} style={{ objectFit: 'cover', borderRadius: 4 }} />
             ))}
           </Space>
         </Image.PreviewGroup>
@@ -265,6 +267,7 @@ export type StorePackageAuditPanelProps = {
   requestId: string;
   /** 是否在面板顶部显示通过/驳回（抽屉 extra 另有按钮时可关） */
   showActions?: boolean;
+  fullscreen?: boolean;
   onAudited?: () => void;
   onDetailLoaded?: (detail: StorePackageAuditDetailDto | null) => void;
 };
@@ -273,6 +276,7 @@ export type StorePackageAuditPanelProps = {
 export default function StorePackageAuditPanel({
   requestId,
   showActions = true,
+  fullscreen = false,
   onAudited,
   onDetailLoaded,
 }: StorePackageAuditPanelProps) {
@@ -389,6 +393,7 @@ export default function StorePackageAuditPanel({
                 title={`套餐 ${index + 1}`}
                 pkg={pkg}
                 change={changeByKey.get(packageKey(pkg, index))}
+                imageSize={fullscreen ? 160 : 72}
               />
             ))
           ) : (
@@ -407,6 +412,7 @@ export default function StorePackageAuditPanel({
                 pkg={pkg}
                 change={changeByKey.get(packageKey(pkg, index))}
                 changes={changesByKey.get(packageKey(pkg, index))}
+                imageSize={fullscreen ? 160 : 72}
               />
             ))
           ) : (

apps/admin-web/src/layouts/AdminLayout.tsx

@@ -20,10 +20,11 @@ import {
   AccountBookOutlined,
   ProjectOutlined,
 } from '@ant-design/icons';
-import { hasAnySystemSettingsPermission } from '@dukang/shared-types';
+import { hasAnySystemSettingsPermission, hasAnyStoreMenuPermission } from '@dukang/shared-types';
 import { clearAuth, request, type HqProfile } from '../lib/api';
 import { bindAdminEllipsisTitle } from '../lib/ellipsis-title';
 import { AUDIT_NOTICE_CHANGED_EVENT, PACKAGE_AUDIT_CHANGED_EVENT } from '../lib/admin-events';
+import { ListColumnPrefsProvider } from '../lib/ListColumnPrefsContext';
 
 const { Header, Sider, Content } = Layout;
 
@@ -156,6 +157,9 @@ function menuAllowed(key: string, permissionKeys: string[]): boolean {
   if (key === 'tickets-group') {
     return permissionKeys.includes('tickets') || permissionKeys.includes('tech_support');
   }
+  if (key === 'stores-group') {
+    return hasAnyStoreMenuPermission(permissionKeys);
+  }
   if (key === 'dev-plan-group') {
     return permissionKeys.includes('dev_plan');
   }
@@ -175,11 +179,11 @@ function menuAllowed(key: string, permissionKeys: string[]): boolean {
     '/knowledge-bases': 'knowledge_bases',
     'stores-group': 'stores',
     '/stores': 'stores',
-    '/store-package-audits': 'stores',
-    '/store-ratings': 'stores',
-    '/store-categories': 'stores',
-    '/store-accounts': 'stores',
-    '/store-media': 'stores',
+    '/store-package-audits': 'store_audits',
+    '/store-ratings': 'store_ratings',
+    '/store-categories': 'store_categories',
+    '/store-accounts': 'store_accounts',
+    '/store-media': 'store_media',
     'partners-group': 'partners',
     '/cities': 'partners',
     '/city-partners': 'partners',
@@ -196,10 +200,10 @@ function menuAllowed(key: string, permissionKeys: string[]): boolean {
     '/benefit/ledgers': 'benefit',
     '/redeem-records': 'benefit',
     '/redeem-pending': 'benefit',
-    '/redeem/debug': 'benefit',
+    '/redeem/debug': 'benefit_debug',
     'deliveries-group': 'deliveries',
     '/deliveries': 'deliveries',
-    '/deliveries/xiaofeixia': 'deliveries',
+    '/deliveries/xiaofeixia': 'deliveries_debug',
     '/tickets': 'tickets',
     '/tickets/support': 'tech_support',
     'dev-plan-group': 'dev_plan',
@@ -413,7 +417,9 @@ export default function AdminLayout() {
           style={{ flex: 1, minHeight: 0, overflow: 'auto' }}
         >
           <Content style={{ margin: 24 }}>
-            <Outlet />
+            <ListColumnPrefsProvider initial={profile?.listColumnPrefs}>
+              <Outlet />
+            </ListColumnPrefsProvider>
           </Content>
         </div>
       </Layout>

apps/admin-web/src/lib/ListColumnPrefsContext.tsx

@@ -0,0 +1,50 @@
+import { createContext, useCallback, useContext, useEffect, useMemo, useState, type ReactNode } from 'react';
+import type { HqListColumnKey, HqListColumnPref, HqListColumnPrefsMap } from '@dukang/shared-types';
+import { request } from './api';
+
+type Ctx = {
+  prefs: HqListColumnPrefsMap;
+  ready: boolean;
+  setPrefs: (next: HqListColumnPrefsMap) => void;
+  save: (listKey: HqListColumnKey, next: HqListColumnPref | null) => Promise<void>;
+};
+
+const ListColumnPrefsContext = createContext<Ctx>({
+  prefs: {},
+  ready: false,
+  setPrefs: () => {},
+  save: async () => {},
+});
+
+export function ListColumnPrefsProvider({
+  initial,
+  children,
+}: {
+  initial?: HqListColumnPrefsMap;
+  children: ReactNode;
+}) {
+  const [prefs, setPrefs] = useState<HqListColumnPrefsMap>(initial ?? {});
+  const [ready] = useState(true);
+
+  useEffect(() => {
+    if (initial) setPrefs(initial);
+  }, [initial]);
+
+  const save = useCallback(async (listKey: HqListColumnKey, next: HqListColumnPref | null) => {
+    const res = await request<{ listColumnPrefs: HqListColumnPrefsMap }>(
+      `/admin/me/list-columns/${listKey}`,
+      {
+        method: 'PUT',
+        body: JSON.stringify(next ? { order: next.order, hidden: next.hidden } : { reset: true }),
+      },
+    );
+    setPrefs(res.listColumnPrefs ?? {});
+  }, []);
+
+  const value = useMemo(() => ({ prefs, ready, setPrefs, save }), [prefs, ready, save]);
+  return <ListColumnPrefsContext.Provider value={value}>{children}</ListColumnPrefsContext.Provider>;
+}
+
+export function useListColumnPrefs() {
+  return useContext(ListColumnPrefsContext);
+}

apps/admin-web/src/lib/api.ts

@@ -1,3 +1,5 @@
+import type { HqListColumnPrefsMap } from '@dukang/shared-types';
+
 export const apiBase = '/api/v1';
 export const CLIENT_APP = 'HQ_WEB';
 
@@ -8,6 +10,9 @@ export type HqProfile = {
   adminRole: string;
   status: string;
   permissionKeys?: string[];
+  cityIds?: string[];
+  cityScoped?: boolean;
+  listColumnPrefs?: HqListColumnPrefsMap;
 };
 
 export function getToken() {
@@ -87,6 +92,9 @@ export type DashboardStats = {
   openTickets?: number;
   pendingStoreWithdrawals?: number;
   overdueStoreWithdrawals?: number;
+  pendingStoreOnboard?: number;
+  pendingStorePackageAudits?: number;
+  pendingStoreInfoChanges?: number;
   ordersByStatus: Array<{ status: string; count: number }>;
 };
 
@@ -161,6 +169,7 @@ export type AdminUserRow = {
   wxOpenId: string | null;
   wechatVerified: boolean;
   nickname: string | null;
+  hqRemark: string | null;
   status: number;
   sourceType: string;
   sourceRefId: string | null;
@@ -195,6 +204,18 @@ export type AdminOrderRow = {
   quantity?: number;
   receiverName: string;
   receiverPhone: string;
+  receiverProvince?: string;
+  receiverCity?: string;
+  receiverDistrict?: string;
+  receiverAddress?: string;
+  benefitAmount?: number;
+  benefitCoupon?: {
+    couponNo?: string;
+    totalAmount?: number;
+    usedAmount?: number;
+    balance?: number;
+    status?: string;
+  } | null;
   createdAt: string;
   cityId?: string;
   city?: { id: string; name: string; code: string };

apps/admin-web/src/lib/exportExcel.ts

@@ -8,3 +8,19 @@ export function downloadExcelCsv(csv: string, filename: string) {
   a.click();
   URL.revokeObjectURL(url);
 }
+
+/** Download binary file from base64 payload returned by HQ export APIs. */
+export function downloadBase64File(contentBase64: string, filename: string, mimeType: string) {
+  const binary = atob(contentBase64);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i += 1) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  const blob = new Blob([bytes], { type: mimeType });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement('a');
+  a.href = url;
+  a.download = filename;
+  a.click();
+  URL.revokeObjectURL(url);
+}

apps/admin-web/src/lib/list-column-prefs.ts

@@ -0,0 +1,84 @@
+import type { ColumnType } from 'antd/es/table';
+import type { HqListColumnKey, HqListColumnPref } from '@dukang/shared-types';
+
+export const SERIAL_COLUMN_KEY = '__serial';
+export const ACTIONS_COLUMN_KEY = '__actions';
+
+export function columnKey<T>(col: ColumnType<T>, index: number): string {
+  if (col.key != null && String(col.key).length) return String(col.key);
+  const dataIndex = col.dataIndex;
+  if (typeof dataIndex === 'string' && dataIndex) return dataIndex;
+  if (Array.isArray(dataIndex) && dataIndex.length) return dataIndex.map(String).join('.');
+  if (typeof col.title === 'string' && col.title) return col.title;
+  return `col-${index}`;
+}
+
+export function isActionsColumn<T>(col: ColumnType<T>, key: string): boolean {
+  if (key === ACTIONS_COLUMN_KEY || key === 'actions' || key === 'action') return true;
+  return col.title === '操作';
+}
+
+export function mergeColumnOrder(defaultKeys: string[], pref?: HqListColumnPref): string[] {
+  const known = new Set(defaultKeys);
+  const ordered = (pref?.order ?? []).filter((k) => known.has(k));
+  for (const key of defaultKeys) {
+    if (ordered.includes(key)) continue;
+    const defaultIdx = defaultKeys.indexOf(key);
+    let insertAt = ordered.length;
+    for (let i = 0; i < ordered.length; i += 1) {
+      if (defaultKeys.indexOf(ordered[i]) > defaultIdx) {
+        insertAt = i;
+        break;
+      }
+    }
+    ordered.splice(insertAt, 0, key);
+  }
+  return ordered;
+}
+
+export function visibleColumnKeys(defaultKeys: string[], pref?: HqListColumnPref): string[] {
+  const hidden = new Set(pref?.hidden ?? []);
+  return mergeColumnOrder(defaultKeys, pref).filter((k) => !hidden.has(k));
+}
+
+export function applyColumnPrefs<T>(
+  columns: ColumnType<T>[],
+  pref: HqListColumnPref | undefined,
+): ColumnType<T>[] {
+  const keyed = columns.map((col, i) => {
+    const key = columnKey(col, i);
+    return { col: { ...col, key }, key, actions: isActionsColumn(col, key) };
+  });
+  const configurable = keyed.filter((c) => !c.actions);
+  const actions = keyed.filter((c) => c.actions);
+  const defaultKeys = configurable.map((c) => c.key);
+  const visible = new Set(visibleColumnKeys(defaultKeys, pref));
+  const orderedKeys = mergeColumnOrder(defaultKeys, pref).filter((k) => visible.has(k));
+  const byKey = new Map(configurable.map((c) => [c.key, c.col]));
+  return [...orderedKeys.map((k) => byKey.get(k)!).filter(Boolean), ...actions.map((c) => c.col)];
+}
+
+export type ListColumnSettingItem = {
+  key: string;
+  title: string;
+  visible: boolean;
+};
+
+export function settingItems<T>(
+  columns: ColumnType<T>[],
+  pref?: HqListColumnPref,
+): ListColumnSettingItem[] {
+  const keyed = columns
+    .map((col, i) => ({ col, key: columnKey(col, i) }))
+    .filter(({ col, key }) => !isActionsColumn(col, key));
+  const hidden = new Set(pref?.hidden ?? []);
+  const order = mergeColumnOrder(keyed.map((c) => c.key), pref);
+  const byKey = new Map(keyed.map((c) => [c.key, c.col]));
+  return order.map((key) => {
+    const col = byKey.get(key);
+    const title = typeof col?.title === 'string' ? col.title : key;
+    return { key, title, visible: !hidden.has(key) };
+  });
+}
+
+export type { HqListColumnKey };

apps/admin-web/src/lib/useAdminListColumns.tsx

@@ -0,0 +1,103 @@
+import { useMemo, useState } from 'react';
+import { Button, message } from 'antd';
+import { SettingOutlined } from '@ant-design/icons';
+import type { ColumnsType, ColumnType } from 'antd/es/table';
+import type { HqListColumnKey } from '@dukang/shared-types';
+import { AdminListColumnsModal } from '../components/AdminListColumnsModal';
+import { useListColumnPrefs } from './ListColumnPrefsContext';
+import {
+  ACTIONS_COLUMN_KEY,
+  SERIAL_COLUMN_KEY,
+  applyColumnPrefs,
+  settingItems,
+  type ListColumnSettingItem,
+} from './list-column-prefs';
+
+type Options = {
+  page?: number;
+  pageSize?: number;
+};
+
+export function useAdminListColumns<T>(
+  listKey: HqListColumnKey,
+  allColumns: ColumnsType<T>,
+  options: Options = {},
+) {
+  const { page = 1, pageSize = 20 } = options;
+  const { prefs, save } = useListColumnPrefs();
+  const [open, setOpen] = useState(false);
+  const [saving, setSaving] = useState(false);
+  const pref = prefs[listKey];
+
+  const configured = useMemo(
+    () => applyColumnPrefs(allColumns as ColumnType<T>[], pref),
+    [allColumns, pref],
+  );
+
+  const items = useMemo(
+    () => settingItems(allColumns as ColumnType<T>[], pref),
+    [allColumns, pref],
+  );
+
+  const serialCol: ColumnType<T> = useMemo(
+    () => ({
+      key: SERIAL_COLUMN_KEY,
+      title: '序号',
+      width: 64,
+      fixed: 'left' as const,
+      render: (_: unknown, __: T, index: number) => (page - 1) * pageSize + index + 1,
+    }),
+    [page, pageSize],
+  );
+
+  const columns = useMemo<ColumnsType<T>>(
+    () => [
+      serialCol,
+      ...configured.map((col) =>
+        col.title === '操作' || col.key === ACTIONS_COLUMN_KEY || col.key === 'actions'
+          ? { ...col, key: col.key ?? ACTIONS_COLUMN_KEY }
+          : col,
+      ),
+    ],
+    [configured, serialCol],
+  );
+
+  async function persist(next: ListColumnSettingItem[] | null) {
+    setSaving(true);
+    try {
+      if (!next) {
+        await save(listKey, null);
+      } else {
+        await save(listKey, {
+          order: next.map((i) => i.key),
+          hidden: next.filter((i) => !i.visible).map((i) => i.key),
+        });
+      }
+      setOpen(false);
+      message.success(next ? '列设置已保存' : '已恢复默认列');
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '保存失败');
+    } finally {
+      setSaving(false);
+    }
+  }
+
+  const settingsButton = (
+    <Button icon={<SettingOutlined />} onClick={() => setOpen(true)}>
+      列设置
+    </Button>
+  );
+
+  const settingsModal = (
+    <AdminListColumnsModal
+      open={open}
+      items={items}
+      saving={saving}
+      onCancel={() => setOpen(false)}
+      onReset={() => void persist(null)}
+      onSave={(draft) => void persist(draft)}
+    />
+  );
+
+  return { columns, settingsButton, settingsModal };
+}

apps/admin-web/src/pages/BenefitCouponsPage.tsx

@@ -20,6 +20,8 @@ import { request } from '../lib/api';
 import { COUPON_STATUS_LABELS, fmtTime } from '../lib/constants';
 import RedeemRecordDetailDescriptions from '../components/RedeemRecordDetailDescriptions';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -99,7 +101,7 @@ export default function BenefitCouponsPage() {
     }
   }
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: '券号', dataIndex: 'couponNo', width: 200, ellipsis: false },
     { title: '用户', dataIndex: ['user', 'userNo'], width: 120, ellipsis: false },
     { title: '手机号', dataIndex: ['user', 'phone'], width: 120, render: (v) => v || '—' },
@@ -113,7 +115,7 @@ export default function BenefitCouponsPage() {
     { title: '总额', dataIndex: 'totalAmount', width: 80, render: (v) => `¥${v}` },
     { title: '余额', dataIndex: 'balance', width: 80, render: (v) => `¥${v}` },
     { title: '状态', dataIndex: 'status', width: 90, render: (s) => <Tag>{COUPON_STATUS_LABELS[s] || s}</Tag> },
-    { title: '来源', dataIndex: 'sourceProduct', ellipsis: true },
+    { title: '来源', dataIndex: 'sourceProduct' },
     { title: '创建', dataIndex: 'createdAt', width: 160, render: fmtTime },
     {
       title: '操作',
@@ -155,15 +157,21 @@ export default function BenefitCouponsPage() {
     }
   }
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('benefit-coupons', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 16 }}>
         <Typography.Title level={4} style={{ margin: 0 }}>
           好客权益券
         </Typography.Title>
-        <Button type="primary" onClick={() => setGrantOpen(true)}>
-          手动发放
-        </Button>
+        <Space>
+          {settingsButton}
+          <Button type="primary" onClick={() => setGrantOpen(true)}>
+            手动发放
+          </Button>
+        </Space>
       </div>
 
       <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={(v) => { setFilters(v); setPage(1); }}>
@@ -190,7 +198,7 @@ export default function BenefitCouponsPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1200 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,
@@ -316,7 +324,7 @@ export default function BenefitCouponsPage() {
                   locale={{ emptyText: '暂无关联核销单' }}
                   dataSource={detail.redeemRecords ?? []}
                   columns={[
-                    { title: '核销号', dataIndex: 'redeemNo', ellipsis: true },
+                    { title: '核销号', dataIndex: 'redeemNo' },
                     {
                       title: '角色',
                       dataIndex: 'role',
@@ -327,7 +335,7 @@ export default function BenefitCouponsPage() {
                     {
                       title: '门店',
                       dataIndex: ['store', 'name'],
-                      ellipsis: true,
+
                       render: (v: string | undefined, row: CouponRedeemRecord) =>
                         v ? `${v}${row.store?.cityName ? `（${row.store.cityName}）` : ''}` : '—',
                     },

apps/admin-web/src/pages/BenefitLedgersPage.tsx

@@ -3,6 +3,8 @@ import { Form, Input, Select, Button, Table, Tag, Typography } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
 import { LEDGER_TYPE_LABELS, fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string; type: string; amount: number; balanceAfter: number; remark: string | null; createdAt: string;
@@ -24,19 +26,23 @@ export default function BenefitLedgersPage() {
     [filters],
   );
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: '类型', dataIndex: 'type', width: 90, render: (t) => <Tag>{LEDGER_TYPE_LABELS[t] || t}</Tag> },
     { title: '用户', dataIndex: ['user', 'userNo'], width: 120, ellipsis: false },
     { title: '券号', dataIndex: ['coupon', 'couponNo'], width: 200, ellipsis: false },
     { title: '变动', dataIndex: 'amount', width: 90, render: (v) => `${v >= 0 ? '+' : ''}${v}` },
     { title: '余额后', dataIndex: 'balanceAfter', width: 90 },
-    { title: '备注', dataIndex: 'remark', ellipsis: true },
+    { title: '备注', dataIndex: 'remark' },
     { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('benefit-ledgers', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Typography.Title level={4}>权益流水</Typography.Title>
+          {settingsButton}
       <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={(v) => { setFilters(v); setPage(1); }}>
         <Form.Item name="userId" label="用户ID"><Input allowClear /></Form.Item>
         <Form.Item name="couponId" label="券ID"><Input allowClear /></Form.Item>
@@ -45,7 +51,7 @@ export default function BenefitLedgersPage() {
         </Form.Item>
         <Form.Item><Button type="primary" htmlType="submit">查询</Button></Form.Item>
       </Form>
-      <Table rowKey="id" className="admin-table-nowrap" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 1000 }}
+      <Table rowKey="id" className="admin-table-nowrap" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 'max-content' }}
         pagination={{ current: page, pageSize, total: data?.total ?? 0, showSizeChanger: true, onChange: (p, ps) => { setPage(p); setPageSize(ps); } }} />
     </div>
   );

apps/admin-web/src/pages/CityWarehousesPage.tsx

@@ -30,6 +30,8 @@ import {
 import { request, type Paginated } from '../lib/api';
 import { ADMIN_OPTIONS_PAGE_SIZE, fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -70,6 +72,7 @@ function FulfillmentFields({
   onModeChange: (mode: WarehouseFulfillmentMode) => void;
 }) {
   const autoShip = mode === WarehouseFulfillmentMode.API_AUTO;
+
   return (
     <>
       <Form.Item
@@ -219,7 +222,7 @@ export default function CityWarehousesPage() {
     }
   }
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     {
       title: '城市',
       width: 100,
@@ -229,8 +232,8 @@ export default function CityWarehousesPage() {
         </span>
       ),
     },
-    { title: '仓库', dataIndex: 'name', width: 140, ellipsis: true },
-    { title: '地址', dataIndex: 'address', width: 180, ellipsis: true },
+    { title: '仓库', dataIndex: 'name', width: 140 },
+    { title: '地址', dataIndex: 'address', width: 180 },
     { title: '联系人', dataIndex: 'contactName', width: 90 },
     { title: '电话', dataIndex: 'contactPhone', width: 120 },
     {
@@ -242,7 +245,6 @@ export default function CityWarehousesPage() {
       title: '合伙人',
       dataIndex: 'partnerCompanyName',
       width: 120,
-      ellipsis: true,
       render: (v, row) =>
         v && row.partnerAccountId ? (
           <Link to="/city-partners">{v}</Link>
@@ -298,10 +300,17 @@ export default function CityWarehousesPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('city-warehouses', baseColumns, {
+    page,
+    pageSize,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
         <Typography.Title level={4} style={{ margin: 0 }}>仓库</Typography.Title>
+          {settingsButton}
         <Button
           type="primary"
           onClick={() => {
@@ -367,7 +376,7 @@ export default function CityWarehousesPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1400 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,

apps/admin-web/src/pages/DashboardPage.tsx

@@ -64,6 +64,20 @@ export default function DashboardPage() {
   const [profile, setProfile] = useState<HqProfile | null>(null);
   const [deploying, setDeploying] = useState(false);
   const isSuperAdmin = profile?.adminRole === 'SUPER_ADMIN';
+  const keys = profile?.permissionKeys ?? [];
+  const has = (k: string) => keys.includes(k);
+  const cityScoped = !!profile?.cityScoped;
+  const canUsers = has('users');
+  const canOrders = has('orders');
+  const canStores = has('stores');
+  const canStoreAudits = has('store_audits');
+  const canPartners = has('partners');
+  const canPromo = has('promo_codes');
+  const canFinance = has('finance');
+  const canBenefit = has('benefit');
+  const canDeliveries = has('deliveries');
+  const canTickets = has('tickets');
+  const permsReady = profile !== null;
 
   const [filterForm] = Form.useForm<{
     range: [Dayjs, Dayjs];
@@ -115,18 +129,26 @@ export default function DashboardPage() {
       .catch(() => {
         setVersionLoading(false);
       });
+  }, [loadVersion]);
+
+  useEffect(() => {
+    if (!profile) return;
     void request<Paginated<CityOption>>(`/admin/cities?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`)
       .then((res) => setCities(res.items ?? []))
       .catch(() => setCities([]));
-    void request<Paginated<PromoOption>>(`/admin/promo-codes?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`)
-      .then((res) => setPromos(res.items ?? []))
-      .catch(() => setPromos([]));
-    void request<Paginated<{ id: string; companyName?: string | null; name: string }>>(
-      `/admin/partners?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`,
-    )
-      .then((res) => setPartners(res.items ?? []))
-      .catch(() => setPartners([]));
-  }, [loadVersion]);
+    if ((profile.permissionKeys ?? []).includes('promo_codes')) {
+      void request<Paginated<PromoOption>>(`/admin/promo-codes?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`)
+        .then((res) => setPromos(res.items ?? []))
+        .catch(() => setPromos([]));
+    }
+    if ((profile.permissionKeys ?? []).includes('partners')) {
+      void request<Paginated<{ id: string; companyName?: string | null; name: string }>>(
+        `/admin/partners?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`,
+      )
+        .then((res) => setPartners(res.items ?? []))
+        .catch(() => setPartners([]));
+    }
+  }, [profile]);
 
   useEffect(() => {
     void loadAnalytics(filters);
@@ -206,9 +228,19 @@ export default function DashboardPage() {
 
   const byDateOption = useMemo<EChartsOption>(() => {
     const rows = analytics?.byDate ?? [];
+    const legend: string[] = [];
+    const series: EChartsOption['series'] = [];
+    if (canUsers) {
+      legend.push('新增用户');
+      series.push({ name: '新增用户', type: 'line', smooth: true, data: rows.map((r) => r.users) });
+    }
+    if (canOrders) {
+      legend.push('订单数');
+      series.push({ name: '订单数', type: 'line', smooth: true, data: rows.map((r) => r.orders) });
+    }
     return {
       tooltip: { trigger: 'axis' },
-      legend: { data: ['新增用户', '订单数'] },
+      legend: { data: legend },
       grid: { left: 40, right: 20, top: 40, bottom: 40 },
       xAxis: {
         type: 'category',
@@ -216,18 +248,25 @@ export default function DashboardPage() {
         axisLabel: { rotate: rows.length > 14 ? 45 : 0 },
       },
       yAxis: { type: 'value', minInterval: 1 },
-      series: [
-        { name: '新增用户', type: 'line', smooth: true, data: rows.map((r) => r.users) },
-        { name: '订单数', type: 'line', smooth: true, data: rows.map((r) => r.orders) },
-      ],
+      series,
     };
-  }, [analytics]);
+  }, [analytics, canUsers, canOrders]);
 
   const byCityOption = useMemo<EChartsOption>(() => {
     const rows = analytics?.byCity ?? [];
+    const legend: string[] = [];
+    const series: EChartsOption['series'] = [];
+    if (canUsers) {
+      legend.push('用户');
+      series.push({ name: '用户', type: 'bar', data: rows.map((r) => r.users), barMaxWidth: 36 });
+    }
+    if (canOrders) {
+      legend.push('订单');
+      series.push({ name: '订单', type: 'bar', data: rows.map((r) => r.orders), barMaxWidth: 36 });
+    }
     return {
       tooltip: { trigger: 'axis' },
-      legend: { data: ['用户', '订单'] },
+      legend: { data: legend },
       grid: { left: 48, right: 20, top: 40, bottom: 48 },
       xAxis: {
         type: 'category',
@@ -235,18 +274,25 @@ export default function DashboardPage() {
         axisLabel: { interval: 0, rotate: rows.length > 4 ? 30 : 0 },
       },
       yAxis: { type: 'value', minInterval: 1 },
-      series: [
-        { name: '用户', type: 'bar', data: rows.map((r) => r.users), barMaxWidth: 36 },
-        { name: '订单', type: 'bar', data: rows.map((r) => r.orders), barMaxWidth: 36 },
-      ],
+      series,
     };
-  }, [analytics]);
+  }, [analytics, canUsers, canOrders]);
 
   const byPromoOption = useMemo<EChartsOption>(() => {
     const rows = analytics?.byPromo ?? [];
+    const legend: string[] = [];
+    const series: EChartsOption['series'] = [];
+    if (canUsers) {
+      legend.push('用户');
+      series.push({ name: '用户', type: 'bar', data: rows.map((r) => r.users), barMaxWidth: 36 });
+    }
+    if (canOrders) {
+      legend.push('订单');
+      series.push({ name: '订单', type: 'bar', data: rows.map((r) => r.orders), barMaxWidth: 36 });
+    }
     return {
       tooltip: { trigger: 'axis' },
-      legend: { data: ['用户', '订单'] },
+      legend: { data: legend },
       grid: { left: 48, right: 20, top: 40, bottom: 64 },
       xAxis: {
         type: 'category',
@@ -254,18 +300,36 @@ export default function DashboardPage() {
         axisLabel: { interval: 0, rotate: rows.length > 3 ? 30 : 0 },
       },
       yAxis: { type: 'value', minInterval: 1 },
-      series: [
-        { name: '用户', type: 'bar', data: rows.map((r) => r.users), barMaxWidth: 36 },
-        { name: '订单', type: 'bar', data: rows.map((r) => r.orders), barMaxWidth: 36 },
-      ],
+      series,
     };
-  }, [analytics]);
+  }, [analytics, canUsers, canOrders]);
 
   const opsByDateOption = useMemo<EChartsOption>(() => {
     const rows = analytics?.byDate ?? [];
+    const legend: string[] = [];
+    const series: NonNullable<EChartsOption['series']> = [];
+    if (canPartners) {
+      legend.push('新增合伙人');
+      series.push({ name: '新增合伙人', type: 'line', smooth: true, data: rows.map((r) => r.partners) });
+    }
+    if (canStores) {
+      legend.push('新签门店');
+      series.push({ name: '新签门店', type: 'line', smooth: true, data: rows.map((r) => r.stores) });
+    }
+    if (canBenefit) {
+      legend.push('核销笔数', '核销金额');
+      series.push({ name: '核销笔数', type: 'line', smooth: true, data: rows.map((r) => r.redeems) });
+      series.push({
+        name: '核销金额',
+        type: 'line',
+        smooth: true,
+        yAxisIndex: 1,
+        data: rows.map((r) => r.redeemAmount),
+      });
+    }
     return {
       tooltip: { trigger: 'axis' },
-      legend: { data: ['新增合伙人', '新签门店', '核销笔数', '核销金额'] },
+      legend: { data: legend },
       grid: { left: 48, right: 48, top: 48, bottom: 40 },
       xAxis: {
         type: 'category',
@@ -276,26 +340,29 @@ export default function DashboardPage() {
         { type: 'value', name: '数量', minInterval: 1 },
         { type: 'value', name: '金额', minInterval: 1 },
       ],
-      series: [
-        { name: '新增合伙人', type: 'line', smooth: true, data: rows.map((r) => r.partners) },
-        { name: '新签门店', type: 'line', smooth: true, data: rows.map((r) => r.stores) },
-        { name: '核销笔数', type: 'line', smooth: true, data: rows.map((r) => r.redeems) },
-        {
-          name: '核销金额',
-          type: 'line',
-          smooth: true,
-          yAxisIndex: 1,
-          data: rows.map((r) => r.redeemAmount),
-        },
-      ],
+      series,
     };
-  }, [analytics]);
+  }, [analytics, canPartners, canStores, canBenefit]);
 
   const opsByCityOption = useMemo<EChartsOption>(() => {
     const rows = analytics?.byCity ?? [];
+    const legend: string[] = [];
+    const series: EChartsOption['series'] = [];
+    if (canPartners) {
+      legend.push('合伙人');
+      series.push({ name: '合伙人', type: 'bar', data: rows.map((r) => r.partners), barMaxWidth: 28 });
+    }
+    if (canStores) {
+      legend.push('门店');
+      series.push({ name: '门店', type: 'bar', data: rows.map((r) => r.stores), barMaxWidth: 28 });
+    }
+    if (canBenefit) {
+      legend.push('核销笔数');
+      series.push({ name: '核销笔数', type: 'bar', data: rows.map((r) => r.redeems), barMaxWidth: 28 });
+    }
     return {
       tooltip: { trigger: 'axis' },
-      legend: { data: ['合伙人', '门店', '核销笔数'] },
+      legend: { data: legend },
       grid: { left: 48, right: 20, top: 40, bottom: 48 },
       xAxis: {
         type: 'category',
@@ -303,19 +370,31 @@ export default function DashboardPage() {
         axisLabel: { interval: 0, rotate: rows.length > 4 ? 30 : 0 },
       },
       yAxis: { type: 'value', minInterval: 1 },
-      series: [
-        { name: '合伙人', type: 'bar', data: rows.map((r) => r.partners), barMaxWidth: 28 },
-        { name: '门店', type: 'bar', data: rows.map((r) => r.stores), barMaxWidth: 28 },
-        { name: '核销笔数', type: 'bar', data: rows.map((r) => r.redeems), barMaxWidth: 28 },
-      ],
+      series,
     };
-  }, [analytics]);
+  }, [analytics, canPartners, canStores, canBenefit]);
 
   const opsByPartnerOption = useMemo<EChartsOption>(() => {
     const rows = analytics?.byPartner ?? [];
+    const legend: string[] = [];
+    const series: NonNullable<EChartsOption['series']> = [];
+    if (canStores) {
+      legend.push('门店');
+      series.push({ name: '门店', type: 'bar', data: rows.map((r) => r.stores), barMaxWidth: 28 });
+    }
+    if (canBenefit) {
+      legend.push('核销笔数', '核销金额');
+      series.push({ name: '核销笔数', type: 'bar', data: rows.map((r) => r.redeems), barMaxWidth: 28 });
+      series.push({
+        name: '核销金额',
+        type: 'line',
+        yAxisIndex: 1,
+        data: rows.map((r) => r.redeemAmount),
+      });
+    }
     return {
       tooltip: { trigger: 'axis' },
-      legend: { data: ['门店', '核销笔数', '核销金额'] },
+      legend: { data: legend },
       grid: { left: 48, right: 48, top: 40, bottom: 64 },
       xAxis: {
         type: 'category',
@@ -326,18 +405,9 @@ export default function DashboardPage() {
         { type: 'value', name: '数量', minInterval: 1 },
         { type: 'value', name: '金额' },
       ],
-      series: [
-        { name: '门店', type: 'bar', data: rows.map((r) => r.stores), barMaxWidth: 28 },
-        { name: '核销笔数', type: 'bar', data: rows.map((r) => r.redeems), barMaxWidth: 28 },
-        {
-          name: '核销金额',
-          type: 'line',
-          yAxisIndex: 1,
-          data: rows.map((r) => r.redeemAmount),
-        },
-      ],
+      series,
     };
-  }, [analytics]);
+  }, [analytics, canStores, canBenefit]);
 
   const redeemByCityOption = useMemo<EChartsOption>(() => {
     const rows = analytics?.byCity ?? [];
@@ -368,7 +438,9 @@ export default function DashboardPage() {
 
   return (
     <div>
-      <Typography.Title level={4}>数据概览</Typography.Title>
+      <Typography.Title level={4}>
+        {cityScoped ? '数据概览（负责城市）' : '数据概览'}
+      </Typography.Title>
 
       {isSuperAdmin ? (
       <Card
@@ -411,46 +483,94 @@ export default function DashboardPage() {
       ) : null}
 
       <Row gutter={[16, 16]} style={{ marginBottom: 24 }}>
-        <Col xs={24} sm={12} lg={6}>
-          <Card loading={loading}>
-            <Statistic title="有效用户" value={stats?.usersTotal ?? 0} />
-          </Card>
-        </Col>
-        <Col xs={24} sm={12} lg={6}>
-          <Card loading={loading}>
-            <Statistic title="访客（未验手机）" value={stats?.guestUsers ?? 0} valueStyle={{ color: '#faad14' }} />
-          </Card>
-        </Col>
-        <Col xs={24} sm={12} lg={6}>
-          <Card loading={loading}>
-            <Statistic title="已验手机" value={stats?.verifiedUsers ?? 0} valueStyle={{ color: '#52c41a' }} />
-          </Card>
-        </Col>
-        <Col xs={24} sm={12} lg={6}>
-          <Card loading={loading}>
-            <Statistic title="今日下单" value={stats?.ordersToday ?? 0} />
-          </Card>
-        </Col>
-        <Col xs={24} sm={12} lg={6}>
-          <Card loading={loading}>
-            <Statistic title="门店" value={stats?.storesTotal ?? 0} />
-          </Card>
-        </Col>
-        <Col xs={24} sm={12} lg={6}>
-          <Card loading={loading}>
-            <Statistic title="合伙人" value={stats?.partnersTotal ?? 0} />
-          </Card>
-        </Col>
-        <Col xs={24} sm={12} lg={6}>
-          <Card loading={loading}>
-            <Statistic title="今日核销" value={stats?.redeemToday ?? 0} />
-          </Card>
-        </Col>
-        <Col xs={24} sm={12} lg={6}>
-          <Card loading={loading}>
-            <Statistic title="配送单" value={stats?.deliveriesTotal ?? 0} />
-          </Card>
-        </Col>
+        {!permsReady ? (
+          <Col xs={24} sm={12} lg={6}>
+            <Card loading />
+          </Col>
+        ) : null}
+        {permsReady && canUsers ? (
+          <Col xs={24} sm={12} lg={6}>
+            <Card loading={loading}>
+              <Statistic title="有效用户" value={stats?.usersTotal ?? 0} />
+            </Card>
+          </Col>
+        ) : null}
+        {permsReady && canUsers ? (
+          <Col xs={24} sm={12} lg={6}>
+            <Card loading={loading}>
+              <Statistic title="访客（未验手机）" value={stats?.guestUsers ?? 0} valueStyle={{ color: '#faad14' }} />
+            </Card>
+          </Col>
+        ) : null}
+        {permsReady && canUsers ? (
+          <Col xs={24} sm={12} lg={6}>
+            <Card loading={loading}>
+              <Statistic title="已验手机" value={stats?.verifiedUsers ?? 0} valueStyle={{ color: '#52c41a' }} />
+            </Card>
+          </Col>
+        ) : null}
+        {permsReady && canOrders ? (
+          <Col xs={24} sm={12} lg={6}>
+            <Card loading={loading}>
+              <Statistic title="今日下单" value={stats?.ordersToday ?? 0} />
+            </Card>
+          </Col>
+        ) : null}
+        {permsReady && canStores ? (
+          <Col xs={24} sm={12} lg={6}>
+            <Card loading={loading}>
+              <Statistic title="门店" value={stats?.storesTotal ?? 0} />
+            </Card>
+          </Col>
+        ) : null}
+        {permsReady && canStores ? (
+          <Col xs={24} sm={12} lg={6}>
+            <Card loading={loading} extra={<Link to="/stores?auditStatus=PENDING">去处理</Link>}>
+              <Statistic
+                title="待入驻审核"
+                value={stats?.pendingStoreOnboard ?? 0}
+                valueStyle={{ color: (stats?.pendingStoreOnboard ?? 0) > 0 ? '#fa8c16' : undefined }}
+              />
+            </Card>
+          </Col>
+        ) : null}
+        {permsReady && canStoreAudits ? (
+          <Col xs={24} sm={12} lg={6}>
+            <Card loading={loading} extra={<Link to="/store-package-audits">去处理</Link>}>
+              <Statistic
+                title="待套餐/信息审核"
+                value={(stats?.pendingStorePackageAudits ?? 0) + (stats?.pendingStoreInfoChanges ?? 0)}
+                valueStyle={{
+                  color:
+                    (stats?.pendingStorePackageAudits ?? 0) + (stats?.pendingStoreInfoChanges ?? 0) > 0
+                      ? '#fa8c16'
+                      : undefined,
+                }}
+              />
+            </Card>
+          </Col>
+        ) : null}
+        {permsReady && canPartners ? (
+          <Col xs={24} sm={12} lg={6}>
+            <Card loading={loading}>
+              <Statistic title="合伙人" value={stats?.partnersTotal ?? 0} />
+            </Card>
+          </Col>
+        ) : null}
+        {permsReady && canBenefit ? (
+          <Col xs={24} sm={12} lg={6}>
+            <Card loading={loading}>
+              <Statistic title="今日核销" value={stats?.redeemToday ?? 0} />
+            </Card>
+          </Col>
+        ) : null}
+        {permsReady && canDeliveries ? (
+          <Col xs={24} sm={12} lg={6}>
+            <Card loading={loading}>
+              <Statistic title="配送单" value={stats?.deliveriesTotal ?? 0} />
+            </Card>
+          </Col>
+        ) : null}
       </Row>
 
       <Card
@@ -478,62 +598,73 @@ export default function DashboardPage() {
           <Form.Item name="cityId" label="城市">
             <Select
               allowClear
-              placeholder="全部开城"
+              placeholder={cityScoped ? '全部负责城市' : '全部开城'}
               style={{ width: 160 }}
               options={[
-                { value: 'none', label: '未选城' },
+                ...(cityScoped ? [] : [{ value: 'none', label: '未选城' }]),
                 ...cities.map((c) => ({ value: c.id, label: c.name })),
               ]}
             />
           </Form.Item>
-          <Form.Item name="promoCodeId" label="推广码">
-            <Select
-              allowClear
-              placeholder="全部来源"
-              style={{ width: 200 }}
-              options={[
-                { value: 'none', label: '自然量 / 无推广码' },
-                ...promos.map((p) => ({ value: p.id, label: `${p.name}（${p.code}）` })),
-              ]}
-            />
-          </Form.Item>
-          <Form.Item name="partnerAccountId" label="合伙人">
-            <Select
-              allowClear
-              placeholder="全部合伙人"
-              style={{ width: 200 }}
-              options={partners.map((p) => ({
-                value: p.id,
-                label: p.companyName || p.name,
-              }))}
-            />
-          </Form.Item>
+          {canPromo ? (
+            <Form.Item name="promoCodeId" label="推广码">
+              <Select
+                allowClear
+                placeholder="全部来源"
+                style={{ width: 200 }}
+                options={[
+                  { value: 'none', label: '自然量 / 无推广码' },
+                  ...promos.map((p) => ({ value: p.id, label: `${p.name}（${p.code}）` })),
+                ]}
+              />
+            </Form.Item>
+          ) : null}
+          {canPartners ? (
+            <Form.Item name="partnerAccountId" label="合伙人">
+              <Select
+                allowClear
+                placeholder="全部合伙人"
+                style={{ width: 200 }}
+                options={partners.map((p) => ({
+                  value: p.id,
+                  label: p.companyName || p.name,
+                }))}
+              />
+            </Form.Item>
+          ) : null}
           <Form.Item>
             <Button type="primary" htmlType="submit">查询</Button>
           </Form.Item>
         </Form>
       </Card>
 
+      {canUsers || canOrders ? (
       <Card
-        title="用户 / 订单统计"
+        title={canUsers && canOrders ? '用户 / 订单统计' : canUsers ? '用户统计' : '订单统计'}
         style={{ marginBottom: 24 }}
         extra={
           <Space>
-            <Link to={`/orders?${ordersDrillQs}`}>查看订单</Link>
-            <Link to="/users">查看用户</Link>
+            {canOrders ? <Link to={`/orders?${ordersDrillQs}`}>查看订单</Link> : null}
+            {canUsers ? <Link to="/users">查看用户</Link> : null}
           </Space>
         }
       >
         <Row gutter={[16, 16]} style={{ marginBottom: 16 }}>
-          <Col xs={24} sm={8}>
-            <Statistic title="区间新增用户" value={analytics?.summary.users ?? 0} />
-          </Col>
-          <Col xs={24} sm={8}>
-            <Statistic title="区间订单数" value={analytics?.summary.orders ?? 0} />
-          </Col>
-          <Col xs={24} sm={8}>
-            <Statistic title="区间付费用户" value={analytics?.summary.payingUsers ?? 0} />
-          </Col>
+          {canUsers ? (
+            <Col xs={24} sm={8}>
+              <Statistic title="区间新增用户" value={analytics?.summary.users ?? 0} />
+            </Col>
+          ) : null}
+          {canOrders ? (
+            <Col xs={24} sm={8}>
+              <Statistic title="区间订单数" value={analytics?.summary.orders ?? 0} />
+            </Col>
+          ) : null}
+          {canOrders ? (
+            <Col xs={24} sm={8}>
+              <Statistic title="区间付费用户" value={analytics?.summary.payingUsers ?? 0} />
+            </Col>
+          ) : null}
         </Row>
 
         <Row gutter={[16, 16]}>
@@ -542,7 +673,7 @@ export default function DashboardPage() {
               <ReactECharts option={byDateOption} style={{ height: 320 }} notMerge />
             </Card>
           </Col>
-          <Col xs={24} lg={12}>
+          <Col xs={24} lg={canPromo ? 12 : 24}>
             <Card
               type="inner"
               title="按城市（点击柱联动筛选）"
@@ -562,6 +693,7 @@ export default function DashboardPage() {
               />
             </Card>
           </Col>
+          {canPromo ? (
           <Col xs={24} lg={12}>
             <Card
               type="inner"
@@ -584,42 +716,53 @@ export default function DashboardPage() {
               />
             </Card>
           </Col>
+          ) : null}
         </Row>
       </Card>
+      ) : null}
 
+      {canPartners || canStores || canBenefit ? (
       <Card
-        title="合伙人 / 门店 / 核销统计"
+        title={[canPartners && '合伙人', canStores && '门店', canBenefit && '核销'].filter(Boolean).join(' / ') + '统计'}
         style={{ marginBottom: 24 }}
         extra={
           <Space>
-            <Link to="/city-partners">查看合伙人</Link>
-            <Link to="/stores">查看门店</Link>
-            <Link to="/redeem-records">查看核销</Link>
+            {canPartners ? <Link to="/city-partners">查看合伙人</Link> : null}
+            {canStores ? <Link to="/stores">查看门店</Link> : null}
+            {canBenefit ? <Link to="/redeem-records">查看核销</Link> : null}
           </Space>
         }
       >
         <Row gutter={[16, 16]} style={{ marginBottom: 16 }}>
-          <Col xs={24} sm={6}>
-            <Statistic title="区间新增合伙人" value={analytics?.summary.partners ?? 0} />
-          </Col>
-          <Col xs={24} sm={6}>
-            <Statistic title="区间新签门店" value={analytics?.summary.stores ?? 0} />
-          </Col>
-          <Col xs={24} sm={6}>
-            <Statistic title="区间核销笔数" value={analytics?.summary.redeems ?? 0} />
-          </Col>
-          <Col xs={24} sm={6}>
-            <Statistic title="区间核销金额" value={analytics?.summary.redeemAmount ?? 0} precision={2} />
-          </Col>
+          {canPartners ? (
+            <Col xs={24} sm={6}>
+              <Statistic title="区间新增合伙人" value={analytics?.summary.partners ?? 0} />
+            </Col>
+          ) : null}
+          {canStores ? (
+            <Col xs={24} sm={6}>
+              <Statistic title="区间新签门店" value={analytics?.summary.stores ?? 0} />
+            </Col>
+          ) : null}
+          {canBenefit ? (
+            <Col xs={24} sm={6}>
+              <Statistic title="区间核销笔数" value={analytics?.summary.redeems ?? 0} />
+            </Col>
+          ) : null}
+          {canBenefit ? (
+            <Col xs={24} sm={6}>
+              <Statistic title="区间核销金额" value={analytics?.summary.redeemAmount ?? 0} precision={2} />
+            </Col>
+          ) : null}
         </Row>
 
         <Row gutter={[16, 16]}>
           <Col xs={24}>
-            <Card type="inner" title="按日趋势（合伙人 / 门店 / 核销）" loading={analyticsLoading} size="small">
+            <Card type="inner" title="按日趋势" loading={analyticsLoading} size="small">
               <ReactECharts option={opsByDateOption} style={{ height: 320 }} notMerge />
             </Card>
           </Col>
-          <Col xs={24} lg={12}>
+          <Col xs={24} lg={canBenefit ? 12 : 24}>
             <Card
               type="inner"
               title="按城市（点击柱联动筛选）"
@@ -639,6 +782,7 @@ export default function DashboardPage() {
               />
             </Card>
           </Col>
+          {canBenefit ? (
           <Col xs={24} lg={12}>
             <Card
               type="inner"
@@ -659,6 +803,8 @@ export default function DashboardPage() {
               />
             </Card>
           </Col>
+          ) : null}
+          {canPartners && (canStores || canBenefit) ? (
           <Col xs={24}>
             <Card
               type="inner"
@@ -681,10 +827,14 @@ export default function DashboardPage() {
               />
             </Card>
           </Col>
+          ) : null}
         </Row>
       </Card>
+      ) : null}
 
+      {canFinance || canTickets ? (
       <Row gutter={[16, 16]} style={{ marginBottom: 24 }}>
+        {canFinance ? (
         <Col xs={24} sm={12} lg={8}>
           <Card
             loading={loading}
@@ -704,6 +854,8 @@ export default function DashboardPage() {
             </Typography.Text>
           </Card>
         </Col>
+        ) : null}
+        {canFinance ? (
         <Col xs={24} sm={12} lg={8}>
           <Card
             loading={loading}
@@ -717,6 +869,8 @@ export default function DashboardPage() {
             />
           </Card>
         </Col>
+        ) : null}
+        {canFinance ? (
         <Col xs={24} sm={12} lg={8}>
           <Card
             loading={loading}
@@ -737,20 +891,28 @@ export default function DashboardPage() {
             </Typography.Text>
           </Card>
         </Col>
+        ) : null}
+        {canTickets ? (
         <Col xs={24} sm={12} lg={8}>
           <Card loading={loading} title="待处理工单">
             <Statistic value={stats?.openTickets ?? 0} suffix="个" />
           </Card>
         </Col>
+        ) : null}
       </Row>
+      ) : null}
 
+      {canUsers || canOrders ? (
       <Row gutter={[16, 16]}>
-        <Col xs={24} lg={12}>
+        {canUsers ? (
+        <Col xs={24} lg={canOrders ? 12 : 24}>
           <Card title="已合并访客账号" loading={loading}>
             <Statistic value={stats?.mergedUsers ?? 0} suffix="个" />
           </Card>
         </Col>
-        <Col xs={24} lg={12}>
+        ) : null}
+        {canOrders ? (
+        <Col xs={24} lg={canUsers ? 12 : 24}>
           <Card title="订单状态分布" loading={loading}>
             <Table
               size="small"
@@ -768,7 +930,9 @@ export default function DashboardPage() {
             />
           </Card>
         </Col>
+        ) : null}
       </Row>
+      ) : null}
     </div>
   );
 }

apps/admin-web/src/pages/DeliveriesPage.tsx

@@ -7,6 +7,8 @@ import OrderTrackDrawer from '../components/OrderTrackDrawer';
 import { request } from '../lib/api';
 import { ORDER_STATUS_LABELS, fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -59,7 +61,7 @@ export default function DeliveriesPage() {
     setTrackOpen(true);
   }
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: '订单号', dataIndex: ['order', 'orderNo'], width: 170 },
     { title: 'provider', dataIndex: 'provider', width: 90 },
     { title: '运单号', dataIndex: 'trackingNo', width: 140, render: (v) => v || '—' },
@@ -83,16 +85,20 @@ export default function DeliveriesPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('deliveries', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Typography.Title level={4}>快递/配送单</Typography.Title>
+          {settingsButton}
       <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={(v) => { setFilters(v); setPage(1); }}>
         <Form.Item name="orderNo" label="订单号"><Input allowClear /></Form.Item>
         <Form.Item name="provider" label="provider"><Input allowClear placeholder="MOCK" /></Form.Item>
         <Form.Item name="trackingNo" label="运单号"><Input allowClear /></Form.Item>
         <Form.Item><Button type="primary" htmlType="submit">查询</Button></Form.Item>
       </Form>
-      <Table rowKey="id" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 1100 }}
+      <Table rowKey="id" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 'max-content' }}
         pagination={{ current: page, pageSize, total: data?.total ?? 0, showSizeChanger: true, onChange: (p, ps) => { setPage(p); setPageSize(ps); } }} />
       <Drawer title="配送单编辑" width={480} open={drawerOpen} onClose={() => setDrawerOpen(false)}
         extra={

apps/admin-web/src/pages/DevPlanTasksPage.tsx

@@ -2,6 +2,7 @@ import { useEffect, useState } from 'react';
 import {
   Button,
   Form,
+  Image,
   Input,
   Modal,
   Popconfirm,
@@ -18,6 +19,7 @@ import {
   DEV_PLAN_TASK_TYPE_LABELS,
   SUPPORT_TICKET_STATUS_LABELS,
   type DevPlanTaskDto,
+  type DevPlanTaskExportFormat,
   type DevPlanTaskStatusDto,
   type DevPlanTaskTypeDto,
   type DevPlanVersionDto,
@@ -25,7 +27,11 @@ import {
 } from '@dukang/shared-types';
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
+import { downloadBase64File } from '../lib/exportExcel';
 import { useAdminList } from '../lib/useAdminList';
+import OssUpload from '../components/OssUpload';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 const TYPE_OPTIONS = (Object.keys(DEV_PLAN_TASK_TYPE_LABELS) as DevPlanTaskTypeDto[]).map((v) => ({
   value: v,
@@ -56,6 +62,8 @@ export default function DevPlanTasksPage() {
   const [editing, setEditing] = useState<DevPlanTaskDto | null>(null);
   const [saving, setSaving] = useState(false);
   const [dispatching, setDispatching] = useState(false);
+  const [exportFormat, setExportFormat] = useState<DevPlanTaskExportFormat>('xlsx');
+  const [exporting, setExporting] = useState(false);
   const [form] = Form.useForm();
   const [dispatchForm] = Form.useForm<{ supplement?: string }>();
   const [batchForm] = Form.useForm<{ status?: DevPlanTaskStatusDto; versionId?: string }>();
@@ -88,24 +96,30 @@ export default function DevPlanTasksPage() {
 
   function openCreate() {
     setEditing(null);
-    form.setFieldsValue({ content: '', type: 'BUG', status: 'TODO', supportTicketId: undefined });
+    form.setFieldsValue({ content: '', type: 'BUG', status: 'TODO', supportTicketId: undefined, attachmentUrls: [''] });
     setModalOpen(true);
   }
 
   function openEdit(row: DevPlanTaskDto) {
     setEditing(row);
-    form.setFieldsValue({ content: row.content, type: row.type, status: row.status });
+    form.setFieldsValue({
+      content: row.content,
+      type: row.type,
+      status: row.status,
+      attachmentUrls: row.attachmentUrls?.length ? row.attachmentUrls : [''],
+    });
     setModalOpen(true);
   }
 
   async function save() {
     const values = await form.validateFields();
+    const attachmentUrls = (values.attachmentUrls ?? []).map((u: string) => u?.trim()).filter(Boolean);
     setSaving(true);
     try {
       if (editing) {
         await request(`/admin/dev-plan/tasks/${editing.id}`, {
           method: 'PUT',
-          body: JSON.stringify(values),
+          body: JSON.stringify({ ...values, attachmentUrls }),
         });
         message.success('已更新');
       } else {
@@ -115,6 +129,7 @@ export default function DevPlanTasksPage() {
             content: values.content,
             type: values.type,
             supportTicketId: values.supportTicketId || undefined,
+            attachmentUrls,
           }),
         });
         message.success('已创建');
@@ -199,7 +214,35 @@ export default function DevPlanTasksPage() {
     }
   }
 
-  const columns: ColumnsType<DevPlanTaskDto> = [
+  async function exportTasks(scope: 'filter' | 'selected') {
+    setExporting(true);
+    try {
+      const result = await request<{
+        filename: string;
+        mimeType: string;
+        contentBase64: string;
+        count: number;
+      }>('/admin/dev-plan/tasks/export', {
+        method: 'POST',
+        body: JSON.stringify({
+          scope,
+          format: exportFormat,
+          ids: scope === 'selected' ? selectedRowKeys : undefined,
+          status: filters.status || undefined,
+          type: filters.type || undefined,
+          keyword: filters.keyword || undefined,
+        }),
+      });
+      downloadBase64File(result.contentBase64, result.filename, result.mimeType);
+      message.success(`已导出 ${result.count} 条任务`);
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '导出失败');
+    } finally {
+      setExporting(false);
+    }
+  }
+
+  const baseColumns: ColumnsType<DevPlanTaskDto> = [
     { title: '任务号', dataIndex: 'taskNo', width: 160 },
     {
       title: '类型',
@@ -215,7 +258,23 @@ export default function DevPlanTasksPage() {
         <Tag color={STATUS_COLOR[s]}>{DEV_PLAN_TASK_STATUS_LABELS[s]}</Tag>
       ),
     },
-    { title: '内容', dataIndex: 'content', ellipsis: true },
+    { title: '内容', dataIndex: 'content' },
+    {
+      title: '附件',
+      width: 100,
+      render: (_, row) =>
+        row.attachmentUrls?.length ? (
+          <Image.PreviewGroup>
+            <Space size={4}>
+              {row.attachmentUrls.slice(0, 3).map((url) => (
+                <Image key={url} src={url} width={32} height={32} style={{ objectFit: 'cover' }} />
+              ))}
+            </Space>
+          </Image.PreviewGroup>
+        ) : (
+          '—'
+        ),
+    },
     { title: '来源工单', dataIndex: 'supportTicketNo', width: 140, render: (v) => v || '—' },
     { title: '创建人', dataIndex: 'creatorName', width: 90 },
     { title: '创建时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
@@ -237,13 +296,34 @@ export default function DevPlanTasksPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('dev-plan-tasks', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: 16 }}>
         <Typography.Title level={4} style={{ margin: 0 }}>
           开发计划 · 任务列表
         </Typography.Title>
-        <Space>
+          {settingsButton}
+        <Space wrap>
+          <Select
+            value={exportFormat}
+            style={{ width: 120 }}
+            onChange={setExportFormat}
+            options={[
+              { value: 'markdown', label: 'Markdown' },
+              { value: 'docx', label: 'Word' },
+              { value: 'xlsx', label: 'Excel' },
+              { value: 'pdf', label: 'PDF' },
+            ]}
+          />
+          <Button loading={exporting} disabled={!selectedRowKeys.length} onClick={() => void exportTasks('selected')}>
+            导出已勾选
+          </Button>
+          <Button loading={exporting} onClick={() => void exportTasks('filter')}>
+            导出全部筛选
+          </Button>
           <Button disabled={!selectedRowKeys.length} onClick={openBatchEdit}>
             批量编辑
           </Button>
@@ -287,7 +367,7 @@ export default function DevPlanTasksPage() {
           selectedRowKeys,
           onChange: (keys) => setSelectedRowKeys(keys as string[]),
         }}
-        scroll={{ x: 1100 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,
@@ -333,6 +413,29 @@ export default function DevPlanTasksPage() {
               />
             </Form.Item>
           )}
+          <Form.Item label="附件图片">
+            <Form.List name="attachmentUrls">
+              {(fields, { add, remove }) => (
+                <>
+                  {fields.map((field) => (
+                    <Space key={field.key} align="start" style={{ display: 'flex', marginBottom: 8 }}>
+                      <Form.Item {...field} style={{ flex: 1, marginBottom: 0 }}>
+                        <OssUpload bizType="SUPPORT_TICKET_ATTACHMENT" mediaType="IMAGE" />
+                      </Form.Item>
+                      {fields.length > 1 ? (
+                        <Button type="link" danger onClick={() => remove(field.name)}>
+                          删除
+                        </Button>
+                      ) : null}
+                    </Space>
+                  ))}
+                  <Button type="dashed" onClick={() => add('')} block>
+                    添加图片
+                  </Button>
+                </>
+              )}
+            </Form.List>
+          </Form.Item>
         </Form>
       </Modal>
 

apps/admin-web/src/pages/DevPlanVersionsPage.tsx

@@ -22,6 +22,8 @@ import {
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 
 const STATUS_OPTIONS = (Object.keys(DEV_PLAN_VERSION_STATUS_LABELS) as DevPlanVersionStatusDto[]).map(
@@ -119,7 +121,7 @@ export default function DevPlanVersionsPage() {
     }
   }
 
-  const columns: ColumnsType<DevPlanVersionDto> = [
+  const baseColumns: ColumnsType<DevPlanVersionDto> = [
     { title: '版本号', dataIndex: 'versionNo', width: 120 },
     {
       title: '状态',
@@ -129,7 +131,7 @@ export default function DevPlanVersionsPage() {
         <Tag color={STATUS_COLOR[s]}>{DEV_PLAN_VERSION_STATUS_LABELS[s]}</Tag>
       ),
     },
-    { title: '内容', dataIndex: 'content', ellipsis: true, render: (v) => v || '—' },
+    { title: '内容', dataIndex: 'content', render: (v) => v || '—' },
     { title: '开发起始', dataIndex: 'devStartedAt', width: 160, render: (v) => (v ? fmtTime(v) : '—') },
     { title: '开发完成', dataIndex: 'devCompletedAt', width: 160, render: (v) => (v ? fmtTime(v) : '—') },
     { title: '上线时间', dataIndex: 'releasedAt', width: 160, render: (v) => (v ? fmtTime(v) : '—') },
@@ -158,12 +160,16 @@ export default function DevPlanVersionsPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('dev-plan-versions', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: 16 }}>
         <Typography.Title level={4} style={{ margin: 0 }}>
           开发计划 · 版本列表
         </Typography.Title>
+          {settingsButton}
         <Button type="primary" onClick={openCreate}>
           新建版本
         </Button>
@@ -190,7 +196,7 @@ export default function DevPlanVersionsPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1100 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,

apps/admin-web/src/pages/DomainEventsPage.tsx

@@ -4,6 +4,8 @@ import { Card, Descriptions, Drawer, Select, Space, Table, Tag } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -55,7 +57,7 @@ export default function DomainEventsPage() {
     load();
   }, [load]);
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: '时间', dataIndex: 'createdAt', width: 170, render: (v) => fmtTime(v) },
     { title: '类型', dataIndex: 'eventType', width: 130, render: (v) => <Tag>{v}</Tag> },
     { title: '关联', render: (_, r) => `${r.refType} #${r.refId}` },
@@ -76,8 +78,13 @@ export default function DomainEventsPage() {
     },
   ];
 
+  const page = Number(params.get('page') ?? 1);
+  const pageSize = data?.pageSize ?? 20;
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('logs-domain-events', baseColumns, { page, pageSize });
+
   return (
-    <Card title="领域事件">
+    <Card title="领域事件" extra={settingsButton}>
+      {settingsModal}
       <Space wrap style={{ marginBottom: 16 }}>
         <Select
           style={{ width: 180 }}

apps/admin-web/src/pages/FulfillmentProvidersPage.tsx

@@ -28,6 +28,8 @@ import {
 } from '@dukang/shared-types';
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 const TYPE_OPTIONS = Object.entries(FULFILLMENT_PROVIDER_TYPE_LABELS).map(([value, label]) => ({
   value,
@@ -173,7 +175,7 @@ export default function FulfillmentProvidersPage() {
     void load();
   }
 
-  const columns: ColumnsType<FulfillmentProviderDto> = [
+  const baseColumns: ColumnsType<FulfillmentProviderDto> = [
     { title: '编码', dataIndex: 'code', width: 100 },
     { title: '名称', dataIndex: 'name' },
     {
@@ -230,13 +232,20 @@ export default function FulfillmentProvidersPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('fulfillment-providers', baseColumns, {
+    page: 1,
+    pageSize: rows.length || 20,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
         <div>
           <Typography.Title level={4} style={{ margin: 0 }}>
             仓配管理
           </Typography.Title>
+          {settingsButton}
           <Typography.Text type="secondary">
             注册承运商接口凭证，并配置物流对账用的银行账户、结算方式与计价标准
           </Typography.Text>
@@ -253,7 +262,7 @@ export default function FulfillmentProvidersPage() {
         message="小飞侠默认计价：2瓶6元，加一瓶+2元，6瓶一箱14元。财务对账见「财务 → 物流对账」。"
       />
 
-      <Table rowKey="id" loading={loading} columns={columns} dataSource={rows} pagination={false} />
+      <Table scroll={{ x: 'max-content' }} rowKey="id" loading={loading} columns={columns} dataSource={rows} pagination={false} />
 
       <Modal
         title={editRow ? '编辑承运商' : '注册承运商'}

apps/admin-web/src/pages/HqAccountsPage.tsx

@@ -3,9 +3,12 @@ import {
   Button, Drawer, Form, Input, Modal, Radio, Select, Space, Table, Tag, Typography, message,
 } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
-import { request, type HqProfile } from '../lib/api';
-import { ACCOUNT_STATUS_LABELS, fmtTime } from '../lib/constants';
+import { HQ_ADMIN_ROLES } from '@dukang/shared-types';
+import { request, type HqProfile, type Paginated } from '../lib/api';
+import { ACCOUNT_STATUS_LABELS, ADMIN_OPTIONS_PAGE_SIZE, fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -17,14 +20,13 @@ type Row = {
   status: string;
   lastLoginAt: string | null;
   createdAt: string;
+  cityIds?: string[];
 };
 
-const ROLE_LABELS: Record<string, string> = {
-  SUPER_ADMIN: '超级管理员',
-  OPS: '运营',
-  FINANCE: '财务',
-  CUSTOMER_SERVICE: '客服',
-};
+type CityOption = { id: string; name: string };
+
+const ROLE_OPTIONS = HQ_ADMIN_ROLES.map((r) => ({ value: r.value, label: r.label }));
+const ROLE_LABELS = Object.fromEntries(HQ_ADMIN_ROLES.map((r) => [r.value, r.label]));
 
 export default function HqAccountsPage() {
   const [profile, setProfile] = useState<HqProfile | null>(null);
@@ -46,14 +48,27 @@ export default function HqAccountsPage() {
   const [detail, setDetail] = useState<Row | null>(null);
   const [drawerOpen, setDrawerOpen] = useState(false);
   const [createOpen, setCreateOpen] = useState(false);
+  const [saving, setSaving] = useState(false);
+  const [cities, setCities] = useState<CityOption[]>([]);
   const credentialType = Form.useWatch('credentialType', createForm) ?? 'phone';
+  const editRole = Form.useWatch('adminRole', editForm);
+  const createRole = Form.useWatch('adminRole', createForm);
   const isSuperAdmin = profile?.adminRole === 'SUPER_ADMIN';
 
   useEffect(() => {
     request<HqProfile>('/admin/auth/me').then(setProfile).catch(() => {});
   }, []);
 
-  const columns: ColumnsType<Row> = [
+  useEffect(() => {
+    if (!isSuperAdmin) return;
+    request<Paginated<CityOption>>(`/admin/cities?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`)
+      .then((res) => setCities(res.items))
+      .catch(() => {});
+  }, [isSuperAdmin]);
+
+  const cityOptions = cities.map((c) => ({ value: c.id, label: c.name }));
+
+  const baseColumns: ColumnsType<Row> = [
     { title: '姓名', dataIndex: 'name' },
     { title: '用户名', dataIndex: 'loginName', width: 120, render: (v) => v || '—' },
     { title: '手机', dataIndex: 'phone', width: 130 },
@@ -67,7 +82,18 @@ export default function HqAccountsPage() {
         </Space>
       ),
     },
-    { title: '角色', dataIndex: 'adminRole', width: 110, render: (r) => ROLE_LABELS[r] || r },
+    { title: '角色', dataIndex: 'adminRole', width: 130, render: (r) => ROLE_LABELS[r] || r },
+    {
+      title: '城市',
+      width: 160,
+      render: (_, r) => {
+        if (!r.cityIds?.length) return <Typography.Text type="secondary">全国</Typography.Text>;
+        const names = r.cityIds
+          .map((id) => cities.find((c) => c.id === id)?.name || id)
+          .join('、');
+        return names;
+      },
+    },
     { title: '状态', dataIndex: 'status', width: 90, render: (s) => <Tag>{ACCOUNT_STATUS_LABELS[s] || s}</Tag> },
     { title: '最后登录', dataIndex: 'lastLoginAt', width: 160, render: fmtTime },
     {
@@ -81,6 +107,7 @@ export default function HqAccountsPage() {
             loginName: row.loginName,
             adminRole: row.adminRole,
             status: row.status,
+            cityIds: row.cityIds ?? [],
           });
           setDrawerOpen(true);
         }}>编辑</Button>
@@ -88,16 +115,20 @@ export default function HqAccountsPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('hq-accounts', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
         <Typography.Title level={4} style={{ margin: 0 }}>HQ 账户</Typography.Title>
+          {settingsButton}
         {isSuperAdmin && (
           <Button
             type="primary"
             onClick={() => {
               createForm.resetFields();
-              createForm.setFieldsValue({ credentialType: 'phone', adminRole: 'OPS' });
+              createForm.setFieldsValue({ credentialType: 'phone', adminRole: 'OPS', cityIds: [] });
               setCreateOpen(true);
             }}
           >
@@ -108,23 +139,31 @@ export default function HqAccountsPage() {
       <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={(v) => { setFilters(v); setPage(1); }}>
         <Form.Item name="phone" label="手机"><Input allowClear /></Form.Item>
         <Form.Item name="adminRole" label="角色">
-          <Select allowClear style={{ width: 120 }} options={Object.entries(ROLE_LABELS).map(([value, label]) => ({ value, label }))} />
+          <Select allowClear style={{ width: 160 }} options={ROLE_OPTIONS} />
         </Form.Item>
         <Form.Item><Button type="primary" htmlType="submit">查询</Button></Form.Item>
       </Form>
-      <Table rowKey="id" loading={loading} columns={columns} dataSource={data?.items ?? []}
+      <Table scroll={{ x: 'max-content' }} rowKey="id" loading={loading} columns={columns} dataSource={data?.items ?? []}
         pagination={{ current: page, pageSize, total: data?.total ?? 0, showSizeChanger: true, onChange: (p, ps) => { setPage(p); setPageSize(ps); } }} />
-      <Drawer title="编辑 HQ 账户" width={420} open={drawerOpen} onClose={() => setDrawerOpen(false)}
+      <Drawer title="编辑 HQ 账户" width={460} open={drawerOpen} onClose={() => setDrawerOpen(false)}
         extra={
-          <Button type="primary" onClick={async () => {
+          <Button type="primary" loading={saving} onClick={async () => {
             if (!detail) return;
-            const v = await editForm.validateFields();
-            const payload = { ...v };
-            if (!payload.password) delete payload.password;
-            await request(`/admin/hq-accounts/${detail.id}`, { method: 'PUT', body: JSON.stringify(payload) });
-            message.success('已保存');
-            setDrawerOpen(false);
-            void reload();
+            try {
+              const v = await editForm.validateFields();
+              const payload: Record<string, unknown> = { ...v };
+              if (!payload.password) delete payload.password;
+              if (!String(payload.loginName ?? '').trim()) delete payload.loginName;
+              setSaving(true);
+              await request(`/admin/hq-accounts/${detail.id}`, { method: 'PUT', body: JSON.stringify(payload) });
+              message.success('已保存');
+              setDrawerOpen(false);
+              void reload();
+            } catch (e) {
+              if (e instanceof Error && e.message) message.error(e.message);
+            } finally {
+              setSaving(false);
+            }
           }}>保存</Button>
         }>
         <Form form={editForm} layout="vertical">
@@ -144,7 +183,15 @@ export default function HqAccountsPage() {
             <Input.Password placeholder="至少 6 位" />
           </Form.Item>
           <Form.Item name="adminRole" label="角色">
-            <Select options={Object.entries(ROLE_LABELS).map(([value, label]) => ({ value, label }))} />
+            <Select options={ROLE_OPTIONS} />
+          </Form.Item>
+          <Form.Item
+            name="cityIds"
+            label="负责城市"
+            extra={editRole === 'CITY_STORE_SERVICE' ? '城市门店服务必须至少选一个城市' : '不选表示全国可见'}
+            rules={editRole === 'CITY_STORE_SERVICE' ? [{ required: true, type: 'array', min: 1, message: '请至少勾选一个城市' }] : []}
+          >
+            <Select mode="multiple" allowClear showSearch optionFilterProp="label" placeholder="不选=全国" options={cityOptions} />
           </Form.Item>
           <Form.Item name="status" label="状态">
             <Select options={Object.entries(ACCOUNT_STATUS_LABELS).map(([value, label]) => ({ value, label }))} />
@@ -156,15 +203,19 @@ export default function HqAccountsPage() {
         open={createOpen}
         onCancel={() => setCreateOpen(false)}
         onOk={async () => {
-          const v = await createForm.validateFields();
-          await request('/admin/hq-accounts', { method: 'POST', body: JSON.stringify(v) });
-          message.success('已创建');
-          setCreateOpen(false);
-          createForm.resetFields();
-          void reload();
+          try {
+            const v = await createForm.validateFields();
+            await request('/admin/hq-accounts', { method: 'POST', body: JSON.stringify(v) });
+            message.success('已创建');
+            setCreateOpen(false);
+            createForm.resetFields();
+            void reload();
+          } catch (e) {
+            if (e instanceof Error && e.message) message.error(e.message);
+          }
         }}
       >
-        <Form form={createForm} layout="vertical" initialValues={{ credentialType: 'phone', adminRole: 'OPS' }}>
+        <Form form={createForm} layout="vertical" initialValues={{ credentialType: 'phone', adminRole: 'OPS', cityIds: [] }}>
           <Form.Item name="credentialType" label="创建方式">
             <Radio.Group>
               <Radio value="phone">手机号账户（短信登录）</Radio>
@@ -173,7 +224,15 @@ export default function HqAccountsPage() {
           </Form.Item>
           <Form.Item name="name" label="姓名" rules={[{ required: true }]}><Input /></Form.Item>
           <Form.Item name="adminRole" label="角色">
-            <Select options={Object.entries(ROLE_LABELS).map(([value, label]) => ({ value, label }))} />
+            <Select options={ROLE_OPTIONS} />
+          </Form.Item>
+          <Form.Item
+            name="cityIds"
+            label="负责城市"
+            extra={createRole === 'CITY_STORE_SERVICE' ? '城市门店服务必须至少选一个城市' : '不选表示全国可见'}
+            rules={createRole === 'CITY_STORE_SERVICE' ? [{ required: true, type: 'array', min: 1, message: '请至少勾选一个城市' }] : []}
+          >
+            <Select mode="multiple" allowClear showSearch optionFilterProp="label" placeholder="不选=全国" options={cityOptions} />
           </Form.Item>
           {credentialType === 'phone' ? (
             <Form.Item name="phone" label="手机号" rules={[{ required: true, message: '请输入手机号' }]}>

apps/admin-web/src/pages/HqLogsPage.tsx

@@ -1,199 +1,204 @@
-import { useEffect, useState } from 'react';
-import {
-  Button, Descriptions, Drawer, Form, Input, Select, Space, Table, Tag, Typography,
-} from 'antd';
-import type { ColumnsType } from 'antd/es/table';
-import { useSearchParams } from 'react-router-dom';
-import { request } from '../lib/api';
-import { AdminCellLine } from '../components/AdminCellLine';
-import { fmtTime } from '../lib/constants';
-import { HQ_OPERATION_ACTION_OPTIONS, resolveHqOperationLabel } from '../lib/hq-log';
+import { useEffect, useState } from 'react';
+import {
+  Button, Descriptions, Drawer, Form, Input, Select, Space, Table, Tag, Typography,
+} from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import { useSearchParams } from 'react-router-dom';
+import { request } from '../lib/api';
+import { AdminCellLine } from '../components/AdminCellLine';
+import { fmtTime } from '../lib/constants';
+import { HQ_OPERATION_ACTION_OPTIONS, resolveHqOperationLabel } from '../lib/hq-log';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
+
+type Row = {
+  id: string;
+  hqAccountId: string | null;
+  hqName: string | null;
+  hqPhone: string | null;
+  hqRole: string | null;
+  action: string | null;
+  actionLabel: string;
+  refType: string | null;
+  refId: string | null;
+  status: string | null;
+  remark: string | null;
+  detail: Record<string, unknown> | null;
+  createdAt: string;
+};
+
+export default function HqLogsPage() {
+  const [searchParams, setSearchParams] = useSearchParams();
+  const [form] = Form.useForm();
+  const [filters, setFilters] = useState<Record<string, string>>(() => ({
+    hqAccountId: searchParams.get('hqAccountId') ?? '',
+    action: searchParams.get('action') ?? '',
+    refType: searchParams.get('refType') ?? '',
+  }));
+  const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<Row>(
+    '/admin/logs/hq',
+    () => {
+      const qs = new URLSearchParams();
+      if (filters.hqAccountId) qs.set('hqAccountId', filters.hqAccountId);
+      if (filters.action) qs.set('action', filters.action);
+      if (filters.refType) qs.set('refType', filters.refType);
+      return qs;
+    },
+    [filters],
+  );
+  const [detail, setDetail] = useState<Row | null>(null);
+  const [drawerOpen, setDrawerOpen] = useState(false);
+
+  useEffect(() => {
+    form.setFieldsValue(filters);
+  }, [form, filters]);
+
+  const baseColumns: ColumnsType<Row> = [
+    { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
+    {
+      title: '操作人',
+      width: 200,
+
+      render: (_, r) => (
+        <AdminCellLine
+          primary={r.hqName}
+          secondary={[r.hqPhone, r.hqAccountId ? `#${r.hqAccountId}` : ''].filter(Boolean).join(' ') || null}
+        />
+      ),
+    },
+    {
+      title: '行为',
+      dataIndex: 'actionLabel',
+      width: 160,
+      render: (v, r) => <Tag color="blue">{v || resolveHqOperationLabel(r.action)}</Tag>,
+    },
+    { title: '对象类型', dataIndex: 'refType', width: 120, render: (v) => v || '—' },
+    { title: '对象 ID', dataIndex: 'refId', width: 100, render: (v) => v || '—' },
+    {
+      title: '操作',
+      width: 80,
+      render: (_, row) => (
+        <Button
+          type="link"
+          size="small"
+          onClick={async () => {
+            const res = await request<Row>(`/admin/logs/hq/${row.id}`);
+            setDetail(res);
+            setDrawerOpen(true);
+          }}
+        >
+          详情
+        </Button>
+      ),
+    },
+  ];
+
   const { columns, settingsButton, settingsModal } = useAdminListColumns('logs-hq', baseColumns, { page, pageSize });
-type Row = {
-  id: string;
-  hqAccountId: string | null;
-  hqName: string | null;
-  hqPhone: string | null;
-  hqRole: string | null;
-  action: string | null;
-  actionLabel: string;
-  refType: string | null;
-  refId: string | null;
-  status: string | null;
-  remark: string | null;
-  detail: Record<string, unknown> | null;
-  createdAt: string;
-};
-
-export default function HqLogsPage() {
-  const [searchParams, setSearchParams] = useSearchParams();
-  const [form] = Form.useForm();
-  const [filters, setFilters] = useState<Record<string, string>>(() => ({
-    hqAccountId: searchParams.get('hqAccountId') ?? '',
-    action: searchParams.get('action') ?? '',
-    refType: searchParams.get('refType') ?? '',
-  }));
-  const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<Row>(
-    '/admin/logs/hq',
-    () => {
-      const qs = new URLSearchParams();
-      if (filters.hqAccountId) qs.set('hqAccountId', filters.hqAccountId);
-      if (filters.action) qs.set('action', filters.action);
-      if (filters.refType) qs.set('refType', filters.refType);
-      return qs;
-    },
-    [filters],
-  );
-  const [detail, setDetail] = useState<Row | null>(null);
-  const [drawerOpen, setDrawerOpen] = useState(false);
-
-  useEffect(() => {
-    form.setFieldsValue(filters);
-  }, [form, filters]);
-
-  const columns: ColumnsType<Row> = [
-    { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
-    {
-      title: '操作人',
-      width: 200,
-      ellipsis: true,
-      render: (_, r) => (
-        <AdminCellLine
-          primary={r.hqName}
-          secondary={[r.hqPhone, r.hqAccountId ? `#${r.hqAccountId}` : ''].filter(Boolean).join(' ') || null}
-        />
-      ),
-    },
-    {
-      title: '行为',
-      dataIndex: 'actionLabel',
-      width: 160,
-      render: (v, r) => <Tag color="blue">{v || resolveHqOperationLabel(r.action)}</Tag>,
-    },
-    { title: '对象类型', dataIndex: 'refType', width: 120, render: (v) => v || '—' },
-    { title: '对象 ID', dataIndex: 'refId', width: 100, render: (v) => v || '—' },
-    {
-      title: '操作',
-      width: 80,
-      render: (_, row) => (
-        <Button
-          type="link"
-          size="small"
-          onClick={async () => {
-            const res = await request<Row>(`/admin/logs/hq/${row.id}`);
-            setDetail(res);
-            setDrawerOpen(true);
-          }}
-        >
-          详情
-        </Button>
-      ),
-    },
-  ];
-
-  return (
+
   return (
+    <div>
       {settingsModal}
-      <Typography.Paragraph type="secondary">
-        记录总部后台写操作（开城、订单、用户、权限、合伙人等），仅追加不删除。
-      </Typography.Paragraph>
-
-      <Form
-        form={form}
-        layout="inline"
-        style={{ marginBottom: 16 }}
-        onFinish={(values) => {
-          setFilters(values);
-          setPage(1);
-          const qs = new URLSearchParams();
-          if (values.hqAccountId) qs.set('hqAccountId', values.hqAccountId);
-          if (values.action) qs.set('action', values.action);
-          if (values.refType) qs.set('refType', values.refType);
-          setSearchParams(qs);
-        }}
-      >
-        <Form.Item name="hqAccountId" label="HQ 账户 ID">
-          <Input allowClear style={{ width: 140 }} />
-        </Form.Item>
-        <Form.Item name="action" label="行为">
-          <Select
-            allowClear
-            showSearch
-            optionFilterProp="label"
-            style={{ width: 180 }}
-            options={HQ_OPERATION_ACTION_OPTIONS.map((o) => ({ value: o.value, label: o.label }))}
-          />
-        </Form.Item>
-        <Form.Item name="refType" label="对象类型">
-          <Input allowClear placeholder="ORDER / USER / CITY..." style={{ width: 140 }} />
-        </Form.Item>
-        <Form.Item>
-          <Space>
-            <Button type="primary" htmlType="submit">查询</Button>
-            <Button onClick={() => {
-              form.resetFields();
-              setFilters({ hqAccountId: '', action: '', refType: '' });
-              setSearchParams({});
-              setPage(1);
-              void reload();
-            }}
-            >
-              重置
-            </Button>
-          </Space>
-        </Form.Item>
-      </Form>
-
-      <Table
-        rowKey="id"
-        loading={loading}
-        columns={columns}
-        dataSource={data?.items ?? []}
-        scroll={{ x: 900 }}
-        pagination={{
-          current: page,
-          pageSize,
-          total: data?.total ?? 0,
-          showSizeChanger: true,
-          onChange: (p, ps) => {
-            setPage(p);
-            setPageSize(ps);
-          },
-        }}
-      />
-
-      <Drawer title="操作详情" width={640} open={drawerOpen} onClose={() => setDrawerOpen(false)}>
-        {detail && (
-          <>
-            <Descriptions column={1} bordered size="small">
-              <Descriptions.Item label="日志 ID">{detail.id}</Descriptions.Item>
-              <Descriptions.Item label="时间">{fmtTime(detail.createdAt)}</Descriptions.Item>
-              <Descriptions.Item label="操作人">
-                <AdminCellLine
-                  primary={detail.hqName}
-                  secondary={[detail.hqPhone, detail.hqAccountId ? `ID:${detail.hqAccountId}` : ''].filter(Boolean).join(' ') || null}
-                />
-              </Descriptions.Item>
-              <Descriptions.Item label="角色">{detail.hqRole || '—'}</Descriptions.Item>
-              <Descriptions.Item label="行为">
-                {detail.actionLabel || resolveHqOperationLabel(detail.action)}
-              </Descriptions.Item>
-              <Descriptions.Item label="对象">{detail.refType} / {detail.refId}</Descriptions.Item>
-              <Descriptions.Item label="状态">{detail.status || '—'}</Descriptions.Item>
-              <Descriptions.Item label="备注">{detail.remark || '—'}</Descriptions.Item>
-            </Descriptions>
-            <Typography.Title level={5} style={{ marginTop: 16 }}>请求/响应快照</Typography.Title>
-            <pre style={{
-              margin: 0, padding: 12, background: '#f5f5f5', borderRadius: 4,
-              maxHeight: 400, overflow: 'auto', fontSize: 12,
-            }}
-            >
-              {JSON.stringify(detail.detail, null, 2)}
-            </pre>
-          </>
-        )}
-      </Drawer>
-    </div>
-  );
-}
+      <Typography.Title level={4}>HQ 操作日志</Typography.Title>
+          {settingsButton}
+      <Typography.Paragraph type="secondary">
+        记录总部后台写操作（开城、订单、用户、权限、合伙人等），仅追加不删除。
+      </Typography.Paragraph>
+
+      <Form
+        form={form}
+        layout="inline"
+        style={{ marginBottom: 16 }}
+        onFinish={(values) => {
+          setFilters(values);
+          setPage(1);
+          const qs = new URLSearchParams();
+          if (values.hqAccountId) qs.set('hqAccountId', values.hqAccountId);
+          if (values.action) qs.set('action', values.action);
+          if (values.refType) qs.set('refType', values.refType);
+          setSearchParams(qs);
+        }}
+      >
+        <Form.Item name="hqAccountId" label="HQ 账户 ID">
+          <Input allowClear style={{ width: 140 }} />
+        </Form.Item>
+        <Form.Item name="action" label="行为">
+          <Select
+            allowClear
+            showSearch
+            optionFilterProp="label"
+            style={{ width: 180 }}
+            options={HQ_OPERATION_ACTION_OPTIONS.map((o) => ({ value: o.value, label: o.label }))}
+          />
+        </Form.Item>
+        <Form.Item name="refType" label="对象类型">
+          <Input allowClear placeholder="ORDER / USER / CITY..." style={{ width: 140 }} />
+        </Form.Item>
+        <Form.Item>
+          <Space>
+            <Button type="primary" htmlType="submit">查询</Button>
+            <Button onClick={() => {
+              form.resetFields();
+              setFilters({ hqAccountId: '', action: '', refType: '' });
+              setSearchParams({});
+              setPage(1);
+              void reload();
+            }}
+            >
+              重置
+            </Button>
+          </Space>
+        </Form.Item>
+      </Form>
+
+      <Table
+        rowKey="id"
+        loading={loading}
+        columns={columns}
+        dataSource={data?.items ?? []}
+        scroll={{ x: 'max-content' }}
+        pagination={{
+          current: page,
+          pageSize,
+          total: data?.total ?? 0,
+          showSizeChanger: true,
+          onChange: (p, ps) => {
+            setPage(p);
+            setPageSize(ps);
+          },
+        }}
+      />
+
+      <Drawer title="操作详情" width={640} open={drawerOpen} onClose={() => setDrawerOpen(false)}>
+        {detail && (
+          <>
+            <Descriptions column={1} bordered size="small">
+              <Descriptions.Item label="日志 ID">{detail.id}</Descriptions.Item>
+              <Descriptions.Item label="时间">{fmtTime(detail.createdAt)}</Descriptions.Item>
+              <Descriptions.Item label="操作人">
+                <AdminCellLine
+                  primary={detail.hqName}
+                  secondary={[detail.hqPhone, detail.hqAccountId ? `ID:${detail.hqAccountId}` : ''].filter(Boolean).join(' ') || null}
+                />
+              </Descriptions.Item>
+              <Descriptions.Item label="角色">{detail.hqRole || '—'}</Descriptions.Item>
+              <Descriptions.Item label="行为">
+                {detail.actionLabel || resolveHqOperationLabel(detail.action)}
+              </Descriptions.Item>
+              <Descriptions.Item label="对象">{detail.refType} / {detail.refId}</Descriptions.Item>
+              <Descriptions.Item label="状态">{detail.status || '—'}</Descriptions.Item>
+              <Descriptions.Item label="备注">{detail.remark || '—'}</Descriptions.Item>
+            </Descriptions>
+            <Typography.Title level={5} style={{ marginTop: 16 }}>请求/响应快照</Typography.Title>
+            <pre style={{
+              margin: 0, padding: 12, background: '#f5f5f5', borderRadius: 4,
+              maxHeight: 400, overflow: 'auto', fontSize: 12,
+            }}
+            >
+              {JSON.stringify(detail.detail, null, 2)}
+            </pre>
+          </>
+        )}
+      </Drawer>
+    </div>
+  );

apps/admin-web/src/pages/HqPermissionsPage.tsx

@@ -17,6 +17,7 @@ import {
 import {
   HQ_ADMIN_ROLES,
   HQ_PERMISSION_CATALOG,
+  computeHqEffectivePermissionKeys,
   type HqPermissionKey,
 } from '@dukang/shared-types';
 import { request, type HqProfile } from '../lib/api';
@@ -27,6 +28,8 @@ type AccountPermRes = {
   account: AccountOption;
   permissionKeys: string[];
   rolePermissionKeys: string[];
+  grantKeys?: string[];
+  denyKeys?: string[];
   userPermissionKeys: string[];
   effectivePermissionKeys: string[];
 };
@@ -46,11 +49,17 @@ function PermissionChecklist({
   value,
   onChange,
   disabled,
+  roleKeys,
+  grantKeys,
 }: {
   value: string[];
   onChange: (keys: string[]) => void;
   disabled?: boolean;
+  roleKeys?: string[];
+  grantKeys?: string[];
 }) {
+  const roleSet = new Set(roleKeys ?? []);
+  const grantSet = new Set(grantKeys ?? []);
   return (
     <Checkbox.Group
       style={{ width: '100%' }}
@@ -81,6 +90,13 @@ function PermissionChecklist({
                 {items.map((item) => (
                   <Checkbox key={item.key} value={item.key}>
                     {item.label}
+                    {roleSet.has(item.key) && !value.includes(item.key) ? (
+                      <Tag style={{ marginLeft: 6 }} color="red">已撤销</Tag>
+                    ) : grantSet.has(item.key) ? (
+                      <Tag style={{ marginLeft: 6 }} color="orange">追加</Tag>
+                    ) : roleSet.has(item.key) ? (
+                      <Tag style={{ marginLeft: 6 }} color="blue">角色</Tag>
+                    ) : null}
                   </Checkbox>
                 ))}
               </Space>
@@ -88,7 +104,16 @@ function PermissionChecklist({
               <Row gutter={[12, 10]}>
                 {items.map((item) => (
                   <Col key={item.key} xs={24} sm={12} md={span}>
-                    <Checkbox value={item.key}>{item.label}</Checkbox>
+                    <Checkbox value={item.key}>
+                      {item.label}
+                      {roleSet.has(item.key) && !value.includes(item.key) ? (
+                        <Tag style={{ marginLeft: 6 }} color="red">已撤销</Tag>
+                      ) : grantSet.has(item.key) ? (
+                        <Tag style={{ marginLeft: 6 }} color="orange">追加</Tag>
+                      ) : roleSet.has(item.key) ? (
+                        <Tag style={{ marginLeft: 6 }} color="blue">角色</Tag>
+                      ) : null}
+                    </Checkbox>
                   </Col>
                 ))}
               </Row>
@@ -100,6 +125,14 @@ function PermissionChecklist({
   );
 }
 
+function splitAccountOverrides(roleKeys: string[], effectiveKeys: string[]) {
+  const roleSet = new Set(roleKeys);
+  const effectiveSet = new Set(effectiveKeys);
+  const grantKeys = effectiveKeys.filter((k) => !roleSet.has(k));
+  const denyKeys = roleKeys.filter((k) => !effectiveSet.has(k));
+  return { grantKeys, denyKeys };
+}
+
 export default function HqPermissionsPage() {
   const [profile, setProfile] = useState<HqProfile | null>(null);
   const [role, setRole] = useState<string>('OPS');
@@ -111,6 +144,8 @@ export default function HqPermissionsPage() {
   const [accountId, setAccountId] = useState<string>();
   const [accountKeys, setAccountKeys] = useState<string[]>([]);
   const [roleInheritedKeys, setRoleInheritedKeys] = useState<string[]>([]);
+  const [grantKeys, setGrantKeys] = useState<string[]>([]);
+  const [denyKeys, setDenyKeys] = useState<string[]>([]);
   const [accountLoading, setAccountLoading] = useState(false);
   const [accountSaving, setAccountSaving] = useState(false);
 
@@ -121,8 +156,8 @@ export default function HqPermissionsPage() {
   const selectedIsSuperAdmin = selectedAccount?.adminRole === 'SUPER_ADMIN';
 
   const previewEffectiveKeys = useMemo(
-    () => [...new Set([...roleInheritedKeys, ...accountKeys])],
-    [roleInheritedKeys, accountKeys],
+    () => computeHqEffectivePermissionKeys(roleInheritedKeys, grantKeys, denyKeys),
+    [roleInheritedKeys, grantKeys, denyKeys],
   );
 
   const isSuperAdmin = profile?.adminRole === 'SUPER_ADMIN';
@@ -151,8 +186,10 @@ export default function HqPermissionsPage() {
     setAccountLoading(true);
     request<AccountPermRes>(`/admin/hq-permissions/accounts/${accountId}`)
       .then((res) => {
-        setAccountKeys(res.userPermissionKeys);
+        setGrantKeys(res.grantKeys ?? res.userPermissionKeys ?? []);
+        setDenyKeys(res.denyKeys ?? []);
         setRoleInheritedKeys(res.rolePermissionKeys);
+        setAccountKeys(res.effectivePermissionKeys);
       })
       .finally(() => setAccountLoading(false));
   }, [isSuperAdmin, accountId]);
@@ -179,10 +216,12 @@ export default function HqPermissionsPage() {
     try {
       const res = await request<AccountPermRes>(`/admin/hq-permissions/accounts/${accountId}`, {
         method: 'PUT',
-        body: JSON.stringify({ permissionKeys: accountKeys }),
+        body: JSON.stringify({ grantKeys, denyKeys }),
       });
-      setAccountKeys(res.userPermissionKeys);
+      setGrantKeys(res.grantKeys ?? res.userPermissionKeys ?? []);
+      setDenyKeys(res.denyKeys ?? []);
       setRoleInheritedKeys(res.rolePermissionKeys);
+      setAccountKeys(res.effectivePermissionKeys);
       message.success('用户权限已保存');
     } catch (e) {
       message.error(e instanceof Error ? e.message : '保存失败');
@@ -204,8 +243,9 @@ export default function HqPermissionsPage() {
     <div>
       <Typography.Title level={4}>权限分配</Typography.Title>
       <Typography.Paragraph type="secondary">
-        按角色配置基础权限；按用户可追加专属权限。最终生效权限 = 角色权限 ∪ 用户权限。
+        按角色配置基础权限；按用户可追加或撤销。最终生效权限 =（角色权限 ∪ 追加）− 撤销。
         超级管理员默认拥有除「危险操作」外的全部权限；删除用户/订单/城市需在「按用户分配」中单独勾选（默认均无）。
+        运营/财务默认可删除门店分类；城市门店服务可新增分类，不可删除。
         「系统设置」已拆分为各配置分组；「财务」对应门店/合伙人/酒厂账单。
       </Typography.Paragraph>
 
@@ -275,59 +315,51 @@ export default function HqPermissionsPage() {
                   <Alert type="info" showIcon message="请先选择要配置的 HQ 账户" />
                 ) : (
                   <>
-                    <div style={{ marginBottom: 12 }}>
-                      <span style={{ marginRight: 8 }}>角色继承：</span>
-                      {selectedIsSuperAdmin ? (
-                        <Tag color="blue">超级管理员基础权限（不含危险操作）</Tag>
-                      ) : (
-                        <Space wrap size={[4, 4]}>
-                          {roleInheritedKeys.map((key) => {
-                            const item = HQ_PERMISSION_CATALOG.find((p) => p.key === key);
-                            return (
-                              <Tag key={key} color="blue">
-                                {item?.label || key}
-                              </Tag>
-                            );
-                          })}
-                          {!roleInheritedKeys.length ? (
-                            <Typography.Text type="secondary">无</Typography.Text>
-                          ) : null}
-                        </Space>
-                      )}
-                    </div>
                     <Typography.Paragraph type="secondary">
-                      下方勾选为用户专属追加权限（保存后与角色权限合并生效）。危险操作（删除用户/订单/城市）默认不授予，需在此勾选。
+                      勾选表示该账号最终拥有该权限。取消角色已有项即为撤销；勾选角色没有的项即为追加。
+                      切换角色会清空账号级追加/撤销。
                     </Typography.Paragraph>
-                    <PermissionChecklist value={accountKeys} onChange={setAccountKeys} />
+                    <PermissionChecklist
+                      value={accountKeys}
+                      roleKeys={roleInheritedKeys}
+                      grantKeys={grantKeys}
+                      disabled={selectedIsSuperAdmin}
+                      onChange={(nextEffective) => {
+                        if (selectedIsSuperAdmin) return;
+                        const next = splitAccountOverrides(roleInheritedKeys, nextEffective);
+                        setGrantKeys(next.grantKeys);
+                        setDenyKeys(next.denyKeys);
+                        setAccountKeys(nextEffective);
+                      }}
+                    />
+                    {selectedIsSuperAdmin ? (
+                      <Alert
+                        type="info"
+                        showIcon
+                        style={{ marginTop: 12 }}
+                        message="超级管理员基础权限不可撤销。危险操作请到下方以外的方式：当前勾选仅展示生效权限。"
+                      />
+                    ) : null}
                     <div style={{ marginTop: 12 }}>
                       <span style={{ marginRight: 8 }}>合并生效：</span>
-                      {selectedIsSuperAdmin ? (
-                        <Space wrap size={[4, 4]}>
-                          <Tag>基础权限（全部）</Tag>
-                          {accountKeys.map((key) => {
-                            const item = HQ_PERMISSION_CATALOG.find((p) => p.key === (key as HqPermissionKey));
-                            return (
-                              <Tag key={key} color="orange">
-                                {item?.label || key}
-                              </Tag>
-                            );
-                          })}
-                        </Space>
-                      ) : (
-                        <Space wrap size={[4, 4]}>
-                          {previewEffectiveKeys.map((key) => {
-                            const item = HQ_PERMISSION_CATALOG.find((p) => p.key === (key as HqPermissionKey));
-                            return (
-                              <Tag key={key}>
-                                {item?.label || key}
-                              </Tag>
-                            );
-                          })}
-                        </Space>
-                      )}
+                      <Space wrap size={[4, 4]}>
+                        {previewEffectiveKeys.map((key) => {
+                          const item = HQ_PERMISSION_CATALOG.find((p) => p.key === (key as HqPermissionKey));
+                          return (
+                            <Tag key={key}>
+                              {item?.label || key}
+                            </Tag>
+                          );
+                        })}
+                      </Space>
                     </div>
                     <div style={{ marginTop: 16 }}>
-                      <Button type="primary" loading={accountSaving} onClick={() => void saveAccountPermissions()}>
+                      <Button
+                        type="primary"
+                        loading={accountSaving}
+                        disabled={selectedIsSuperAdmin}
+                        onClick={() => void saveAccountPermissions()}
+                      >
                         保存用户权限
                       </Button>
                     </div>

apps/admin-web/src/pages/InvoicesPage.tsx

@@ -17,9 +17,11 @@ import {
 } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
 import {
+  INVOICE_CATEGORY_LABELS,
   INVOICE_KIND_LABELS,
   INVOICE_STATUS_LABELS,
   INVOICE_TITLE_TYPE_LABELS,
+  type InvoiceCategory,
   type InvoiceKind,
   type InvoiceStatus,
   type InvoiceTitleType,
@@ -28,6 +30,8 @@ import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
 import { uploadFileToOss } from '../lib/upload';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -35,6 +39,7 @@ type Row = {
   orderNo?: string;
   titleType: InvoiceTitleType;
   invoiceKind: InvoiceKind;
+  invoiceCategory?: InvoiceCategory;
   titleName: string;
   status: InvoiceStatus;
   overdue?: boolean;
@@ -54,6 +59,7 @@ type CreateFormValues = {
   orderNo: string;
   titleType: InvoiceTitleType;
   invoiceKind: InvoiceKind;
+  invoiceCategory?: InvoiceCategory;
   titleName: string;
   taxNo?: string;
   addressPhone?: string;
@@ -156,6 +162,7 @@ export default function InvoicesPage() {
           orderNo: values.orderNo.trim(),
           titleType: values.titleType,
           invoiceKind: values.invoiceKind,
+          invoiceCategory: values.invoiceCategory,
           titleName: values.titleName.trim(),
           taxNo: values.taxNo?.trim() || undefined,
           addressPhone: values.addressPhone?.trim() || undefined,
@@ -176,7 +183,7 @@ export default function InvoicesPage() {
     }
   }
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: '申请单号', dataIndex: 'invoiceNo', width: 180 },
     { title: '订单号', dataIndex: 'orderNo', width: 160 },
     {
@@ -186,10 +193,18 @@ export default function InvoicesPage() {
     },
     {
       title: '票种',
-      width: 120,
+      width: 140,
       render: (_, r) => INVOICE_KIND_LABELS[r.invoiceKind] ?? r.invoiceKind,
     },
-    { title: '名称', dataIndex: 'titleName', ellipsis: true },
+    {
+      title: '类型',
+      width: 88,
+      render: (_, r) =>
+        r.invoiceCategory
+          ? INVOICE_CATEGORY_LABELS[r.invoiceCategory] ?? r.invoiceCategory
+          : '—',
+    },
+    { title: '名称', dataIndex: 'titleName' },
     {
       title: '状态',
       width: 110,
@@ -214,8 +229,11 @@ export default function InvoicesPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('invoices', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <div
         style={{
           display: 'flex',
@@ -227,12 +245,14 @@ export default function InvoicesPage() {
         <Typography.Title level={4} style={{ margin: 0 }}>
           发票管理
         </Typography.Title>
+          {settingsButton}
         <Button
           type="primary"
           onClick={() => {
             createForm.setFieldsValue({
               titleType: 'PERSONAL',
               invoiceKind: 'NORMAL',
+              invoiceCategory: 'LIQUOR',
             });
             setCreateOpen(true);
           }}
@@ -272,7 +292,7 @@ export default function InvoicesPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1000 }}
+        scroll={{ x: 'max-content' }}
         rowClassName={(r) => (r.overdue ? 'ant-table-row-overdue' : '')}
         pagination={{
           current: page,
@@ -324,6 +344,11 @@ export default function InvoicesPage() {
             <Descriptions.Item label="发票类型">
               {INVOICE_KIND_LABELS[detail.invoiceKind]}
             </Descriptions.Item>
+            <Descriptions.Item label="类型">
+              {detail.invoiceCategory
+                ? INVOICE_CATEGORY_LABELS[detail.invoiceCategory]
+                : '—'}
+            </Descriptions.Item>
             <Descriptions.Item label="抬头名称">{detail.titleName}</Descriptions.Item>
             <Descriptions.Item label="税号">{detail.taxNo ?? '—'}</Descriptions.Item>
             <Descriptions.Item label="地址电话">{detail.addressPhone ?? '—'}</Descriptions.Item>
@@ -382,6 +407,18 @@ export default function InvoicesPage() {
               }}
             />
           </Form.Item>
+          <Form.Item
+            name="invoiceCategory"
+            label="类型"
+            rules={[{ required: true, message: '请选择类型' }]}
+          >
+            <Select
+              options={(Object.keys(INVOICE_CATEGORY_LABELS) as InvoiceCategory[]).map((k) => ({
+                value: k,
+                label: INVOICE_CATEGORY_LABELS[k],
+              }))}
+            />
+          </Form.Item>
           <Form.Item
             name="titleType"
             label="抬头类型"

apps/admin-web/src/pages/KnowledgeBasesPage.tsx

@@ -25,6 +25,8 @@ import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
 import { uploadFileToOss } from '../lib/upload';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type FormValues = {
   name: string;
@@ -124,9 +126,9 @@ export default function KnowledgeBasesPage() {
     }
   };
 
-  const columns: ColumnsType<KnowledgeBaseDto> = [
+  const baseColumns: ColumnsType<KnowledgeBaseDto> = [
     { title: '名称', dataIndex: 'name' },
-    { title: '说明', dataIndex: 'description', ellipsis: true },
+    { title: '说明', dataIndex: 'description' },
     { title: '文档数', dataIndex: 'documentCount', width: 90 },
     {
       title: '启用',
@@ -184,7 +186,7 @@ export default function KnowledgeBasesPage() {
 
   const docColumns: ColumnsType<KnowledgeDocumentDto> = [
     { title: '标题', dataIndex: 'title' },
-    { title: '文件', dataIndex: 'fileName', ellipsis: true },
+    { title: '文件', dataIndex: 'fileName' },
     {
       title: '状态',
       dataIndex: 'status',
@@ -250,12 +252,16 @@ export default function KnowledgeBasesPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('knowledge-bases', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16 }} wrap>
         <Typography.Title level={4} style={{ margin: 0 }}>
           知识库
         </Typography.Title>
+          {settingsButton}
         <Typography.Text type="secondary">
           支持粘贴文本或上传 .txt/.md；可绑定到企微机器人供 AI 检索
         </Typography.Text>

apps/admin-web/src/pages/LlmConfigsPage.tsx

@@ -25,6 +25,8 @@ import {
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type FormValues = {
   name: string;
@@ -153,7 +155,7 @@ export default function LlmConfigsPage() {
     }
   };
 
-  const columns: ColumnsType<LlmApiConfigDto> = [
+  const baseColumns: ColumnsType<LlmApiConfigDto> = [
     { title: '名称', dataIndex: 'name' },
     {
       title: '提供商',
@@ -161,7 +163,7 @@ export default function LlmConfigsPage() {
       width: 120,
       render: (p: LlmProvider) => LLM_PROVIDER_LABELS[p] || p,
     },
-    { title: '模型', dataIndex: 'modelName', ellipsis: true },
+    { title: '模型', dataIndex: 'modelName' },
     {
       title: 'Key',
       dataIndex: 'apiKeyConfigured',
@@ -257,12 +259,16 @@ export default function LlmConfigsPage() {
 
   const fullEdit = !editing || editing.canEditFull;
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('llm-configs', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16 }} wrap>
         <Typography.Title level={4} style={{ margin: 0 }}>
           语言模型配置
         </Typography.Title>
+          {settingsButton}
         <Typography.Text type="secondary">
           非超管仅可见自己创建的配置，且创建后只能改是否生效
         </Typography.Text>

apps/admin-web/src/pages/LogisticsBillsPage.tsx

@@ -29,6 +29,7 @@ import { fmtTime } from '../lib/constants';
 import { downloadExcelCsv } from '../lib/exportExcel';
 import { request } from '../lib/api';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
 
 type BillRow = {
   id: string;
@@ -44,6 +45,13 @@ type BillRow = {
   settlementMethod: string;
   status: string;
   paidAt?: string | null;
+  paymentRef?: string | null;
+  fulfillmentProvider?: {
+    bankAccountName?: string | null;
+    bankName?: string | null;
+    bankBranch?: string | null;
+    bankAccountNo?: string | null;
+  };
 };
 
 type BillItem = {
@@ -140,14 +148,30 @@ export default function LogisticsBillsPage() {
   }, [summaryPeriod]);
 
   function confirmPay(ids: string[], amountHint?: number) {
+    let paymentRef = '';
     Modal.confirm({
       title: '确认结算？',
-      content: `将确认 ${ids.length} 笔物流对账单${amountHint != null ? `，合计约 ¥${amountHint.toFixed(2)}` : ''}。充值模式将扣减余额，挂账模式标记已打款。`,
+      content: (
+        <div>
+          <div>
+            将确认 {ids.length} 笔物流对账单
+            {amountHint != null ? `，合计约 ¥${amountHint.toFixed(2)}` : ''}。充值模式将扣减余额，挂账模式标记已打款。
+          </div>
+          <Input
+            placeholder="打款凭证号（可选）"
+            style={{ marginTop: 8 }}
+            onChange={(e) => {
+              paymentRef = e.target.value;
+            }}
+          />
+        </div>
+      ),
       okText: '确认结算',
       cancelText: '取消',
       onOk: async () => {
+        const body = JSON.stringify({ paymentRef: paymentRef.trim() || undefined });
         if (ids.length === 1) {
-          await request(`/admin/logistics-bills/${ids[0]}/confirm`, { method: 'POST' });
+          await request(`/admin/logistics-bills/${ids[0]}/confirm`, { method: 'POST', body });
         } else {
           await request('/admin/logistics-bills/batch-confirm', {
             method: 'POST',
@@ -217,11 +241,12 @@ export default function LogisticsBillsPage() {
   }
 
   const summary = data?.summary;
+  const providerBank = (r: BillRow) => r.fulfillmentProvider;
   const selectedRows = (data?.items ?? []).filter((r) => selectedKeys.includes(r.id));
   const selectedAmount = selectedRows.reduce((s, r) => s + Number(r.logisticsAmount), 0);
 
   const billColumns: ColumnsType<BillRow> = [
-    { title: '账单号', dataIndex: 'billNo', width: 170, ellipsis: true },
+    { title: '账单号', dataIndex: 'billNo', width: 170 },
     {
       title: '承运商',
       width: 140,
@@ -248,6 +273,16 @@ export default function LogisticsBillsPage() {
       width: 110,
       render: (v) => `¥${Number(v).toFixed(2)}`,
     },
+    {
+      title: '收款户名',
+      width: 100,
+      render: (_, r) => providerBank(r)?.bankAccountName || '—',
+    },
+    {
+      title: '收款账号',
+      width: 140,
+      render: (_, r) => providerBank(r)?.bankAccountNo || '—',
+    },
     {
       title: '状态',
       dataIndex: 'status',
@@ -303,7 +338,6 @@ export default function LogisticsBillsPage() {
     {
       title: '银行账户',
       width: 180,
-      ellipsis: true,
       render: (_, r) =>
         r.bankAccountName
           ? `${r.bankAccountName} / ${r.bankName || ''} ${r.bankAccountNo || ''}`
@@ -355,12 +389,19 @@ export default function LogisticsBillsPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('finance-logistics-bills', billColumns, {
+    page,
+    pageSize,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Space direction="vertical" size={0} style={{ marginBottom: 16 }}>
         <Typography.Title level={4} style={{ margin: 0 }}>
           物流对账
         </Typography.Title>
+        {settingsButton}
         <Typography.Text type="secondary">
           按快递承运商汇总月度物流费；计价与银行账户在「仓配管理」配置。前期充值扣款，后期可切挂账月结。
         </Typography.Text>
@@ -501,7 +542,7 @@ export default function LogisticsBillsPage() {
                 <Table
                   rowKey="id"
                   loading={loading}
-                  columns={billColumns}
+                  columns={columns}
                   dataSource={data?.items ?? []}
                   rowSelection={{
                     selectedRowKeys: selectedKeys,
@@ -550,7 +591,31 @@ export default function LogisticsBillsPage() {
               <Descriptions.Item label="结算时间">
                 {detail.paidAt ? fmtTime(detail.paidAt) : '—'}
               </Descriptions.Item>
+              <Descriptions.Item label="打款凭证">
+                {detail.paymentRef ? String(detail.paymentRef) : '—'}
+              </Descriptions.Item>
             </Descriptions>
+            {providerBank(detail) ? (
+              <>
+                <Typography.Title level={5} style={{ marginTop: 16 }}>
+                  收款账户
+                </Typography.Title>
+                <Descriptions column={1} size="small" bordered style={{ marginBottom: 16 }}>
+                  <Descriptions.Item label="户名">
+                    {providerBank(detail)?.bankAccountName || '—'}
+                  </Descriptions.Item>
+                  <Descriptions.Item label="开户银行">
+                    {providerBank(detail)?.bankName || '—'}
+                  </Descriptions.Item>
+                  <Descriptions.Item label="开户支行">
+                    {providerBank(detail)?.bankBranch || '—'}
+                  </Descriptions.Item>
+                  <Descriptions.Item label="账号">
+                    {providerBank(detail)?.bankAccountNo || '—'}
+                  </Descriptions.Item>
+                </Descriptions>
+              </>
+            ) : null}
             <Table
               rowKey="id"
               size="small"

apps/admin-web/src/pages/OrdersPage.tsx

@@ -4,7 +4,9 @@ import {
   Alert,
   Button,
   Checkbox,
+  Col,
   Collapse,
+  DatePicker,
   Descriptions,
   Drawer,
   Form,
@@ -12,6 +14,7 @@ import {
   InputNumber,
   Modal,
   Radio,
+  Row,
   Select,
   Space,
   Table,
@@ -20,7 +23,11 @@ import {
   message,
 } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
+import dayjs, { type Dayjs } from 'dayjs';
+import { ORDER_TYPE_LABELS } from '@dukang/shared-types';
 import { request, type AdminOrderItem, type AdminOrderRow, type HqProfile, type Paginated } from '../lib/api';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+import { downloadBase64File } from '../lib/exportExcel';
 import {
   ADMIN_OPTIONS_PAGE_SIZE,
   DELIVERY_PROVIDER_LABELS,
@@ -130,6 +137,110 @@ type OrderDetail = AdminOrderRow & {
 
 type ShipMode = 'WAREHOUSE' | 'EXPRESS';
 
+type OrderExportScope = 'filter' | 'selected';
+type OrderExportFormat = 'xlsx' | 'pdf';
+
+type OrderExportFilters = {
+  orderNo?: string;
+  status?: string;
+  orderType?: string;
+  cityId?: string;
+  receiverPhone?: string;
+  fulfillmentHold?: boolean;
+  excludeTest?: boolean;
+  deliveryType?: string;
+  dateRange?: [Dayjs, Dayjs];
+};
+
+type OrderExportResult = {
+  filename: string;
+  mimeType: string;
+  contentBase64: string;
+  count: number;
+};
+
+const ORDER_TYPE_OPTIONS = Object.entries(ORDER_TYPE_LABELS).map(([value, label]) => ({ value, label }));
+
+const DELIVERY_TYPE_OPTIONS = [
+  { value: 'LOCAL', label: '同城' },
+  { value: 'CROSS_CITY', label: '跨城' },
+  { value: 'ON_SITE_PICKUP', label: '现场提货' },
+];
+
+function isOnSitePickupOrder(row: Pick<AdminOrderRow, 'deliveryType' | 'receiverProvince' | 'receiverCity' | 'receiverAddress'>) {
+  return (
+    row.deliveryType === 'ON_SITE_PICKUP' ||
+    row.receiverAddress === '现场取货' ||
+    row.receiverAddress === '现场提货' ||
+    (row.receiverProvince === '现场' && row.receiverCity === '现场')
+  );
+}
+
+function formatReceiverAddress(row: AdminOrderRow) {
+  if (isOnSitePickupOrder(row)) return '现场取货';
+  const region = [row.receiverProvince, row.receiverCity, row.receiverDistrict].filter(Boolean).join('');
+  const detail = row.receiverAddress || '';
+  if (!region) return detail;
+  if (!detail || detail.startsWith(region)) return detail || region;
+  return `${region}${detail}`;
+}
+
+function datePresetRange(kind: 'day' | 'week' | 'month' | 'quarter' | 'year'): [Dayjs, Dayjs] {
+  const now = dayjs();
+  if (kind === 'day') return [now.startOf('day'), now.endOf('day')];
+  if (kind === 'week') {
+    const monday = now.startOf('day').subtract((now.day() + 6) % 7, 'day');
+    return [monday, monday.add(6, 'day').endOf('day')];
+  }
+  if (kind === 'month') return [now.startOf('month'), now.endOf('month')];
+  if (kind === 'quarter') {
+    const start = now.month(Math.floor(now.month() / 3) * 3).startOf('month');
+    return [start, start.add(2, 'month').endOf('month')];
+  }
+  return [now.startOf('year'), now.endOf('year')];
+}
+
+const DATE_PRESETS: Array<{ key: 'day' | 'week' | 'month' | 'quarter' | 'year'; label: string }> = [
+  { key: 'day', label: '当日' },
+  { key: 'week', label: '当周' },
+  { key: 'month', label: '当月' },
+  { key: 'quarter', label: '当季' },
+  { key: 'year', label: '当年' },
+];
+
+function formatBenefitBrief(row: AdminOrderRow) {
+  const coupon = row.benefitCoupon;
+  if (coupon) {
+    return `总额¥${Number(coupon.totalAmount ?? 0).toFixed(0)} / 已用¥${Number(coupon.usedAmount ?? 0).toFixed(0)} / 余¥${Number(coupon.balance ?? 0).toFixed(0)}`;
+  }
+  if (row.benefitAmount != null) return `¥${Number(row.benefitAmount).toFixed(0)}`;
+  return '—';
+}
+
+function buildExportPayload(
+  scope: OrderExportScope,
+  format: OrderExportFormat,
+  filters: OrderExportFilters,
+  selectedIds: string[],
+) {
+  const payload: Record<string, unknown> = { scope, format };
+  if (scope === 'selected') {
+    payload.ids = selectedIds;
+    return payload;
+  }
+  if (filters.orderNo) payload.orderNo = filters.orderNo;
+  if (filters.status) payload.status = filters.status;
+  if (filters.orderType) payload.orderType = filters.orderType;
+  if (filters.cityId) payload.cityId = filters.cityId;
+  if (filters.receiverPhone) payload.receiverPhone = filters.receiverPhone;
+  if (filters.deliveryType) payload.deliveryType = filters.deliveryType;
+  if (filters.fulfillmentHold) payload.fulfillmentHold = true;
+  if (filters.excludeTest) payload.excludeTest = true;
+  if (filters.dateRange?.[0]) payload.createdFrom = filters.dateRange[0].format('YYYY-MM-DD');
+  if (filters.dateRange?.[1]) payload.createdTo = filters.dateRange[1].format('YYYY-MM-DD');
+  return payload;
+}
+
 function orderProductRows(detail: OrderDetail): AdminOrderItem[] {
   if (detail.items?.length) return detail.items;
   if (!detail.productName) return [];
@@ -192,8 +303,11 @@ export default function OrdersPage() {
   const [warehouses, setWarehouses] = useState<WarehouseOption[]>([]);
   const [proxyOpen, setProxyOpen] = useState(false);
   const [trackOpen, setTrackOpen] = useState(false);
+  const [exporting, setExporting] = useState(false);
+  const [exportFormat, setExportFormat] = useState<OrderExportFormat>('xlsx');
   const canDeleteOrders = (profile?.permissionKeys ?? []).includes('orders_delete');
   const canProxyOrder = (profile?.permissionKeys ?? []).includes('orders');
+  const canExportOrders = (profile?.permissionKeys ?? []).includes('orders');
 
   const selectedOrders = useMemo(
     () => (data?.items ?? []).filter((row) => selectedRowKeys.includes(row.id)),
@@ -238,6 +352,7 @@ export default function OrdersPage() {
     try {
       const values = form.getFieldsValue();
       const qs = new URLSearchParams({ page: String(page), pageSize: String(pageSize) });
+      if (initialOrderNo) qs.set('orderNo', initialOrderNo);
       if (values.orderNo) qs.set('orderNo', values.orderNo);
       if (values.status) qs.set('status', values.status);
       if (values.orderType) qs.set('orderType', values.orderType);
@@ -245,12 +360,15 @@ export default function OrdersPage() {
       if (values.receiverPhone) qs.set('receiverPhone', values.receiverPhone);
       if (values.fulfillmentHold) qs.set('fulfillmentHold', 'true');
       if (values.excludeTest) qs.set('excludeTest', 'true');
+      if (values.deliveryType) qs.set('deliveryType', values.deliveryType);
+      if (values.dateRange?.[0]) qs.set('createdFrom', values.dateRange[0].format('YYYY-MM-DD'));
+      if (values.dateRange?.[1]) qs.set('createdTo', values.dateRange[1].format('YYYY-MM-DD'));
       const res = await request<Paginated<AdminOrderRow>>(`/admin/orders?${qs}`);
       setData(res);
     } finally {
       setLoading(false);
     }
-  }, [form, page, pageSize]);
+  }, [form, page, pageSize, initialOrderNo]);
 
   useEffect(() => {
     void load();
@@ -451,79 +569,93 @@ export default function OrdersPage() {
     }
   }
 
-  const columns: ColumnsType<AdminOrderRow> = [
-    {
-      title: '订单号',
-      dataIndex: 'orderNo',
-      width: 200,
-      render: (v, row) => (
-        <Space size={4}>
-          <span>{v}</span>
-          {row.isTest ? <Tag color="orange">测试</Tag> : null}
-        </Space>
-      ),
-    },
-    {
-      title: '城市',
-      width: 90,
-      render: (_, row) => row.city?.name || '—',
-    },
+  async function submitExport(scope: OrderExportScope) {
+    const values = form.getFieldsValue() as OrderExportFilters;
+    if (scope === 'selected' && !selectedRowKeys.length) {
+      message.warning('请先勾选要导出的订单');
+      return;
+    }
+    setExporting(true);
+    try {
+      const payload = buildExportPayload(scope, exportFormat, values, selectedRowKeys);
+      const result = await request<OrderExportResult>('/admin/orders/export', {
+        method: 'POST',
+        body: JSON.stringify(payload),
+      });
+      downloadBase64File(result.contentBase64, result.filename, result.mimeType);
+      message.success(`已导出 ${result.count} 条订单`);
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '导出失败');
+    } finally {
+      setExporting(false);
+    }
+  }
+
+  const baseColumns: ColumnsType<AdminOrderRow> = [
     {
       title: '商品',
-      width: 180,
-      ellipsis: true,
-      render: (_, row) => {
-        const name = row.productName || '—';
-        const qty = row.quantity != null ? ` ×${row.quantity}` : '';
-        return (
-          <span title={row.productSpec ? `${name}（${row.productSpec}）` : name}>
-            {name}{qty}
-          </span>
-        );
-      },
-    },
-    {
-      title: '状态',
-      dataIndex: 'status',
-      width: 140,
-      render: (s, row) => (
-        <Space size={4} wrap>
-          <Tag color={ORDER_STATUS_COLORS[s] || 'default'}>{ORDER_STATUS_LABELS[s] || s}</Tag>
-          {row.fulfillmentHold ? <Tag color="orange">大单待确认</Tag> : null}
-          {row.orderType === 'PROXY' || row.isProxyOrder ? (
-            <Tag color="purple" title={row.proxyPartnerName || undefined}>
-              代下单
-            </Tag>
-          ) : null}
-        </Space>
+      width: 240,
+      render: (_, row) => (
+        <div>
+          <Space size={4} wrap>
+            <span>{row.productName || '—'}</span>
+            {row.isTest ? <Tag color="orange">测试</Tag> : null}
+            {row.fulfillmentHold ? <Tag color="orange">大单</Tag> : null}
+            {row.orderType === 'PROXY' || row.isProxyOrder ? (
+              <Tag color="purple">代下单</Tag>
+            ) : null}
+          </Space>
+          <div>
+            <Typography.Text type="secondary" style={{ fontSize: 12 }}>
+              {[row.productSpec, row.quantity != null ? `×${row.quantity}` : null]
+                .filter(Boolean)
+                .join(' ')}
+            </Typography.Text>
+          </div>
+        </div>
       ),
     },
     {
-      title: '配送',
-      dataIndex: 'deliveryType',
-      width: 90,
-      render: (v) =>
-        v === 'ON_SITE_PICKUP' ? '现场提货' : v === 'LOCAL' ? '同城' : '跨城',
-    },
-    { title: '实付', dataIndex: 'payAmount', width: 90, render: (v) => `¥${v}` },
-    { title: '收货人', dataIndex: 'receiverName', width: 90 },
-    { title: '手机', dataIndex: 'receiverPhone', width: 120 },
-    {
-      title: '用户',
-      dataIndex: ['user', 'userNo'],
-      width: 110,
-      render: (_, row) => row.user?.userNo || '—',
+      title: '状态 / 实付',
+      width: 130,
+      render: (_, row) => (
+        <div>
+          <Tag color={ORDER_STATUS_COLORS[row.status] || 'default'}>
+            {ORDER_STATUS_LABELS[row.status] || row.status}
+          </Tag>
+          <div>¥{row.payAmount}</div>
+        </div>
+      ),
     },
     {
-      title: '快递',
-      width: 100,
-      render: (_, row) => row.delivery?.trackingNo || row.delivery?.provider || '—',
+      title: '好客权益',
+      width: 200,
+      render: (_, row) => formatBenefitBrief(row),
+    },
+    {
+      title: '收货信息',
+      width: 240,
+      render: (_, row) => {
+        const address = formatReceiverAddress(row);
+        return (
+          <div>
+            <div>
+              {row.receiverName || '—'} {row.receiverPhone || ''}
+            </div>
+            {address ? (
+              <Typography.Text type="secondary" style={{ fontSize: 12 }}>
+                {address}
+              </Typography.Text>
+            ) : null}
+          </div>
+        );
+      },
     },
     {
       title: '下单时间',
       dataIndex: 'createdAt',
       width: 170,
-      render: (v) => new Date(v).toLocaleString('zh-CN'),
+      render: fmtTime,
     },
     {
       title: '操作',
@@ -555,26 +687,24 @@ export default function OrdersPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('orders', baseColumns, {
+    page,
+    pageSize,
+  });
+
   return (
     <div>
-      <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
+      {settingsModal}
+      <Space style={{ marginBottom: 20, width: '100%', justifyContent: 'space-between' }}>
         <Typography.Title level={4} style={{ margin: 0 }}>订单监控</Typography.Title>
-        <Space>
+        <Space size={12}>
+          {settingsButton}
           <Button onClick={() => window.open('/orders/big-screen', 'dukang-big-screen')}>大屏</Button>
           {canProxyOrder ? (
             <Button type="primary" onClick={() => setProxyOpen(true)}>
               代下单
             </Button>
           ) : null}
-          {canDeleteOrders ? (
-            <Button
-              danger
-              disabled={!selectedRowKeys.length}
-              onClick={() => setBatchDeleteOpen(true)}
-            >
-              批量删除{selectedRowKeys.length ? ` (${selectedRowKeys.length})` : ''}
-            </Button>
-          ) : null}
         </Space>
       </Space>
 
@@ -592,54 +722,115 @@ export default function OrdersPage() {
         />
       ) : null}
 
-      <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={() => { setPage(1); void load(); }}>
-        <Form.Item name="orderNo" label="订单号">
-          <Input placeholder="DK..." allowClear />
-        </Form.Item>
-        <Form.Item name="status" label="状态">
-          <Select allowClear style={{ width: 120 }} options={Object.entries(ORDER_STATUS_LABELS).map(([value, label]) => ({ value, label }))} />
-        </Form.Item>
-        <Form.Item name="orderType" label="类型">
-          <Select
-            allowClear
-            style={{ width: 120 }}
-            placeholder="全部"
-            options={[
-              { value: 'NORMAL', label: '普通订单' },
-              { value: 'PROXY', label: '代下单' },
-            ]}
-          />
-        </Form.Item>
-        <Form.Item name="cityId" label="城市">
-          <Select
-            allowClear
-            showSearch
-            optionFilterProp="label"
-            style={{ width: 140 }}
-            placeholder="全部"
-            options={cities.map((c) => ({ value: c.id, label: c.name }))}
-          />
-        </Form.Item>
-        <Form.Item name="receiverPhone" label="收货手机">
-          <Input allowClear />
-        </Form.Item>
-        <Form.Item name="fulfillmentHold" label="大单拦截" valuePropName="checked">
-          <Select
-            allowClear
-            style={{ width: 140 }}
-            placeholder="全部"
-            options={[{ value: true, label: '仅待确认大单' }]}
-          />
-        </Form.Item>
-        <Form.Item name="excludeTest" valuePropName="checked">
-          <Checkbox>过滤测试账号</Checkbox>
-        </Form.Item>
-        <Form.Item>
-          <Space>
+      <Form form={form} layout="vertical" onFinish={() => { setPage(1); void load(); }}>
+        <Row gutter={[16, 8]}>
+          <Col xs={24} md={14} lg={12}>
+            <Form.Item label="下单日期" style={{ marginBottom: 12 }}>
+              <Space direction="vertical" size={8} style={{ width: '100%' }}>
+                <Form.Item name="dateRange" noStyle>
+                  <DatePicker.RangePicker allowClear style={{ width: '100%' }} />
+                </Form.Item>
+                <Space size={8} wrap>
+                  {DATE_PRESETS.map((preset) => (
+                    <Button
+                      key={preset.key}
+                      size="small"
+                      onClick={() => form.setFieldsValue({ dateRange: datePresetRange(preset.key) })}
+                    >
+                      {preset.label}
+                    </Button>
+                  ))}
+                </Space>
+              </Space>
+            </Form.Item>
+          </Col>
+          <Col xs={12} sm={6} md={5} lg={3}>
+            <Form.Item name="status" label="状态" style={{ marginBottom: 12 }}>
+              <Select
+                allowClear
+                placeholder="全部"
+                options={Object.entries(ORDER_STATUS_LABELS).map(([value, label]) => ({ value, label }))}
+              />
+            </Form.Item>
+          </Col>
+          <Col xs={12} sm={6} md={5} lg={3}>
+            <Form.Item name="orderType" label="类型" style={{ marginBottom: 12 }}>
+              <Select allowClear placeholder="全部" options={ORDER_TYPE_OPTIONS} />
+            </Form.Item>
+          </Col>
+          <Col xs={12} sm={6} md={5} lg={3}>
+            <Form.Item name="deliveryType" label="配送" style={{ marginBottom: 12 }}>
+              <Select allowClear placeholder="全部" options={DELIVERY_TYPE_OPTIONS} />
+            </Form.Item>
+          </Col>
+          <Col xs={12} sm={6} md={5} lg={3}>
+            <Form.Item name="cityId" label="城市" style={{ marginBottom: 12 }}>
+              <Select
+                allowClear
+                showSearch
+                optionFilterProp="label"
+                placeholder="全部"
+                options={cities.map((c) => ({ value: c.id, label: c.name }))}
+              />
+            </Form.Item>
+          </Col>
+          <Col xs={12} sm={8} md={6} lg={6}>
+            <Form.Item name="receiverPhone" label="收货手机" style={{ marginBottom: 12 }}>
+              <Input allowClear placeholder="手机号" />
+            </Form.Item>
+          </Col>
+          <Col xs={12} sm={8} md={8} lg={8}>
+            <Form.Item label=" " colon={false} style={{ marginBottom: 12 }}>
+              <Space size={16} wrap>
+                <Form.Item name="fulfillmentHold" valuePropName="checked" noStyle>
+                  <Checkbox>大单拦截</Checkbox>
+                </Form.Item>
+                <Form.Item name="excludeTest" valuePropName="checked" noStyle>
+                  <Checkbox>过滤测试</Checkbox>
+                </Form.Item>
+              </Space>
+            </Form.Item>
+          </Col>
+        </Row>
+
+        <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', margin: '8px 0 16px', gap: 12, flexWrap: 'wrap' }}>
+          {canExportOrders ? (
+            <Space size={12} wrap>
+              <Radio.Group
+                optionType="button"
+                buttonStyle="solid"
+                value={exportFormat}
+                onChange={(e) => setExportFormat(e.target.value)}
+              >
+                <Radio.Button value="xlsx">Excel</Radio.Button>
+                <Radio.Button value="pdf">PDF</Radio.Button>
+              </Radio.Group>
+              <Button
+                disabled={!selectedRowKeys.length}
+                loading={exporting}
+                onClick={() => void submitExport('selected')}
+              >
+                导出已勾选{selectedRowKeys.length ? `（${selectedRowKeys.length}）` : ''}
+              </Button>
+              <Button loading={exporting} onClick={() => void submitExport('filter')}>
+                导出全部筛选
+              </Button>
+            </Space>
+          ) : <span />}
+          <Space size={12} wrap>
             <Button type="primary" htmlType="submit">查询</Button>
             <Button onClick={() => { form.resetFields(); setPage(1); void load(); }}>重置</Button>
+            {canDeleteOrders ? (
+              <Button
+                danger
+                disabled={!selectedRowKeys.length}
+                onClick={() => setBatchDeleteOpen(true)}
+              >
+                批量删除{selectedRowKeys.length ? `（${selectedRowKeys.length}）` : ''}
+              </Button>
+            ) : null}
           </Space>
-        </Form.Item>
+        </div>
       </Form>
 
       <Table
@@ -647,16 +838,18 @@ export default function OrdersPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1500 }}
-        rowSelection={canDeleteOrders ? {
+        scroll={{ x: 'max-content' }}
+        rowSelection={{
           selectedRowKeys,
+          preserveSelectedRowKeys: true,
           onChange: (keys) => setSelectedRowKeys(keys as string[]),
-        } : undefined}
+        }}
         pagination={{
           current: page,
           pageSize,
           total: data?.total ?? 0,
           showSizeChanger: true,
+          showTotal: (total) => `共 ${total} 条`,
           onChange: (p, ps) => {
             setPage(p);
             setPageSize(ps);
@@ -829,7 +1022,7 @@ export default function OrdersPage() {
                   locale={{ emptyText: '暂无关联核销单' }}
                   dataSource={detail.redeemRecords ?? []}
                   columns={[
-                    { title: '核销号', dataIndex: 'redeemNo', width: 160, ellipsis: true },
+                    { title: '核销号', dataIndex: 'redeemNo', width: 160 },
                     {
                       title: '角色',
                       dataIndex: 'role',
@@ -840,7 +1033,6 @@ export default function OrdersPage() {
                     {
                       title: '门店',
                       dataIndex: ['store', 'name'],
-                      ellipsis: true,
                       render: (v: string | undefined, row) =>
                         v ? `${v}${row.store?.cityName ? `（${row.store.cityName}）` : ''}` : '—',
                     },
@@ -956,7 +1148,6 @@ export default function OrdersPage() {
                     {
                       title: '备注',
                       dataIndex: 'remark',
-                      ellipsis: true,
                       render: (v) => v || '—',
                     },
                     {
@@ -1251,7 +1442,6 @@ export default function OrdersPage() {
             {
               title: '商品',
               width: 160,
-              ellipsis: true,
               render: (_, row) =>
                 row.productName
                   ? `${row.productName}${row.quantity != null ? ` ×${row.quantity}` : ''}`

apps/admin-web/src/pages/PartnerAccountsPage.tsx

@@ -7,6 +7,8 @@ import { PARTNER_PERMISSION_KEYS, PARTNER_PERMISSION_LABELS, PARTNER_STAFF_ROLE_
 import { request, type Paginated } from '../lib/api';
 import { AdminCellLine } from '../components/AdminCellLine';
 import { ACCOUNT_STATUS_LABELS, ADMIN_OPTIONS_PAGE_SIZE, ORDER_STATUS_LABELS, PARTNER_BILL_STATUS_LABELS, fmtTime } from '../lib/constants';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type PartnerOption = { id: string; companyName: string };
 type ParentAccount = { id: string; name: string; phone: string };
@@ -169,11 +171,10 @@ export default function PartnerAccountsPage() {
     return keys;
   }
 
-  const columns: ColumnsType<AccountTreeRow> = [
+  const baseColumns: ColumnsType<AccountTreeRow> = [
     {
       title: '姓名 / 类型',
       width: 200,
-      ellipsis: true,
       render: (_, row) => (
         <AdminCellLine
           primary={row.name}
@@ -189,7 +190,6 @@ export default function PartnerAccountsPage() {
     {
       title: '开城合伙人',
       width: 140,
-      ellipsis: true,
       render: (_, row) => row.companyName || row.parent?.name || '—',
     },
     {
@@ -254,11 +254,18 @@ export default function PartnerAccountsPage() {
     { title: '下单', dataIndex: 'createdAt', width: 160, render: fmtTime },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('partner-accounts', baseColumns, {
+    page: 1,
+    pageSize: treeData.length || 20,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
         <div>
           <Typography.Title level={4} style={{ margin: 0 }}>合伙人子账号</Typography.Title>
+          {settingsButton}
           <Typography.Text type="secondary">
             主账号在「开城合伙人」创建；此处仅管理子账号树与权限
           </Typography.Text>
@@ -305,7 +312,7 @@ export default function PartnerAccountsPage() {
         loading={loading}
         columns={columns}
         dataSource={treeData}
-        scroll={{ x: 1200 }}
+        scroll={{ x: 'max-content' }}
         pagination={false}
         expandable={{
           expandedRowKeys,
@@ -399,7 +406,7 @@ export default function PartnerAccountsPage() {
               label: `账单 (${detail.bills?.length ?? 0})`,
               children: (
                 <Table rowKey="id" className="admin-table-nowrap" size="small" columns={billColumns}
-                  dataSource={detail.bills ?? []} pagination={false} scroll={{ x: 700 }} />
+                  dataSource={detail.bills ?? []} pagination={false} scroll={{ x: 'max-content' }} />
               ),
             },
             {
@@ -407,7 +414,7 @@ export default function PartnerAccountsPage() {
               label: `名下订单 (${detail.orders?.length ?? 0})`,
               children: (
                 <Table rowKey="id" className="admin-table-nowrap" size="small" columns={orderColumns}
-                  dataSource={detail.orders ?? []} pagination={false} scroll={{ x: 650 }} />
+                  dataSource={detail.orders ?? []} pagination={false} scroll={{ x: 'max-content' }} />
               ),
             },
           ]} />

apps/admin-web/src/pages/PartnerLogsPage.tsx

@@ -1,234 +1,237 @@
-import { useEffect, useState } from 'react';
-import { Button, Descriptions, Drawer, Form, Input, Segmented, Space, Table, Tag, Typography } from 'antd';
-import type { ColumnsType } from 'antd/es/table';
-import { useSearchParams } from 'react-router-dom';
-import {
-  PARTNER_LOG_CATEGORY_OPTIONS,
-  PARTNER_LOG_CATEGORY_LABELS,
-  PARTNER_STAFF_ROLE_LABELS,
-  resolvePartnerLogCategory,
-  type PartnerLogCategory,
-  type PartnerStaffRole,
-} from '@dukang/shared-types';
-import { request } from '../lib/api';
-import { AdminCellLine } from '../components/AdminCellLine';
-import { fmtTime } from '../lib/constants';
+import { useEffect, useState } from 'react';
+import { Button, Descriptions, Drawer, Form, Input, Segmented, Space, Table, Tag, Typography } from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import { useSearchParams } from 'react-router-dom';
+import {
+  PARTNER_LOG_CATEGORY_OPTIONS,
+  PARTNER_LOG_CATEGORY_LABELS,
+  PARTNER_STAFF_ROLE_LABELS,
+  resolvePartnerLogCategory,
+  type PartnerLogCategory,
+  type PartnerStaffRole,
+} from '@dukang/shared-types';
+import { request } from '../lib/api';
+import { AdminCellLine } from '../components/AdminCellLine';
+import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
+
+type Row = {
+  id: string;
+  partnerId: string;
+  partnerAccountId: string | null;
+  accountName: string | null;
+  accountPhone: string | null;
+  companyName: string | null;
+  isSubAccount?: boolean;
+  staffRole?: string | null;
+  category: PartnerLogCategory | null;
+  eventName: string;
+  clientApp: string | null;
+  refType: string | null;
+  refId: string | null;
+  extraJson: Record<string, unknown> | null;
+  createdAt: string;
+};
+
+function summarizeExtra(json: Record<string, unknown> | null) {
+  if (!json) return '—';
+  const text = JSON.stringify(json);
+  return text.length > 80 ? `${text.slice(0, 80)}…` : text;
+}
+
+export default function PartnerLogsPage() {
+  const [searchParams, setSearchParams] = useSearchParams();
+  const [form] = Form.useForm();
+  const [category, setCategory] = useState(searchParams.get('category') ?? '');
+  const [filters, setFilters] = useState<Record<string, string>>(() => ({
+    partnerId: searchParams.get('partnerId') ?? '',
+    partnerAccountId: searchParams.get('partnerAccountId') ?? '',
+    phone: searchParams.get('phone') ?? '',
+    companyName: searchParams.get('companyName') ?? '',
+    eventName: searchParams.get('eventName') ?? '',
+  }));
+  const { data, loading, page, pageSize, setPage, setPageSize } = useAdminList<Row>(
+    '/admin/logs/partners',
+    () => {
+      const qs = new URLSearchParams();
+      if (filters.partnerId) qs.set('partnerId', filters.partnerId);
+      if (filters.partnerAccountId) qs.set('partnerAccountId', filters.partnerAccountId);
+      if (filters.phone) qs.set('phone', filters.phone);
+      if (filters.companyName) qs.set('companyName', filters.companyName);
+      if (filters.eventName) qs.set('eventName', filters.eventName);
+      if (category) qs.set('category', category);
+      return qs;
+    },
+    [filters, category],
+  );
+  const [detail, setDetail] = useState<Record<string, unknown> | null>(null);
+  const [drawerOpen, setDrawerOpen] = useState(false);
+
+  useEffect(() => {
+    form.setFieldsValue(filters);
+  }, [form, filters]);
+
+  const baseColumns: ColumnsType<Row> = [
+    { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
+    {
+      title: '合伙人',
+      width: 180,
+
+      render: (_, r) => (
+        r.isSubAccount ? (
+          <Tag color="blue">子账号</Tag>
+        ) : (
+          <AdminCellLine primary={r.companyName} secondary={r.partnerId} />
+        )
+      ),
+    },
+    {
+      title: '账号',
+      width: 150,
+
+      render: (_, r) => (
+        <AdminCellLine
+          primary={r.accountName}
+          secondary={
+            r.isSubAccount && r.staffRole
+              ? `${r.accountPhone || ''} · ${PARTNER_STAFF_ROLE_LABELS[r.staffRole as PartnerStaffRole] || r.staffRole}`
+              : r.accountPhone || r.partnerAccountId
+          }
+        />
+      ),
+    },
+    {
+      title: '分类',
+      dataIndex: 'category',
+      width: 100,
+      render: (v: PartnerLogCategory | null, r) => (
+        <Tag>{PARTNER_LOG_CATEGORY_LABELS[v ?? ''] || resolvePartnerLogCategory(r.eventName) || '其他'}</Tag>
+      ),
+    },
+    { title: '事件', dataIndex: 'eventName', width: 180 },
+    {
+      title: '关联',
+      width: 120,
+      render: (_, r) => (r.refType && r.refId ? `${r.refType}#${r.refId}` : '—'),
+    },
+    {
+      title: '摘要',
+
+      render: (_, r) => summarizeExtra(r.extraJson),
+    },
+    {
+      title: '操作',
+      width: 80,
+      render: (_, row) => (
+        <Button
+          type="link"
+          size="small"
+          onClick={async () => {
+            setDetail(await request(`/admin/logs/partners/${row.id}`));
+            setDrawerOpen(true);
+          }}
+        >
+          详情
+        </Button>
+      ),
+    },
   ];
-type Row = {
-  id: string;
-  partnerId: string;
-  partnerAccountId: string | null;
-  accountName: string | null;
-  accountPhone: string | null;
-  companyName: string | null;
-  isSubAccount?: boolean;
-  staffRole?: string | null;
-  category: PartnerLogCategory | null;
-  eventName: string;
-  clientApp: string | null;
-  refType: string | null;
-  refId: string | null;
-  extraJson: Record<string, unknown> | null;
-  createdAt: string;
-};
-
-function summarizeExtra(json: Record<string, unknown> | null) {
-  if (!json) return '—';
-  const text = JSON.stringify(json);
-  return text.length > 80 ? `${text.slice(0, 80)}…` : text;
-}
-
-export default function PartnerLogsPage() {
-  const [searchParams, setSearchParams] = useSearchParams();
-  const [form] = Form.useForm();
-  const [category, setCategory] = useState(searchParams.get('category') ?? '');
-  const [filters, setFilters] = useState<Record<string, string>>(() => ({
-    partnerId: searchParams.get('partnerId') ?? '',
-    partnerAccountId: searchParams.get('partnerAccountId') ?? '',
-    phone: searchParams.get('phone') ?? '',
-    companyName: searchParams.get('companyName') ?? '',
-    eventName: searchParams.get('eventName') ?? '',
-  }));
-  const { data, loading, page, pageSize, setPage, setPageSize } = useAdminList<Row>(
-    '/admin/logs/partners',
-    () => {
-      const qs = new URLSearchParams();
-      if (filters.partnerId) qs.set('partnerId', filters.partnerId);
-      if (filters.partnerAccountId) qs.set('partnerAccountId', filters.partnerAccountId);
-      if (filters.phone) qs.set('phone', filters.phone);
-      if (filters.companyName) qs.set('companyName', filters.companyName);
-      if (filters.eventName) qs.set('eventName', filters.eventName);
-      if (category) qs.set('category', category);
-      return qs;
-    },
-    [filters, category],
-  );
-  const [detail, setDetail] = useState<Record<string, unknown> | null>(null);
-  const [drawerOpen, setDrawerOpen] = useState(false);
-
-  useEffect(() => {
-    form.setFieldsValue(filters);
-  }, [form, filters]);
-
-  const columns: ColumnsType<Row> = [
-    { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
-    {
-      title: '合伙人',
-      width: 180,
-      ellipsis: true,
-      render: (_, r) => (
-        r.isSubAccount ? (
-          <Tag color="blue">子账号</Tag>
-        ) : (
-          <AdminCellLine primary={r.companyName} secondary={r.partnerId} />
-        )
-      ),
-    },
-    {
-      title: '账号',
-      width: 150,
-      ellipsis: true,
-      render: (_, r) => (
-        <AdminCellLine
-          primary={r.accountName}
-          secondary={
-            r.isSubAccount && r.staffRole
-              ? `${r.accountPhone || ''} · ${PARTNER_STAFF_ROLE_LABELS[r.staffRole as PartnerStaffRole] || r.staffRole}`
-              : r.accountPhone || r.partnerAccountId
-          }
-        />
-      ),
-    },
-    {
-      title: '分类',
-      dataIndex: 'category',
-      width: 100,
-      render: (v: PartnerLogCategory | null, r) => (
-        <Tag>{PARTNER_LOG_CATEGORY_LABELS[v ?? ''] || resolvePartnerLogCategory(r.eventName) || '其他'}</Tag>
-      ),
-    },
-    { title: '事件', dataIndex: 'eventName', width: 180 },
-    {
-      title: '关联',
-      width: 120,
-      render: (_, r) => (r.refType && r.refId ? `${r.refType}#${r.refId}` : '—'),
-    },
-    {
-      title: '摘要',
-      ellipsis: true,
-      render: (_, r) => summarizeExtra(r.extraJson),
-    },
-    {
-      title: '操作',
-      width: 80,
-      render: (_, row) => (
-        <Button
-          type="link"
-          size="small"
-          onClick={async () => {
-            setDetail(await request(`/admin/logs/partners/${row.id}`));
-            setDrawerOpen(true);
-          }}
-        >
-          详情
-        </Button>
-      ),
-    },
-  ];
-
-  return (
+
   const { columns, settingsButton, settingsModal } = useAdminListColumns('logs-partners', baseColumns, { page, pageSize });
-      <Typography.Title level={4} style={{ marginBottom: 16 }}>
-        合伙人日志
+
+  return (
+    <div>
       {settingsModal}
-      <Segmented
-        options={PARTNER_LOG_CATEGORY_OPTIONS.map((o) => ({ value: o.value, label: o.label }))}
-        value={category}
-        onChange={(v) => {
-          setCategory(String(v));
-          setPage(1);
-          setSearchParams((prev) => {
-            const next = new URLSearchParams(prev);
-            if (v) next.set('category', String(v));
-            else next.delete('category');
-            return next;
-          });
-        }}
-        style={{ marginBottom: 16 }}
-      />
-      <Form
-        form={form}
-        layout="inline"
-        style={{ marginBottom: 16, flexWrap: 'wrap', gap: 8 }}
-        onFinish={(values) => {
-          setFilters(values);
-          setPage(1);
-        }}
-      >
-        <Form.Item name="phone" label="手机号">
-          <Input placeholder="账号手机号" allowClear style={{ width: 140 }} />
-        </Form.Item>
-        <Form.Item name="companyName" label="公司">
-          <Input placeholder="合伙人公司" allowClear style={{ width: 140 }} />
-        </Form.Item>
-        <Form.Item name="partnerId" label="合伙人ID">
-          <Input placeholder="partnerId" allowClear style={{ width: 120 }} />
-        </Form.Item>
-        <Form.Item name="eventName" label="事件名">
-          <Input placeholder="partner_sms_login" allowClear style={{ width: 160 }} />
-        </Form.Item>
-        <Form.Item>
-          <Space>
-            <Button type="primary" htmlType="submit">
-              查询
-            </Button>
-            <Button
-              onClick={() => {
-                form.resetFields();
-                setFilters({
-                  partnerId: '',
-                  partnerAccountId: '',
-                  phone: '',
-                  companyName: '',
-                  eventName: '',
-                });
-                setPage(1);
-              }}
-            >
-              重置
-            </Button>
-          </Space>
-        </Form.Item>
-      </Form>
-      <Table
-        rowKey="id"
-        loading={loading}
-        columns={columns}
-        dataSource={data?.items ?? []}
-        pagination={{
-          current: page,
-          pageSize,
-          total: data?.total ?? 0,
-          showSizeChanger: true,
-          onChange: (p, ps) => {
-            setPage(p);
-            setPageSize(ps);
-          },
-        }}
-        scroll={{ x: 1100 }}
-      />
-      <Drawer title="日志详情" open={drawerOpen} onClose={() => setDrawerOpen(false)} width={520}>
-        {detail && (
-          <Descriptions column={1} bordered size="small">
-            {Object.entries(detail).map(([k, v]) => (
-              <Descriptions.Item key={k} label={k}>
-                {typeof v === 'object' ? JSON.stringify(v, null, 2) : String(v ?? '—')}
-              </Descriptions.Item>
-            ))}
-          </Descriptions>
-        )}
-      </Drawer>
-    </div>
-  );
-}
+      <Typography.Title level={4} style={{ marginBottom: 16 }}>
+        合伙人日志
+      </Typography.Title>
+          {settingsButton}
+      <Segmented
+        options={PARTNER_LOG_CATEGORY_OPTIONS.map((o) => ({ value: o.value, label: o.label }))}
+        value={category}
+        onChange={(v) => {
+          setCategory(String(v));
+          setPage(1);
+          setSearchParams((prev) => {
+            const next = new URLSearchParams(prev);
+            if (v) next.set('category', String(v));
+            else next.delete('category');
+            return next;
+          });
+        }}
+        style={{ marginBottom: 16 }}
+      />
+      <Form
+        form={form}
+        layout="inline"
+        style={{ marginBottom: 16, flexWrap: 'wrap', gap: 8 }}
+        onFinish={(values) => {
+          setFilters(values);
+          setPage(1);
+        }}
+      >
+        <Form.Item name="phone" label="手机号">
+          <Input placeholder="账号手机号" allowClear style={{ width: 140 }} />
+        </Form.Item>
+        <Form.Item name="companyName" label="公司">
+          <Input placeholder="合伙人公司" allowClear style={{ width: 140 }} />
+        </Form.Item>
+        <Form.Item name="partnerId" label="合伙人ID">
+          <Input placeholder="partnerId" allowClear style={{ width: 120 }} />
+        </Form.Item>
+        <Form.Item name="eventName" label="事件名">
+          <Input placeholder="partner_sms_login" allowClear style={{ width: 160 }} />
+        </Form.Item>
+        <Form.Item>
+          <Space>
+            <Button type="primary" htmlType="submit">
+              查询
+            </Button>
+            <Button
+              onClick={() => {
+                form.resetFields();
+                setFilters({
+                  partnerId: '',
+                  partnerAccountId: '',
+                  phone: '',
+                  companyName: '',
+                  eventName: '',
+                });
+                setPage(1);
+              }}
+            >
+              重置
+            </Button>
+          </Space>
+        </Form.Item>
+      </Form>
+      <Table
+        rowKey="id"
+        loading={loading}
+        columns={columns}
+        dataSource={data?.items ?? []}
+        pagination={{
+          current: page,
+          pageSize,
+          total: data?.total ?? 0,
+          showSizeChanger: true,
+          onChange: (p, ps) => {
+            setPage(p);
+            setPageSize(ps);
+          },
+        }}
+        scroll={{ x: 'max-content' }}
+      />
+      <Drawer title="日志详情" open={drawerOpen} onClose={() => setDrawerOpen(false)} width={520}>
+        {detail && (
+          <Descriptions column={1} bordered size="small">
+            {Object.entries(detail).map(([k, v]) => (
+              <Descriptions.Item key={k} label={k}>
+                {typeof v === 'object' ? JSON.stringify(v, null, 2) : String(v ?? '—')}
+              </Descriptions.Item>
+            ))}
+          </Descriptions>
+        )}
+      </Drawer>

apps/admin-web/src/pages/PartnersPage.tsx

@@ -1,405 +1,410 @@
-import { useCallback, useEffect, useState } from 'react';
-import {
-  Button,
-  Drawer,
-  Form,
-  Input,
-  InputNumber,
-  Modal,
-  Select,
-  Space,
-  Table,
-  Tabs,
-  Tag,
-  Typography,
-  message,
-} from 'antd';
-import type { ColumnsType } from 'antd/es/table';
-import {
-  CITY_PARTNER_SCOPE_LABELS,
-  CityPartnerScopeType,
-  PARTNER_PERMISSION_KEYS,
-  PARTNER_PERMISSION_LABELS,
-  type PartnerPermissionKey,
-} from '@dukang/shared-types';
-import { request, type Paginated } from '../lib/api';
-import { districtCodeLabel, formatDistrictLabels } from '../lib/china-region';
-import { ADMIN_OPTIONS_PAGE_SIZE, fmtTime } from '../lib/constants';
-import { useAdminList } from '../lib/useAdminList';
+import { useCallback, useEffect, useState } from 'react';
+import {
+  Button,
+  Drawer,
+  Form,
+  Input,
+  InputNumber,
+  Modal,
+  Select,
+  Space,
+  Table,
+  Tabs,
+  Tag,
+  Typography,
+  message,
+} from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import {
+  CITY_PARTNER_SCOPE_LABELS,
+  CityPartnerScopeType,
+  PARTNER_PERMISSION_KEYS,
+  PARTNER_PERMISSION_LABELS,
+  type PartnerPermissionKey,
+} from '@dukang/shared-types';
+import { request, type Paginated } from '../lib/api';
+import { districtCodeLabel, formatDistrictLabels } from '../lib/china-region';
+import { ADMIN_OPTIONS_PAGE_SIZE, fmtTime } from '../lib/constants';
+import { useAdminList } from '../lib/useAdminList';
 import CityDistrictMultiSelect from '../components/CityDistrictMultiSelect';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
+
+type Row = {
+  id: string;
+  companyName: string;
+  phone: string;
+  name: string;
+  contactPhone?: string | null;
+  cityId?: string | null;
+  cityName?: string | null;
+  scopeType?: string;
+  districtCodes?: string[] | null;
+  orderCommissionRate?: number;
+  redeemCommissionRate?: number;
+  storeCount: number;
+  accountCount: number;
+  createdAt: string;
+};
+
+type PartnerDetail = Row & {
+  address?: string;
+  districtCodes?: string[] | null;
+  bindingStatus?: string;
+  bankAccountName?: string | null;
+  bankAccountNo?: string | null;
+  bankBranch?: string | null;
+  managedWarehouseId?: string | null;
+  children?: Array<{
+    id: string;
+    phone: string;
+    name: string;
+    staffRole?: string;
+    permissions?: string[];
+    status: string;
+  }>;
+};
+
+type CityOption = { id: string; name: string; code: string };
+type WarehouseOption = { id: string; name: string };
+
+const SCOPE_OPTIONS = Object.entries(CITY_PARTNER_SCOPE_LABELS).map(([value, label]) => ({ value, label }));
+const PERM_OPTIONS = PARTNER_PERMISSION_KEYS.map((k: PartnerPermissionKey) => ({ value: k, label: PARTNER_PERMISSION_LABELS[k] }));
+
+function flattenDistrictCodes(values: string[] | string[][] | undefined): string[] {
+  if (!values?.length) return [];
+  if (Array.isArray(values[0])) {
+    return (values as string[][]).map((path) => path[path.length - 1]).filter(Boolean);
+  }
+  return values as string[];
+}
+
+export default function PartnersPage() {
+  const [form] = Form.useForm();
+  const [editForm] = Form.useForm();
+  const [createForm] = Form.useForm();
+  const [subForm] = Form.useForm();
+  const [filters, setFilters] = useState<Record<string, string>>({});
+  const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<Row>(
+    '/admin/partners',
+    () => {
+      const qs = new URLSearchParams();
+      if (filters.companyName) qs.set('companyName', filters.companyName);
+      if (filters.contactPhone) qs.set('contactPhone', filters.contactPhone);
+      return qs;
+    },
+    [filters],
+  );
+  const [detail, setDetail] = useState<PartnerDetail | null>(null);
+  const [drawerOpen, setDrawerOpen] = useState(false);
+  const [createOpen, setCreateOpen] = useState(false);
+  const [subOpen, setSubOpen] = useState(false);
+  const [cities, setCities] = useState<CityOption[]>([]);
+  const [warehouses, setWarehouses] = useState<WarehouseOption[]>([]);
+  const [createScopeType, setCreateScopeType] = useState<CityPartnerScopeType>(CityPartnerScopeType.CITY_WIDE);
+  const [editScopeType, setEditScopeType] = useState<CityPartnerScopeType>(CityPartnerScopeType.CITY_WIDE);
+  const [createCityId, setCreateCityId] = useState<string | undefined>();
+
+  const createCityCode = createCityId ? cities.find((c) => c.id === createCityId)?.code : undefined;
+  const editCityCode = detail?.cityId ? cities.find((c) => c.id === detail.cityId)?.code : undefined;
+
+  function formatApiError(err: unknown): string | null {
+    if (err && typeof err === 'object' && 'errorFields' in err) return null;
+    if (!(err instanceof Error)) return '操作失败';
+    return err.message.replace(/\b(\d{6})\b/g, (code) => {
+      const label = districtCodeLabel(code);
+      return label !== code ? `${label}(${code})` : code;
+    });
+  }
+
+  const loadCities = useCallback(async () => {
+    const res = await request<Paginated<CityOption>>(`/admin/cities?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`);
+    setCities(res.items);
+  }, []);
+
+  const loadWarehouses = useCallback(async (cityId: string) => {
+    const rows = await request<WarehouseOption[]>(`/admin/cities/${cityId}/warehouses`);
+    setWarehouses(rows.map((w) => ({ id: w.id, name: (w as { name: string }).name })));
+  }, []);
+
+  useEffect(() => {
+    void loadCities();
+  }, [loadCities]);
+
+  async function openPartner(id: string) {
+    const d = await request<PartnerDetail>(`/admin/partners/${id}`);
+    setDetail(d);
+    setEditScopeType((d.scopeType as CityPartnerScopeType) || CityPartnerScopeType.CITY_WIDE);
+    if (d.cityId) await loadWarehouses(d.cityId);
+    editForm.setFieldsValue({
+      name: d.name,
+      phone: d.phone,
+      companyName: d.companyName,
+      contactPhone: d.contactPhone ?? d.phone,
+      address: d.address ?? '',
+      scopeType: d.scopeType,
+      districtCodes: d.districtCodes ?? [],
+      orderCommissionRate: (d.orderCommissionRate ?? 0) * 100,
+      redeemCommissionRate: (d.redeemCommissionRate ?? 0.03) * 100,
+      bindingStatus: d.bindingStatus,
+      managedWarehouseId: d.managedWarehouseId,
+      bankAccountName: d.bankAccountName ?? '',
+      bankAccountNo: d.bankAccountNo ?? '',
+      bankBranch: d.bankBranch ?? '',
+    });
+    setDrawerOpen(true);
+  }
+
+  async function savePartner() {
+    if (!detail) return;
+    try {
+      const v = await editForm.validateFields();
+      const body = {
+        ...v,
+        orderCommissionRate: Number(v.orderCommissionRate ?? 0) / 100,
+        redeemCommissionRate: Number(v.redeemCommissionRate ?? 3) / 100,
+        districtCodes: editScopeType === CityPartnerScopeType.DISTRICT ? flattenDistrictCodes(v.districtCodes) : undefined,
+      };
+      await request(`/admin/partners/${detail.id}`, { method: 'PUT', body: JSON.stringify(body) });
+      message.success('已保存');
+      setDrawerOpen(false);
+      void reload();
+    } catch (e) {
+      const msg = formatApiError(e);
+      if (msg) message.error(msg);
+    }
+  }
+
+  const baseColumns: ColumnsType<Row> = [
+    { title: '城市', dataIndex: 'cityName', width: 100 },
+    {
+      title: '区县',
+      dataIndex: 'districtCodes',
+      width: 160,
+
+      render: (codes: string[] | null | undefined, row) =>
+        row.scopeType === CityPartnerScopeType.CITY_WIDE ? '全城' : formatDistrictLabels(codes),
+    },
+    { title: '公司名', dataIndex: 'companyName' },
+    { title: '主账号', dataIndex: 'phone', width: 130 },
+    {
+      title: '管辖',
+      dataIndex: 'scopeType',
+      width: 100,
+      render: (v) => (v ? CITY_PARTNER_SCOPE_LABELS[v as keyof typeof CITY_PARTNER_SCOPE_LABELS] || v : '—'),
+    },
+    { title: '门店', dataIndex: 'storeCount', width: 70 },
+    { title: '子账号', dataIndex: 'accountCount', width: 80, render: (n) => Math.max(0, n - 1) },
+    { title: '创建', dataIndex: 'createdAt', width: 160, render: fmtTime },
+    {
+      title: '操作',
+      width: 120,
+      render: (_, row) => (
+        <Button type="link" size="small" onClick={() => void openPartner(row.id)}>
+          管理
+        </Button>
+      ),
+    },
+  ];
+
   const { columns, settingsButton, settingsModal } = useAdminListColumns('partners', baseColumns, { page, pageSize });
-type Row = {
-  id: string;
-  companyName: string;
-  phone: string;
-  name: string;
-  contactPhone?: string | null;
-  cityId?: string | null;
-  cityName?: string | null;
-  scopeType?: string;
-  districtCodes?: string[] | null;
-  orderCommissionRate?: number;
-  redeemCommissionRate?: number;
-  storeCount: number;
-  accountCount: number;
-  createdAt: string;
-};
-
-type PartnerDetail = Row & {
-  address?: string;
-  districtCodes?: string[] | null;
-  bindingStatus?: string;
-  bankAccountName?: string | null;
-  bankAccountNo?: string | null;
-  bankBranch?: string | null;
-  managedWarehouseId?: string | null;
-  children?: Array<{
-    id: string;
-    phone: string;
-    name: string;
-    staffRole?: string;
-    permissions?: string[];
-    status: string;
-  }>;
-};
-
-type CityOption = { id: string; name: string; code: string };
-type WarehouseOption = { id: string; name: string };
-
-const SCOPE_OPTIONS = Object.entries(CITY_PARTNER_SCOPE_LABELS).map(([value, label]) => ({ value, label }));
-const PERM_OPTIONS = PARTNER_PERMISSION_KEYS.map((k: PartnerPermissionKey) => ({ value: k, label: PARTNER_PERMISSION_LABELS[k] }));
-
-function flattenDistrictCodes(values: string[] | string[][] | undefined): string[] {
-  if (!values?.length) return [];
-  if (Array.isArray(values[0])) {
-    return (values as string[][]).map((path) => path[path.length - 1]).filter(Boolean);
-  }
-  return values as string[];
-}
-
-export default function PartnersPage() {
-  const [form] = Form.useForm();
-  const [editForm] = Form.useForm();
-  const [createForm] = Form.useForm();
-  const [subForm] = Form.useForm();
-  const [filters, setFilters] = useState<Record<string, string>>({});
-  const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<Row>(
-    '/admin/partners',
-    () => {
-      const qs = new URLSearchParams();
-      if (filters.companyName) qs.set('companyName', filters.companyName);
-      if (filters.contactPhone) qs.set('contactPhone', filters.contactPhone);
-      return qs;
-    },
-    [filters],
-  );
-  const [detail, setDetail] = useState<PartnerDetail | null>(null);
-  const [drawerOpen, setDrawerOpen] = useState(false);
-  const [createOpen, setCreateOpen] = useState(false);
-  const [subOpen, setSubOpen] = useState(false);
-  const [cities, setCities] = useState<CityOption[]>([]);
-  const [warehouses, setWarehouses] = useState<WarehouseOption[]>([]);
-  const [createScopeType, setCreateScopeType] = useState<CityPartnerScopeType>(CityPartnerScopeType.CITY_WIDE);
-  const [editScopeType, setEditScopeType] = useState<CityPartnerScopeType>(CityPartnerScopeType.CITY_WIDE);
-  const [createCityId, setCreateCityId] = useState<string | undefined>();
-
-  const createCityCode = createCityId ? cities.find((c) => c.id === createCityId)?.code : undefined;
-  const editCityCode = detail?.cityId ? cities.find((c) => c.id === detail.cityId)?.code : undefined;
-
-  function formatApiError(err: unknown): string | null {
-    if (err && typeof err === 'object' && 'errorFields' in err) return null;
-    if (!(err instanceof Error)) return '操作失败';
-    return err.message.replace(/\b(\d{6})\b/g, (code) => {
-      const label = districtCodeLabel(code);
-      return label !== code ? `${label}(${code})` : code;
-    });
-  }
-
-  const loadCities = useCallback(async () => {
-    const res = await request<Paginated<CityOption>>(`/admin/cities?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`);
-    setCities(res.items);
-  }, []);
-
-  const loadWarehouses = useCallback(async (cityId: string) => {
-    const rows = await request<WarehouseOption[]>(`/admin/cities/${cityId}/warehouses`);
-    setWarehouses(rows.map((w) => ({ id: w.id, name: (w as { name: string }).name })));
-  }, []);
-
-  useEffect(() => {
-    void loadCities();
-  }, [loadCities]);
-
-  async function openPartner(id: string) {
-    const d = await request<PartnerDetail>(`/admin/partners/${id}`);
-    setDetail(d);
-    setEditScopeType((d.scopeType as CityPartnerScopeType) || CityPartnerScopeType.CITY_WIDE);
-    if (d.cityId) await loadWarehouses(d.cityId);
-    editForm.setFieldsValue({
-      name: d.name,
-      phone: d.phone,
-      companyName: d.companyName,
-      contactPhone: d.contactPhone ?? d.phone,
-      address: d.address ?? '',
-      scopeType: d.scopeType,
-      districtCodes: d.districtCodes ?? [],
-      orderCommissionRate: (d.orderCommissionRate ?? 0) * 100,
-      redeemCommissionRate: (d.redeemCommissionRate ?? 0.03) * 100,
-      bindingStatus: d.bindingStatus,
-      managedWarehouseId: d.managedWarehouseId,
-      bankAccountName: d.bankAccountName ?? '',
-      bankAccountNo: d.bankAccountNo ?? '',
-      bankBranch: d.bankBranch ?? '',
-    });
-    setDrawerOpen(true);
-  }
-
-  async function savePartner() {
-    if (!detail) return;
-    try {
-      const v = await editForm.validateFields();
-      const body = {
-        ...v,
-        orderCommissionRate: Number(v.orderCommissionRate ?? 0) / 100,
-        redeemCommissionRate: Number(v.redeemCommissionRate ?? 3) / 100,
-        districtCodes: editScopeType === CityPartnerScopeType.DISTRICT ? flattenDistrictCodes(v.districtCodes) : undefined,
-      };
-      await request(`/admin/partners/${detail.id}`, { method: 'PUT', body: JSON.stringify(body) });
-      message.success('已保存');
-      setDrawerOpen(false);
-      void reload();
-    } catch (e) {
-      const msg = formatApiError(e);
-      if (msg) message.error(msg);
-    }
-  }
-
-  const columns: ColumnsType<Row> = [
-    { title: '城市', dataIndex: 'cityName', width: 100 },
-    {
-      title: '区县',
-      dataIndex: 'districtCodes',
-      width: 160,
-      ellipsis: true,
-      render: (codes: string[] | null | undefined, row) =>
-        row.scopeType === CityPartnerScopeType.CITY_WIDE ? '全城' : formatDistrictLabels(codes),
-    },
-    { title: '公司名', dataIndex: 'companyName', ellipsis: true },
-    { title: '主账号', dataIndex: 'phone', width: 130 },
-    {
-      title: '管辖',
-      dataIndex: 'scopeType',
-      width: 100,
-      render: (v) => (v ? CITY_PARTNER_SCOPE_LABELS[v as keyof typeof CITY_PARTNER_SCOPE_LABELS] || v : '—'),
-    },
-    { title: '门店', dataIndex: 'storeCount', width: 70 },
-    { title: '子账号', dataIndex: 'accountCount', width: 80, render: (n) => Math.max(0, n - 1) },
-    { title: '创建', dataIndex: 'createdAt', width: 160, render: fmtTime },
-    {
-      title: '操作',
-      width: 120,
-      render: (_, row) => (
-        <Button type="link" size="small" onClick={() => void openPartner(row.id)}>
-          管理
-        </Button>
-      ),
-    },
-  ];
-
-  return (
+
   return (
-      <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
+    <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
-        <Button type="primary" onClick={() => { setCreateOpen(true); createForm.resetFields(); setCreateScopeType(CityPartnerScopeType.CITY_WIDE); }}>
-          新建城市合伙人
-        </Button>
-      </Space>
-      <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={(v) => { setFilters(v); setPage(1); }}>
-        <Form.Item name="companyName" label="公司"><Input allowClear /></Form.Item>
-        <Form.Item name="contactPhone" label="电话"><Input allowClear /></Form.Item>
-        <Form.Item><Button type="primary" htmlType="submit">查询</Button></Form.Item>
-      </Form>
-      <Table
-        rowKey="id"
-        className="admin-table-nowrap"
-        loading={loading}
-        columns={columns}
-        dataSource={data?.items ?? []}
-        pagination={{
-          current: page,
-          pageSize,
-          total: data?.total ?? 0,
-          showSizeChanger: true,
-          onChange: (p, ps) => { setPage(p); setPageSize(ps); },
-        }}
-      />
-
-      <Drawer
-        title="城市合伙人"
-        width={640}
-        open={drawerOpen}
-        onClose={() => setDrawerOpen(false)}
-        extra={<Button type="primary" onClick={() => void savePartner()}>保存</Button>}
-      >
-        {detail && (
-          <Tabs
-            items={[
-              {
-                key: 'info',
-                label: '基本信息',
-                children: (
-                  <Form form={editForm} layout="vertical">
-                    <Form.Item name="companyName" label="公司名"><Input placeholder="选填" /></Form.Item>
-                    <Form.Item name="name" label="主账号姓名" rules={[{ required: true }]}><Input /></Form.Item>
-                    <Form.Item name="phone" label="登录手机号" rules={[{ required: true }]}><Input /></Form.Item>
-                    <Form.Item name="contactPhone" label="业务联系电话"><Input /></Form.Item>
-                    <Form.Item name="address" label="地址"><Input placeholder="选填" /></Form.Item>
-                    <Form.Item name="scopeType" label="管辖类型" rules={[{ required: true }]}>
-                      <Select options={SCOPE_OPTIONS} onChange={(v) => setEditScopeType(v)} />
-                    </Form.Item>
-                    {editScopeType === CityPartnerScopeType.DISTRICT && (
-                      <Form.Item
-                        name="districtCodes"
-                        label="区县"
-                        extra="仅作标识，可多选当前城市下的区县（不做互斥）"
-                      >
-                        <CityDistrictMultiSelect cityCode={editCityCode} />
-                      </Form.Item>
-                    )}
-                    <Space style={{ width: '100%' }} size="large">
-                      <Form.Item name="orderCommissionRate" label="订单佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
-                      <Form.Item name="redeemCommissionRate" label="核销佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
-                    </Space>
-                    <Form.Item name="managedWarehouseId" label="管仓仓库">
-                      <Select allowClear options={warehouses.map((w) => ({ value: w.id, label: w.name }))} />
-                    </Form.Item>
-                    <Form.Item name="bankAccountName" label="户名"><Input /></Form.Item>
-                    <Form.Item name="bankAccountNo" label="账号"><Input /></Form.Item>
-                    <Form.Item name="bankBranch" label="开户行"><Input /></Form.Item>
-                  </Form>
-                ),
-              },
-              {
-                key: 'staff',
-                label: '子账号',
-                children: (
-                  <>
-                    <Button type="primary" style={{ marginBottom: 12 }} onClick={() => { subForm.resetFields(); setSubOpen(true); }}>
-                      添加子账号
-                    </Button>
-                    <Table
-                      size="small"
-                      rowKey="id"
-                      pagination={false}
-                      dataSource={detail.children ?? []}
-                      columns={[
-                        { title: '姓名', dataIndex: 'name' },
-                        { title: '手机', dataIndex: 'phone' },
-                        { title: '状态', dataIndex: 'status', render: (s) => <Tag>{s}</Tag> },
-                        {
-                          title: '权限',
-                          dataIndex: 'permissions',
-                          render: (p: string[] | undefined) => p?.map((k) => PARTNER_PERMISSION_LABELS[k as keyof typeof PARTNER_PERMISSION_LABELS] || k).join('、') || '—',
-                        },
-                      ]}
-                    />
-                  </>
-                ),
-              },
-            ]}
-          />
-        )}
-      </Drawer>
-
-      <Modal
-        title="新建城市合伙人"
-        open={createOpen}
-        width={560}
-        onCancel={() => setCreateOpen(false)}
-        onOk={async () => {
-          try {
-            const v = await createForm.validateFields();
-            await request('/admin/partners', {
-              method: 'POST',
-              body: JSON.stringify({
-                ...v,
-                orderCommissionRate: Number(v.orderCommissionRate ?? 0) / 100,
-                redeemCommissionRate: Number(v.redeemCommissionRate ?? 3) / 100,
-                districtCodes: createScopeType === CityPartnerScopeType.DISTRICT ? flattenDistrictCodes(v.districtCodes) : undefined,
-              }),
-            });
-            message.success('已创建');
-            setCreateOpen(false);
-            createForm.resetFields();
-            void reload();
-          } catch (e) {
-            const msg = formatApiError(e);
-            if (msg) message.error(msg);
-          }
-        }}
-      >
-        <Form form={createForm} layout="vertical" initialValues={{ orderCommissionRate: 0, redeemCommissionRate: 3, scopeType: CityPartnerScopeType.CITY_WIDE }}>
-          <Form.Item name="cityId" label="开城城市" rules={[{ required: true }]}>
-            <Select
-              options={cities.map((c) => ({ value: c.id, label: `${c.name} (${c.code})` }))}
-              onChange={(id) => {
-                setCreateCityId(id);
-                createForm.setFieldsValue({ districtCodes: undefined });
-                void loadWarehouses(id);
-              }}
-            />
-          </Form.Item>
-          <Form.Item name="companyName" label="公司名"><Input placeholder="选填" /></Form.Item>
-          <Form.Item name="name" label="主账号姓名" rules={[{ required: true }]}><Input /></Form.Item>
-          <Form.Item name="phone" label="登录手机号" rules={[{ required: true }]}><Input /></Form.Item>
-          <Form.Item name="address" label="地址"><Input placeholder="选填" /></Form.Item>
-          <Form.Item name="scopeType" label="管辖类型" rules={[{ required: true }]}>
-            <Select options={SCOPE_OPTIONS} onChange={(v) => setCreateScopeType(v)} />
-          </Form.Item>
-          {createScopeType === CityPartnerScopeType.DISTRICT && (
-            <Form.Item
-              name="districtCodes"
-              label="区县"
-              extra="选填；仅作标识，可多选当前城市下的区县（不做互斥）"
-            >
-              <CityDistrictMultiSelect cityCode={createCityCode} />
-            </Form.Item>
-          )}
-          <Space style={{ width: '100%' }} size="large">
-            <Form.Item name="orderCommissionRate" label="订单佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
-            <Form.Item name="redeemCommissionRate" label="核销佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
-          </Space>
-          {createCityId && (
-            <Form.Item name="managedWarehouseId" label="管仓仓库（可选）">
-              <Select allowClear options={warehouses.map((w) => ({ value: w.id, label: w.name }))} />
-            </Form.Item>
-          )}
-        </Form>
-      </Modal>
-
-      <Modal
-        title="添加子账号"
-        open={subOpen}
-        onCancel={() => setSubOpen(false)}
-        onOk={async () => {
-          if (!detail) return;
-          const v = await subForm.validateFields();
-          await request('/admin/partner-accounts', {
-            method: 'POST',
-            body: JSON.stringify({ ...v, parentAccountId: detail.id }),
-          });
-          message.success('已创建');
-          setSubOpen(false);
-          void openPartner(detail.id);
-        }}
-      >
-        <Form form={subForm} layout="vertical">
-          <Form.Item name="name" label="姓名" rules={[{ required: true }]}><Input /></Form.Item>
-          <Form.Item name="phone" label="手机号" rules={[{ required: true }]}><Input /></Form.Item>
-          <Form.Item name="permissions" label="权限">
-            <Select mode="multiple" options={PERM_OPTIONS} />
-          </Form.Item>
-        </Form>
-      </Modal>
-    </div>
-  );
-}
+        <Typography.Title level={4} style={{ margin: 0 }}>开城合伙人</Typography.Title>
+          {settingsButton}
+        <Button type="primary" onClick={() => { setCreateOpen(true); createForm.resetFields(); setCreateScopeType(CityPartnerScopeType.CITY_WIDE); }}>
+          新建城市合伙人
+        </Button>
+      </Space>
+      <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={(v) => { setFilters(v); setPage(1); }}>
+        <Form.Item name="companyName" label="公司"><Input allowClear /></Form.Item>
+        <Form.Item name="contactPhone" label="电话"><Input allowClear /></Form.Item>
+        <Form.Item><Button type="primary" htmlType="submit">查询</Button></Form.Item>
+      </Form>
+      <Table
+        rowKey="id"
+        className="admin-table-nowrap"
+        loading={loading}
+        columns={columns}
+        dataSource={data?.items ?? []}
+        pagination={{
+          current: page,
+          pageSize,
+          total: data?.total ?? 0,
+          showSizeChanger: true,
+          onChange: (p, ps) => { setPage(p); setPageSize(ps); },
+        }}
+      />
+
+      <Drawer
+        title="城市合伙人"
+        width={640}
+        open={drawerOpen}
+        onClose={() => setDrawerOpen(false)}
+        extra={<Button type="primary" onClick={() => void savePartner()}>保存</Button>}
+      >
+        {detail && (
+          <Tabs
+            items={[
+              {
+                key: 'info',
+                label: '基本信息',
+                children: (
+                  <Form form={editForm} layout="vertical">
+                    <Form.Item name="companyName" label="公司名"><Input placeholder="选填" /></Form.Item>
+                    <Form.Item name="name" label="主账号姓名" rules={[{ required: true }]}><Input /></Form.Item>
+                    <Form.Item name="phone" label="登录手机号" rules={[{ required: true }]}><Input /></Form.Item>
+                    <Form.Item name="contactPhone" label="业务联系电话"><Input /></Form.Item>
+                    <Form.Item name="address" label="地址"><Input placeholder="选填" /></Form.Item>
+                    <Form.Item name="scopeType" label="管辖类型" rules={[{ required: true }]}>
+                      <Select options={SCOPE_OPTIONS} onChange={(v) => setEditScopeType(v)} />
+                    </Form.Item>
+                    {editScopeType === CityPartnerScopeType.DISTRICT && (
+                      <Form.Item
+                        name="districtCodes"
+                        label="区县"
+                        extra="仅作标识，可多选当前城市下的区县（不做互斥）"
+                      >
+                        <CityDistrictMultiSelect cityCode={editCityCode} />
+                      </Form.Item>
+                    )}
+                    <Space style={{ width: '100%' }} size="large">
+                      <Form.Item name="orderCommissionRate" label="订单佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
+                      <Form.Item name="redeemCommissionRate" label="核销佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
+                    </Space>
+                    <Form.Item name="managedWarehouseId" label="管仓仓库">
+                      <Select allowClear options={warehouses.map((w) => ({ value: w.id, label: w.name }))} />
+                    </Form.Item>
+                    <Form.Item name="bankAccountName" label="户名"><Input /></Form.Item>
+                    <Form.Item name="bankAccountNo" label="账号"><Input /></Form.Item>
+                    <Form.Item name="bankBranch" label="开户行"><Input /></Form.Item>
+                  </Form>
+                ),
+              },
+              {
+                key: 'staff',
+                label: '子账号',
+                children: (
+                  <>
+                    <Button type="primary" style={{ marginBottom: 12 }} onClick={() => { subForm.resetFields(); setSubOpen(true); }}>
+                      添加子账号
+                    </Button>
+                    <Table
+                      size="small"
+                      rowKey="id"
+                      pagination={false}
+                      dataSource={detail.children ?? []}
+                      columns={[
+                        { title: '姓名', dataIndex: 'name' },
+                        { title: '手机', dataIndex: 'phone' },
+                        { title: '状态', dataIndex: 'status', render: (s) => <Tag>{s}</Tag> },
+                        {
+                          title: '权限',
+                          dataIndex: 'permissions',
+                          render: (p: string[] | undefined) => p?.map((k) => PARTNER_PERMISSION_LABELS[k as keyof typeof PARTNER_PERMISSION_LABELS] || k).join('、') || '—',
+                        },
+                      ]}
+                    />
+                  </>
+                ),
+              },
+            ]}
+          />
+        )}
+      </Drawer>
+
+      <Modal
+        title="新建城市合伙人"
+        open={createOpen}
+        width={560}
+        onCancel={() => setCreateOpen(false)}
+        onOk={async () => {
+          try {
+            const v = await createForm.validateFields();
+            await request('/admin/partners', {
+              method: 'POST',
+              body: JSON.stringify({
+                ...v,
+                orderCommissionRate: Number(v.orderCommissionRate ?? 0) / 100,
+                redeemCommissionRate: Number(v.redeemCommissionRate ?? 3) / 100,
+                districtCodes: createScopeType === CityPartnerScopeType.DISTRICT ? flattenDistrictCodes(v.districtCodes) : undefined,
+              }),
+            });
+            message.success('已创建');
+            setCreateOpen(false);
+            createForm.resetFields();
+            void reload();
+          } catch (e) {
+            const msg = formatApiError(e);
+            if (msg) message.error(msg);
+          }
+        }}
+      >
+        <Form form={createForm} layout="vertical" initialValues={{ orderCommissionRate: 0, redeemCommissionRate: 3, scopeType: CityPartnerScopeType.CITY_WIDE }}>
+          <Form.Item name="cityId" label="开城城市" rules={[{ required: true }]}>
+            <Select
+              options={cities.map((c) => ({ value: c.id, label: `${c.name} (${c.code})` }))}
+              onChange={(id) => {
+                setCreateCityId(id);
+                createForm.setFieldsValue({ districtCodes: undefined });
+                void loadWarehouses(id);
+              }}
+            />
+          </Form.Item>
+          <Form.Item name="companyName" label="公司名"><Input placeholder="选填" /></Form.Item>
+          <Form.Item name="name" label="主账号姓名" rules={[{ required: true }]}><Input /></Form.Item>
+          <Form.Item name="phone" label="登录手机号" rules={[{ required: true }]}><Input /></Form.Item>
+          <Form.Item name="address" label="地址"><Input placeholder="选填" /></Form.Item>
+          <Form.Item name="scopeType" label="管辖类型" rules={[{ required: true }]}>
+            <Select options={SCOPE_OPTIONS} onChange={(v) => setCreateScopeType(v)} />
+          </Form.Item>
+          {createScopeType === CityPartnerScopeType.DISTRICT && (
+            <Form.Item
+              name="districtCodes"
+              label="区县"
+              extra="选填；仅作标识，可多选当前城市下的区县（不做互斥）"
+            >
+              <CityDistrictMultiSelect cityCode={createCityCode} />
+            </Form.Item>
+          )}
+          <Space style={{ width: '100%' }} size="large">
+            <Form.Item name="orderCommissionRate" label="订单佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
+            <Form.Item name="redeemCommissionRate" label="核销佣金 %"><InputNumber min={0} max={100} precision={2} /></Form.Item>
+          </Space>
+          {createCityId && (
+            <Form.Item name="managedWarehouseId" label="管仓仓库（可选）">
+              <Select allowClear options={warehouses.map((w) => ({ value: w.id, label: w.name }))} />
+            </Form.Item>
+          )}
+        </Form>
+      </Modal>
+
+      <Modal
+        title="添加子账号"
+        open={subOpen}
+        onCancel={() => setSubOpen(false)}
+        onOk={async () => {
+          if (!detail) return;
+          const v = await subForm.validateFields();
+          await request('/admin/partner-accounts', {
+            method: 'POST',
+            body: JSON.stringify({ ...v, parentAccountId: detail.id }),
+          });
+          message.success('已创建');
+          setSubOpen(false);
+          void openPartner(detail.id);
+        }}
+      >
+        <Form form={subForm} layout="vertical">
+          <Form.Item name="name" label="姓名" rules={[{ required: true }]}><Input /></Form.Item>
+          <Form.Item name="phone" label="手机号" rules={[{ required: true }]}><Input /></Form.Item>
+          <Form.Item name="permissions" label="权限">
+            <Select mode="multiple" options={PERM_OPTIONS} />
+          </Form.Item>
+        </Form>
+      </Modal>
+    </div>
+  );

apps/admin-web/src/pages/PendingRedeemPage.tsx

@@ -1,266 +1,271 @@
-import { useState } from 'react';
-import {
-  Button,
-  Descriptions,
-  Drawer,
-  Form,
-  Image,
-  Input,
-  Modal,
-  Select,
-  Space,
-  Table,
-  Tag,
-  Typography,
-  message,
-} from 'antd';
-import type { ColumnsType } from 'antd/es/table';
-import {
-  REDEEM_PENDING_STATUS_LABELS,
-  type RedeemPendingItem,
-  type RedeemPendingStatus,
-} from '@dukang/shared-types';
-import { request } from '../lib/api';
-import { fmtTime } from '../lib/constants';
+import { useState } from 'react';
+import {
+  Button,
+  Descriptions,
+  Drawer,
+  Form,
+  Image,
+  Input,
+  Modal,
+  Select,
+  Space,
+  Table,
+  Tag,
+  Typography,
+  message,
+} from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import {
+  REDEEM_PENDING_STATUS_LABELS,
+  type RedeemPendingItem,
+  type RedeemPendingStatus,
+} from '@dukang/shared-types';
+import { request } from '../lib/api';
+import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
+
+const STATUS_COLOR: Record<RedeemPendingStatus, string> = {
+  PENDING: 'orange',
+  COMPLETED: 'green',
+  REJECTED: 'default',
+};
+
+export default function PendingRedeemPage() {
+  const [form] = Form.useForm();
+  const [filters, setFilters] = useState<Record<string, string>>({});
+  const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<RedeemPendingItem>(
+    '/admin/redeem-pending',
+    () => {
+      const qs = new URLSearchParams();
+      if (filters.status) qs.set('status', filters.status);
+      if (filters.pendingNo) qs.set('pendingNo', filters.pendingNo);
+      if (filters.redeemToken) qs.set('redeemToken', filters.redeemToken);
+      if (filters.storeId) qs.set('storeId', filters.storeId);
+      return qs;
+    },
+    [filters],
+  );
+  const [detail, setDetail] = useState<RedeemPendingItem | null>(null);
+  const [drawerOpen, setDrawerOpen] = useState(false);
+  const [acting, setActing] = useState(false);
+  const [rejectOpen, setRejectOpen] = useState(false);
+  const [rejectReason, setRejectReason] = useState('');
+
+  async function openDetail(id: string) {
+    const res = await request<RedeemPendingItem>(`/admin/redeem-pending/${id}`);
+    setDetail(res);
+    setDrawerOpen(true);
+  }
+
+  async function complete() {
+    if (!detail) return;
+    setActing(true);
+    try {
+      await request(`/admin/redeem-pending/${detail.id}/complete`, { method: 'POST', body: '{}' });
+      message.success('已补核销');
+      setDrawerOpen(false);
+      void reload();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '补核销失败');
+    } finally {
+      setActing(false);
+    }
+  }
+
+  async function reject() {
+    if (!detail || !rejectReason.trim()) {
+      message.error('请填写驳回原因');
+      return;
+    }
+    setActing(true);
+    try {
+      await request(`/admin/redeem-pending/${detail.id}/reject`, {
+        method: 'POST',
+        body: JSON.stringify({ reason: rejectReason.trim() }),
+      });
+      message.success('已驳回');
+      setRejectOpen(false);
+      setDrawerOpen(false);
+      void reload();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '驳回失败');
+    } finally {
+      setActing(false);
+    }
+  }
+
+  const baseColumns: ColumnsType<RedeemPendingItem> = [
+    { title: '待处理单号', dataIndex: 'pendingNo', width: 170 },
+    {
+      title: '核销码 ID',
+      dataIndex: 'redeemToken',
+      width: 160,
+
+      render: (v: string) => <Typography.Text copyable={{ text: v }}>{v.slice(0, 8)}…</Typography.Text>,
+    },
+    { title: '门店', dataIndex: ['store', 'name'], width: 140, render: (_, row) => row.store?.name || '—' },
+    {
+      title: '用户',
+      width: 120,
+      render: (_, row) => row.user?.userNo || row.user?.phone || '—',
+    },
+    { title: '金额', dataIndex: 'amount', width: 90, render: (v) => `¥${v}` },
+    { title: '失败次数', dataIndex: 'failCount', width: 90 },
+    {
+      title: '状态',
+      dataIndex: 'status',
+      width: 100,
+      render: (s: RedeemPendingStatus) => (
+        <Tag color={STATUS_COLOR[s]}>{REDEEM_PENDING_STATUS_LABELS[s] || s}</Tag>
+      ),
+    },
+    { title: '提交时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
+    {
+      title: '操作',
+      width: 80,
+      fixed: 'right',
+      render: (_, row) => (
+        <Button type="link" size="small" onClick={() => void openDetail(row.id)}>
+          详情
+        </Button>
+      ),
+    },
+  ];
+
   const { columns, settingsButton, settingsModal } = useAdminListColumns('redeem-pending', baseColumns, { page, pageSize });
-const STATUS_COLOR: Record<RedeemPendingStatus, string> = {
-  PENDING: 'orange',
-  COMPLETED: 'green',
-  REJECTED: 'default',
-};
-
-export default function PendingRedeemPage() {
-  const [form] = Form.useForm();
-  const [filters, setFilters] = useState<Record<string, string>>({});
-  const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<RedeemPendingItem>(
-    '/admin/redeem-pending',
-    () => {
-      const qs = new URLSearchParams();
-      if (filters.status) qs.set('status', filters.status);
-      if (filters.pendingNo) qs.set('pendingNo', filters.pendingNo);
-      if (filters.redeemToken) qs.set('redeemToken', filters.redeemToken);
-      if (filters.storeId) qs.set('storeId', filters.storeId);
-      return qs;
-    },
-    [filters],
-  );
-  const [detail, setDetail] = useState<RedeemPendingItem | null>(null);
-  const [drawerOpen, setDrawerOpen] = useState(false);
-  const [acting, setActing] = useState(false);
-  const [rejectOpen, setRejectOpen] = useState(false);
-  const [rejectReason, setRejectReason] = useState('');
-
-  async function openDetail(id: string) {
-    const res = await request<RedeemPendingItem>(`/admin/redeem-pending/${id}`);
-    setDetail(res);
-    setDrawerOpen(true);
-  }
-
-  async function complete() {
-    if (!detail) return;
-    setActing(true);
-    try {
-      await request(`/admin/redeem-pending/${detail.id}/complete`, { method: 'POST', body: '{}' });
-      message.success('已补核销');
-      setDrawerOpen(false);
-      void reload();
-    } catch (e) {
-      message.error(e instanceof Error ? e.message : '补核销失败');
-    } finally {
-      setActing(false);
-    }
-  }
-
-  async function reject() {
-    if (!detail || !rejectReason.trim()) {
-      message.error('请填写驳回原因');
-      return;
-    }
-    setActing(true);
-    try {
-      await request(`/admin/redeem-pending/${detail.id}/reject`, {
-        method: 'POST',
-        body: JSON.stringify({ reason: rejectReason.trim() }),
-      });
-      message.success('已驳回');
-      setRejectOpen(false);
-      setDrawerOpen(false);
-      void reload();
-    } catch (e) {
-      message.error(e instanceof Error ? e.message : '驳回失败');
-    } finally {
-      setActing(false);
-    }
-  }
-
-  const columns: ColumnsType<RedeemPendingItem> = [
-    { title: '待处理单号', dataIndex: 'pendingNo', width: 170 },
-    {
-      title: '核销码 ID',
-      dataIndex: 'redeemToken',
-      width: 160,
-      ellipsis: true,
-      render: (v: string) => <Typography.Text copyable={{ text: v }}>{v.slice(0, 8)}…</Typography.Text>,
-    },
-    { title: '门店', dataIndex: ['store', 'name'], width: 140, render: (_, row) => row.store?.name || '—' },
-    {
-      title: '用户',
-      width: 120,
-      render: (_, row) => row.user?.userNo || row.user?.phone || '—',
-    },
-    { title: '金额', dataIndex: 'amount', width: 90, render: (v) => `¥${v}` },
-    { title: '失败次数', dataIndex: 'failCount', width: 90 },
-    {
-      title: '状态',
-      dataIndex: 'status',
-      width: 100,
-      render: (s: RedeemPendingStatus) => (
-        <Tag color={STATUS_COLOR[s]}>{REDEEM_PENDING_STATUS_LABELS[s] || s}</Tag>
-      ),
-    },
-    { title: '提交时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
-    {
-      title: '操作',
-      width: 80,
-      fixed: 'right',
-      render: (_, row) => (
-        <Button type="link" size="small" onClick={() => void openDetail(row.id)}>
-          详情
-        </Button>
-      ),
-    },
-  ];
-
-  return (
+
   return (
+    <div>
       {settingsModal}
-      <Form
-        form={form}
-        layout="inline"
-        style={{ marginBottom: 16 }}
-        onFinish={(v) => {
-          setFilters(v);
-          setPage(1);
-        }}
-      >
-        <Form.Item name="pendingNo" label="待处理单号">
-          <Input allowClear />
-        </Form.Item>
-        <Form.Item name="redeemToken" label="核销码 ID">
-          <Input allowClear />
-        </Form.Item>
-        <Form.Item name="storeId" label="门店 ID">
-          <Input allowClear />
-        </Form.Item>
-        <Form.Item name="status" label="状态">
-          <Select
-            allowClear
-            style={{ width: 120 }}
-            options={Object.entries(REDEEM_PENDING_STATUS_LABELS).map(([value, label]) => ({
-              value,
-              label,
-            }))}
-          />
-        </Form.Item>
-        <Form.Item>
-          <Button type="primary" htmlType="submit">
-            查询
-          </Button>
-        </Form.Item>
-      </Form>
-
-      <Table
-        rowKey="id"
-        loading={loading}
-        columns={columns}
-        dataSource={data?.items ?? []}
-        scroll={{ x: 1100 }}
-        pagination={{
-          current: page,
-          pageSize,
-          total: data?.total ?? 0,
-          showSizeChanger: true,
-          onChange: (p, ps) => {
-            setPage(p);
-            setPageSize(ps);
-          },
-        }}
-      />
-
-      <Drawer
-        title="待处理核销详情"
-        width={560}
-        open={drawerOpen}
-        onClose={() => setDrawerOpen(false)}
-        extra={
-          detail?.status === 'PENDING' && (
-            <Space>
-              <Button danger onClick={() => { setRejectReason(''); setRejectOpen(true); }}>
-                驳回
-              </Button>
-              <Button type="primary" loading={acting} onClick={() => void complete()}>
-                人工补核销
-              </Button>
-            </Space>
-          )
-        }
-      >
-        {detail && (
-          <>
-            {detail.photoUrl && (
-              <div style={{ textAlign: 'center', marginBottom: 16 }}>
-                <Image src={detail.photoUrl} alt="核销码照片" style={{ maxHeight: 280 }} />
-              </div>
-            )}
-            <Descriptions column={1} bordered size="small">
-              <Descriptions.Item label="待处理单号">{detail.pendingNo}</Descriptions.Item>
-              <Descriptions.Item label="核销码 ID">
-                <Typography.Text copyable>{detail.redeemToken}</Typography.Text>
-              </Descriptions.Item>
-              <Descriptions.Item label="状态">
-                <Tag color={STATUS_COLOR[detail.status]}>
-                  {REDEEM_PENDING_STATUS_LABELS[detail.status]}
-                </Tag>
-              </Descriptions.Item>
-              <Descriptions.Item label="金额">¥{detail.amount}</Descriptions.Item>
-              <Descriptions.Item label="类型">{detail.redeemType}</Descriptions.Item>
-              <Descriptions.Item label="失败次数">{detail.failCount}</Descriptions.Item>
-              <Descriptions.Item label="门店">
-                {detail.store?.name || '—'}（{detail.store?.id}）
-              </Descriptions.Item>
-              <Descriptions.Item label="用户">
-                {detail.user?.userNo || '—'} / {detail.user?.phone || '无手机'}
-              </Descriptions.Item>
-              <Descriptions.Item label="关联核销单">
-                {detail.redeemRecord?.redeemNo || '—'}
-              </Descriptions.Item>
-              <Descriptions.Item label="驳回原因">{detail.rejectReason || '—'}</Descriptions.Item>
-              <Descriptions.Item label="备注">{detail.remark || '—'}</Descriptions.Item>
-              <Descriptions.Item label="提交时间">{fmtTime(detail.createdAt)}</Descriptions.Item>
-              <Descriptions.Item label="处理时间">
-                {detail.processedAt ? fmtTime(detail.processedAt) : '—'}
-              </Descriptions.Item>
-            </Descriptions>
-          </>
-        )}
-      </Drawer>
-
-      <Modal
-        title="驳回待处理单"
-        open={rejectOpen}
-        okText="确认驳回"
-        okButtonProps={{ danger: true, loading: acting, disabled: !rejectReason.trim() }}
-        onOk={() => void reject()}
-        onCancel={() => setRejectOpen(false)}
-      >
-        <Input.TextArea
-          rows={3}
-          placeholder="请填写驳回原因"
-          value={rejectReason}
-          onChange={(e) => setRejectReason(e.target.value)}
-        />
-      </Modal>
-    </div>
-  );
-}
+      <Typography.Title level={4}>待处理核销（弱网兜底）</Typography.Title>
+          {settingsButton}
+      <Form
+        form={form}
+        layout="inline"
+        style={{ marginBottom: 16 }}
+        onFinish={(v) => {
+          setFilters(v);
+          setPage(1);
+        }}
+      >
+        <Form.Item name="pendingNo" label="待处理单号">
+          <Input allowClear />
+        </Form.Item>
+        <Form.Item name="redeemToken" label="核销码 ID">
+          <Input allowClear />
+        </Form.Item>
+        <Form.Item name="storeId" label="门店 ID">
+          <Input allowClear />
+        </Form.Item>
+        <Form.Item name="status" label="状态">
+          <Select
+            allowClear
+            style={{ width: 120 }}
+            options={Object.entries(REDEEM_PENDING_STATUS_LABELS).map(([value, label]) => ({
+              value,
+              label,
+            }))}
+          />
+        </Form.Item>
+        <Form.Item>
+          <Button type="primary" htmlType="submit">
+            查询
+          </Button>
+        </Form.Item>
+      </Form>
+
+      <Table
+        rowKey="id"
+        loading={loading}
+        columns={columns}
+        dataSource={data?.items ?? []}
+        scroll={{ x: 'max-content' }}
+        pagination={{
+          current: page,
+          pageSize,
+          total: data?.total ?? 0,
+          showSizeChanger: true,
+          onChange: (p, ps) => {
+            setPage(p);
+            setPageSize(ps);
+          },
+        }}
+      />
+
+      <Drawer
+        title="待处理核销详情"
+        width={560}
+        open={drawerOpen}
+        onClose={() => setDrawerOpen(false)}
+        extra={
+          detail?.status === 'PENDING' && (
+            <Space>
+              <Button danger onClick={() => { setRejectReason(''); setRejectOpen(true); }}>
+                驳回
+              </Button>
+              <Button type="primary" loading={acting} onClick={() => void complete()}>
+                人工补核销
+              </Button>
+            </Space>
+          )
+        }
+      >
+        {detail && (
+          <>
+            {detail.photoUrl && (
+              <div style={{ textAlign: 'center', marginBottom: 16 }}>
+                <Image src={detail.photoUrl} alt="核销码照片" style={{ maxHeight: 280 }} />
+              </div>
+            )}
+            <Descriptions column={1} bordered size="small">
+              <Descriptions.Item label="待处理单号">{detail.pendingNo}</Descriptions.Item>
+              <Descriptions.Item label="核销码 ID">
+                <Typography.Text copyable>{detail.redeemToken}</Typography.Text>
+              </Descriptions.Item>
+              <Descriptions.Item label="状态">
+                <Tag color={STATUS_COLOR[detail.status]}>
+                  {REDEEM_PENDING_STATUS_LABELS[detail.status]}
+                </Tag>
+              </Descriptions.Item>
+              <Descriptions.Item label="金额">¥{detail.amount}</Descriptions.Item>
+              <Descriptions.Item label="类型">{detail.redeemType}</Descriptions.Item>
+              <Descriptions.Item label="失败次数">{detail.failCount}</Descriptions.Item>
+              <Descriptions.Item label="门店">
+                {detail.store?.name || '—'}（{detail.store?.id}）
+              </Descriptions.Item>
+              <Descriptions.Item label="用户">
+                {detail.user?.userNo || '—'} / {detail.user?.phone || '无手机'}
+              </Descriptions.Item>
+              <Descriptions.Item label="关联核销单">
+                {detail.redeemRecord?.redeemNo || '—'}
+              </Descriptions.Item>
+              <Descriptions.Item label="驳回原因">{detail.rejectReason || '—'}</Descriptions.Item>
+              <Descriptions.Item label="备注">{detail.remark || '—'}</Descriptions.Item>
+              <Descriptions.Item label="提交时间">{fmtTime(detail.createdAt)}</Descriptions.Item>
+              <Descriptions.Item label="处理时间">
+                {detail.processedAt ? fmtTime(detail.processedAt) : '—'}
+              </Descriptions.Item>
+            </Descriptions>
+          </>
+        )}
+      </Drawer>
+
+      <Modal
+        title="驳回待处理单"
+        open={rejectOpen}
+        okText="确认驳回"
+        okButtonProps={{ danger: true, loading: acting, disabled: !rejectReason.trim() }}
+        onOk={() => void reject()}
+        onCancel={() => setRejectOpen(false)}
+      >
+        <Input.TextArea
+          rows={3}
+          placeholder="请填写驳回原因"
+          value={rejectReason}
+          onChange={(e) => setRejectReason(e.target.value)}
+        />
+      </Modal>
+    </div>
+  );

apps/admin-web/src/pages/ProductDetailTemplatesPage.tsx

@@ -13,6 +13,8 @@ import { useAdminList } from '../lib/useAdminList';
 import DetailImageUrlList from '../components/DetailImageUrlList';
 import type { ProductDetailTemplateDto } from '../lib/product-detail-templates';
 import { TEMPLATE_MAX_DETAIL_IMAGES } from '../lib/product-detail-templates';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = ProductDetailTemplateDto;
 
@@ -136,10 +138,10 @@ export default function ProductDetailTemplatesPage() {
   const [drawerOpen, setDrawerOpen] = useState(false);
   const [createOpen, setCreateOpen] = useState(false);
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: '编码', dataIndex: 'code', width: 120 },
     { title: '名称', dataIndex: 'name', width: 120 },
-    { title: '说明', dataIndex: 'description', width: 200, ellipsis: true },
+    { title: '说明', dataIndex: 'description', width: 200 },
     { title: '香型', dataIndex: 'aromaType', width: 90, render: (v) => (v ? AROMA_TYPE_LABELS[v] || v : '—') },
     { title: '详情图', dataIndex: 'detailImageUrls', width: 80, render: (v: string[] | undefined) => v?.length ?? 0 },
     { title: '排序', dataIndex: 'sortOrder', width: 60 },
@@ -158,10 +160,17 @@ export default function ProductDetailTemplatesPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('product-detail-templates', baseColumns, {
+    page,
+    pageSize,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
         <Typography.Title level={4} style={{ margin: 0 }}>商品详情模板</Typography.Title>
+          {settingsButton}
         <Button type="primary" onClick={() => setCreateOpen(true)}>新建模板</Button>
       </Space>
       <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={(v) => { setFilters(v); setPage(1); }}>
@@ -175,7 +184,7 @@ export default function ProductDetailTemplatesPage() {
         </Form.Item>
         <Form.Item><Button type="primary" htmlType="submit">查询</Button></Form.Item>
       </Form>
-      <Table rowKey="id" className="admin-table-nowrap" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 1100 }}
+      <Table rowKey="id" className="admin-table-nowrap" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 'max-content' }}
         pagination={{ current: page, pageSize, total: data?.total ?? 0, showSizeChanger: true, onChange: (p, ps) => { setPage(p); setPageSize(ps); } }} />
       <Drawer title="编辑详情模板" width={640} open={drawerOpen} onClose={() => setDrawerOpen(false)}
         extra={detail && (

apps/admin-web/src/pages/ProductsPage.tsx

@@ -12,7 +12,10 @@ import OssUpload from '../components/OssUpload';
 import MultiImageUpload from '../components/MultiImageUpload';
 import DetailImageUrlList from '../components/DetailImageUrlList';
 import ProductDetailTemplatePicker from '../components/ProductDetailTemplatePicker';
+import ProductSpecsEditor from '../components/ProductSpecsEditor';
 import type { FormInstance } from 'antd/es/form';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type ProductDetailContentDto = {
   storyTitle?: string;
@@ -20,6 +23,22 @@ type ProductDetailContentDto = {
   features?: Array<{ icon: string; title: string; desc: string }>;
 };
 
+type SkuListRow = {
+  id: string;
+  skuCode: string;
+  barcode69: string;
+  specText: string;
+  price: number;
+  benefitAmount: number;
+  status: string;
+  isDefault?: boolean;
+  allowOnSitePickup?: boolean;
+  allowOnlinePurchase?: boolean;
+  allowCrossCityDelivery?: boolean;
+  soldBottles?: number;
+  virtual?: boolean;
+};
+
 type Row = {
   id: string;
   skuCode: string;
@@ -29,9 +48,15 @@ type Row = {
   aromaType: string;
   spec: string;
   price: number;
+  priceMin?: number;
+  priceMax?: number;
+  soldBottles?: number;
   benefitAmount: number;
   status: string;
   sortOrder: number;
+  skuCount?: number;
+  specEnabled?: boolean;
+  skus?: SkuListRow[];
   allowOnSitePickup?: boolean;
   allowOnlinePurchase?: boolean;
   allowCrossCityDelivery?: boolean;
@@ -213,7 +238,33 @@ function VisibilityWhitelistFields({ form }: { form: FormInstance }) {
   );
 }
 
-function BaseInfoFields({ mode, form }: { mode: 'create' | 'edit'; form: FormInstance }) {
+function FulfillmentTags(row: {
+  allowOnlinePurchase?: boolean;
+  allowCrossCityDelivery?: boolean;
+  allowOnSitePickup?: boolean;
+}) {
+  return (
+    <Space size={[0, 4]} wrap>
+      {row.allowOnlinePurchase !== false ? <Tag color="blue">线上</Tag> : null}
+      {row.allowOnlinePurchase !== false && row.allowCrossCityDelivery !== false ? (
+        <Tag color="cyan">跨城</Tag>
+      ) : null}
+      {row.allowOnSitePickup ? <Tag color="green">现场</Tag> : null}
+      {row.allowOnlinePurchase === false && !row.allowOnSitePickup ? <Tag>无</Tag> : null}
+    </Space>
+  );
+}
+
+function BaseInfoFields({
+  mode,
+  form,
+  hideFulfillment,
+}: {
+  mode: 'create' | 'edit';
+  form: FormInstance;
+  /** 多规格商品：履约只在规格 SKU 上编辑 */
+  hideFulfillment?: boolean;
+}) {
   return (
     <>
       {mode === 'create' && (
@@ -221,8 +272,13 @@ function BaseInfoFields({ mode, form }: { mode: 'create' | 'edit'; form: FormIns
           <Form.Item label="SKU">
             <Input disabled placeholder="保存后自动生成" />
           </Form.Item>
-          <Form.Item name="barcode69" label="69码" rules={[{ required: true }]}>
-            <Input />
+          <Form.Item
+            name="barcode69"
+            label="69码"
+            rules={[{ required: true, message: '请填写默认规格 69 码' }]}
+            extra="默认规格的 69 码；若有多种规格，保存后请到「规格与 SKU」为每个规格分别填写不同 69 码"
+          >
+            <Input placeholder="默认规格 69 码" />
           </Form.Item>
           <Form.Item name="aromaType" label="香型" rules={[{ required: true }]}>
             <Select options={Object.entries(AROMA_TYPE_LABELS).map(([value, label]) => ({ value, label }))} />
@@ -250,39 +306,47 @@ function BaseInfoFields({ mode, form }: { mode: 'create' | 'edit'; form: FormIns
       <Form.Item name="sortOrder" label="排序">
         <InputNumber min={0} style={{ width: '100%' }} />
       </Form.Item>
-      <Form.Item
-        name="allowOnlinePurchase"
-        label="允许线上购买"
-        valuePropName="checked"
-        extra="配送到址（同城）"
-      >
-        <Switch
-          checkedChildren="开"
-          unCheckedChildren="关"
-          onChange={(checked) => {
-            if (!checked) form.setFieldsValue({ allowCrossCityDelivery: false });
-          }}
-        />
-      </Form.Item>
-      <Form.Item noStyle shouldUpdate={(prev, cur) => prev.allowOnlinePurchase !== cur.allowOnlinePurchase}>
-        {() => (
+      {hideFulfillment ? (
+        <Typography.Paragraph type="secondary" style={{ marginBottom: 16 }}>
+          该商品有多种规格，履约（线上 / 跨城 / 现场）请到「规格与 SKU」中按规格设置。
+        </Typography.Paragraph>
+      ) : (
+        <>
           <Form.Item
-            name="allowCrossCityDelivery"
-            label="允许跨城配送"
+            name="allowOnlinePurchase"
+            label="允许线上购买"
             valuePropName="checked"
-            extra="须先开启线上购买"
+            extra="配送到址（同城）"
           >
             <Switch
               checkedChildren="开"
               unCheckedChildren="关"
-              disabled={!form.getFieldValue('allowOnlinePurchase')}
+              onChange={(checked) => {
+                if (!checked) form.setFieldsValue({ allowCrossCityDelivery: false });
+              }}
             />
           </Form.Item>
-        )}
-      </Form.Item>
-      <Form.Item name="allowOnSitePickup" label="允许现场取货" valuePropName="checked">
-        <Switch checkedChildren="开" unCheckedChildren="关" />
-      </Form.Item>
+          <Form.Item noStyle shouldUpdate={(prev, cur) => prev.allowOnlinePurchase !== cur.allowOnlinePurchase}>
+            {() => (
+              <Form.Item
+                name="allowCrossCityDelivery"
+                label="允许跨城配送"
+                valuePropName="checked"
+                extra="须先开启线上购买"
+              >
+                <Switch
+                  checkedChildren="开"
+                  unCheckedChildren="关"
+                  disabled={!form.getFieldValue('allowOnlinePurchase')}
+                />
+              </Form.Item>
+            )}
+          </Form.Item>
+          <Form.Item name="allowOnSitePickup" label="允许现场取货" valuePropName="checked">
+            <Switch checkedChildren="开" unCheckedChildren="关" />
+          </Form.Item>
+        </>
+      )}
       <VisibilityWhitelistFields form={form} />
       <Form.Item name="coverUrl" label="封面">
         <OssUpload bizType="COVER" mediaType="IMAGE" />
@@ -325,13 +389,36 @@ export default function ProductsPage() {
     }
   }
 
-  const columns: ColumnsType<Row> = useMemo(() => [
-    { title: 'SKU', dataIndex: 'skuCode', width: 90 },
-    { title: '商品名', dataIndex: 'name', width: 180, ellipsis: true },
+  const baseColumns: ColumnsType<Row> = useMemo(() => [
     { title: '香型', dataIndex: 'aromaType', width: 80, render: (v) => AROMA_TYPE_LABELS[v] || v },
-    { title: '规格', dataIndex: 'spec', width: 120, ellipsis: true },
-    { title: '售价', dataIndex: 'price', width: 80, render: (v) => `¥${v}` },
-    { title: '权益额', dataIndex: 'benefitAmount', width: 80, render: (v) => `¥${v}` },
+    { title: '品名', dataIndex: 'name', width: 200 },
+    {
+      title: '累计销售',
+      dataIndex: 'soldBottles',
+      width: 110,
+      render: (v: number | undefined) => `累计 ${v ?? 0} 瓶`,
+    },
+    {
+      title: '售价',
+      key: 'priceRange',
+      width: 120,
+      render: (_, row) => {
+        const min = row.priceMin ?? row.price;
+        const max = row.priceMax ?? row.price;
+        if (min === max) return `¥${min}`;
+        return `¥${min} ~ ¥${max}`;
+      },
+    },
+    {
+      title: '规格数',
+      dataIndex: 'skuCount',
+      width: 80,
+      render: (v: number | undefined, row) => {
+        const real = v ?? 0;
+        if (real > 0) return real;
+        return row.skus?.some((s) => s.virtual) ? 1 : 0;
+      },
+    },
     { title: '状态', dataIndex: 'status', width: 80, render: (s) => (
       <Tag color={s === 'ON_SALE' ? 'green' : undefined}>{PRODUCT_STATUS_LABELS[s] || s}</Tag>
     ) },
@@ -342,23 +429,7 @@ export default function ProductsPage() {
       render: (v: boolean) =>
         v ? <Tag color="orange">限测</Tag> : <Tag>公开</Tag>,
     },
-    {
-      title: '履约',
-      key: 'fulfillment',
-      width: 160,
-      render: (_, row) => (
-        <Space size={[0, 4]} wrap>
-          {row.allowOnlinePurchase !== false ? <Tag color="blue">线上</Tag> : null}
-          {row.allowOnlinePurchase !== false && row.allowCrossCityDelivery !== false ? (
-            <Tag color="cyan">跨城</Tag>
-          ) : null}
-          {row.allowOnSitePickup ? <Tag color="green">现场</Tag> : null}
-          {row.allowOnlinePurchase === false && !row.allowOnSitePickup ? <Tag>无</Tag> : null}
-        </Space>
-      ),
-    },
     { title: '排序', dataIndex: 'sortOrder', width: 60 },
-    { title: '创建', dataIndex: 'createdAt', width: 160, render: fmtTime },
     {
       title: '操作', width: 120,
       render: (_, row) => (
@@ -371,7 +442,7 @@ export default function ProductsPage() {
           }}>编辑</Button>
           <Popconfirm
             title="确认删除该商品？"
-            description={`将永久删除「${row.name}」（${row.skuCode}），此操作不可恢复。`}
+            description={`将永久删除「${row.name}」，此操作不可恢复。`}
             okText="确认删除"
             cancelText="取消"
             okButtonProps={{ danger: true }}
@@ -384,14 +455,62 @@ export default function ProductsPage() {
     },
   ], [detail, editForm]);
 
+  const skuColumns: ColumnsType<SkuListRow> = useMemo(() => [
+    {
+      title: '规格',
+      dataIndex: 'specText',
+      width: 140,
+      render: (v: string, row) => (
+        <Space size={4}>
+          <span>{v || '默认'}</span>
+          {row.isDefault ? <Tag color="blue">默认</Tag> : null}
+          {row.virtual ? <Tag>未建SKU</Tag> : null}
+        </Space>
+      ),
+    },
+    { title: 'SKU', dataIndex: 'skuCode', width: 110 },
+    { title: '69码', dataIndex: 'barcode69', width: 160 },
+    { title: '售价', dataIndex: 'price', width: 90, render: (v) => `¥${v}` },
+    { title: '权益额', dataIndex: 'benefitAmount', width: 90, render: (v) => `¥${v}` },
+    {
+      title: '累计销售',
+      dataIndex: 'soldBottles',
+      width: 100,
+      render: (v: number | undefined) => `${v ?? 0} 瓶`,
+    },
+    {
+      title: '履约',
+      key: 'fulfillment',
+      width: 160,
+      render: (_, row) => <FulfillmentTags {...row} />,
+    },
+    {
+      title: '状态',
+      dataIndex: 'status',
+      width: 90,
+      render: (s) => (
+        <Tag color={s === 'ON_SALE' ? 'green' : undefined}>{PRODUCT_STATUS_LABELS[s] || s}</Tag>
+      ),
+    },
+  ], []);
+
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('products', baseColumns, {
+    page,
+    pageSize,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
         <Typography.Title level={4} style={{ margin: 0 }}>商品管理</Typography.Title>
+          {settingsButton}
         <Button type="primary" onClick={() => setCreateOpen(true)}>新建商品</Button>
       </Space>
       <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={(v) => { setFilters(v); setPage(1); }}>
-        <Form.Item name="name" label="名称"><Input allowClear /></Form.Item>
+        <Form.Item name="name" label="名称">
+          <Input allowClear placeholder="名称 / SKU / 69 码" style={{ width: 200 }} />
+        </Form.Item>
         <Form.Item name="status" label="状态">
           <Select allowClear style={{ width: 110 }} options={Object.entries(PRODUCT_STATUS_LABELS).map(([value, label]) => ({ value, label }))} />
         </Form.Item>
@@ -400,17 +519,46 @@ export default function ProductsPage() {
         </Form.Item>
         <Form.Item><Button type="primary" htmlType="submit">查询</Button></Form.Item>
       </Form>
-      <Table rowKey="id" className="admin-table-nowrap" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 1320 }}
-        pagination={{ current: page, pageSize, total: data?.total ?? 0, showSizeChanger: true, onChange: (p, ps) => { setPage(p); setPageSize(ps); } }} />
-      <Drawer title="编辑商品" width={720} open={drawerOpen} onClose={() => setDrawerOpen(false)}
+      <Table
+        rowKey="id"
+        className="admin-table-nowrap"
+        loading={loading}
+        columns={columns}
+        dataSource={data?.items ?? []}
+        scroll={{ x: 'max-content' }}
+        expandable={{
+          rowExpandable: () => true,
+          expandedRowRender: (row) => (
+            <div style={{ margin: '-8px -8px -8px 24px', padding: 12, background: '#f5f5f5', borderRadius: 6 }}>
+              <Table
+                size="small"
+                rowKey="id"
+                pagination={false}
+                columns={skuColumns}
+                dataSource={row.skus ?? []}
+                scroll={{ x: 'max-content' }}
+                style={{ background: 'transparent' }}
+              />
+            </div>
+          ),
+        }}
+        pagination={{ current: page, pageSize, total: data?.total ?? 0, showSizeChanger: true, onChange: (p, ps) => { setPage(p); setPageSize(ps); } }}
+      />
+      <Drawer title="编辑商品" width={1100} open={drawerOpen} onClose={() => setDrawerOpen(false)}
         extra={detail && (
           <Button type="primary" onClick={async () => {
             const v = await editForm.validateFields();
-            if (!v.allowOnlinePurchase && !v.allowOnSitePickup) {
+            const multiSku = Array.isArray(detail.skus) && (detail.skus as unknown[]).length > 1;
+            if (!multiSku && !v.allowOnlinePurchase && !v.allowOnSitePickup) {
               message.error('请至少勾选「允许线上购买」或「允许现场取货」之一');
               return;
             }
             const payload = buildProductPayload(v);
+            if (multiSku) {
+              delete (payload as { allowOnlinePurchase?: boolean }).allowOnlinePurchase;
+              delete (payload as { allowCrossCityDelivery?: boolean }).allowCrossCityDelivery;
+              delete (payload as { allowOnSitePickup?: boolean }).allowOnSitePickup;
+            }
             await request(`/admin/products/${detail.id}`, { method: 'PUT', body: JSON.stringify(payload) });
             message.success('已保存');
             setDrawerOpen(false);
@@ -420,13 +568,24 @@ export default function ProductsPage() {
         {detail && (
           <>
             <Descriptions column={1} bordered size="small" style={{ marginBottom: 16 }}>
-              <Descriptions.Item label="SKU">{String(detail.skuCode)}</Descriptions.Item>
-              <Descriptions.Item label="69码">{String(detail.barcode69)}</Descriptions.Item>
+              <Descriptions.Item label="默认 SKU">{String(detail.skuCode)}（系统生成）</Descriptions.Item>
+              <Descriptions.Item label="默认 69 码">{String(detail.barcode69)}</Descriptions.Item>
               <Descriptions.Item label="香型">{AROMA_TYPE_LABELS[String(detail.aromaType)] || String(detail.aromaType)}</Descriptions.Item>
+              <Descriptions.Item label="创建时间">{fmtTime(String(detail.createdAt ?? ''))}</Descriptions.Item>
             </Descriptions>
             <Form form={editForm} layout="vertical">
               <Tabs items={[
-                { key: 'base', label: '基础信息', children: <BaseInfoFields mode="edit" form={editForm} /> },
+                {
+                  key: 'base',
+                  label: '基础信息',
+                  children: (
+                    <BaseInfoFields
+                      mode="edit"
+                      form={editForm}
+                      hideFulfillment={Array.isArray(detail.skus) && (detail.skus as unknown[]).length > 1}
+                    />
+                  ),
+                },
                 {
                   key: 'detail',
                   label: '详情页',
@@ -437,6 +596,23 @@ export default function ProductsPage() {
                     />
                   ),
                 },
+                {
+                  key: 'specs',
+                  label: '规格与 SKU',
+                  children: (
+                    <ProductSpecsEditor
+                      productId={String(detail.id)}
+                      initialAttrs={(detail.specAttrs as never) ?? []}
+                      initialSkus={(detail.skus as never) ?? []}
+                      onSaved={async () => {
+                        const d = await request<Record<string, unknown>>(`/admin/products/${detail.id}`);
+                        setDetail(d);
+                        editForm.setFieldsValue(mapDetailToForm(d));
+                        void reload();
+                      }}
+                    />
+                  ),
+                },
               ]} />
             </Form>
           </>

apps/admin-web/src/pages/PromoCodesPage.tsx

@@ -14,6 +14,8 @@ import {
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = PromoCodeItem;
 
@@ -74,8 +76,8 @@ export default function PromoCodesPage() {
     void loadScenes();
   }, []);
 
-  const columns: ColumnsType<Row> = [
-    { title: '名称', dataIndex: 'name', width: 160, ellipsis: true },
+  const baseColumns: ColumnsType<Row> = [
+    { title: '名称', dataIndex: 'name', width: 160 },
     { title: '码值', dataIndex: 'code', width: 110 },
     {
       title: '场景',
@@ -160,10 +162,14 @@ export default function PromoCodesPage() {
     }
   }
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('promo-codes', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 16 }}>
         <Typography.Title level={4} style={{ margin: 0 }}>推广码管理</Typography.Title>
+          {settingsButton}
         <Button type="primary" onClick={() => setCreateOpen(true)}>创建推广码</Button>
       </div>
 
@@ -194,7 +200,7 @@ export default function PromoCodesPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1200 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,

apps/admin-web/src/pages/RedeemRecordsPage.tsx

@@ -7,6 +7,8 @@ import RedeemRecordDetailDescriptions from '../components/RedeemRecordDetailDesc
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -75,7 +77,7 @@ export default function RedeemRecordsPage() {
     }
   }, [data, initialRedeemNo, loading]);
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     {
       title: '核销号',
       dataIndex: 'redeemNo',
@@ -133,9 +135,13 @@ export default function RedeemRecordsPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('redeem-records', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Typography.Title level={4}>核销记录</Typography.Title>
+          {settingsButton}
       <Form
         form={form}
         layout="inline"
@@ -175,7 +181,7 @@ export default function RedeemRecordsPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1300 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,

apps/admin-web/src/pages/ResourcesPage.tsx

@@ -12,6 +12,8 @@ import {
   fmtTime,
 } from '../lib/constants';
 import OssUpload from '../components/OssUpload';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -58,7 +60,7 @@ export default function ResourcesPage() {
     void reload();
   }, []);
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: 'ID', dataIndex: 'id', width: 80 },
     {
       title: '归属',
@@ -84,8 +86,8 @@ export default function ResourcesPage() {
           </a>
         ),
     },
-    { title: 'URL', dataIndex: 'url', ellipsis: true },
-    { title: 'OSS Key', dataIndex: 'ossKey', ellipsis: true, width: 160 },
+    { title: 'URL', dataIndex: 'url' },
+    { title: 'OSS Key', dataIndex: 'ossKey', width: 160 },
     { title: '排序', dataIndex: 'sortOrder', width: 60 },
     {
       title: '状态',
@@ -114,12 +116,16 @@ export default function ResourcesPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('resources', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
         <Typography.Title level={4} style={{ margin: 0 }}>
           OSS 资源库
         </Typography.Title>
+          {settingsButton}
         <Button type="primary" onClick={() => setCreateOpen(true)}>
           登记资源
         </Button>
@@ -170,7 +176,7 @@ export default function ResourcesPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1200 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,

apps/admin-web/src/pages/StoreAccountsPage.tsx

@@ -6,6 +6,8 @@ import type { ColumnsType } from 'antd/es/table';
 import { request, type Paginated } from '../lib/api';
 import { ACCOUNT_STATUS_LABELS, ADMIN_OPTIONS_PAGE_SIZE, STORE_STATUS_LABELS, fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type StoreBrief = { id: string; name: string; status: string; cityName?: string };
 
@@ -74,7 +76,7 @@ export default function StoreAccountsPage() {
     }
   }
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     {
       title: '姓名',
       dataIndex: 'name',
@@ -138,11 +140,15 @@ export default function StoreAccountsPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('store-accounts', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
         <Space direction="vertical" size={0}>
           <Typography.Title level={4} style={{ margin: 0 }}>门店账户</Typography.Title>
+          {settingsButton}
           <Typography.Text type="secondary">
             主账号可绑定多家门店；收款信息挂在主账号；「新建账户」用于补录无主账号门店
           </Typography.Text>
@@ -185,7 +191,7 @@ export default function StoreAccountsPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1100 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,

apps/admin-web/src/pages/StoreCategoriesPage.tsx

@@ -3,7 +3,9 @@ import {
   Button, Form, Input, InputNumber, Modal, Popconfirm, Select, Space, Table, Tag, Typography, message,
 } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
-import { request } from '../lib/api';
+import { request, type HqProfile } from '../lib/api';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type CategoryNode = {
   id: string;
@@ -38,7 +40,9 @@ export default function StoreCategoriesPage() {
   const [loading, setLoading] = useState(false);
   const [modalOpen, setModalOpen] = useState(false);
   const [editing, setEditing] = useState<FlatRow | null>(null);
+  const [profile, setProfile] = useState<HqProfile | null>(null);
   const [form] = Form.useForm();
+  const canDelete = (profile?.permissionKeys ?? []).includes('store_categories_delete');
 
   const rows = useMemo(() => flattenTree(tree), [tree]);
   const rootOptions = useMemo(
@@ -60,6 +64,7 @@ export default function StoreCategoriesPage() {
 
   useEffect(() => {
     void reload();
+    request<HqProfile>('/admin/auth/me').then(setProfile).catch(() => {});
   }, []);
 
   function openCreate(parentId?: string) {
@@ -112,7 +117,7 @@ export default function StoreCategoriesPage() {
     void reload();
   }
 
-  const columns: ColumnsType<FlatRow> = [
+  const baseColumns: ColumnsType<FlatRow> = [
     {
       title: '层级',
       dataIndex: 'level',
@@ -141,45 +146,56 @@ export default function StoreCategoriesPage() {
     },
     {
       title: '操作',
-      width: 220,
+      width: canDelete ? 220 : 160,
       render: (_, row) => (
         <Space wrap>
           <Button type="link" size="small" onClick={() => openEdit(row)}>编辑</Button>
           {row.level === 1 ? (
             <Button type="link" size="small" onClick={() => openCreate(row.id)}>加二级</Button>
           ) : null}
-          <Popconfirm
-            title={row.level === 1 ? '删除一级分类？若有门店占用将改为停用' : '删除该分类？若有门店占用将改为停用'}
-            onConfirm={async () => {
-              await request(`/admin/store-categories/${row.id}`, { method: 'DELETE' });
-              message.success('已处理');
-              void reload();
-            }}
-          >
-            <Button type="link" size="small" danger>删除</Button>
-          </Popconfirm>
+          {canDelete ? (
+            <Popconfirm
+              title={row.level === 1 ? '删除一级分类？若有门店占用将改为停用' : '删除该分类？若有门店占用将改为停用'}
+              onConfirm={async () => {
+                await request(`/admin/store-categories/${row.id}`, { method: 'DELETE' });
+                message.success('已处理');
+                void reload();
+              }}
+            >
+              <Button type="link" size="small" danger>删除</Button>
+            </Popconfirm>
+          ) : null}
         </Space>
       ),
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('store-categories', baseColumns, {
+    page: 1,
+    pageSize: rows.length || 20,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
         <Space direction="vertical" size={0}>
           <Typography.Title level={4} style={{ margin: 0 }}>门店分类</Typography.Title>
+          {settingsButton}
           <Typography.Text type="secondary">两级分类：一级（餐饮/住宿/娱乐）→ 二级业态，供合伙人开店选择</Typography.Text>
         </Space>
         <Space>
-          <Button
-            onClick={async () => {
-              await request('/admin/store-categories/ensure-defaults', { method: 'POST' });
-              message.success('已同步默认分类');
-              void reload();
-            }}
-          >
-            同步默认分类
-          </Button>
+          {canDelete ? (
+            <Button
+              onClick={async () => {
+                await request('/admin/store-categories/ensure-defaults', { method: 'POST' });
+                message.success('已同步默认分类');
+                void reload();
+              }}
+            >
+              同步默认分类
+            </Button>
+          ) : null}
           <Button type="primary" onClick={() => openCreate()}>新增一级</Button>
         </Space>
       </Space>

apps/admin-web/src/pages/StoreLogsPage.tsx

@@ -12,6 +12,8 @@ import { request } from '../lib/api';
 import { AdminCellLine } from '../components/AdminCellLine';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -80,14 +82,14 @@ export default function StoreLogsPage() {
     form.setFieldsValue(filters);
   }, [form, filters]);
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
     {
-      title: '门店', width: 180, ellipsis: true,
+      title: '门店', width: 180,
       render: (_, r) => <AdminCellLine primary={r.storeName} secondary={r.storeId} />,
     },
     {
-      title: '账号', width: 150, ellipsis: true,
+      title: '账号', width: 150,
       render: (_, r) => (
         <AdminCellLine
           primary={r.accountName}
@@ -111,7 +113,7 @@ export default function StoreLogsPage() {
       render: (_, r) => (r.refType && r.refId ? `${r.refType}#${r.refId}` : '—'),
     },
     {
-      title: '摘要', ellipsis: true,
+      title: '摘要',
       render: (_, r) => summarizeExtra(r.extraJson),
     },
     {
@@ -127,9 +129,13 @@ export default function StoreLogsPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('logs-stores', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Typography.Title level={4}>商户日志</Typography.Title>
+          {settingsButton}
       <Typography.Paragraph type="secondary" style={{ marginTop: -8 }}>
         门店登录、微信授权、核销、打款与营业状态等操作记录；历史核销/打款数据来自业务表归档。
       </Typography.Paragraph>
@@ -164,7 +170,7 @@ export default function StoreLogsPage() {
         <Form.Item><Button type="primary" htmlType="submit">筛选</Button></Form.Item>
         <Form.Item><Button onClick={() => { form.resetFields(); setFilters({}); setCategory(''); setSearchParams({}); setPage(1); }}>重置</Button></Form.Item>
       </Form>
-      <Table rowKey="id" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 1200 }}
+      <Table rowKey="id" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 'max-content' }}
         pagination={{ current: page, pageSize, total: data?.total ?? 0, showSizeChanger: true, onChange: (p, ps) => { setPage(p); setPageSize(ps); } }} />
       <Drawer title="商户日志详情" width={560} open={drawerOpen} onClose={() => setDrawerOpen(false)}>
         {detail && (

apps/admin-web/src/pages/StoreMediaPage.tsx

@@ -7,6 +7,8 @@ import { request, type Paginated } from '../lib/api';
 import { ADMIN_OPTIONS_PAGE_SIZE, MEDIA_TYPE_LABELS, fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
 import OssUpload from '../components/OssUpload';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string; mediaType: string; url: string; sortOrder: number; createdAt: string;
@@ -40,7 +42,7 @@ export default function StoreMediaPage() {
     setStores(res.items);
   }
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: '门店', dataIndex: ['store', 'name'], width: 140 },
     { title: '类型', dataIndex: 'mediaType', width: 80, render: (t) => <Tag>{MEDIA_TYPE_LABELS[t] || t}</Tag> },
     {
@@ -49,7 +51,7 @@ export default function StoreMediaPage() {
         ? <Image src={url} width={60} height={40} style={{ objectFit: 'cover' }} />
         : <a href={url} target="_blank" rel="noreferrer">视频</a>,
     },
-    { title: 'URL', dataIndex: 'url', ellipsis: true },
+    { title: 'URL', dataIndex: 'url' },
     { title: '排序', dataIndex: 'sortOrder', width: 70 },
     { title: '创建', dataIndex: 'createdAt', width: 160, render: fmtTime },
     {
@@ -73,10 +75,14 @@ export default function StoreMediaPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('store-media', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
         <Typography.Title level={4} style={{ margin: 0 }}>门店资源</Typography.Title>
+          {settingsButton}
         <Button type="primary" onClick={() => { void loadStores(); setCreateOpen(true); }}>新增资源</Button>
       </Space>
       <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={(v) => { setFilters(v); setPage(1); }}>
@@ -86,7 +92,7 @@ export default function StoreMediaPage() {
         </Form.Item>
         <Form.Item><Button type="primary" htmlType="submit">查询</Button></Form.Item>
       </Form>
-      <Table rowKey="id" className="admin-table-nowrap" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 900 }}
+      <Table rowKey="id" className="admin-table-nowrap" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 'max-content' }}
         pagination={{ current: page, pageSize, total: data?.total ?? 0, showSizeChanger: true, onChange: (p, ps) => { setPage(p); setPageSize(ps); } }} />
       <Modal title="新增门店资源" open={createOpen} onCancel={() => setCreateOpen(false)} onOk={async () => {
         const v = await createForm.validateFields();

apps/admin-web/src/pages/StorePackageAuditsPage.tsx

@@ -32,6 +32,7 @@ import { request, type Paginated } from '../lib/api';
 import { notifyPackageAuditChanged } from '../lib/admin-events';
 import { fmtTime } from '../lib/constants';
 import StorePackageAuditPanel from '../components/StorePackageAuditPanel';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
 
 const HQ_PACKAGE_STATUS_LABELS: Record<StorePackageChangeStatus, string> = {
   PENDING: '待审核',
@@ -55,10 +56,12 @@ function InfoChangeImageDiff({
   field,
   live,
   proposed,
+  imageSize = 72,
 }: {
   field: string;
   live: unknown;
   proposed: unknown;
+  imageSize?: number;
 }) {
   const liveUrls =
     field === 'coverUrl'
@@ -83,7 +86,7 @@ function InfoChangeImageDiff({
           <Image.PreviewGroup>
             <Space wrap size={8}>
               {liveUrls.map((url) => (
-                <Image key={`live-${url}`} src={url} width={72} height={72} style={{ objectFit: 'cover', borderRadius: 4 }} />
+                <Image key={`live-${url}`} src={url} width={imageSize} height={imageSize} style={{ objectFit: 'cover', borderRadius: 4 }} />
               ))}
             </Space>
           </Image.PreviewGroup>
@@ -99,7 +102,7 @@ function InfoChangeImageDiff({
           <Image.PreviewGroup>
             <Space wrap size={8}>
               {proposedUrls.map((url) => (
-                <Image key={`new-${url}`} src={url} width={72} height={72} style={{ objectFit: 'cover', borderRadius: 4 }} />
+                <Image key={`new-${url}`} src={url} width={imageSize} height={imageSize} style={{ objectFit: 'cover', borderRadius: 4 }} />
               ))}
             </Space>
           </Image.PreviewGroup>
@@ -128,6 +131,7 @@ function InfoChangeAuditPanel({
   const [rejectOpen, setRejectOpen] = useState(false);
   const [rejectReason, setRejectReason] = useState('');
   const [activeId, setActiveId] = useState<string | null>(null);
+  const [infoFullscreen, setInfoFullscreen] = useState(false);
 
   async function reload(nextPage = page, nextStatus = status) {
     setLoading(true);
@@ -286,25 +290,33 @@ function InfoChangeAuditPanel({
 
       <Drawer
         title={detail ? `${detail.storeName || detail.storeId} · 信息变更` : '信息变更详情'}
-        width={680}
+        width={infoFullscreen ? '100%' : 680}
         open={detailOpen}
-        onClose={() => setDetailOpen(false)}
+        onClose={() => {
+          setDetailOpen(false);
+          setInfoFullscreen(false);
+        }}
         extra={
-          detail?.status === 'PENDING' ? (
-            <Space>
-              <Button onClick={() => void audit(detail.id, 'APPROVE')}>通过</Button>
-              <Button
-                danger
-                onClick={() => {
-                  setActiveId(detail.id);
-                  setRejectReason('');
-                  setRejectOpen(true);
-                }}
-              >
-                驳回
-              </Button>
-            </Space>
-          ) : null
+          <Space>
+            <Button onClick={() => setInfoFullscreen((v) => !v)}>
+              {infoFullscreen ? '退出全屏' : '全屏查看'}
+            </Button>
+            {detail?.status === 'PENDING' ? (
+              <>
+                <Button onClick={() => void audit(detail.id, 'APPROVE')}>通过</Button>
+                <Button
+                  danger
+                  onClick={() => {
+                    setActiveId(detail.id);
+                    setRejectReason('');
+                    setRejectOpen(true);
+                  }}
+                >
+                  驳回
+                </Button>
+              </>
+            ) : null}
+          </Space>
         }
       >
         {detailLoading ? (
@@ -328,7 +340,12 @@ function InfoChangeAuditPanel({
                     label={STORE_INFO_CHANGEABLE_FIELD_LABELS[d.field] ?? d.field}
                   >
                     {d.field === 'coverUrl' || d.field === 'envPhotoUrls' ? (
-                      <InfoChangeImageDiff field={d.field} live={d.live} proposed={d.proposed} />
+                      <InfoChangeImageDiff
+                        field={d.field}
+                        live={d.live}
+                        proposed={d.proposed}
+                        imageSize={infoFullscreen ? 160 : 72}
+                      />
                     ) : (
                       <span>
                         <Typography.Text delete type="secondary">
@@ -388,6 +405,7 @@ export default function StorePackageAuditsPage() {
   const [detailOpen, setDetailOpen] = useState(false);
   const [activeRequestId, setActiveRequestId] = useState<string | null>(null);
   const [drawerTitle, setDrawerTitle] = useState('套餐变更详情');
+  const [packageFullscreen, setPackageFullscreen] = useState(false);
 
   async function reload(nextPage = page, nextStatus = status) {
     setLoading(true);
@@ -452,7 +470,7 @@ export default function StorePackageAuditsPage() {
     }
   }
 
-  const columns: ColumnsType<StorePackageChangeRequestDto> = [
+  const baseColumns: ColumnsType<StorePackageChangeRequestDto> = [
     { title: '门店', dataIndex: 'storeName', render: (_, row) => row.storeName || row.storeId },
     {
       title: '状态',
@@ -502,9 +520,16 @@ export default function StorePackageAuditsPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('store-package-audits', baseColumns, {
+    page,
+    pageSize: 20,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Typography.Title level={4}>审核通知</Typography.Title>
+      {settingsButton}
       <Tabs
         activeKey={activeTab}
         onChange={setActiveTab}
@@ -554,14 +579,23 @@ export default function StorePackageAuditsPage() {
 
       <Drawer
         title={drawerTitle}
-        width={880}
+        width={packageFullscreen ? '100%' : 880}
         open={detailOpen}
-        onClose={() => setDetailOpen(false)}
+        onClose={() => {
+          setDetailOpen(false);
+          setPackageFullscreen(false);
+        }}
         destroyOnClose
+        extra={
+          <Button onClick={() => setPackageFullscreen((v) => !v)}>
+            {packageFullscreen ? '退出全屏' : '全屏查看'}
+          </Button>
+        }
       >
         {activeRequestId ? (
           <StorePackageAuditPanel
             requestId={activeRequestId}
+            fullscreen={packageFullscreen}
             onAudited={() => {
               setDetailOpen(false);
               void reload(page, status);

apps/admin-web/src/pages/StoreRatingsPage.tsx

@@ -1,9 +1,12 @@
-import { useState } from 'react';
-import { Button, Form, Input, Table, Typography } from 'antd';
+import { useEffect, useState } from 'react';
+import { Button, Form, Input, Select, Table, Typography } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
 import { useSearchParams } from 'react-router-dom';
-import { fmtTime } from '../lib/constants';
+import { fmtTime, ADMIN_OPTIONS_PAGE_SIZE } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { request, type Paginated } from '../lib/api';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -20,22 +23,30 @@ export default function StoreRatingsPage() {
   const [searchParams] = useSearchParams();
   const initialStoreId = searchParams.get('storeId') || '';
   const [form] = Form.useForm();
+  const [cities, setCities] = useState<{ id: string; name: string }[]>([]);
   const [filters, setFilters] = useState<Record<string, string>>({
     ...(initialStoreId ? { storeId: initialStoreId } : {}),
   });
 
+  useEffect(() => {
+    request<Paginated<{ id: string; name: string }>>(`/admin/cities?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`)
+      .then((res) => setCities(res.items))
+      .catch(() => {});
+  }, []);
+
   const { data, loading, page, pageSize, setPage, setPageSize } = useAdminList<Row>(
     '/admin/store-ratings',
     () => {
       const qs = new URLSearchParams();
       if (filters.storeId) qs.set('storeId', filters.storeId);
+      if (filters.cityId) qs.set('cityId', filters.cityId);
       if (filters.redeemNo) qs.set('redeemNo', filters.redeemNo);
       return qs;
     },
     [filters],
   );
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: '核销号', dataIndex: 'redeemNo', width: 180 },
     {
       title: '门店',
@@ -53,11 +64,15 @@ export default function StoreRatingsPage() {
     { title: '评价时间', dataIndex: 'createdAt', width: 170, render: fmtTime },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('store-ratings', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Typography.Title level={4} style={{ marginTop: 0 }}>
         门店评价
       </Typography.Title>
+          {settingsButton}
       <Form
         form={form}
         layout="inline"
@@ -66,11 +81,22 @@ export default function StoreRatingsPage() {
         onFinish={(v) => {
           setFilters({
             storeId: v.storeId || '',
+            cityId: v.cityId || '',
             redeemNo: v.redeemNo || '',
           });
           setPage(1);
         }}
       >
+        <Form.Item name="cityId" label="城市">
+          <Select
+            allowClear
+            showSearch
+            optionFilterProp="label"
+            style={{ width: 140 }}
+            placeholder="全部"
+            options={cities.map((c) => ({ value: c.id, label: c.name }))}
+          />
+        </Form.Item>
         <Form.Item name="storeId" label="门店ID">
           <Input allowClear placeholder="storeId" />
         </Form.Item>

apps/admin-web/src/pages/StoreWithdrawalsPage.tsx

@@ -20,6 +20,8 @@ import { STORE_WITHDRAW_STATUS_LABELS, type StoreWithdrawStatus } from '@dukang/
 import { request, type Paginated } from '../lib/api';
 import { ADMIN_OPTIONS_PAGE_SIZE, fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -147,7 +149,7 @@ export default function StoreWithdrawalsPage() {
     });
   }
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     {
       title: '提现单号',
       dataIndex: 'withdrawNo',
@@ -229,11 +231,15 @@ export default function StoreWithdrawalsPage() {
       }
     | undefined;
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('finance-store-withdrawals', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Typography.Title level={4} style={{ marginTop: 0 }}>
         门店提现审
       </Typography.Title>
+          {settingsButton}
       {overdueSummary ? (
         <Typography.Paragraph type="secondary">
           待审 {overdueSummary.pendingCount} 笔
@@ -299,7 +305,7 @@ export default function StoreWithdrawalsPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1100 }}
+        scroll={{ x: 'max-content' }}
         rowClassName={(row) => (row.overdue ? 'ant-table-row-selected' : '')}
         pagination={{
           current: page,

apps/admin-web/src/pages/StoresPage.tsx

@@ -39,6 +39,7 @@ import {
   type StoreCreateForm,
 } from '../lib/storeCreate';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
 import { resolveRegionBinding } from '../lib/china-region';
 import ChinaRegionCascader from '../components/ChinaRegionCascader';
 import OssUpload from '../components/OssUpload';
@@ -198,6 +199,9 @@ type StoreRow = {
   pendingPackageAuditId?: string | null;
   /** 该门店当前待审核信息变更的 requestId（无则为空） */
   pendingInfoChangeId?: string | null;
+  /** 累计核销好客权益（券面额合计） */
+  totalRedeemedBenefitAmount?: number;
+  contactPhone?: string | null;
   isTest?: boolean;
   cityRef?: { name: string; code: string };
   partner?: { id?: string; companyName?: string | null; name?: string | null; phone?: string | null };
@@ -720,47 +724,60 @@ export default function StoresPage() {
     }
   }
 
-  const columns: ColumnsType<StoreRow> = [
+  const baseColumns: ColumnsType<StoreRow> = [
     {
+      key: 'coverUrl',
       title: '封面', dataIndex: 'coverUrl', width: 72,
       render: (url) => url ? <Image src={url} width={48} height={48} style={{ objectFit: 'cover', borderRadius: 4 }} /> : '—',
     },
     {
+      key: 'name',
       title: '门店名',
       dataIndex: 'name',
       width: 180,
-      ellipsis: { showTitle: false },
       render: (v: string, row) => {
         const name = v || '—';
         return (
-          <Space size={4} style={{ maxWidth: '100%' }} wrap={false}>
-            <Typography.Text ellipsis={{ tooltip: name }} style={{ maxWidth: row.isTest ? 110 : 160 }}>
-              {name}
-            </Typography.Text>
+          <Space size={4} wrap={false}>
+            <span>{name}</span>
             {row.isTest ? <Tag color="orange">测试</Tag> : null}
           </Space>
         );
       },
     },
     {
+      key: 'category',
       title: '分类',
       width: 100,
-      ellipsis: true,
       render: (_, row) => row.category?.name || '—',
     },
-    { title: '城市', dataIndex: 'cityName', width: 80, ellipsis: true },
-    { title: '登录号', dataIndex: 'phone', width: 120 },
+    { key: 'cityName', title: '城市', dataIndex: 'cityName', width: 80 },
+    { key: 'phone', title: '登录号', dataIndex: 'phone', width: 120 },
     {
+      key: 'contactPhone',
       title: '联系电话',
       dataIndex: 'contactPhone',
       width: 120,
       render: (v: string | null | undefined, row) => v || row.phone,
     },
     {
+      key: 'status',
       title: '营业状态', dataIndex: 'status', width: 90,
       render: (s) => <Tag>{STORE_STATUS_LABELS[s] || s}</Tag>,
     },
     {
+      key: 'totalRedeemedBenefitAmount',
+      title: '累计核销好客权益',
+      dataIndex: 'totalRedeemedBenefitAmount',
+      width: 150,
+      align: 'right',
+      render: (v: number | undefined) => {
+        const n = Number(v ?? 0);
+        return n > 0 ? `¥${n.toFixed(2)}` : '—';
+      },
+    },
+    {
+      key: 'auditStatus',
       title: '审核', dataIndex: 'auditStatus', width: 100,
       render: (s, row) => {
         const status = s || 'APPROVED';
@@ -769,7 +786,7 @@ export default function StoresPage() {
           <Space direction="vertical" size={0} style={{ maxWidth: '100%' }}>
             <Tag color={color}>{STORE_AUDIT_STATUS_LABELS[status] || status}</Tag>
             {status === 'REJECTED' && row.rejectReason ? (
-              <Typography.Text type="secondary" style={{ fontSize: 12, maxWidth: 88 }} ellipsis={{ tooltip: row.rejectReason }}>
+              <Typography.Text type="secondary" style={{ fontSize: 12 }}>
                 {row.rejectReason}
               </Typography.Text>
             ) : null}
@@ -778,32 +795,29 @@ export default function StoresPage() {
       },
     },
     {
+      key: 'partner',
       title: '开城合伙人',
       dataIndex: 'partner',
       width: 140,
-      ellipsis: { showTitle: false },
       render: (partner: StoreRow['partner']) => {
         if (!partner) return '—';
-        const label = partnerOptionLabel({ id: partner.id ?? '', ...partner });
-        return (
-          <Typography.Text ellipsis={{ tooltip: label }} style={{ maxWidth: 124 }}>
-            {label}
-          </Typography.Text>
-        );
+        return partnerOptionLabel({ id: partner.id ?? '', ...partner });
       },
     },
     {
+      key: 'visibilityWhitelistEnabled',
       title: '可见',
       dataIndex: 'visibilityWhitelistEnabled',
       width: 90,
       render: (v) =>
         v ? <Tag color="orange">限测</Tag> : <Tag>公开</Tag>,
     },
-    { title: '介绍', dataIndex: 'intro', width: 160, ellipsis: true, render: (v) => v || '—' },
-    { title: '排序', dataIndex: 'sortOrder', width: 70 },
-    { title: '店长', dataIndex: ['account', 'name'], width: 90, ellipsis: true, render: (v) => v || '—' },
-    { title: '创建', dataIndex: 'createdAt', width: 160, render: fmtTime },
+    { key: 'intro', title: '介绍', dataIndex: 'intro', width: 160, render: (v) => v || '—' },
+    { key: 'sortOrder', title: '排序', dataIndex: 'sortOrder', width: 70 },
+    { key: 'accountName', title: '店长', dataIndex: ['account', 'name'], width: 90, render: (v) => v || '—' },
+    { key: 'createdAt', title: '创建', dataIndex: 'createdAt', width: 160, render: fmtTime },
     {
+      key: 'actions',
       title: '操作',
       width: 280,
       fixed: 'right',
@@ -850,14 +864,23 @@ export default function StoresPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('stores', baseColumns, {
+    page,
+    pageSize,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
         <Space direction="vertical" size={0}>
           <Typography.Title level={4} style={{ margin: 0 }}>门店</Typography.Title>
           <Typography.Text type="secondary">共 {data?.total ?? 0} 家门店（含合伙人录入）</Typography.Text>
         </Space>
-        <Button type="primary" onClick={openCreateModal}>新建门店</Button>
+        <Space>
+          {settingsButton}
+          <Button type="primary" onClick={openCreateModal}>新建门店</Button>
+        </Space>
       </Space>
       <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={(v) => { setFilters(v); setPage(1); }}>
         <Form.Item name="name" label="名称"><Input allowClear /></Form.Item>
@@ -918,7 +941,7 @@ export default function StoresPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1720 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,

apps/admin-web/src/pages/SupportTicketsPage.tsx

@@ -46,6 +46,8 @@ import { request, type HqProfile } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
 import OssUpload from '../components/OssUpload';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 const DISPATCH_WECOM_STORAGE_KEY = 'support_ticket_dispatch_wecom';
 const DEFAULT_DISPATCH_SUPPLEMENT = '请按以下任务进入开发流程';
@@ -218,8 +220,13 @@ export default function SupportTicketsPage() {
 
     setReviewOpen(false);
     const summary = [detail!.title, detail!.content].filter(Boolean).join('\n').slice(0, 500);
+    const ticketUrls = (detail!.attachmentUrls ?? []).filter(Boolean);
     tasksForm.setFieldsValue({
-      tasks: [{ content: summary || detail!.title, type: mapSupportTicketTypeToDevPlanTask(detail!.ticketType) }],
+      tasks: [{
+        content: summary || detail!.title,
+        type: mapSupportTicketTypeToDevPlanTask(detail!.ticketType),
+        attachmentUrls: ticketUrls,
+      }],
       dispatchToWecom: localStorage.getItem(DISPATCH_WECOM_STORAGE_KEY) !== 'false',
       dispatchSupplement: DEFAULT_DISPATCH_SUPPLEMENT,
     });
@@ -364,7 +371,11 @@ export default function SupportTicketsPage() {
         body: JSON.stringify({
           decision: 'APPROVE',
           note: note?.trim() || undefined,
-          tasks: values.tasks.map((t) => ({ content: t.content.trim(), type: t.type })),
+          tasks: values.tasks.map((t) => ({
+            content: t.content.trim(),
+            type: t.type,
+            attachmentUrls: t.attachmentUrls?.length ? t.attachmentUrls : detail!.attachmentUrls,
+          })),
           dispatchToWecom: !!values.dispatchToWecom,
           dispatchSupplement: values.dispatchSupplement?.trim() || undefined,
         }),
@@ -461,7 +472,7 @@ export default function SupportTicketsPage() {
     }
   }
 
-  const columns: ColumnsType<TicketRow> = [
+  const baseColumns: ColumnsType<TicketRow> = [
     { title: '工单号', dataIndex: 'ticketNo', width: 180 },
     {
       title: '类型',
@@ -494,7 +505,7 @@ export default function SupportTicketsPage() {
         </Space>
       ),
     },
-    { title: '标题', dataIndex: 'title', ellipsis: true },
+    { title: '标题', dataIndex: 'title' },
     { title: '创建人', dataIndex: 'creatorName', width: 100 },
     { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
     {
@@ -537,8 +548,11 @@ export default function SupportTicketsPage() {
     return null;
   })();
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('support-tickets', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <div
         style={{
           display: 'flex',
@@ -550,6 +564,7 @@ export default function SupportTicketsPage() {
         <Typography.Title level={4} style={{ margin: 0 }}>
           技术支持
         </Typography.Title>
+          {settingsButton}
         <Space>
           {isSuperAdmin ? (
             <>
@@ -610,7 +625,7 @@ export default function SupportTicketsPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 900 }}
+        scroll={{ x: 'max-content' }}
         rowSelection={
           isSuperAdmin
             ? {

apps/admin-web/src/pages/TestWhitelistPage.tsx

@@ -20,6 +20,7 @@ import {
 import type { ColumnsType } from 'antd/es/table';
 import { request, type Paginated } from '../lib/api';
 import { fmtTime } from '../lib/constants';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
 
 const MOCK_KEYS = ['MOCK_SMS', 'MOCK_WECHAT', 'MOCK_PAY'] as const;
 
@@ -257,7 +258,6 @@ export default function TestWhitelistPage() {
     {
       title: '备注',
       dataIndex: 'note',
-      ellipsis: true,
       render: (v) => v || '—',
     },
     {
@@ -334,7 +334,7 @@ export default function TestWhitelistPage() {
     if (accountType === 'partner') {
       return [
         { title: '姓名', dataIndex: 'name', width: 100 },
-        { title: '公司', dataIndex: 'companyName', ellipsis: true, render: (v) => (v as string) || '—' },
+        { title: '公司', dataIndex: 'companyName', render: (v) => (v as string) || '—' },
         { title: '手机', dataIndex: 'phone', width: 120 },
         {
           title: '标记',
@@ -347,7 +347,7 @@ export default function TestWhitelistPage() {
     }
     if (accountType === 'store') {
       return [
-        { title: '门店名', dataIndex: 'name', width: 160, ellipsis: true },
+        { title: '门店名', dataIndex: 'name', width: 160 },
         { title: '城市', dataIndex: 'cityName', width: 90 },
         { title: '电话', dataIndex: 'phone', width: 120 },
         { title: '状态', dataIndex: 'status', width: 90 },
@@ -386,11 +386,18 @@ export default function TestWhitelistPage() {
     ];
   }
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('test-whitelist', phoneColumns, {
+    page: phonePage,
+    pageSize: phonePageSize,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Typography.Title level={4} style={{ marginTop: 0 }}>
         白名单管理
       </Typography.Title>
+      {settingsButton}
 
       <Card size="small" loading={mockLoading} style={{ marginBottom: 16 }}>
         <Typography.Text type="secondary" style={{ display: 'block', marginBottom: 12 }}>
@@ -472,7 +479,7 @@ export default function TestWhitelistPage() {
                 <Table
                   rowKey="id"
                   loading={phonesLoading}
-                  columns={phoneColumns}
+                  columns={columns}
                   dataSource={phones?.items ?? []}
                   pagination={{
                     current: phonePage,

apps/admin-web/src/pages/ThirdPartyLogsPage.tsx

@@ -4,6 +4,8 @@ import type { ColumnsType } from 'antd/es/table';
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -69,7 +71,7 @@ export default function ThirdPartyLogsPage() {
   const [detail, setDetail] = useState<Record<string, unknown> | null>(null);
   const [drawerOpen, setDrawerOpen] = useState(false);
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
     { title: 'Provider', dataIndex: 'provider', width: 120 },
     { title: '场景', dataIndex: 'scene', width: 120 },
@@ -87,12 +89,10 @@ export default function ThirdPartyLogsPage() {
     {
       title: '错误信息',
       dataIndex: 'errorMessage',
-      ellipsis: true,
       render: (v: string | null | undefined) => v || '—',
     },
     {
       title: '请求摘要',
-      ellipsis: true,
       render: (_, r) => summarizeJson(r.requestBody),
     },
     { title: '外部单号', dataIndex: 'externalNo', width: 140, render: (v) => v || '—' },
@@ -114,9 +114,16 @@ export default function ThirdPartyLogsPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('logs-third-party', baseColumns, {
+    page,
+    pageSize,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Typography.Title level={4}>第三方日志</Typography.Title>
+          {settingsButton}
       <Form
         layout="inline"
         style={{ marginBottom: 16 }}
@@ -143,7 +150,7 @@ export default function ThirdPartyLogsPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1200 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,

apps/admin-web/src/pages/TicketsPage.tsx

@@ -25,6 +25,8 @@ import {
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -115,7 +117,7 @@ export default function TicketsPage() {
     }
   }
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: '工单号', dataIndex: 'ticketNo', width: 180 },
     {
       title: '类型',
@@ -132,7 +134,7 @@ export default function TicketsPage() {
       ),
     },
     { title: '关联', width: 140, render: (_, r) => `${r.refType}#${r.refId}` },
-    { title: '备注', dataIndex: 'remark', ellipsis: true },
+    { title: '备注', dataIndex: 'remark' },
     { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
     {
       title: '操作',
@@ -154,8 +156,11 @@ export default function TicketsPage() {
 
   const evidenceUrls = detail?.extraJson?.evidenceUrls ?? [];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('tickets', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <div
         style={{
           display: 'flex',
@@ -167,6 +172,7 @@ export default function TicketsPage() {
         <Typography.Title level={4} style={{ margin: 0 }}>
           工单中心
         </Typography.Title>
+          {settingsButton}
         <Button type="primary" onClick={() => setCreateOpen(true)}>
           创建工单
         </Button>
@@ -205,7 +211,7 @@ export default function TicketsPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 900 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,

apps/admin-web/src/pages/UserLogsPage.tsx

@@ -7,6 +7,8 @@ import { request } from '../lib/api';
 import { AdminCellLine } from '../components/AdminCellLine';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -61,10 +63,10 @@ export default function UserLogsPage() {
     form.setFieldsValue(filters);
   }, [form, filters]);
 
-  const columns: ColumnsType<Row> = [
+  const baseColumns: ColumnsType<Row> = [
     { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
     {
-      title: '用户', width: 180, ellipsis: true,
+      title: '用户', width: 180,
       render: (_, r) => (
         <AdminCellLine
           primary={r.nickname || r.userNo}
@@ -84,7 +86,7 @@ export default function UserLogsPage() {
       render: (_, r) => (r.refType && r.refId ? `${r.refType}#${r.refId}` : '—'),
     },
     {
-      title: '摘要', ellipsis: true,
+      title: '摘要',
       render: (_, r) => summarizeExtra(r.extraJson),
     },
     {
@@ -98,9 +100,13 @@ export default function UserLogsPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('logs-users', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Typography.Title level={4}>用户日志</Typography.Title>
+          {settingsButton}
       <Segmented
         style={{ marginBottom: 16 }}
         options={USER_LOG_CATEGORY_OPTIONS.map((o) => ({ value: o.value, label: o.label }))}
@@ -131,7 +137,7 @@ export default function UserLogsPage() {
         <Form.Item><Button type="primary" htmlType="submit">筛选</Button></Form.Item>
         <Form.Item><Button onClick={() => { form.resetFields(); setFilters({}); setCategory(''); setSearchParams({}); setPage(1); }}>重置</Button></Form.Item>
       </Form>
-      <Table rowKey="id" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 1000 }}
+      <Table rowKey="id" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 'max-content' }}
         pagination={{ current: page, pageSize, total: data?.total ?? 0, showSizeChanger: true, onChange: (p, ps) => { setPage(p); setPageSize(ps); } }} />
       <Drawer title="日志详情" width={520} open={drawerOpen} onClose={() => setDrawerOpen(false)}>
         {detail && (

apps/admin-web/src/pages/UsersPage.tsx

@@ -1,4 +1,4 @@
-import { useCallback, useEffect, useState } from 'react';
+import { useCallback, useEffect, useRef, useState } from 'react';
 import { Link, useLocation, useNavigate } from 'react-router-dom';
 import {
   Alert,
@@ -19,6 +19,7 @@ import {
 import type { ColumnsType } from 'antd/es/table';
 import { USER_SOURCE_TYPE_LABELS, resolveUserLogCategory, type UserSourceType } from '@dukang/shared-types';
 import { request, type AdminUserRow, type HqProfile, type Paginated } from '../lib/api';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
 import { ORDER_STATUS_LABELS, fmtTime, maskPhone } from '../lib/constants';
 
 type UserOrderRow = {
@@ -30,6 +31,77 @@ type UserOrderRow = {
   createdAt: string;
 };
 
+function HqRemarkCell({
+  id,
+  hqRemark,
+  onSaved,
+}: {
+  id: string;
+  hqRemark: string | null;
+  onSaved: (id: string, hqRemark: string | null) => void;
+}) {
+  const [editing, setEditing] = useState(false);
+  const [value, setValue] = useState(hqRemark ?? '');
+  const savingRef = useRef(false);
+
+  useEffect(() => {
+    if (!editing) setValue(hqRemark ?? '');
+  }, [hqRemark, editing]);
+
+  async function commit() {
+    if (savingRef.current) return;
+    const next = value.trim() || null;
+    const prev = hqRemark?.trim() || null;
+    setEditing(false);
+    if (next === prev) return;
+    savingRef.current = true;
+    try {
+      const res = await request<{ id: string; hqRemark: string | null }>(`/admin/users/${id}`, {
+        method: 'PUT',
+        body: JSON.stringify({ hqRemark: next ?? '' }),
+      });
+      onSaved(id, res.hqRemark);
+      message.success('备注已保存');
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '保存失败');
+      setValue(hqRemark ?? '');
+    } finally {
+      savingRef.current = false;
+    }
+  }
+
+  if (editing) {
+    return (
+      <Input
+        size="small"
+        autoFocus
+        maxLength={128}
+        value={value}
+        onChange={(e) => setValue(e.target.value)}
+        onBlur={() => void commit()}
+        onPressEnter={() => void commit()}
+        onKeyDown={(e) => {
+          if (e.key === 'Escape') void commit();
+        }}
+        onClick={(e) => e.stopPropagation()}
+      />
+    );
+  }
+
+  return (
+    <span
+      title="双击修改备注，离开后保存"
+      onDoubleClick={(e) => {
+        e.stopPropagation();
+        setEditing(true);
+      }}
+      style={{ cursor: 'text', display: 'inline-block', minWidth: 48 }}
+    >
+      {hqRemark || '—'}
+    </span>
+  );
+}
+
 /** 好客权益金额展示：0 与空值统一显示占位，避免整列都是 ¥0.00 干扰 */
 function fmtBenefit(v: number | null | undefined) {
   const n = Number(v ?? 0);
@@ -244,7 +316,7 @@ export default function UsersPage() {
     { title: '下单时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
   ];
 
-  const columns: ColumnsType<AdminUserRow> = [
+  const baseColumns: ColumnsType<AdminUserRow> = [
     {
       title: '用户编号',
       dataIndex: 'userNo',
@@ -256,12 +328,36 @@ export default function UsersPage() {
         </Space>
       ),
     },
-    { title: '昵称', dataIndex: 'nickname', width: 100 },
+    {
+      title: '昵称',
+      dataIndex: 'nickname',
+      width: 140,
+      render: (v: string | null) => v || '—',
+    },
+    {
+      title: '备注',
+      dataIndex: 'hqRemark',
+      width: 160,
+      render: (v: string | null, row) => (
+        <HqRemarkCell
+          id={row.id}
+          hqRemark={v}
+          onSaved={(id, hqRemark) => {
+            setData((prev) =>
+              prev
+                ? { ...prev, items: prev.items.map((u) => (u.id === id ? { ...u, hqRemark } : u)) }
+                : prev,
+            );
+            setDetail((d) => (d && d.id === id ? { ...d, hqRemark } : d));
+          }}
+        />
+      ),
+    },
     {
       title: '手机',
       dataIndex: 'phone',
       width: 120,
-      render: (v) => maskPhone(v),
+      render: (v) => v || '—',
     },
     {
       title: '验手机',
@@ -289,7 +385,6 @@ export default function UsersPage() {
       title: '来源 ID',
       dataIndex: 'sourceRefId',
       width: 100,
-      ellipsis: true,
       render: (v, row) => {
         if (!v) return '—';
         if (row.sourceType === 'PROMO_CODE') {
@@ -306,13 +401,11 @@ export default function UsersPage() {
       title: '来源标签',
       dataIndex: 'sourceLabel',
       width: 120,
-      ellipsis: true,
       render: (v) => v || '—',
     },
     {
       title: 'deviceKey',
       dataIndex: 'deviceKey',
-      ellipsis: true,
       render: (v) => v || '—',
     },
     {
@@ -377,10 +470,18 @@ export default function UsersPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('users', baseColumns, {
+    page,
+    pageSize,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
         <Typography.Title level={4} style={{ margin: 0 }}>用户监控</Typography.Title>
+        <Space>
+          {settingsButton}
         {canDeleteUsers ? (
           <Button
             danger
@@ -390,6 +491,7 @@ export default function UsersPage() {
             批量删除{selectedRowKeys.length ? ` (${selectedRowKeys.length})` : ''}
           </Button>
         ) : null}
+        </Space>
       </Space>
       <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={() => { setPage(1); void load(); }}>
         <Form.Item name="phone" label="手机号">
@@ -429,7 +531,7 @@ export default function UsersPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1830 }}
+        scroll={{ x: 'max-content' }}
         rowSelection={canDeleteUsers ? {
           selectedRowKeys,
           preserveSelectedRowKeys: true,
@@ -462,6 +564,7 @@ export default function UsersPage() {
               <Descriptions.Item label="ID">{detail.id}</Descriptions.Item>
               <Descriptions.Item label="用户编号">{detail.userNo}</Descriptions.Item>
               <Descriptions.Item label="昵称">{detail.nickname || '—'}</Descriptions.Item>
+              <Descriptions.Item label="备注">{detail.hqRemark || '—'}</Descriptions.Item>
               <Descriptions.Item label="手机号">{maskPhone(detail.phone)}</Descriptions.Item>
               <Descriptions.Item label="验手机时间">
                 {detail.phoneVerifiedAt ? new Date(detail.phoneVerifiedAt).toLocaleString('zh-CN') : '未验证'}

apps/admin-web/src/pages/WechatBindingsPage.tsx

@@ -1,317 +1,318 @@
-import { useEffect, useState } from 'react';
-import {
-  Button, Descriptions, Drawer, Form, Input, Select, Space, Table, Tag, Typography,
-} from 'antd';
-import type { ColumnsType } from 'antd/es/table';
-import { request } from '../lib/api';
-import { AdminCellLine } from '../components/AdminCellLine';
-import { fmtTime, maskPhone } from '../lib/constants';
+import { useEffect, useState } from 'react';
+import {
+  Button, Descriptions, Drawer, Form, Input, Select, Space, Table, Tag, Typography,
+} from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import { request } from '../lib/api';
+import { AdminCellLine } from '../components/AdminCellLine';
+import { fmtTime, maskPhone } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
+
+type ActorType = 'USER' | 'STORE' | 'PARTNER' | 'HQ';
+
+type Identity = {
+  actorType: ActorType;
+  actorId: string;
+  phone: string | null;
+  name: string | null;
+  wxOpenId: string;
+  wxUnionId: string | null;
+  phoneVerified?: boolean;
+  refLabel: string | null;
+  refId: string | null;
+  lastLoginAt: string | null;
+  status: string | number;
+};
+
+type GroupRow = {
+  groupKey: string;
+  unionId: string | null;
+  identityCount: number;
+  actorTypes: ActorType[];
+  multiRole: boolean;
+  primaryPhone: string | null;
+  latestLoginAt: string | null;
+  identities: Identity[];
+};
+
+const ACTOR_TYPE_LABELS: Record<ActorType, string> = {
+  USER: 'C 端用户',
+  STORE: '门店账号',
+  PARTNER: '合伙人账号',
+  HQ: 'HQ 账号',
+};
+
+const ACTOR_TYPE_COLORS: Record<ActorType, string> = {
+  USER: 'blue',
+  STORE: 'green',
+  PARTNER: 'orange',
+  HQ: 'purple',
+};
+
+function renderActorTags(types: ActorType[]) {
+  return types.map((t) => (
+    <Tag key={t} color={ACTOR_TYPE_COLORS[t]}>
+      {ACTOR_TYPE_LABELS[t]}
+    </Tag>
+  ));
+}
+
+export default function WechatBindingsPage() {
+  const [form] = Form.useForm();
+  const [filters, setFilters] = useState<Record<string, string>>({
+    actorType: '',
+    phone: '',
+    unionId: '',
+    openId: '',
+  });
+  const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<GroupRow>(
+    '/admin/wechat-bindings',
+    () => {
+      const qs = new URLSearchParams();
+      if (filters.actorType) qs.set('actorType', filters.actorType);
+      if (filters.phone) qs.set('phone', filters.phone);
+      if (filters.unionId) qs.set('unionId', filters.unionId);
+      if (filters.openId) qs.set('openId', filters.openId);
+      return qs;
+    },
+    [filters],
+  );
+  const [detail, setDetail] = useState<GroupRow | null>(null);
+  const [drawerOpen, setDrawerOpen] = useState(false);
+
+  useEffect(() => {
+    form.setFieldsValue(filters);
+  }, [form, filters]);
+
+  async function openDetail(row: GroupRow) {
+    const res = await request<GroupRow>(`/admin/wechat-bindings/${encodeURIComponent(row.groupKey)}`);
+    setDetail(res);
+    setDrawerOpen(true);
+  }
+
+  const baseColumns: ColumnsType<GroupRow> = [
+    {
+      title: 'unionId',
+      dataIndex: 'unionId',
+      width: 180,
+
+      render: (v) => v || <Tag>无 unionId</Tag>,
+    },
+    {
+      title: '身份数',
+      dataIndex: 'identityCount',
+      width: 90,
+      render: (v, r) => (
+        <Space size={4}>
+          <span>{v}</span>
+          {r.multiRole ? <Tag color="red">一人多角色</Tag> : null}
+        </Space>
+      ),
+    },
+    {
+      title: '端类型',
+      dataIndex: 'actorTypes',
+      width: 220,
+      render: (types: ActorType[]) => renderActorTags(types),
+    },
+    {
+      title: '手机号',
+      dataIndex: 'primaryPhone',
+      width: 140,
+      render: (v) => maskPhone(v),
+    },
+    {
+      title: '身份摘要',
+
+      render: (_, r) => (
+        <AdminCellLine
+          primary={r.identities.map((i) => ACTOR_TYPE_LABELS[i.actorType]).join(' / ')}
+          secondary={r.identities
+            .map((i) => i.refLabel || i.name || (i.phone ? maskPhone(i.phone) : ''))
+            .filter(Boolean)
+            .join(' · ')}
+        />
+      ),
+    },
+    {
+      title: '最近登录',
+      dataIndex: 'latestLoginAt',
+      width: 160,
+      render: fmtTime,
+    },
+    {
+      title: '操作',
+      width: 80,
+      render: (_, row) => (
+        <Button type="link" size="small" onClick={() => void openDetail(row)}>
+          详情
+        </Button>
+      ),
+    },
+  ];
+
+  const identityColumns: ColumnsType<Identity> = [
+    {
+      title: '端类型',
+      dataIndex: 'actorType',
+      width: 120,
+      render: (t: ActorType) => <Tag color={ACTOR_TYPE_COLORS[t]}>{ACTOR_TYPE_LABELS[t]}</Tag>,
+    },
+    {
+      title: '账号',
+
+      render: (_, r) => (
+        <AdminCellLine
+          primary={r.name || '—'}
+          secondary={[r.phone ? maskPhone(r.phone) : null, `#${r.actorId}`].filter(Boolean).join(' ')}
+        />
+      ),
+    },
+    {
+      title: '归属',
+      dataIndex: 'refLabel',
+      width: 160,
+
+      render: (v, r) => (v ? `${v}${r.refId ? ` #${r.refId}` : ''}` : '—'),
+    },
+    {
+      title: 'wxOpenId',
+      dataIndex: 'wxOpenId',
+      width: 160,
+
+    },
+    {
+      title: '手机验证',
+      width: 90,
+      render: (_, r) =>
+        r.actorType === 'USER' ? (
+          r.phoneVerified ? <Tag color="blue">已验证</Tag> : <Tag>未验证</Tag>
+        ) : (
+          '—'
+        ),
+    },
+    {
+      title: '最近登录',
+      dataIndex: 'lastLoginAt',
+      width: 160,
+      render: fmtTime,
+    },
+    {
+      title: '状态',
+      dataIndex: 'status',
+      width: 90,
       render: (v) => String(v),
-type ActorType = 'USER' | 'STORE' | 'PARTNER' | 'HQ';
-
-type Identity = {
-  actorType: ActorType;
-  actorId: string;
-  phone: string | null;
-  name: string | null;
-  wxOpenId: string;
-  wxUnionId: string | null;
-  phoneVerified?: boolean;
-  refLabel: string | null;
-  refId: string | null;
-  lastLoginAt: string | null;
-  status: string | number;
-};
-
-type GroupRow = {
-  groupKey: string;
-  unionId: string | null;
-  identityCount: number;
-  actorTypes: ActorType[];
-  multiRole: boolean;
-  primaryPhone: string | null;
-  latestLoginAt: string | null;
-  identities: Identity[];
-};
-
-const ACTOR_TYPE_LABELS: Record<ActorType, string> = {
-  USER: 'C 端用户',
-  STORE: '门店账号',
-  PARTNER: '合伙人账号',
-  HQ: 'HQ 账号',
-};
-
-const ACTOR_TYPE_COLORS: Record<ActorType, string> = {
-  USER: 'blue',
-  STORE: 'green',
-  PARTNER: 'orange',
-  HQ: 'purple',
-};
-
-function renderActorTags(types: ActorType[]) {
-  return types.map((t) => (
-    <Tag key={t} color={ACTOR_TYPE_COLORS[t]}>
-      {ACTOR_TYPE_LABELS[t]}
-    </Tag>
-  ));
-}
-
-export default function WechatBindingsPage() {
-  const [form] = Form.useForm();
-  const [filters, setFilters] = useState<Record<string, string>>({
-    actorType: '',
-    phone: '',
-    unionId: '',
-    openId: '',
-  });
-  const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<GroupRow>(
-    '/admin/wechat-bindings',
-    () => {
-      const qs = new URLSearchParams();
-      if (filters.actorType) qs.set('actorType', filters.actorType);
-      if (filters.phone) qs.set('phone', filters.phone);
-      if (filters.unionId) qs.set('unionId', filters.unionId);
-      if (filters.openId) qs.set('openId', filters.openId);
-      return qs;
-    },
-    [filters],
-  );
-  const [detail, setDetail] = useState<GroupRow | null>(null);
-  const [drawerOpen, setDrawerOpen] = useState(false);
-
-  useEffect(() => {
-    form.setFieldsValue(filters);
-  }, [form, filters]);
-
-  async function openDetail(row: GroupRow) {
-    const res = await request<GroupRow>(`/admin/wechat-bindings/${encodeURIComponent(row.groupKey)}`);
-    setDetail(res);
-    setDrawerOpen(true);
-  }
-
-  const columns: ColumnsType<GroupRow> = [
-    {
-      title: 'unionId',
-      dataIndex: 'unionId',
-      width: 180,
-      ellipsis: true,
-      render: (v) => v || <Tag>无 unionId</Tag>,
-    },
-    {
-      title: '身份数',
-      dataIndex: 'identityCount',
-      width: 90,
-      render: (v, r) => (
-        <Space size={4}>
-          <span>{v}</span>
-          {r.multiRole ? <Tag color="red">一人多角色</Tag> : null}
-        </Space>
-      ),
-    },
-    {
-      title: '端类型',
-      dataIndex: 'actorTypes',
-      width: 220,
-      render: (types: ActorType[]) => renderActorTags(types),
-    },
-    {
-      title: '手机号',
-      dataIndex: 'primaryPhone',
-      width: 140,
-      render: (v) => maskPhone(v),
-    },
-    {
-      title: '身份摘要',
-      ellipsis: true,
-      render: (_, r) => (
-        <AdminCellLine
-          primary={r.identities.map((i) => ACTOR_TYPE_LABELS[i.actorType]).join(' / ')}
-          secondary={r.identities
-            .map((i) => i.refLabel || i.name || (i.phone ? maskPhone(i.phone) : ''))
-            .filter(Boolean)
-            .join(' · ')}
-        />
-      ),
-    },
-    {
-      title: '最近登录',
-      dataIndex: 'latestLoginAt',
-      width: 160,
-      render: fmtTime,
-    },
-    {
-      title: '操作',
-      width: 80,
-      render: (_, row) => (
-        <Button type="link" size="small" onClick={() => void openDetail(row)}>
-          详情
-        </Button>
-      ),
-    },
-  ];
-
-  const identityColumns: ColumnsType<Identity> = [
-    {
-      title: '端类型',
-      dataIndex: 'actorType',
-      width: 120,
-      render: (t: ActorType) => <Tag color={ACTOR_TYPE_COLORS[t]}>{ACTOR_TYPE_LABELS[t]}</Tag>,
-    },
-    {
-      title: '账号',
-      ellipsis: true,
-      render: (_, r) => (
-        <AdminCellLine
-          primary={r.name || '—'}
-          secondary={[r.phone ? maskPhone(r.phone) : null, `#${r.actorId}`].filter(Boolean).join(' ')}
-        />
-      ),
-    },
-    {
-      title: '归属',
-      dataIndex: 'refLabel',
-      width: 160,
-      ellipsis: true,
-      render: (v, r) => (v ? `${v}${r.refId ? ` #${r.refId}` : ''}` : '—'),
-    },
-    {
-      title: 'wxOpenId',
-      dataIndex: 'wxOpenId',
-      width: 160,
-      ellipsis: true,
-    },
-    {
-      title: '手机验证',
-      width: 90,
-      render: (_, r) =>
-        r.actorType === 'USER' ? (
-          r.phoneVerified ? <Tag color="blue">已验证</Tag> : <Tag>未验证</Tag>
-        ) : (
-          '—'
-        ),
-    },
-    {
-      title: '最近登录',
-      dataIndex: 'lastLoginAt',
-      width: 160,
-      render: fmtTime,
-    },
-    {
-      title: '状态',
-      dataIndex: 'status',
-      width: 90,
-      render: (v) => String(v),
-    },
-  ];
-
-  return (
+    },
   ];
+
   const { columns, settingsButton, settingsModal } = useAdminListColumns('wechat-bindings', baseColumns, { page, pageSize });
-      <Typography.Paragraph type="secondary">
-        按 unionId 聚合展示已绑定微信的 C 端用户、门店账号、合伙人账号与 HQ 账号；无 unionId 时按单账号分组。
-      </Typography.Paragraph>
-
-      <Form
-        form={form}
-        layout="inline"
-        style={{ marginBottom: 16 }}
-        onFinish={(values) => {
-          setPage(1);
-          setFilters({
-            actorType: values.actorType ?? '',
-            phone: values.phone?.trim() ?? '',
-            unionId: values.unionId?.trim() ?? '',
-            openId: values.openId?.trim() ?? '',
-          });
-        }}
-      >
-        <Form.Item name="actorType" label="端类型">
-          <Select
-            allowClear
-            placeholder="全部"
-            style={{ width: 140 }}
-            options={[
-              { value: 'USER', label: 'C 端用户' },
-              { value: 'STORE', label: '门店账号' },
-              { value: 'PARTNER', label: '合伙人账号' },
-              { value: 'HQ', label: 'HQ 账号' },
-            ]}
-          />
-        </Form.Item>
-        <Form.Item name="phone" label="手机号">
-          <Input allowClear placeholder="模糊匹配" style={{ width: 140 }} />
-        </Form.Item>
-        <Form.Item name="unionId" label="unionId">
-          <Input allowClear placeholder="精确匹配" style={{ width: 180 }} />
-        </Form.Item>
-        <Form.Item name="openId" label="openId">
-          <Input allowClear placeholder="精确匹配" style={{ width: 180 }} />
-        </Form.Item>
-        <Form.Item>
-          <Space>
-            <Button type="primary" htmlType="submit">
-              查询
-            </Button>
-            <Button
-              onClick={() => {
-                form.resetFields();
-                setPage(1);
-                setFilters({ actorType: '', phone: '', unionId: '', openId: '' });
-              }}
-            >
-              重置
-            </Button>
-            <Button onClick={() => void reload()}>刷新</Button>
-          </Space>
-        </Form.Item>
-      </Form>
-
-      <Table<GroupRow>
-        rowKey="groupKey"
-        loading={loading}
-        columns={columns}
-        dataSource={data?.items ?? []}
-        pagination={{
-          current: page,
-          pageSize,
-          total: data?.total ?? 0,
-          showSizeChanger: true,
-          onChange: (p, ps) => {
-            setPage(p);
-            setPageSize(ps);
-          },
-        }}
-      />
-
-      <Drawer
-        title="微信绑定详情"
-        width={960}
-        open={drawerOpen}
-        onClose={() => setDrawerOpen(false)}
-      >
-        {detail ? (
-          <>
-            <Descriptions column={2} size="small" bordered style={{ marginBottom: 16 }}>
-              <Descriptions.Item label="groupKey">{detail.groupKey}</Descriptions.Item>
-              <Descriptions.Item label="unionId">{detail.unionId || '—'}</Descriptions.Item>
-              <Descriptions.Item label="身份数">{detail.identityCount}</Descriptions.Item>
-              <Descriptions.Item label="端类型">{renderActorTags(detail.actorTypes)}</Descriptions.Item>
-              <Descriptions.Item label="一人多角色">
-                {detail.multiRole ? <Tag color="red">是</Tag> : <Tag>否</Tag>}
-              </Descriptions.Item>
-              <Descriptions.Item label="最近登录">{fmtTime(detail.latestLoginAt)}</Descriptions.Item>
-            </Descriptions>
-            <Table<Identity>
-              rowKey={(r) => `${r.actorType}-${r.actorId}`}
-              size="small"
-              columns={identityColumns}
-              dataSource={detail.identities}
-              pagination={false}
-            />
-          </>
-        ) : null}
-      </Drawer>
-    </div>
-  );
-}
+
+  return (
+    <div>
+      {settingsModal}
+      <Typography.Title level={4}>微信绑定总览</Typography.Title>
+          {settingsButton}
+      <Typography.Paragraph type="secondary">
+        按 unionId 聚合展示已绑定微信的 C 端用户、门店账号、合伙人账号与 HQ 账号；无 unionId 时按单账号分组。
+      </Typography.Paragraph>
+
+      <Form
+        form={form}
+        layout="inline"
+        style={{ marginBottom: 16 }}
+        onFinish={(values) => {
+          setPage(1);
+          setFilters({
+            actorType: values.actorType ?? '',
+            phone: values.phone?.trim() ?? '',
+            unionId: values.unionId?.trim() ?? '',
+            openId: values.openId?.trim() ?? '',
+          });
+        }}
+      >
+        <Form.Item name="actorType" label="端类型">
+          <Select
+            allowClear
+            placeholder="全部"
+            style={{ width: 140 }}
+            options={[
+              { value: 'USER', label: 'C 端用户' },
+              { value: 'STORE', label: '门店账号' },
+              { value: 'PARTNER', label: '合伙人账号' },
+              { value: 'HQ', label: 'HQ 账号' },
+            ]}
+          />
+        </Form.Item>
+        <Form.Item name="phone" label="手机号">
+          <Input allowClear placeholder="模糊匹配" style={{ width: 140 }} />
+        </Form.Item>
+        <Form.Item name="unionId" label="unionId">
+          <Input allowClear placeholder="精确匹配" style={{ width: 180 }} />
+        </Form.Item>
+        <Form.Item name="openId" label="openId">
+          <Input allowClear placeholder="精确匹配" style={{ width: 180 }} />
+        </Form.Item>
+        <Form.Item>
+          <Space>
+            <Button type="primary" htmlType="submit">
+              查询
+            </Button>
+            <Button
+              onClick={() => {
+                form.resetFields();
+                setPage(1);
+                setFilters({ actorType: '', phone: '', unionId: '', openId: '' });
+              }}
+            >
+              重置
+            </Button>
+            <Button onClick={() => void reload()}>刷新</Button>
+          </Space>
+        </Form.Item>
+      </Form>
+
+      <Table<GroupRow>
+        rowKey="groupKey"
+        loading={loading}
+        columns={columns}
+        dataSource={data?.items ?? []}
+        pagination={{
+          current: page,
+          pageSize,
+          total: data?.total ?? 0,
+          showSizeChanger: true,
+          onChange: (p, ps) => {
+            setPage(p);
+            setPageSize(ps);
+          },
+        }}
+      />
+
+      <Drawer
+        title="微信绑定详情"
+        width={960}
+        open={drawerOpen}
+        onClose={() => setDrawerOpen(false)}
+      >
+        {detail ? (
+          <>
+            <Descriptions column={2} size="small" bordered style={{ marginBottom: 16 }}>
+              <Descriptions.Item label="groupKey">{detail.groupKey}</Descriptions.Item>
+              <Descriptions.Item label="unionId">{detail.unionId || '—'}</Descriptions.Item>
+              <Descriptions.Item label="身份数">{detail.identityCount}</Descriptions.Item>
+              <Descriptions.Item label="端类型">{renderActorTags(detail.actorTypes)}</Descriptions.Item>
+              <Descriptions.Item label="一人多角色">
+                {detail.multiRole ? <Tag color="red">是</Tag> : <Tag>否</Tag>}
+              </Descriptions.Item>
+              <Descriptions.Item label="最近登录">{fmtTime(detail.latestLoginAt)}</Descriptions.Item>
+            </Descriptions>
+            <Table<Identity>
+              rowKey={(r) => `${r.actorType}-${r.actorId}`}
+              size="small"
+              columns={identityColumns}
+              dataSource={detail.identities}
+              pagination={false}
+            />
+          </>

apps/admin-web/src/pages/WecomBotLogsPage.tsx

@@ -5,6 +5,8 @@ import { useAdminList } from '../lib/useAdminList';
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import type { WecomBotLogDto } from '@dukang/shared-types';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 export default function WecomBotLogsPage() {
   const [form] = Form.useForm();
@@ -24,12 +26,12 @@ export default function WecomBotLogsPage() {
     [filters],
   );
 
-  const columns: ColumnsType<WecomBotLogDto> = [
+  const baseColumns: ColumnsType<WecomBotLogDto> = [
     { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
-    { title: '机器人', dataIndex: 'botName', width: 120, ellipsis: true, render: (v, r) => v || r.botKey || '—' },
-    { title: '企微用户', dataIndex: 'wecomUserId', width: 120, ellipsis: true },
-    { title: '动作', dataIndex: 'action', width: 160, ellipsis: true },
-    { title: '权限', dataIndex: 'permission', width: 140, ellipsis: true, render: (v) => v || '—' },
+    { title: '机器人', dataIndex: 'botName', width: 120, render: (v, r) => v || r.botKey || '—' },
+    { title: '企微用户', dataIndex: 'wecomUserId', width: 120 },
+    { title: '动作', dataIndex: 'action', width: 160 },
+    { title: '权限', dataIndex: 'permission', width: 140, render: (v) => v || '—' },
     {
       title: '结果',
       dataIndex: 'success',
@@ -37,7 +39,7 @@ export default function WecomBotLogsPage() {
       render: (v: boolean) => <Tag color={v ? 'green' : 'red'}>{v ? '成功' : '失败'}</Tag>,
     },
     { title: '耗时(ms)', dataIndex: 'latencyMs', width: 90, render: (v) => v ?? '—' },
-    { title: '输入摘要', dataIndex: 'inputSummary', ellipsis: true },
+    { title: '输入摘要', dataIndex: 'inputSummary' },
     {
       title: '操作',
       width: 80,
@@ -49,9 +51,13 @@ export default function WecomBotLogsPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('logs-wecom-bots', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <Typography.Title level={4}>企微机器人日志</Typography.Title>
+          {settingsButton}
       <Typography.Paragraph type="secondary">
         记录机器人在企微内的查询与审批操作，含权限点、耗时与成败。
       </Typography.Paragraph>
@@ -96,7 +102,7 @@ export default function WecomBotLogsPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1100 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,

apps/admin-web/src/pages/WecomBotsPage.tsx

@@ -36,6 +36,8 @@ import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
 import OssUpload from '../components/OssUpload';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type FormValues = {
   name: string;
@@ -280,7 +282,7 @@ export default function WecomBotsPage() {
 
   const runtimeMap = new Map((runtime?.bots ?? []).map((b) => [b.id, b]));
 
-  const columns: ColumnsType<WecomBotDto> = [
+  const baseColumns: ColumnsType<WecomBotDto> = [
     {
       title: '头像',
       dataIndex: 'avatarUrl',
@@ -291,18 +293,17 @@ export default function WecomBotsPage() {
         </Avatar>
       ),
     },
-    { title: '名称', dataIndex: 'name', width: 140, ellipsis: true },
+    { title: '名称', dataIndex: 'name', width: 140 },
     {
       title: '角色',
       dataIndex: 'role',
       width: 120,
       render: (r: WecomBotRole) => WECOM_BOT_ROLE_LABELS[r] || r,
     },
-    { title: 'BotID', dataIndex: 'botId', width: 160, ellipsis: true },
+    { title: 'BotID', dataIndex: 'botId', width: 160 },
     {
       title: '权限',
       dataIndex: 'permissions',
-      ellipsis: true,
       render: (perms: WecomBotPermission[]) =>
         perms.map((p) => (
           <Tag key={p} style={{ marginBottom: 2 }}>
@@ -367,13 +368,20 @@ export default function WecomBotsPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('wecom-bots', baseColumns, {
+    page,
+    pageSize,
+  });
+
   return (
     <div>
+      {settingsModal}
       <Space style={{ width: '100%', justifyContent: 'space-between', marginBottom: 16 }} wrap>
         <div>
           <Typography.Title level={4} style={{ margin: 0 }}>
             企微机器人
           </Typography.Title>
+          {settingsButton}
           <Typography.Text type="secondary">
             并列创建多个智能机器人，配置 BotID / Secret / 权限 / 角色 / 头像。总开关在「系统设置 → 功能开关」。
             {runtime ? ` 当前总开关：${runtime.masterEnabled ? '开' : '关'}` : ''}
@@ -428,7 +436,7 @@ export default function WecomBotsPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1200 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,

apps/admin-web/src/pages/WecomMessagePushesPage.tsx

@@ -34,6 +34,8 @@ import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
 import OssUpload from '../components/OssUpload';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type FormValues = {
   name: string;
@@ -193,7 +195,7 @@ function PushRoutesTab() {
     }
   }
 
-  const columns: ColumnsType<WecomMessagePushDto> = [
+  const baseColumns: ColumnsType<WecomMessagePushDto> = [
     {
       title: '名称',
       dataIndex: 'name',
@@ -207,7 +209,6 @@ function PushRoutesTab() {
     {
       title: 'Webhook',
       dataIndex: 'webhookUrlMasked',
-      ellipsis: true,
     },
     {
       title: '推送条件',
@@ -262,8 +263,14 @@ function PushRoutesTab() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('wecom-pushes', baseColumns, {
+    page,
+    pageSize,
+  });
+
   return (
     <>
+      {settingsModal}
       <Typography.Paragraph type="secondary">
         配置群机器人 Webhook：按推送条件订阅业务通知 / 告警。运行时不再读取 .env 中的 Webhook URL。
       </Typography.Paragraph>
@@ -304,6 +311,7 @@ function PushRoutesTab() {
             <Button type="primary" onClick={openCreate}>
               新建推送
             </Button>
+            {settingsButton}
           </Space>
         </Form.Item>
       </Form>

apps/admin-web/src/pages/WineryBillsPage.tsx

@@ -26,6 +26,8 @@ import { fmtTime } from '../lib/constants';
 import { downloadExcelCsv } from '../lib/exportExcel';
 import { request, type HqProfile } from '../lib/api';
 import { useAdminList } from '../lib/useAdminList';
+import { useAdminListColumns } from '../lib/useAdminListColumns';
+
 
 type Row = {
   id: string;
@@ -37,6 +39,13 @@ type Row = {
   wineryAmount: number;
   status: string;
   paidAt?: string | null;
+  paymentRef?: string | null;
+  wineryBank?: {
+    bankAccountName?: string | null;
+    bankName?: string | null;
+    bankBranch?: string | null;
+    bankAccountNo?: string | null;
+  };
 };
 
 type BillItem = {
@@ -127,14 +136,30 @@ export default function WineryBillsPage() {
     (profile?.permissionKeys ?? []).includes('system_settings_winery_bank');
 
   function confirmPay(ids: string[], amountHint?: number) {
+    let paymentRef = '';
     Modal.confirm({
       title: '确认打款？',
-      content: `将确认 ${ids.length} 笔酒厂对账单${amountHint != null ? `，合计约 ¥${amountHint.toFixed(2)}` : ''}。此操作不可撤销。`,
+      content: (
+        <div>
+          <div>
+            将确认 {ids.length} 笔酒厂对账单
+            {amountHint != null ? `，合计约 ¥${amountHint.toFixed(2)}` : ''}。此操作不可撤销。
+          </div>
+          <Input
+            placeholder="打款凭证号（可选）"
+            style={{ marginTop: 8 }}
+            onChange={(e) => {
+              paymentRef = e.target.value;
+            }}
+          />
+        </div>
+      ),
       okText: '确认打款',
       cancelText: '取消',
       onOk: async () => {
+        const body = JSON.stringify({ paymentRef: paymentRef.trim() || undefined });
         if (ids.length === 1) {
-          await request(`/admin/winery-bills/${ids[0]}/confirm`, { method: 'POST' });
+          await request(`/admin/winery-bills/${ids[0]}/confirm`, { method: 'POST', body });
         } else {
           await request('/admin/winery-bills/batch-confirm', {
             method: 'POST',
@@ -212,8 +237,8 @@ export default function WineryBillsPage() {
   const selectedRows = (data?.items ?? []).filter((r) => selectedKeys.includes(r.id));
   const selectedAmount = selectedRows.reduce((s, r) => s + Number(r.wineryAmount), 0);
 
-  const columns: ColumnsType<Row> = [
-    { title: '账单号', dataIndex: 'billNo', width: 170, ellipsis: true },
+  const baseColumns: ColumnsType<Row> = [
+    { title: '账单号', dataIndex: 'billNo', width: 170 },
     {
       title: '账单日',
       dataIndex: 'billDate',
@@ -267,8 +292,11 @@ export default function WineryBillsPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('finance-winery-bills', baseColumns, { page, pageSize });
+
   return (
     <div>
+      {settingsModal}
       <div
         style={{
           display: 'flex',
@@ -282,6 +310,7 @@ export default function WineryBillsPage() {
           <Typography.Title level={4} style={{ margin: 0 }}>
             酒厂对账单
           </Typography.Title>
+          {settingsButton}
           <Typography.Text type="secondary">
             T+3：每日 8:00 汇总 3 天前（自然日）已完成的同城/跨城订单（实付 × {ratePct}%）；未打款红色、已打款绿色、应付为 0
             无需打款（灰），可展开订单明细
@@ -375,7 +404,7 @@ export default function WineryBillsPage() {
           onChange: setSelectedKeys,
           getCheckboxProps: (r) => ({ disabled: !canConfirmWineryPay(r) }),
         }}
-        scroll={{ x: 1100 }}
+        scroll={{ x: 'max-content' }}
         pagination={{
           current: page,
           pageSize,
@@ -399,7 +428,31 @@ export default function WineryBillsPage() {
                 {displayWineryStatus(detail.status, detail.wineryAmount).label}
               </Descriptions.Item>
               <Descriptions.Item label="打款时间">{detail.paidAt ? fmtTime(detail.paidAt) : '—'}</Descriptions.Item>
+              <Descriptions.Item label="打款凭证">
+                {detail.paymentRef ? String(detail.paymentRef) : '—'}
+              </Descriptions.Item>
             </Descriptions>
+            {detail.wineryBank ? (
+              <>
+                <Typography.Title level={5} style={{ marginTop: 16 }}>
+                  收款账户（酒厂）
+                </Typography.Title>
+                <Descriptions column={1} size="small" bordered>
+                  <Descriptions.Item label="户名">
+                    {detail.wineryBank.bankAccountName || '—'}
+                  </Descriptions.Item>
+                  <Descriptions.Item label="开户银行">
+                    {detail.wineryBank.bankName || '—'}
+                  </Descriptions.Item>
+                  <Descriptions.Item label="开户支行">
+                    {detail.wineryBank.bankBranch || '—'}
+                  </Descriptions.Item>
+                  <Descriptions.Item label="账号">
+                    {detail.wineryBank.bankAccountNo || '—'}
+                  </Descriptions.Item>
+                </Descriptions>
+              </>
+            ) : null}
             <Typography.Title level={5} style={{ marginTop: 16 }}>
               订单明细
             </Typography.Title>
@@ -409,7 +462,7 @@ export default function WineryBillsPage() {
               pagination={false}
               dataSource={detail.items ?? []}
               columns={[
-                { title: '订单号', dataIndex: 'orderNo', ellipsis: true },
+                { title: '订单号', dataIndex: 'orderNo' },
                 {
                   title: '配送',
                   dataIndex: 'deliveryType',

apps/admin-web/src/pages/promo/PromoCodeUsersPage.tsx

@@ -9,6 +9,8 @@ import {
 import { fmtTime } from '../../lib/constants';
 import { useAdminList } from '../../lib/useAdminList';
 import type { PromoCodeDetailContext } from './PromoCodeDetailLayout';
+import { useAdminListColumns } from '../../lib/useAdminListColumns';
+
 
 export default function PromoCodeUsersPage() {
   const { id = '' } = useParams();
@@ -21,7 +23,7 @@ export default function PromoCodeUsersPage() {
     [id],
   );
 
-  const columns: ColumnsType<PromoCodeAttributedUser> = [
+  const baseColumns: ColumnsType<PromoCodeAttributedUser> = [
     { title: '用户编号', dataIndex: 'userNo', width: 120 },
     { title: '昵称', dataIndex: 'nickname', width: 100, render: (v) => v || '—' },
     { title: '手机', dataIndex: 'phone', width: 120, render: (v) => v || '—' },
@@ -69,6 +71,8 @@ export default function PromoCodeUsersPage() {
     },
   ];
 
+  const { columns, settingsButton, settingsModal } = useAdminListColumns('promo-code-users', baseColumns, { page, pageSize });
+
   return (
     <Table
       rowKey="id"
@@ -76,7 +80,7 @@ export default function PromoCodeUsersPage() {
       loading={loading}
       columns={columns}
       dataSource={data?.items ?? []}
-      scroll={{ x: 1100 }}
+      scroll={{ x: 'max-content' }}
       pagination={{
         current: page,
         pageSize,

apps/h5-partner/src/pages/ProxyOrderPage.tsx

@@ -58,6 +58,7 @@ export default function ProxyOrderPage() {
   const [regionCodes, setRegionCodes] = useState<string[]>(draft0.regionCodes);
   const [addressDetail, setAddressDetail] = useState(draft0.addressDetail);
   const [productId, setProductId] = useState(draft0.productId);
+  const [skuId, setSkuId] = useState('');
   const [quantity, setQuantity] = useState(draft0.quantity);
   const [promoCodeId, setPromoCodeId] = useState(draft0.promoCodeId);
   const [deliveryMode, setDeliveryMode] = useState<PartnerProxyDeliveryMode>(draft0.deliveryMode);
@@ -156,9 +157,37 @@ export default function ProxyOrderPage() {
   ]);
 
   const selectedProduct = options?.products.find((p) => p.id === productId);
-  const allowOnline = selectedProduct ? selectedProduct.allowOnlinePurchase !== false : true;
-  const allowOnSite = !!selectedProduct?.allowOnSitePickup;
-  const allowCrossCity = selectedProduct ? selectedProduct.allowCrossCityDelivery !== false : true;
+  const skuOptions = (selectedProduct?.skus ?? []).filter((s) => s.status === 'ON_SALE');
+  const selectedSku =
+    skuOptions.find((s) => s.id === skuId) ||
+    skuOptions.find((s) => s.id === selectedProduct?.defaultSkuId) ||
+    skuOptions[0];
+  const allowOnline = selectedSku
+    ? selectedSku.allowOnlinePurchase !== false
+    : selectedProduct
+      ? selectedProduct.allowOnlinePurchase !== false
+      : true;
+  const allowOnSite = selectedSku
+    ? !!selectedSku.allowOnSitePickup
+    : !!selectedProduct?.allowOnSitePickup;
+  const allowCrossCity = selectedSku
+    ? selectedSku.allowCrossCityDelivery !== false
+    : selectedProduct
+      ? selectedProduct.allowCrossCityDelivery !== false
+      : true;
+
+  useEffect(() => {
+    if (!selectedProduct) return;
+    const def =
+      skuOptions.find((s) => s.id === selectedProduct.defaultSkuId) ||
+      skuOptions.find((s) => s.isDefault) ||
+      skuOptions[0];
+    if (def && (!skuId || !skuOptions.some((s) => s.id === skuId))) {
+      setSkuId(def.id);
+      if (def.saleUnit === 'BOX') setQuantity(1);
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [productId, selectedProduct?.id, options]);
 
   useEffect(() => {
     if (!selectedProduct) return;
@@ -184,6 +213,7 @@ export default function ProxyOrderPage() {
           productId,
           quantity,
           deliveryMode,
+          skuId: skuId || undefined,
           receiverCity: deliveryMode === 'ADDRESS' ? region?.city || undefined : undefined,
           receiverDistrict: deliveryMode === 'ADDRESS' ? region?.district || undefined : undefined,
         }),
@@ -200,7 +230,7 @@ export default function ProxyOrderPage() {
         .finally(() => setPreviewLoading(false));
     }, 300);
     return () => clearTimeout(timer);
-  }, [productId, quantity, deliveryMode, region?.city, region?.district]);
+  }, [productId, skuId, quantity, deliveryMode, region?.city, region?.district]);
 
   function validateForm(): string | null {
     if (!/^1\d{10}$/.test(phone.trim())) return '请输入有效手机号';
@@ -359,6 +389,7 @@ export default function ProxyOrderPage() {
       productId,
       quantity,
       promoCodeId: promoCodeId || undefined,
+      skuId: skuId || undefined,
     };
 
     setSubmitting(true);
@@ -524,8 +555,35 @@ export default function ProxyOrderPage() {
               </button>
             </section>
 
+            {skuOptions.length > 1 || selectedProduct?.specEnabled ? (
+              <section className="partner-form-section">
+                <label className="partner-form-label">规格</label>
+                <div className="partner-input-wrap">
+                  <select
+                    className="partner-input"
+                    value={skuId}
+                    onChange={(e) => {
+                      const id = e.target.value;
+                      setSkuId(id);
+                      const sku = skuOptions.find((s) => s.id === id);
+                      if (sku?.saleUnit === 'BOX') setQuantity(1);
+                    }}
+                  >
+                    {skuOptions.map((s) => (
+                      <option key={s.id} value={s.id}>
+                        {s.specText || '默认'} · ¥{fmtMoney(s.price)} ·{' '}
+                        {s.saleUnit === 'BOX' ? `${s.bottlesPerUnit}瓶/箱` : '瓶'}
+                      </option>
+                    ))}
+                  </select>
+                </div>
+              </section>
+            ) : null}
+
             <section className="partner-form-section">
-              <label className="partner-form-label">数量</label>
+              <label className="partner-form-label">
+                {selectedSku?.saleUnit === 'BOX' ? '数量（箱）' : '数量（瓶）'}
+              </label>
               <div className="partner-input-wrap">
                 <input
                   className="partner-input"

apps/h5-shop/src/pages/HomePage.tsx

@@ -463,7 +463,7 @@ export default function HomePage() {
 
             <div className="shop-home-stat">
 
-              <p className="shop-home-stat-label">今日到账金额</p>
+              <p className="shop-home-stat-label">今日核销金额</p>
 
               <p className="shop-home-stat-value">
 

apps/h5-shop/src/pages/RecordsPage.tsx

@@ -196,9 +196,7 @@ export default function RecordsPage() {
                       </div>
                       <p className="shop-record-time">
                         核销时间:{' '}
-                        {new Date(String(r.createdAt))
-                          .toLocaleString('zh-CN', { hour12: false })
-                          .slice(0, 16)}
+                        {new Date(String(r.createdAt)).toLocaleString('zh-CN', { hour12: false })}
                       </p>
                       <p className="shop-record-channel">
                         <span

apps/mini-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dukang/mini-user",
-  "version": "3.4.15",
+  "version": "3.5.4",
   "private": true,
   "description": "杜康好客 · C 端用户微信小程序（Taro）",
   "scripts": {

apps/mini-user/src/components/CouponBadge.tsx

@@ -1,19 +1,20 @@
 import { Text, View } from '@tarojs/components';
-import BenefitFigure from './BenefitFigure';
 
 type CouponBadgeProps = {
   amount: number | string;
   label?: string;
 };
 
-/** Taro 友好版权益角标（对齐 shared-ui CouponBadge） */
+/** 首页商品角标：纯文案「享{amount}好客权益」（无门店图标） */
 export default function CouponBadge({ amount, label = '好客权益' }: CouponBadgeProps) {
   const n = Number(amount);
   const display = Number.isFinite(n) ? (Number.isInteger(n) ? String(n) : n.toFixed(0)) : String(amount);
   return (
     <View className="coupon-badge">
-      <Text>享</Text>
-      <BenefitFigure value={`${display} ${label}`} size="sm" />
+      <Text>
+        享{display}
+        {label}
+      </Text>
     </View>
   );
 }

apps/mini-user/src/lib/checkout-nav.ts

@@ -1,5 +1,6 @@
 export type CheckoutContext = {
   productId?: string;
+  skuId?: string;
   qty?: string;
   addressId?: string;
   cross?: boolean;
@@ -9,6 +10,7 @@ export type CheckoutContext = {
 export function buildQuery(ctx: CheckoutContext): string {
   const parts: string[] = [];
   if (ctx.productId) parts.push(`productId=${encodeURIComponent(ctx.productId)}`);
+  if (ctx.skuId) parts.push(`skuId=${encodeURIComponent(ctx.skuId)}`);
   if (ctx.qty) parts.push(`qty=${encodeURIComponent(ctx.qty)}`);
   if (ctx.addressId) parts.push(`addressId=${encodeURIComponent(ctx.addressId)}`);
   if (ctx.cross) parts.push('cross=1');
@@ -36,12 +38,14 @@ export function buildAddressEditUrl(id: string | undefined, ctx: CheckoutContext
 export function buildPayUrl(params: {
   orderId: string;
   productId?: string;
+  skuId?: string;
   qty?: string;
   addressId?: string;
   cross?: boolean;
 }): string {
   const parts = [`orderId=${encodeURIComponent(params.orderId)}`];
   if (params.productId) parts.push(`productId=${encodeURIComponent(params.productId)}`);
+  if (params.skuId) parts.push(`skuId=${encodeURIComponent(params.skuId)}`);
   if (params.qty) parts.push(`qty=${encodeURIComponent(params.qty)}`);
   if (params.addressId) parts.push(`addressId=${encodeURIComponent(params.addressId)}`);
   if (params.cross) parts.push('cross=1');
@@ -51,6 +55,7 @@ export function buildPayUrl(params: {
 export function readCheckoutContext(params: Record<string, string | undefined>): CheckoutContext {
   return {
     productId: params.productId,
+    skuId: params.skuId,
     qty: params.qty,
     addressId: params.addressId,
     cross: params.cross === '1',

apps/mini-user/src/lib/client-version.ts

@@ -2,7 +2,7 @@ import Taro from '@tarojs/taro';
 import { fetchClientConfig } from './pay-wechat';
 
 /** 与 package.json version 同步，供服务端 minClientVersion 比对 */
-export const APP_VERSION = '3.4.15';
+export const APP_VERSION = '3.5.4';
 
 export const APP_VERSION_LABEL = `v${APP_VERSION}`;
 

apps/mini-user/src/pages/invoice-apply/index.tsx

@@ -7,9 +7,9 @@ import SubPageHeader from '../../components/SubPageHeader';
 import { request, toast } from '../../lib/api';
 import { usePageView } from '../../lib/usePageView';
 import {
-  INVOICE_KIND_LABELS,
+  INVOICE_CATEGORY_LABELS,
   INVOICE_TITLE_TYPE_LABELS,
-  type InvoiceKind,
+  type InvoiceCategory,
   type UserInvoiceTitleDto,
 } from '@dukang/shared-types';
 
@@ -42,7 +42,8 @@ export default function InvoiceApplyPage() {
 
   const [titles, setTitles] = useState<UserInvoiceTitleDto[]>([]);
   const [selectedId, setSelectedId] = useState('');
-  const [invoiceKind, setInvoiceKind] = useState<InvoiceKind>('NORMAL');
+  const [invoiceCategory, setInvoiceCategory] = useState<InvoiceCategory>('LIQUOR');
+  const [remark, setRemark] = useState('');
   const [emailOverride, setEmailOverride] = useState('');
   const [phoneOverride, setPhoneOverride] = useState('');
   const [loading, setLoading] = useState(true);
@@ -103,19 +104,17 @@ export default function InvoiceApplyPage() {
       toast('请填写联系电话');
       return;
     }
-    if (invoiceKind === 'SPECIAL' && selected.titleType !== 'ENTERPRISE') {
-      toast('专用发票仅支持企业抬头');
-      return;
-    }
     setSubmitting(true);
     try {
       await request(`/trade/orders/${orderId}/invoices`, {
         method: 'POST',
         data: {
           titleId: selectedId,
-          invoiceKind,
+          invoiceKind: 'NORMAL',
+          invoiceCategory,
           email,
           phone,
+          remark: remark.trim() || undefined,
         },
       });
       toast('发票申请已提交', 'success');
@@ -192,20 +191,26 @@ export default function InvoiceApplyPage() {
         ) : null}
 
         {canApply ? (
-          <View className="invoice-title-field" style={{ marginBottom: 16 }}>
-            <Text className="invoice-title-label">发票类型</Text>
-            <View className="invoice-title-type-row">
-              {(['NORMAL', 'SPECIAL'] as InvoiceKind[]).map((k) => (
-                <Text
-                  key={k}
-                  className={`invoice-title-type-chip${invoiceKind === k ? ' active' : ''}`}
-                  onClick={() => setInvoiceKind(k)}
-                >
-                  {INVOICE_KIND_LABELS[k]}
-                </Text>
-              ))}
+          <>
+            <View className="invoice-title-field" style={{ marginBottom: 16 }}>
+              <Text className="invoice-title-label">发票类型</Text>
+              <Text className="invoice-kind-static">增值税普通发票</Text>
             </View>
-          </View>
+            <View className="invoice-title-field" style={{ marginBottom: 16 }}>
+              <Text className="invoice-title-label">类型</Text>
+              <View className="invoice-title-type-row">
+                {(['LIQUOR', 'CATERING'] as InvoiceCategory[]).map((k) => (
+                  <Text
+                    key={k}
+                    className={`invoice-title-type-chip${invoiceCategory === k ? ' active' : ''}`}
+                    onClick={() => setInvoiceCategory(k)}
+                  >
+                    {INVOICE_CATEGORY_LABELS[k]}
+                  </Text>
+                ))}
+              </View>
+            </View>
+          </>
         ) : null}
 
         {canApply ? (
@@ -258,7 +263,11 @@ export default function InvoiceApplyPage() {
 
         {canApply && selected && !selected.email ? (
           <View className="invoice-title-field" style={{ marginTop: 16 }}>
-            <Text className="invoice-title-label">接收邮箱</Text>
+            <Text className="invoice-title-label">
+              <Text className="invoice-title-star">*</Text>
+              接收邮箱
+              <Text className="invoice-title-label-hint">必填</Text>
+            </Text>
             <Input
               className="invoice-title-input"
               placeholder="电子发票将发送至此邮箱"
@@ -279,6 +288,19 @@ export default function InvoiceApplyPage() {
             />
           </View>
         ) : null}
+
+        {canApply ? (
+          <View className="invoice-title-field" style={{ marginTop: 16 }}>
+            <Text className="invoice-title-label">备注</Text>
+            <Input
+              className="invoice-title-input"
+              maxlength={200}
+              placeholder="选填，将显示在发票申请备注中"
+              value={remark}
+              onInput={(e) => setRemark(e.detail.value)}
+            />
+          </View>
+        ) : null}
       </View>
 
       {canApply && titles.length > 0 ? (

apps/mini-user/src/pages/invoice-titles/index.tsx

@@ -26,6 +26,24 @@ const ACTION_ICONS = {
 
 type EditDraft = UpsertInvoiceTitleRequest & { id?: string };
 
+function FieldLabel({
+  children,
+  required,
+  hint,
+}: {
+  children: string;
+  required?: boolean;
+  hint?: string;
+}) {
+  return (
+    <Text className="invoice-title-label">
+      {required ? <Text className="invoice-title-star">*</Text> : null}
+      {children}
+      {hint ? <Text className="invoice-title-label-hint">{hint}</Text> : null}
+    </Text>
+  );
+}
+
 function TitleActionIcon({
   kind,
   label,
@@ -120,6 +138,15 @@ export default function InvoiceTitlesPage() {
       toast('企业抬头须填写税号');
       return;
     }
+    const email = draft.email?.trim() || '';
+    if (!email) {
+      toast('请填写接收邮箱（必填）');
+      return;
+    }
+    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
+      toast('邮箱格式不正确');
+      return;
+    }
     setSaving(true);
     try {
       const payload: UpsertInvoiceTitleRequest = {
@@ -152,6 +179,10 @@ export default function InvoiceTitlesPage() {
   }
 
   async function setDefault(t: UserInvoiceTitleDto) {
+    if (!t.email?.trim()) {
+      toast('请先补全接收邮箱后再设为默认');
+      return;
+    }
     try {
       await request(`/trade/invoice-titles/${t.id}`, {
         method: 'PUT',
@@ -241,7 +272,7 @@ export default function InvoiceTitlesPage() {
             </Text>
 
             <View className="invoice-title-field">
-              <Text className="invoice-title-label">抬头类型</Text>
+              <FieldLabel required>抬头类型</FieldLabel>
               <View className="invoice-title-type-row">
                 {(['PERSONAL', 'ENTERPRISE'] as InvoiceTitleType[]).map((tp) => (
                   <Text
@@ -258,7 +289,7 @@ export default function InvoiceTitlesPage() {
             </View>
 
             <View className="invoice-title-field">
-              <Text className="invoice-title-label">抬头名称</Text>
+              <FieldLabel required>抬头名称</FieldLabel>
               <Input
                 className="invoice-title-input"
                 maxlength={128}
@@ -270,7 +301,7 @@ export default function InvoiceTitlesPage() {
 
             {draft.titleType === 'ENTERPRISE' ? (
               <View className="invoice-title-field">
-                <Text className="invoice-title-label">税号</Text>
+                <FieldLabel required>税号</FieldLabel>
                 <Input
                   className="invoice-title-input"
                   maxlength={32}
@@ -282,11 +313,13 @@ export default function InvoiceTitlesPage() {
             ) : null}
 
             <View className="invoice-title-field">
-              <Text className="invoice-title-label">接收邮箱</Text>
+              <FieldLabel required hint="必填，电子发票将发送至此">
+                接收邮箱
+              </FieldLabel>
               <Input
                 className="invoice-title-input"
                 maxlength={128}
-                placeholder="电子发票将发送至此邮箱"
+                placeholder="请填写邮箱（必填）"
                 value={draft.email || ''}
                 onInput={(e) => setDraft({ ...draft, email: e.detail.value })}
               />
@@ -311,7 +344,7 @@ export default function InvoiceTitlesPage() {
                   <Input
                     className="invoice-title-input"
                     maxlength={256}
-                    placeholder="专用发票需要，选填"
+                    placeholder="选填"
                     value={draft.addressPhone || ''}
                     onInput={(e) => setDraft({ ...draft, addressPhone: e.detail.value })}
                   />
@@ -321,7 +354,7 @@ export default function InvoiceTitlesPage() {
                   <Input
                     className="invoice-title-input"
                     maxlength={256}
-                    placeholder="专用发票需要，选填"
+                    placeholder="选填"
                     value={draft.bankAccount || ''}
                     onInput={(e) => setDraft({ ...draft, bankAccount: e.detail.value })}
                   />

apps/mini-user/src/pages/order-confirm-pickup/index.tsx

@@ -32,12 +32,14 @@ type OrderPreview = {
   quantityOk?: boolean;
   quantityMessage?: string | null;
   minQty?: number;
+  saleUnit?: 'BOTTLE' | 'BOX';
 };
 
 export default function OrderConfirmPickupPage() {
   const router = useRouter();
   const productId = router.params.productId ?? '';
-  const [quantity, setQuantity] = useState(Math.max(2, Number(router.params.qty || 2)));
+  const skuId = router.params.skuId ?? '';
+  const [quantity, setQuantity] = useState(Math.max(1, Number(router.params.qty || 2)));
   const [preview, setPreview] = useState<OrderPreview | null>(null);
   const [previewLoading, setPreviewLoading] = useState(false);
   const [loading, setLoading] = useState(false);
@@ -50,7 +52,7 @@ export default function OrderConfirmPickupPage() {
     setPreviewLoading(true);
     request<OrderPreview>('/trade/orders/preview', {
       method: 'POST',
-      data: { productId, quantity, onSitePickup: true },
+      data: { productId, quantity, onSitePickup: true, ...(skuId ? { skuId } : {}) },
     })
       .then((data) => {
         if (!cancelled) {
@@ -70,15 +72,16 @@ export default function OrderConfirmPickupPage() {
     return () => {
       cancelled = true;
     };
-  }, [productId, quantity]);
+  }, [productId, skuId, quantity]);
 
+  const unitLabel = preview?.saleUnit === 'BOX' ? '箱' : '瓶';
   const minQty = preview?.minQty ?? 2;
   const quantityOk = preview ? preview.quantityOk !== false && quantity >= minQty : false;
   const canSubmit = !!preview && quantityOk && !loading && !previewLoading;
 
   function updateQuantity(next: number) {
     if (next < minQty) {
-      const tip = `现场提货至少购买 ${minQty} 瓶`;
+      const tip = `现场提货至少购买 ${minQty}${unitLabel}`;
       toast(tip);
       setMsg(tip);
       if (next < 1) return;
@@ -91,12 +94,13 @@ export default function OrderConfirmPickupPage() {
   async function doSubmit() {
     const order = await request<{ id: string }>('/trade/orders', {
       method: 'POST',
-      data: { productId, quantity, onSitePickup: true },
+      data: { productId, quantity, onSitePickup: true, ...(skuId ? { skuId } : {}) },
     });
     Taro.redirectTo({
       url: buildPayUrl({
         orderId: order.id,
         productId,
+        skuId: skuId || undefined,
         qty: String(quantity),
       }),
     });

apps/mini-user/src/pages/order-confirm/index.tsx

@@ -54,6 +54,9 @@ type OrderPreview = {
   minQty?: number;
   allowCrossCityDelivery?: boolean;
   allowOnlinePurchase?: boolean;
+  skuId?: string;
+  saleUnit?: 'BOTTLE' | 'BOX';
+  bottlesPerUnit?: number;
 };
 
 const CROSS_CITY_BLOCK_MSG = '该商品不支持跨城配送，请更换为开城城市内的收货地址';
@@ -66,6 +69,7 @@ export default function OrderConfirmPage() {
   const router = useRouter();
   const checkoutCtx = readCheckoutContext(router.params);
   const productId = checkoutCtx.productId ?? '';
+  const skuId = checkoutCtx.skuId ?? '';
   const forceCross = checkoutCtx.cross === true;
   const [quantity, setQuantity] = useState(Math.max(1, Number(checkoutCtx.qty || 2)));
   const [addresses, setAddresses] = useState<Address[]>([]);
@@ -96,11 +100,12 @@ export default function OrderConfirmPage() {
     if (!productId) return;
     let cancelled = false;
     setPreviewLoading(true);
-    const body: { productId: string; quantity: number; addressId?: string } = {
+    const body: { productId: string; quantity: number; addressId?: string; skuId?: string } = {
       productId,
       quantity,
     };
     if (addressId) body.addressId = addressId;
+    if (skuId) body.skuId = skuId;
 
     request<OrderPreview>('/trade/orders/preview', { method: 'POST', data: body })
       .then((data) => {
@@ -139,7 +144,7 @@ export default function OrderConfirmPage() {
     return () => {
       cancelled = true;
     };
-  }, [productId, quantity, addressId]);
+  }, [productId, skuId, quantity, addressId]);
 
   const selectedAddress = useMemo(
     () => addresses.find((a) => String(a.id) === addressId),
@@ -157,6 +162,7 @@ export default function OrderConfirmPage() {
     forceCross || preview?.deliveryType === 'CROSS_CITY' || localCross;
   const crossBlocked = isCross && !allowCross;
   const addressOk = preview ? preview.addressOk !== false && !crossBlocked : !crossBlocked;
+  const unitLabel = preview?.saleUnit === 'BOX' ? '箱' : '瓶';
   const minQty =
     preview?.minQty ??
     (isCross ? (preview?.city?.crossMinQty ?? 6) : (preview?.city?.localMinQty ?? 2));
@@ -171,8 +177,8 @@ export default function OrderConfirmPage() {
   function updateQuantity(next: number) {
     if (next < minQty) {
       const tip = isCross
-        ? `跨城配送至少购买 ${minQty} 瓶（1箱）`
-        : `同城配送至少购买 ${minQty} 瓶`;
+        ? `跨城配送至少购买 ${minQty}${unitLabel}`
+        : `同城配送至少购买 ${minQty}${unitLabel}`;
       toast(tip);
       setMsg(tip);
       if (next < 1) return;
@@ -195,6 +201,7 @@ export default function OrderConfirmPage() {
         productId,
         quantity,
         addressId,
+        ...(skuId ? { skuId } : {}),
         ...(clientLocation ? { clientLocation } : {}),
       },
     });
@@ -202,6 +209,7 @@ export default function OrderConfirmPage() {
       url: buildPayUrl({
         orderId: order.id,
         productId,
+        skuId: skuId || undefined,
         qty: String(quantity),
         addressId,
         cross: forceCross,
@@ -223,15 +231,15 @@ export default function OrderConfirmPage() {
       }
       if (!quantityOk) {
         const tip = isCross
-          ? `跨城配送至少购买 ${minQty} 瓶（1箱）`
-          : `同城配送至少购买 ${minQty} 瓶`;
+          ? `跨城配送至少购买 ${minQty}${unitLabel}`
+          : `同城配送至少购买 ${minQty}${unitLabel}`;
         setMsg(tip);
         toast(tip);
       }
       return;
     }
 
-    const returnPath = `/pages/order-confirm/index?productId=${productId}&qty=${quantity}&addressId=${addressId}${forceCross ? '&cross=1' : ''}`;
+    const returnPath = `/pages/order-confirm/index?productId=${productId}&qty=${quantity}&addressId=${addressId}${skuId ? `&skuId=${skuId}` : ''}${forceCross ? '&cross=1' : ''}`;
 
     if (!phonePromptSkipped.current) {
       try {
@@ -371,8 +379,8 @@ export default function OrderConfirmPage() {
               {!quantityOk ? (
                 <Text className="order-qty-hint">
                   {isCross
-                    ? `跨城配送至少购买 ${minQty} 瓶（1箱），请调整数量`
-                    : `同城配送至少购买 ${minQty} 瓶，请调整数量`}
+                    ? `跨城配送至少购买 ${minQty}${unitLabel}，请调整数量`
+                    : `同城配送至少购买 ${minQty}${unitLabel}，请调整数量`}
                 </Text>
               ) : null}
             </View>

apps/mini-user/src/pages/pay/index.tsx

@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useState } from 'react';
-import { View, Text } from '@tarojs/components';
+import { View, Text, Image } from '@tarojs/components';
 import '../../styles/order.css';
 import Taro, { useDidShow, useRouter } from '@tarojs/taro';
 import PageShell from '../../components/PageShell';
@@ -19,13 +19,13 @@ import { applyWechatLoginResult } from '../../lib/wechat-auth';
 import { isWechatEnv } from '../../lib/weixin';
 import { goLogin } from '../../lib/auth-nav';
 import { request, toast } from '../../lib/api';
+import payLogo from '../../assets/logo2.png';
 
 export default function PayPage() {
   const router = useRouter();
   const orderId = router.params.orderId ?? '';
   const [loading, setLoading] = useState(false);
   const [authLoading, setAuthLoading] = useState(false);
-  const [mockMode, setMockMode] = useState(true);
   const [needsWechatAuth, setNeedsWechatAuth] = useState(false);
   const [msg, setMsg] = useState('');
   const [orderNo, setOrderNo] = useState('');
@@ -39,7 +39,6 @@ export default function PayPage() {
   const refreshPayReadiness = useCallback(async () => {
     try {
       const [config, profile] = await Promise.all([fetchClientConfig(), fetchUserProfile()]);
-      setMockMode(config.mockPay);
       setNeedsWechatAuth(needsWechatAuthForPay(config, profile));
       return profile;
     } catch {
@@ -174,7 +173,7 @@ export default function PayPage() {
       <View className="sub-page-body">
         <View className="pay-status">
           <View className="pay-status-icon">
-            <Text>¥</Text>
+            <Image className="pay-status-brand" src={payLogo} mode="aspectFit" />
           </View>
           <Text className="pay-status-title">
             {needsWechatAuth ? '需完成微信授权' : '待支付'}
@@ -204,12 +203,6 @@ export default function PayPage() {
             <Text className="order-row-label">支付方式</Text>
             <Text className="order-row-value">微信支付</Text>
           </View>
-          <View className="order-row">
-            <Text className="order-row-label">说明</Text>
-            <Text className="order-row-value">
-              {mockMode ? 'Mock 模式由服务端直接标记已付款' : '将调起微信收银台'}
-            </Text>
-          </View>
         </View>
         {msg ? (
           <Text className="pay-wechat-auth-msg" style={{ marginTop: 12 }}>

apps/mini-user/src/pages/product-detail/index.tsx

@@ -8,7 +8,7 @@ import Taro, {
   useShareAppMessage,
   useShareTimeline,
 } from '@tarojs/taro';
-import type { ProductDetailContentDto } from '@dukang/shared-types';
+import type { ProductDetailContentDto, ProductSkuDto, ProductSpecAttrDto } from '@dukang/shared-types';
 import PageShell from '../../components/PageShell';
 import PageNavBar from '../../components/PageNavBar';
 import ProductCarousel from '../../components/ProductCarousel';
@@ -47,8 +47,39 @@ type Product = ProductImageSource & {
   allowOnSitePickup?: boolean;
   allowOnlinePurchase?: boolean;
   allowCrossCityDelivery?: boolean;
+  specEnabled?: boolean;
+  specAttrs?: ProductSpecAttrDto[];
+  skus?: ProductSkuDto[];
+  defaultSkuId?: string;
+  saleUnit?: 'BOTTLE' | 'BOX';
 };
 
+function findSku(
+  skus: ProductSkuDto[],
+  selected: Record<string, string>,
+  attrs: ProductSpecAttrDto[],
+): ProductSkuDto | undefined {
+  const valueIds = attrs.map((a) => selected[a.id]).filter(Boolean);
+  if (valueIds.length !== attrs.length) return undefined;
+  const key = [...valueIds].sort().join('_');
+  return skus.find((s) => [...s.specValueIds].sort().join('_') === key);
+}
+
+function isValueAvailable(
+  skus: ProductSkuDto[],
+  attrs: ProductSpecAttrDto[],
+  selected: Record<string, string>,
+  attrId: string,
+  valueId: string,
+): boolean {
+  const trial = { ...selected, [attrId]: valueId };
+  const partialIds = attrs.map((a) => trial[a.id]).filter(Boolean);
+  return skus.some((s) => {
+    if (s.status !== 'ON_SALE') return false;
+    return partialIds.every((id) => s.specValueIds.includes(id));
+  });
+}
+
 export default function ProductDetailPage() {
   const router = useRouter();
   const productId = router.params.id ?? '';
@@ -58,6 +89,7 @@ export default function ProductDetailPage() {
   );
   const [product, setProduct] = useState<Product | null>(null);
   const [headerSolid, setHeaderSolid] = useState(false);
+  const [selected, setSelected] = useState<Record<string, string>>({});
 
   usePageScroll(({ scrollTop }) => {
     setHeaderSolid(scrollTop > 100);
@@ -72,7 +104,25 @@ export default function ProductDetailPage() {
           toast('商品不存在或暂未开放');
           return;
         }
-        setProduct(normalizeFulfillmentFlags(p));
+        const normalized = normalizeFulfillmentFlags(p);
+        setProduct(normalized);
+        const attrs = p.specAttrs ?? [];
+        const skus = p.skus ?? [];
+        const def =
+          skus.find((s) => s.id === p.defaultSkuId) ||
+          skus.find((s) => s.isDefault && s.status === 'ON_SALE') ||
+          skus.find((s) => s.status === 'ON_SALE') ||
+          skus[0];
+        if (def && attrs.length) {
+          const next: Record<string, string> = {};
+          for (const attr of attrs) {
+            const hit = attr.values.find((v) => def.specValueIds.includes(v.id));
+            if (hit) next[attr.id] = hit.id;
+          }
+          setSelected(next);
+        } else {
+          setSelected({});
+        }
       })
       .catch((e) => {
         setProduct(null);
@@ -84,20 +134,53 @@ export default function ProductDetailPage() {
     loadProduct();
   }, [loadProduct]);
 
-  // 登录后返回详情须带 token 重拉，否则白名单商品会一直空白
   useDidShow(() => {
     loadProduct();
   });
 
+  const attrs = product?.specAttrs ?? [];
+  const skus = product?.skus ?? [];
+  const specEnabled = !!(product?.specEnabled && attrs.length > 0);
+  const activeSku = useMemo(() => {
+    if (!product) return undefined;
+    if (!specEnabled) {
+      return (
+        skus.find((s) => s.id === product.defaultSkuId) ||
+        skus.find((s) => s.isDefault) ||
+        skus.find((s) => s.status === 'ON_SALE') ||
+        skus[0]
+      );
+    }
+    return findSku(skus, selected, attrs);
+  }, [product, specEnabled, skus, selected, attrs]);
+
+  const displayPrice = activeSku ? Number(activeSku.price) : Number(product?.price ?? 0);
+  const displayBenefit = activeSku
+    ? Number(activeSku.benefitAmount)
+    : Number(product?.benefitDisplay ?? product?.benefitAmount ?? product?.price ?? 0);
+  const fulfillment = activeSku
+    ? {
+        allowOnlinePurchase: activeSku.allowOnlinePurchase,
+        allowCrossCityDelivery: activeSku.allowCrossCityDelivery,
+        allowOnSitePickup: activeSku.allowOnSitePickup,
+      }
+    : product;
+  const carouselImages = (() => {
+    const base = getProductCarouselImages(product);
+    const skuImg = activeSku?.imageUrl?.trim();
+    if (!skuImg) return base;
+    return [skuImg, ...base.filter((url) => url !== skuImg)];
+  })();
+
   const sharePayload = useMemo(
     () =>
       buildSceneSharePayload('productDetail', {
         path: `/pages/product-detail/index?id=${productId}`,
         dynamicTitle: product?.name,
         dynamicDesc: product?.subtitle,
-        dynamicImageUrl: product ? getProductMainImage(product) : undefined,
+        dynamicImageUrl: (activeSku?.imageUrl?.trim() || (product ? getProductMainImage(product) : undefined)),
       }),
-    [product, productId],
+    [product, productId, activeSku],
   );
 
   useShareAppMessage(() => toWeappShareMessage(sharePayload));
@@ -118,9 +201,23 @@ export default function ProductDetailPage() {
     Taro.switchTab({ url: '/pages/home/index' });
   }
 
+  function ensureSkuSelected(): string | null {
+    if (!specEnabled) return activeSku?.id ?? product?.defaultSkuId ?? null;
+    if (!activeSku || activeSku.status !== 'ON_SALE') {
+      toast('请选择完整规格');
+      return null;
+    }
+    return activeSku.id;
+  }
+
   async function goBuy() {
     if (!productId) return;
-    const returnPath = `/pages/order-confirm/index?productId=${productId}&qty=2`;
+    const skuId = ensureSkuSelected();
+    if (specEnabled && !skuId) return;
+    const qty = activeSku?.saleUnit === 'BOX' ? 1 : 2;
+    const qs = [`productId=${productId}`, `qty=${qty}`];
+    if (skuId) qs.push(`skuId=${skuId}`);
+    const returnPath = `/pages/order-confirm/index?${qs.join('&')}`;
     if (!isLoggedIn()) {
       goLogin(returnPath);
       return;
@@ -132,7 +229,12 @@ export default function ProductDetailPage() {
 
   async function goOnSitePickup() {
     if (!productId) return;
-    const returnPath = `/pages/order-confirm-pickup/index?productId=${productId}&qty=1`;
+    const skuId = ensureSkuSelected();
+    if (specEnabled && !skuId) return;
+    const qty = activeSku?.saleUnit === 'BOX' ? 1 : 1;
+    const qs = [`productId=${productId}`, `qty=${qty}`];
+    if (skuId) qs.push(`skuId=${skuId}`);
+    const returnPath = `/pages/order-confirm-pickup/index?${qs.join('&')}`;
     if (!isLoggedIn()) {
       goLogin(returnPath);
       return;
@@ -151,10 +253,8 @@ export default function ProductDetailPage() {
     );
   }
 
-  const allowOnline = canBuyOnline(product);
-  const allowOnSite = canPickupOnSite(product);
-  const benefit = Number(product.benefitDisplay ?? product.benefitAmount ?? product.price);
-  const carouselImages = getProductCarouselImages(product);
+  const allowOnline = canBuyOnline(fulfillment ?? {});
+  const allowOnSite = canPickupOnSite(fulfillment ?? {});
   const detailImages = getProductDetailImages(product);
   const detail = product.detailContent ?? {};
   const features = detail.features ?? [];
@@ -177,12 +277,45 @@ export default function ProductDetailPage() {
         <View className="product-detail-info">
           <View className="product-detail-price">
             <Text className="product-detail-price-symbol">¥</Text>
-            <Text className="product-detail-price-value">{Number(product.price).toFixed(2)}</Text>
+            <Text className="product-detail-price-value">{displayPrice.toFixed(2)}</Text>
           </View>
           <Text className="product-detail-name">{product.name}</Text>
           {product.subtitle ? (
             <Text className="product-detail-subtitle">{product.subtitle}</Text>
           ) : null}
+          {activeSku?.specText ? (
+            <Text className="product-detail-subtitle">{activeSku.specText}</Text>
+          ) : null}
+
+          {specEnabled ? (
+            <View className="product-detail-specs">
+              {attrs.map((attr) => (
+                <View key={attr.id} className="product-detail-spec-row">
+                  <Text className="product-detail-spec-label">{attr.name}</Text>
+                  <View className="product-detail-spec-chips">
+                    {attr.values.map((val) => {
+                      const active = selected[attr.id] === val.id;
+                      const available = isValueAvailable(skus, attrs, selected, attr.id, val.id);
+                      return (
+                        <View
+                          key={val.id}
+                          className={`product-detail-spec-chip${active ? ' is-active' : ''}${
+                            available ? '' : ' is-disabled'
+                          }`}
+                          onClick={() => {
+                            if (!available) return;
+                            setSelected((prev) => ({ ...prev, [attr.id]: val.id }));
+                          }}
+                        >
+                          <Text className="product-detail-spec-chip-text">{val.name}</Text>
+                        </View>
+                      );
+                    })}
+                  </View>
+                </View>
+              ))}
+            </View>
+          ) : null}
 
           <View className="product-detail-promo">
             <View className="product-detail-promo-glow" />
@@ -192,7 +325,7 @@ export default function ProductDetailPage() {
               </View>
               <View className="product-detail-promo-title">
                 <Text>买杜康美酒 · 享全城好客礼遇</Text>
-                <BenefitFigure value={String(benefit)} size="sm" className="product-detail-promo-amount" />
+                <BenefitFigure value={String(displayBenefit)} size="sm" className="product-detail-promo-amount" />
               </View>
             </View>
             <Text className="product-detail-promo-desc">

apps/mini-user/src/pages/store-detail/index.tsx

@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { View, Text, Image } from '@tarojs/components';
+import { View, Text, Image, ScrollView } from '@tarojs/components';
 import '../../styles/store-detail.css';
 import Taro, {
   useDidShow,
@@ -444,17 +444,19 @@ export default function StoreDetailPage() {
         </View>
       ) : null}
 
-      {intro ? (
+      {benefitRule ? (
         <View className="store-detail-section">
-          <Text className="store-detail-section-title">门店详情</Text>
-          <Text className="store-detail-intro">{intro}</Text>
+          <Text className="store-detail-section-title store-detail-section-title--rule">使用规则</Text>
+          <Text className="store-detail-intro">{benefitRule}</Text>
         </View>
       ) : null}
 
-      {benefitRule ? (
+      {intro ? (
         <View className="store-detail-section">
-          <Text className="store-detail-section-title">好客权益券使用规则</Text>
-          <Text className="store-detail-intro">{benefitRule}</Text>
+          <Text className="store-detail-section-title">门店详情</Text>
+          <ScrollView className="store-detail-intro-scroll" scrollY showScrollbar>
+            <Text className="store-detail-intro">{intro}</Text>
+          </ScrollView>
         </View>
       ) : null}
 

apps/mini-user/src/styles/invoice.css

@@ -153,6 +153,30 @@
   margin-bottom: 6px;
 }
 
+.invoice-title-star {
+  color: #c62828;
+  margin-right: 2px;
+  font-weight: 600;
+}
+
+.invoice-title-label-hint {
+  margin-left: 6px;
+  font-size: 12px;
+  color: #c62828;
+  font-weight: 500;
+}
+
+.invoice-kind-static {
+  display: block;
+  font-size: 15px;
+  color: var(--color-on-surface, #1a1a1a);
+  line-height: 44px;
+  padding: 0 12px;
+  background: var(--color-surface, #fafafa);
+  border: 1px solid var(--color-outline, #ddd);
+  border-radius: 8px;
+}
+
 .invoice-title-input {
   width: 100%;
   height: 44px;

apps/mini-user/src/styles/order.css

@@ -488,16 +488,20 @@
 }
 
 .pay-status-icon {
-  width: 72px;
-  height: 72px;
+  width: 88px;
+  height: 88px;
   border-radius: 50%;
-  background: rgba(166, 29, 36, 0.08);
-  color: var(--color-heritage-red);
-  font-size: 36px;
+  background: #f7f4ee;
   display: flex;
   align-items: center;
   justify-content: center;
   margin: 0 auto 16px;
+  overflow: hidden;
+}
+
+.pay-status-brand {
+  width: 72px;
+  height: 72px;
 }
 
 .pay-status-title {

apps/mini-user/src/styles/product-detail.css

@@ -130,6 +130,7 @@
 
 .product-detail-promo {
   position: relative;
+  margin-top: 8px;
   padding: 16px;
   border-radius: var(--radius-lg);
   background: linear-gradient(135deg, #fff9e6 0%, #fff0c2 100%);
@@ -375,3 +376,53 @@
   font-size: 16px;
   font-weight: 700;
 }
+
+.product-detail-specs {
+  margin: 16px 0 28px;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.product-detail-spec-row {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.product-detail-spec-label {
+  font-size: 13px;
+  color: var(--color-on-surface-variant, #666);
+}
+
+.product-detail-spec-chips {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+.product-detail-spec-chip {
+  padding: 6px 14px;
+  border-radius: 8px;
+  background: #f5f5f5;
+  border: 1px solid transparent;
+}
+
+.product-detail-spec-chip.is-active {
+  background: rgba(166, 29, 36, 0.08);
+  border-color: var(--color-heritage-red);
+}
+
+.product-detail-spec-chip.is-disabled {
+  opacity: 0.35;
+}
+
+.product-detail-spec-chip-text {
+  font-size: 13px;
+  color: #333;
+}
+
+.product-detail-spec-chip.is-active .product-detail-spec-chip-text {
+  color: var(--color-heritage-red);
+  font-weight: 600;
+}

apps/mini-user/src/styles/store-detail.css

@@ -211,6 +211,17 @@
   color: var(--color-on-surface);
 }
 
+.store-detail-section-title--rule {
+  color: var(--color-heritage-red, #a61d24);
+}
+
+.store-detail-intro-scroll {
+  max-height: 168px;
+  height: 168px;
+  overflow-y: auto;
+  -webkit-overflow-scrolling: touch;
+}
+
 .store-detail-env-grid {
   display: flex;
   flex-direction: column;

deploy/_diag_wx_key.mjs

@@ -1,77 +0,0 @@
-#!/usr/bin/env node
-const fs = require('fs');
-const crypto = require('crypto');
-const path = process.argv[2] || '/opt/dukang/server/dukang-api/.env.production';
-
-function stripQuotes(s) {
-  const t = s.trim();
-  if ((t.startsWith('"') && t.endsWith('"')) || (t.startsWith("'") && t.endsWith("'"))) {
-    return t.slice(1, -1);
-  }
-  return t;
-}
-
-function parseEnvValue(text, key) {
-  const re = new RegExp(`^${key}=(.*)$`, 'm');
-  const m = text.match(re);
-  if (!m) return null;
-  return stripQuotes(m[1]);
-}
-
-function tryKey(name, key) {
-  const literalN = (key.match(/\\n/g) || []).length;
-  const realN = (key.match(/\n/g) || []).length;
-  const hasBegin = /BEGIN (RSA )?PRIVATE KEY/.test(key);
-  try {
-    crypto.createPrivateKey(key);
-    console.log(`${name}: OK begin=${hasBegin} literalN=${literalN} realN=${realN} len=${key.length}`);
-    return true;
-  } catch (e) {
-    console.log(
-      `${name}: FAIL ${e.message} begin=${hasBegin} literalN=${literalN} realN=${realN} len=${key.length} head=${JSON.stringify(key.slice(0, 48))}`,
-    );
-    return false;
-  }
-}
-
-const text = fs.readFileSync(path, 'utf8');
-const raw = parseEnvValue(text, 'WX_MCH_PRIVATE_KEY');
-if (!raw) {
-  console.log('MISSING WX_MCH_PRIVATE_KEY in', path);
-  process.exit(1);
-}
-
-console.log('file=', path);
-console.log('MOCK_PAY=', parseEnvValue(text, 'MOCK_PAY'));
-console.log('WX_MINI_APP_ID=', parseEnvValue(text, 'WX_MINI_APP_ID'));
-console.log('WX_APP_ID=', parseEnvValue(text, 'WX_APP_ID'));
-console.log('WX_MCH_ID=', parseEnvValue(text, 'WX_MCH_ID'));
-console.log('WX_PAY_NOTIFY_URL=', parseEnvValue(text, 'WX_PAY_NOTIFY_URL'));
-
-const variants = {
-  as_is: raw,
-  unescape_n: raw.replace(/\\n/g, '\n'),
-  unescape_twice: raw.replace(/\\\\n/g, '\\n').replace(/\\n/g, '\n'),
-  strip_cr_unesc: raw.replace(/\\n/g, '\n').replace(/\r/g, ''),
-  // dotenv style sometimes leaves surrounding quotes in process.env
-  quoted_unesc: stripQuotes(raw).replace(/\\n/g, '\n'),
-};
-
-let ok = false;
-for (const [name, key] of Object.entries(variants)) {
-  if (tryKey(name, key)) ok = true;
-}
-
-// also simulate dotenv load
-try {
-  const dotenv = require('dotenv');
-  const parsed = dotenv.parse(text);
-  const fromDotenv = parsed.WX_MCH_PRIVATE_KEY || '';
-  console.log('dotenv_raw_literalN=', (fromDotenv.match(/\\n/g) || []).length, 'realN=', (fromDotenv.match(/\n/g) || []).length);
-  tryKey('dotenv_as_is', fromDotenv);
-  tryKey('dotenv_unescape', fromDotenv.replace(/\\n/g, '\n'));
-} catch (e) {
-  console.log('dotenv skip', e.message);
-}
-
-process.exit(ok ? 0 : 2);

deploy/backup-prod-db.sh

@@ -0,0 +1,126 @@
+#!/usr/bin/env bash
+# backup-prod-db.sh — 将线上(production)数据库 mysqldump 落盘到 deploy/backups/
+#
+# 与 sync-prod-db-to-local.sh 共用 SSH 隧道；仅导出，不覆盖本地库。
+#
+# 用法：
+#   bash deploy/backup-prod-db.sh              # 交互确认
+#   bash deploy/backup-prod-db.sh --yes      # 跳过确认
+#   bash deploy/backup-prod-db.sh --dry-run  # 只打印计划
+#
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+cd "$SCRIPT_DIR"
+
+LOCAL_CONTAINER="dukang-v1-mysql"
+TUNNEL_PORT=6019
+REMOTE_ENV_FILE="/opt/dukang/server/dukang-api/.env.production"
+HOST_ALIAS="host.docker.internal"
+ASSUME_YES=0
+DRY_RUN=0
+
+for arg in "$@"; do
+  case "$arg" in
+    --yes|-y) ASSUME_YES=1 ;;
+    --dry-run) DRY_RUN=1 ;;
+    --help|-h) sed -n '3,12p' "$0"; exit 0 ;;
+    --tunnel-port=*) TUNNEL_PORT="${arg#*=}" ;;
+    --container=*) LOCAL_CONTAINER="${arg#*=}" ;;
+    --host-alias=*) HOST_ALIAS="${arg#*=}" ;;
+    *) echo "未知参数: $arg" >&2; exit 2 ;;
+  esac
+done
+
+if [[ -f deploy.env ]]; then
+  # shellcheck disable=SC1091
+  source deploy.env
+fi
+DEPLOY_HOST="${DEPLOY_HOST:?请在 deploy.env 配置 DEPLOY_HOST}"
+DEPLOY_USER="${DEPLOY_USER:-root}"
+DEPLOY_PORT="${DEPLOY_PORT:-22}"
+SSH=(ssh -o StrictHostKeyChecking=accept-new -p "$DEPLOY_PORT")
+if [[ -n "${DEPLOY_SSH_KEY:-}" ]]; then SSH+=(-i "$DEPLOY_SSH_KEY"); fi
+TARGET="$DEPLOY_USER@$DEPLOY_HOST"
+
+echo "==> 读取线上数据库配置 ($TARGET:$REMOTE_ENV_FILE)"
+PARSED="$("${SSH[@]}" "$TARGET" bash -s <<'NODEEOF'
+cat > /tmp/_parse_db.js <<'JSEOF'
+const fs=require("fs");
+const l=fs.readFileSync("/opt/dukang/server/dukang-api/.env.production","utf8").match(/^DATABASE_URL=(.*)$/m)[1].trim();
+let u=l;
+if((u[0]==='"'&&u[u.length-1]==='"')||(u[0]==="'"&&u[u.length-1]==="'"))u=u.slice(1,-1);
+const U=new URL(u);
+const b=s=>Buffer.from(s).toString("base64");
+const path=U.pathname.replace(/^\//,"").split("?")[0];
+process.stdout.write([b(decodeURIComponent(U.username)),b(U.hostname),U.port||"3306",b(path),b(decodeURIComponent(U.password))].join("|")+"\n");
+JSEOF
+node /tmp/_parse_db.js; rm -f /tmp/_parse_db.js
+NODEEOF
+)"
+if [[ -z "$PARSED" ]]; then
+  echo "无法读取远端 DATABASE_URL，中止。" >&2; exit 1
+fi
+IFS='|' read -r _U _H _P _DB _PASS <<< "$PARSED"
+REMOTE_USER="$(echo "$_U" | base64 -d)"
+REMOTE_HOST="$(echo "$_H" | base64 -d)"
+REMOTE_PORT="$_P"
+REMOTE_DB="$(echo "$_DB" | base64 -d)"
+REMOTE_PASS="$(echo "$_PASS" | base64 -d)"
+
+mkdir -p backups
+OUT="backups/prod-${REMOTE_DB}-$(date +%Y%m%d-%H%M%S).sql"
+
+echo
+echo "备份计划:"
+echo "  源(线上): $REMOTE_USER@$REMOTE_HOST:$REMOTE_PORT/$REMOTE_DB"
+echo "  目标文件: $OUT"
+echo "  隧道:      $TARGET -L $TUNNEL_PORT:$REMOTE_HOST:$REMOTE_PORT"
+if [[ $DRY_RUN -eq 1 ]]; then
+  echo "(dry-run) 已结束，未做任何修改。"
+  exit 0
+fi
+
+if ! docker ps --format '{{.Names}}' | grep -qx "$LOCAL_CONTAINER"; then
+  echo "本地容器 $LOCAL_CONTAINER 未运行。请先执行: cd deploy && docker compose up -d" >&2
+  exit 1
+fi
+
+if [[ $ASSUME_YES -ne 1 ]]; then
+  read -r -p "确认备份【线上 $REMOTE_DB】到 $OUT ? [y/N] " ans
+  [[ "$ans" == "y" || "$ans" == "Y" ]] || { echo "已取消。"; exit 0; }
+fi
+
+CTL="/tmp/backup-prod-db-$$.sock"
+echo "==> 建立 SSH 隧道"
+"${SSH[@]}" -M -S "$CTL" -f -N -L "$TUNNEL_PORT:$REMOTE_HOST:$REMOTE_PORT" "$TARGET"
+
+ready=0
+for _ in 1 2 3 4 5 6 7 8 9 10; do
+  if docker exec -e "MYSQL_PWD=$REMOTE_PASS" "$LOCAL_CONTAINER" \
+        mysqladmin -h "$HOST_ALIAS" -P "$TUNNEL_PORT" -u "$REMOTE_USER" ping >/dev/null 2>&1; then
+    ready=1; break
+  fi
+  sleep 1
+done
+if [[ $ready -ne 1 ]]; then
+  echo "隧道未就绪，中止。" >&2
+  "${SSH[@]}" -S "$CTL" -O exit "$TARGET" 2>/dev/null || true
+  exit 1
+fi
+
+echo "==> mysqldump 导出中..."
+docker exec -e "MYSQL_PWD=$REMOTE_PASS" "$LOCAL_CONTAINER" \
+  mysqldump -h "$HOST_ALIAS" -P "$TUNNEL_PORT" -u "$REMOTE_USER" \
+  --lock-tables=0 --add-drop-table --skip-triggers \
+  --skip-routines --skip-events --column-statistics=0 --no-tablespaces --set-gtid-purged=OFF \
+  --databases "$REMOTE_DB" > "$OUT"
+RC=$?
+
+"${SSH[@]}" -S "$CTL" -O exit "$TARGET" 2>/dev/null || true
+
+if [[ $RC -ne 0 ]]; then
+  echo "备份失败 (mysqldump 退出码 $RC)。" >&2
+  exit 1
+fi
+echo "==> 备份完成 ✅ $OUT ($(wc -c < "$OUT") bytes)"
+echo "    提示：请在阿里云 RDS 控制台再创建一次手动快照，作为整库回滚保险。"

deploy/enable-api-lingshi-ssl.sh

@@ -1,65 +0,0 @@
-#!/usr/bin/env bash
-# 为 api.lingshivip.cn 申请 DNS 证书并启用 HTTPS
-set -euo pipefail
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-SSL_DIR="/etc/nginx/ssl/api.lingshivip.cn"
-NGINX_CONF="/etc/nginx/conf.d/dukang-lingshivip.conf"
-
-mkdir -p "$SSL_DIR" /var/www/certbot/.well-known/acme-challenge
-
-echo "==> 1. 发起 DNS 验证（需先在 DNSPod 添加 TXT 记录）"
-~/.acme.sh/acme.sh --issue -d api.lingshivip.cn --dns \
-  --yes-I-know-dns-manual-mode-enough-go-ahead-please \
-  --server letsencrypt || true
-
-echo ""
-echo "请在 DNSPod 添加上述 TXT 记录后，执行："
-echo "  $0 --renew"
-echo ""
-
-if [[ "${1:-}" != "--renew" ]]; then
-  exit 0
-fi
-
-echo "==> 2. 继续 DNS 验证并签发证书"
-~/.acme.sh/acme.sh --renew -d api.lingshivip.cn --yes-I-know-dns-manual-mode-enough-go-ahead-please
-
-echo "==> 3. 安装证书到 nginx 目录"
-install -m 644 ~/.acme.sh/api.lingshivip.cn_ecc/fullchain.cer "$SSL_DIR/fullchain.cer"
-install -m 600 ~/.acme.sh/api.lingshivip.cn_ecc/api.lingshivip.cn.key "$SSL_DIR/api.lingshivip.cn.key"
-
-echo "==> 4. 更新 nginx 并重载"
-cp "$SCRIPT_DIR/nginx-lingshivip.conf" "$NGINX_CONF"
-python3 - <<'PY'
-from pathlib import Path
-p = Path("/etc/nginx/conf.d/dukang-lingshivip.conf")
-text = p.read_text()
-old = """    location / {
-        proxy_pass http://127.0.0.1:8090;
-        proxy_http_version 1.1;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-        proxy_set_header Connection "";
-    }
-}
-
-# API 独立域名 HTTPS"""
-new = """    location / {
-        return 301 https://$host$request_uri;
-    }
-}
-
-# API 独立域名 HTTPS"""
-if old not in text:
-    raise SystemExit("nginx api http redirect patch failed")
-p.write_text(text.replace(old, new, 1))
-PY
-
-nginx -t
-systemctl reload nginx
-
-echo "==> 5. 健康检查"
-curl -sf -o /dev/null -w "api-https:%{http_code}\n" https://api.lingshivip.cn/api/v1/health
-echo "==> api.lingshivip.cn HTTPS 已启用"

deploy/enable-runxian-apex-ssl.sh

@@ -1,59 +0,0 @@
-#!/usr/bin/env bash
-# runxian.top 裸域名申请 Let's Encrypt 并启用 HTTPS
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-DOMAIN=runxian.top
-EMAIL="${CERTBOT_EMAIL:-admin@runxian.top}"
-
-echo "==> 检查 DNS: $DOMAIN"
-ip="$(dig +short "$DOMAIN" A @223.5.5.5 | tail -1)"
-if [[ -z "$ip" ]]; then
-  echo "ERROR: $DOMAIN 无 A 记录，请先在 DNS 添加指向本机公网 IP（当前服务器: $(curl -sf ifconfig.me || echo unknown)）"
-  exit 1
-fi
-echo "  $DOMAIN -> $ip"
-
-mkdir -p /var/www/certbot /var/log/nginx/dukang
-
-# 若尚未有证书，先部署仅 HTTP 的配置以便 ACME 校验
-if [[ ! -f /etc/letsencrypt/live/runxian.top/fullchain.pem ]]; then
-  echo "==> 临时 HTTP 配置（用于 ACME）..."
-  cat > /etc/nginx/conf.d/dukang-runxian-apex.conf <<'EOF'
-server {
-    listen 80;
-    server_name runxian.top;
-    root /opt/dukang-haoke/public;
-    index index.html;
-    location ^~ /.well-known/acme-challenge/ {
-        root /var/www/certbot;
-        default_type "text/plain";
-    }
-    location ~ ^/MP_verify_.*\.txt$ {
-        default_type text/plain;
-        access_log off;
-    }
-    location / {
-        try_files $uri $uri/ =404;
-    }
-}
-EOF
-  nginx -t
-  systemctl reload nginx
-fi
-
-echo "==> 申请证书..."
-certbot certonly --webroot -w /var/www/certbot \
-  --cert-name runxian.top \
-  -d runxian.top \
-  --non-interactive --agree-tos -m "$EMAIL"
-
-echo "==> 切换 HTTPS 配置..."
-install -m 644 "$SCRIPT_DIR/nginx-runxian-apex.conf" /etc/nginx/conf.d/dukang-runxian-apex.conf
-nginx -t
-systemctl reload nginx
-
-echo "==> 验证..."
-code="$(curl -sf -o /dev/null -w '%{http_code}' "https://$DOMAIN/MP_verify_ayPJ4CQqbUcec3jX.txt" || echo fail)"
-echo "  https://$DOMAIN/MP_verify_ayPJ4CQqbUcec3jX.txt -> $code"
-echo "==> runxian.top HTTPS 已启用"

deploy/enable-runxian-dukang-ssl.sh

@@ -1,57 +0,0 @@
-#!/usr/bin/env bash
-# 为杜康 runxian.top 申请 Let's Encrypt 并切换 HTTPS 配置
-# 三端 H5 统一入口 user.runxian.top/{user,shop,partner}/
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-DOMAINS=(
-  user.runxian.top
-  shop.runxian.top
-  partner.runxian.top
-  webadmin.runxian.top
-  dkapi.runxian.top
-)
-
-echo "==> 检查 DNS 解析到本机..."
-for d in "${DOMAINS[@]}"; do
-  ip="$(dig +short "$d" @223.5.5.5 | tail -1)"
-  if [[ -z "$ip" ]]; then
-    echo "ERROR: $d 无 A 记录，请先在 DNS 添加指向本机公网 IP"
-    exit 1
-  fi
-  echo "  $d -> $ip"
-done
-
-mkdir -p /var/www/certbot /var/log/nginx/dukang
-
-echo "==> 申请证书..."
-certbot certonly --webroot -w /var/www/certbot \
-  --cert-name user.runxian.top \
-  -d user.runxian.top \
-  -d shop.runxian.top \
-  -d partner.runxian.top \
-  -d webadmin.runxian.top \
-  -d dkapi.runxian.top \
-  --non-interactive --agree-tos -m admin@runxian.top || {
-  echo "certbot 失败，请确认 DNS 已生效且 80 端口可从公网访问"
-  exit 1
-}
-
-echo "==> 切换 nginx HTTPS 配置..."
-install -m 644 "$SCRIPT_DIR/nginx-runxian-dukang-ssl.conf" /etc/nginx/conf.d/dukang-runxian.conf
-nginx -t
-systemctl reload nginx
-
-echo "==> 验证..."
-for url in \
-  https://user.runxian.top/user/ \
-  https://user.runxian.top/shop/ \
-  https://user.runxian.top/partner/ \
-  https://shop.runxian.top/ \
-  https://webadmin.runxian.top/ \
-  https://dkapi.runxian.top/api/v1/health; do
-  code="$(curl -sf -o /dev/null -w '%{http_code}' "$url" || echo fail)"
-  echo "  $url -> $code"
-done
-
-echo "==> runxian.top 杜康域名 HTTPS 已启用（H5 统一入口 user.runxian.top）"