Merge pull request 'Dev v3.4.17 版本发布' (#15) from dev into main

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

.workbuddy/memory/2026-08-16.md

@@ -41,3 +41,39 @@
   - README 的测试号 `13700000001` **不在本地同步库**；本地 `partner_account` 共 9 个，可用真实号如 `18049821889`(Jacy) / `13073729990`(queen)（均 ACTIVE）。
   - 流程：填真实合伙人手机号 → 获取验证码 → **验证码打印在 `pnpm dev:api` 后端终端**（`Mock SMS → 180****8889 code=XXXXXX`）→ 填码登录。
   - 注意 h5-partner 默认 5175，本次因 5175 被占自动落到 5176，代理是路径匹配不受影响。
+
+## 发布：v3.4.17 门店套餐审核快捷入口 上生产
+- 提交 `1c91e6b`（dev_jacy 上，含后端 admin-stores.service.ts + AdminStorePackagesSection/StorePackageAuditsPage/StoresPage 三前端 + 开发计划文档）。
+- 流水线：直接快进推送（避免 git checkout 工作树不刷新）：`git push origin dev_jacy` + `dev_jacy:dev` + `dev_jacy:main`，三分支统一到 `1c91e6b`；本地 `git branch -f dev/main origin/*` 同步。
+- 部署：`bash deploy/deploy-prod.sh --host dukang-server -- --skip-db`（后端仅给列表响应加字段，无 schema 变更，故 skip-db）。
+- 结果：`DEPLOY_EXIT=0`，新 tag `v3.4.17`，全部应用构建通过，PM2 重启 dukang-api/h5-shop/h5-partner/admin-web（另拉起 h5-user），健康检查 api:200 / mini-user(h5):200，系统版本记录 commit `1c91e6b`。
+
+## 发布：v3.4.18 套餐变更对比逐字段列出变动明细
+- 需求：套餐变更对比「将变动的地方详细列出来」（之前只给「新增/删除/变更/未变」粗粒度标记，不列具体字段）。
+- 改动仅在 `apps/admin-web/src/pages/StorePackageAuditsPage.tsx`：
+  - 新增 `fieldChanges(live, proposed)`：逐字段比对 价格/套餐名称/菜品内容/可用时间/其他说明/图片，产出 `label+旧值→新值` 明细。
+  - `diffPackages` 给「变更」行附 `changes`。
+  - `PackageDetailCard` 在「待审核」卡片底部渲染「变更明细」块（旧值删除线 → 新值加粗，橙色块）。
+  - 抽屉顶部加「新增 X · 删除 Y · 变更 Z · 未变 W」汇总条。
+- 提交 `bbd7e52`（feat(admin) 套餐变更对比逐字段列出变动明细），快进推送 dev_jacy/dev/main。
+- 部署：`bash deploy/deploy-prod.sh --host dukang-server -- --skip-db`（无 schema 变更）。
+- 结果：构建通过、PM2 重启 admin-web 等、健康检查 api:200 / mini-user(h5):200，系统版本记录 commit `bbd7e52`（无精确 tag，记 tag=-，无害）。
+- 已知局限：配对按「套餐名称」(空则索引) 位置匹配；若套餐被**改名**，会误判为「删除旧名+新增新名」而非「变更」，故名称变更不会出现在逐字段明细里。
+
+## 优化：套餐变更对比·逐字差异 + 文档并入 v3.4.17
+- 需求：变动明细要能**定位到文本中具体哪些字变了（逐字检查）**，且把开发计划文档合并到 v3.4.17 文档里（不再单独留 v3.4.18 文档）。
+- 代码改动（仍仅 `StorePackageAuditsPage.tsx`）：
+  - `diffText(a,b)`：LCS 动态规划 (`dp[i][j]`)+回溯，产出 `equal/delete/insert` 段落并合并相邻同类型；`O(|a|·|b|)`，字段长度可控。
+  - `TextDiff({oldText,newText})`：两行渲染——「原：」红删线标被删字、「新：」绿标新增字。
+  - `FieldChange` 增加 `kind: 'text'|'value'`：价格/图片走 `旧→新`；套餐名称/菜品内容/可用时间/其他说明走 `TextDiff` 逐字高亮。
+  - `杜康好客-v3.4.17-门店套餐审核快捷入口.md` 新增第 F 节「套餐变更对比·逐字段/逐字明细」，并把原先 v3.4.18 的字段级说明并入，删去独立 v3.4.18 文档计划。
+- 提交 `ecd9973`，快进推送 dev_jacy/dev/main，部署 `--host dukang-server -- --skip-db`。
+- 结果：构建通过、健康检查 api:200 / mini-user(h5):200，系统版本记录 commit `ecd9973`（tag=-，无害）。
+- 验证要点：开任一「变更」套餐的待审核卡片 → 底部「变更明细」→ 菜品/说明等文本以红删+绿增逐字呈现。
+
+## 优化：h5-partner 门店详情·门店套餐「编辑套餐」按钮
+- 需求：按钮**缩小、靠最右侧、保持美观**。根因：`.partner-btn-outline` 是整行大按钮(`flex:1; height:48px; font-size:16px`)，放在卡片标题右侧会被拉伸成大块。
+- 改动：`apps/h5-partner/src/styles.css` 新增 `.partner-btn-outline--compact`（`flex:none; height:30px; padding:0 14px; font-size:13px; font-weight:500; border-radius:var(--radius-sm); color:var(--color-primary)`，hover 用 `color-mix` 8% 底色）；`StoreDetailPage.tsx:288` 的「编辑套餐」按钮加该类（父级 `space-between` 已保证贴右）。
+- 提交 `69e201f`，快进推送 dev_jacy/dev/main，部署 `--host dukang-server -- --skip-db`。
+- 结果：构建通过、PM2 重启 h5-partner、健康检查 api:200 / mini-user(h5):200，系统版本记录 commit `69e201f`（tag=-，无害）。
+- 注意：`StoreDetailPage.tsx:311` 有个历史遗留 TS 错误（`status === 'CLOSED'` 类型无重叠），与本改动无关，未动。

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

@@ -42,6 +42,71 @@ function imageSignature(pkg: StorePackageItemDto | StorePackageViewDto) {
   return normalizeStorePackageImageUrls(pkg).join('|');
 }
 
+type FieldChange = { label: string; old: string; now: string; kind: 'text' | 'value' };
+
+/** 文本逐字差异：LCS 比对，产出 equal / delete / insert 段落，用于高亮具体变了哪些字 */
+function diffText(a: string, b: string): Array<{ type: 'equal' | 'insert' | 'delete'; text: string }> {
+  const m = a.length;
+  const n = b.length;
+  const dp: number[][] = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+  for (let i = m - 1; i >= 0; i--) {
+    for (let j = n - 1; j >= 0; j--) {
+      dp[i][j] = a[i] === b[j] ? dp[i + 1][j + 1] + 1 : Math.max(dp[i + 1][j], dp[i][j + 1]);
+    }
+  }
+  const raw: Array<{ type: 'equal' | 'insert' | 'delete'; text: string }> = [];
+  let i = 0;
+  let j = 0;
+  while (i < m && j < n) {
+    if (a[i] === b[j]) {
+      raw.push({ type: 'equal', text: a[i] });
+      i++;
+      j++;
+    } else if (dp[i + 1][j] >= dp[i][j + 1]) {
+      raw.push({ type: 'delete', text: a[i] });
+      i++;
+    } else {
+      raw.push({ type: 'insert', text: b[j] });
+      j++;
+    }
+  }
+  while (i < m) raw.push({ type: 'delete', text: a[i++] });
+  while (j < n) raw.push({ type: 'insert', text: b[j++] });
+  const merged: Array<{ type: 'equal' | 'insert' | 'delete'; text: string }> = [];
+  for (const s of raw) {
+    const last = merged[merged.length - 1];
+    if (last && last.type === s.type) last.text += s.text;
+    else merged.push({ ...s });
+  }
+  return merged;
+}
+
+/** 逐字段比较套餐内容，返回发生变化的字段明细（用于“变动的地方详细列出”） */
+function fieldChanges(
+  live: StorePackageItemDto | StorePackageViewDto,
+  proposed: StorePackageItemDto | StorePackageViewDto,
+): FieldChange[] {
+  const changes: FieldChange[] = [];
+  const text = (v: string | number | null | undefined) => (v ?? '').toString().trim();
+  const pushText = (label: string, oldV: string, newV: string) => {
+    if (oldV !== newV) changes.push({ label, old: oldV, now: newV, kind: 'text' });
+  };
+  const pushValue = (label: string, oldV: string, newV: string) => {
+    if (oldV !== newV) changes.push({ label, old: oldV || '（空）', now: newV || '（空）', kind: 'value' });
+  };
+  pushValue('价格', `¥${text(live.price)}`, `¥${text(proposed.price)}`);
+  pushText('套餐名称', text(live.name), text(proposed.name));
+  pushText('菜品内容', text(live.dishes), text(proposed.dishes));
+  pushText('可用时间', text(live.usableTime), text(proposed.usableTime));
+  pushText('其他说明', text(live.otherNotes), text(proposed.otherNotes));
+  const liveImgs = normalizeStorePackageImageUrls(live);
+  const proposedImgs = normalizeStorePackageImageUrls(proposed);
+  if (imageSignature(live) !== imageSignature(proposed)) {
+    changes.push({ label: '图片', old: `${liveImgs.length} 张`, now: `${proposedImgs.length} 张`, kind: 'value' });
+  }
+  return changes;
+}
+
 function diffPackages(live: StorePackageViewDto[], proposed: StorePackageItemDto[]) {
   const liveMap = new Map(live.map((p, i) => [packageKey(p, i), p]));
   const proposedMap = new Map(proposed.map((p, i) => [packageKey(p, i), p]));
@@ -51,6 +116,7 @@ function diffPackages(live: StorePackageViewDto[], proposed: StorePackageItemDto
     change: 'added' | 'removed' | 'changed' | 'unchanged';
     live?: StorePackageViewDto;
     proposed?: StorePackageItemDto;
+    changes?: FieldChange[];
   }> = [];
 
   for (const key of keys) {
@@ -67,7 +133,13 @@ function diffPackages(live: StorePackageViewDto[], proposed: StorePackageItemDto
         (l.usableTime ?? '') !== (p.usableTime ?? '') ||
         (l.otherNotes ?? '') !== (p.otherNotes ?? '') ||
         imageSignature(l) !== imageSignature(p);
-      rows.push({ key, change: changed ? 'changed' : 'unchanged', live: l, proposed: p });
+      rows.push({
+        key,
+        change: changed ? 'changed' : 'unchanged',
+        live: l,
+        proposed: p,
+        changes: changed ? fieldChanges(l, p) : undefined,
+      });
     }
   }
   return rows;
@@ -80,14 +152,53 @@ const CHANGE_LABELS = {
   unchanged: { text: '未变', color: 'default' },
 } as const;
 
+/** 文本逐字差异渲染：原行红色删除线标出被删的字，新行绿色标出新增的字 */
+function TextDiff({ oldText, newText }: { oldText: string; newText: string }) {
+  const segs = diffText(oldText, newText);
+  return (
+    <div style={{ marginTop: 2 }}>
+      <div style={{ lineHeight: 1.6 }}>
+        <Typography.Text type="secondary">原：</Typography.Text>
+        {segs
+          .filter((s) => s.type !== 'insert')
+          .map((s, idx) =>
+            s.type === 'delete' ? (
+              <Typography.Text key={idx} delete style={{ color: '#cf1322' }}>
+                {s.text || '（空）'}
+              </Typography.Text>
+            ) : (
+              <Typography.Text key={idx}>{s.text}</Typography.Text>
+            ),
+          )}
+      </div>
+      <div style={{ lineHeight: 1.6 }}>
+        <Typography.Text type="secondary">新：</Typography.Text>
+        {segs
+          .filter((s) => s.type !== 'delete')
+          .map((s, idx) =>
+            s.type === 'insert' ? (
+              <Typography.Text key={idx} style={{ color: '#389e0d' }}>
+                {s.text || '（空）'}
+              </Typography.Text>
+            ) : (
+              <Typography.Text key={idx}>{s.text}</Typography.Text>
+            ),
+          )}
+      </div>
+    </div>
+  );
+}
+
 function PackageDetailCard({
   title,
   pkg,
   change,
+  changes,
 }: {
   title?: string;
   pkg: StorePackageItemDto | StorePackageViewDto;
   change?: keyof typeof CHANGE_LABELS;
+  changes?: FieldChange[];
 }) {
   const images = normalizeStorePackageImageUrls(pkg);
   const meta = change ? CHANGE_LABELS[change] : null;
@@ -149,6 +260,39 @@ function PackageDetailCard({
       ) : (
         <Typography.Text type="secondary">无套餐图片</Typography.Text>
       )}
+      {changes && changes.length ? (
+        <div
+          style={{
+            marginTop: 8,
+            padding: 8,
+            background: '#fff7e6',
+            border: '1px solid #ffe7ba',
+            borderRadius: 6,
+          }}
+        >
+          <Typography.Text strong style={{ fontSize: 12 }}>
+            变更明细
+          </Typography.Text>
+          <ul style={{ margin: '6px 0 0', paddingLeft: 18 }}>
+            {changes.map((c) => (
+              <li key={c.label} style={{ marginBottom: 6 }}>
+                <Typography.Text type="secondary">{c.label}：</Typography.Text>
+                {c.kind === 'text' ? (
+                  <TextDiff oldText={c.old} newText={c.now} />
+                ) : (
+                  <>
+                    <Typography.Text delete type="secondary">
+                      {c.old}
+                    </Typography.Text>
+                    <Typography.Text type="secondary"> → </Typography.Text>
+                    <Typography.Text strong>{c.now}</Typography.Text>
+                  </>
+                )}
+              </li>
+            ))}
+          </ul>
+        </div>
+      ) : null}
     </div>
   );
 }
@@ -236,6 +380,11 @@ export default function StorePackageAuditsPage() {
 
   const diffRows = detail ? diffPackages(detail.livePackages ?? [], detail.packages ?? []) : [];
   const changeByKey = new Map(diffRows.map((row) => [row.key, row.change]));
+  const changesByKey = new Map(diffRows.map((row) => [row.key, row.changes]));
+  const addedCount = diffRows.filter((r) => r.change === 'added').length;
+  const removedCount = diffRows.filter((r) => r.change === 'removed').length;
+  const changedCount = diffRows.filter((r) => r.change === 'changed').length;
+  const unchangedCount = diffRows.filter((r) => r.change === 'unchanged').length;
 
   const columns: ColumnsType<StorePackageChangeRequestDto> = [
     { title: '门店', dataIndex: 'storeName', render: (_, row) => row.storeName || row.storeId },
@@ -354,9 +503,17 @@ export default function StorePackageAuditsPage() {
             {detail.rejectReason ? (
               <Typography.Paragraph type="danger">驳回原因：{detail.rejectReason}</Typography.Paragraph>
             ) : null}
-            <Typography.Paragraph type="secondary" style={{ marginBottom: 12 }}>
-              线上已审核 {detail.livePackages?.length ?? 0} 条 · 待审核 {detail.packages?.length ?? 0} 条
-            </Typography.Paragraph>
+            <Space direction="vertical" size={4} style={{ marginBottom: 12 }}>
+              <Typography.Text type="secondary">
+                线上已审核 {detail.livePackages?.length ?? 0} 条 · 待审核 {detail.packages?.length ?? 0} 条
+              </Typography.Text>
+              <Space wrap>
+                <Tag color="green">新增 {addedCount}</Tag>
+                <Tag color="red">删除 {removedCount}</Tag>
+                <Tag color="orange">变更 {changedCount}</Tag>
+                {unchangedCount ? <Tag>未变 {unchangedCount}</Tag> : null}
+              </Space>
+            </Space>
             <div className="admin-package-audit-cols">
               <div className="admin-package-audit-col">
                 <Typography.Title level={5} style={{ marginTop: 0 }}>
@@ -386,6 +543,7 @@ export default function StorePackageAuditsPage() {
                       title={`套餐 ${index + 1}`}
                       pkg={pkg}
                       change={changeByKey.get(packageKey(pkg, index))}
+                      changes={changesByKey.get(packageKey(pkg, index))}
                     />
                   ))
                 ) : (

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

@@ -285,7 +285,7 @@ export default function StoreDetailPage() {
           <section className="partner-form-card" style={{ margin: '0 0 16px' }}>
             <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center' }}>
               <h3 className="label-md text-muted" style={{ textTransform: 'uppercase', letterSpacing: '0.1em' }}>门店套餐</h3>
-              <button type="button" className="partner-btn-outline" onClick={() => navigate(`/stores/${id}/packages`)}>
+              <button type="button" className="partner-btn-outline partner-btn-outline--compact" onClick={() => navigate(`/stores/${id}/packages`)}>
                 编辑套餐
               </button>
             </div>

apps/h5-partner/src/styles.css

@@ -304,6 +304,30 @@ html {
   cursor: pointer;
 }
 
+/* 卡片标题旁的紧凑型描边按钮：不拉伸、缩小尺寸、贴右对齐 */
+.partner-btn-outline--compact {
+  flex: none;
+  height: 30px;
+  padding: 0 14px;
+  border: 1px solid var(--color-outline);
+  border-radius: var(--radius-sm);
+  background: transparent;
+  color: var(--color-primary);
+  font-family: var(--font-label);
+  font-size: 13px;
+  font-weight: 500;
+  line-height: 1;
+  cursor: pointer;
+  transition: background 0.15s, border-color 0.15s;
+}
+.partner-btn-outline--compact:hover {
+  background: color-mix(in srgb, var(--color-primary) 8%, transparent);
+  border-color: var(--color-primary);
+}
+.partner-btn-outline--compact:active {
+  transform: scale(0.97);
+}
+
 .partner-btn-wechat {
   width: 100%;
   padding: 16px;

杜康好客-v3.4.17-门店套餐审核快捷入口.md

@@ -50,14 +50,33 @@
 
 | 位置 | 说明 |
 |------|------|
-| `GET /admin/stores` | 列表，新增 `pendingPackageAuditId`（ops/admin-stores.service.ts） |
+| `GET /admin/stores` | 列表，新增 `pendingPackageAuditId`（ops/admin/* 透传，无 schema 变更） |
 | `GET /admin/stores/:storeId/packages` | 返回 `pendingRequest`（store-package.service.ts，未改，仅前端消费） |
 | `GET /admin/store-package-audits/:requestId` | 审核详情（含 `livePackages` 对照） |
 | `PUT /admin/store-package-audits/:requestId/audit` | 通过 / 驳回 |
 | `apps/admin-web/src/components/AdminStorePackagesSection.tsx` | 套餐页签提醒 + 按钮 |
-| `apps/admin-web/src/pages/StorePackageAuditsPage.tsx` | `?requestId=` 自动开抽屉 |
+| `apps/admin-web/src/pages/StorePackageAuditsPage.tsx` | `?requestId=` 自动开抽屉 + 变更明细（含 `fieldChanges` / `diffText` / `TextDiff`） |
 | `apps/admin-web/src/pages/StoresPage.tsx` | 列表操作栏快捷入口 |
 
+## F. 套餐变更对比·逐字段 / 逐字明细
+
+组件：`apps/admin-web/src/pages/StorePackageAuditsPage.tsx`
+
+> 需求：审核抽屉原本只给每条套餐「新增 / 删除 / 变更 / 未变」粗粒度标记，看不出具体哪里变了。本次在「待审核套餐」卡片底部新增**变更明细**块，逐字段列出差异；文本类字段进一步做**逐字（LCS）差异定位**，精确高亮哪些字被增 / 删。
+
+- `fieldChanges(live, proposed)`：逐字段比对，产出 `{ label, old, now, kind }` 明细：
+  - `kind: 'value'`（整体替换展示 `旧 → 新`）：**价格**、**图片（N 张 → M 张）**。
+  - `kind: 'text'`（走逐字差异）：**套餐名称、菜品内容、可用时间、其他说明**。
+- `diffText(a, b)`：LCS 动态规划（`dp[i][j]`）+ 回溯，产出 `equal / delete / insert` 段落并合并相邻同类型；时间/空间 `O(|a|·|b|)`，套餐字段长度可控，无性能风险。
+- `TextDiff({ oldText, newText })`：渲染两行——
+  - 「原：」行用**红色删除线**标出被删的字（`delete` 段），其余正常；
+  - 「新：」行用**绿色**标出新增的字（`insert` 段），其余正常。
+  - 一眼定位到具体改动的字，而非整段替换。
+- 抽屉顶部汇总条：**新增 X · 删除 Y · 变更 Z · 未变 W**（由 `diffPackages` 的 `changes` 统计）。
+
+### 已知局限
+- 套餐按**名称**（空则按位置）配对；若某条套餐**改名**，会误判为「删除旧名 + 新增新名」而非「变更」，改名本身不会进入逐字明细。如需把改名也识别为「变更」，需升级 `packageKey` 配对策略（名称变了但其余字段相近 → 视为变更）。
+
 ## 验收
 
 - [ ] 某门店有待审套餐变更时：门店详情-套餐页签顶部出现黄色「有待审核套餐」提醒，且「审核 / 对比」可点。
@@ -65,3 +84,4 @@
 - [ ] 门店列表操作栏对该门店出现「审核套餐」「对比」按钮，点击同样跳转并自动打开抽屉。
 - [ ] 在审核页完成审核后，返回门店详情-套餐页签，提醒消失（或被事件即时刷新）。
 - [ ] 无待审套餐的门店：列表与详情页签均不出现上述入口。
+- [ ] 抽屉中「变更」套餐的「待审核」卡片底部出现「变更明细」：价格/图片以 `旧 → 新` 展示；菜品内容/可用时间/其他说明/套餐名称以**逐字差异**展示（原行红删、新行绿增），能精确定位到具体改动的字。