fix(expressTemplate): 修正运费模板计费方式类型及删除报错

- 将运费模板和详情模型中的计费方式 type 从 string 改为 boolean 类型 - 修改相关页面中计费方式显示及选择控件为布尔值 true/false 表示按件/按重量 - 统一删除操作使用后端返回的主键 id 替代废弃的 shopExpressTemplateId - 修复删除运费模板时报错“参数格式错误: id 的值 'undefined' 无法转换为 Integer” - ele-modal 关闭按钮定位修复，兼容最大化按钮时的偏移问题 - 小程序端 checkout 运费模板接入，支持动态计算显示运费费用 - 优化编辑表单中首件/续件数量或重量的动态标签和占位提示逻辑
2026-07-07 15:03:06 +08:00
parent 08685d5ef1
commit 6118e2be01
9 changed files with 98 additions and 30 deletions
--- a/.workbuddy/memory/2026-07-07.md
+++ b/.workbuddy/memory/2026-07-07.md
@@ -21,3 +21,38 @@
 - **search.vue**: 修正类型导入、添加搜索输入框、添加批量删除按钮（disabled 联动 selection）
 - **Detail Edit**: templateId 改为下拉选择（从 listShopExpressTemplate 加载选项）
 - 修复 rules 类型错误（reactive<Record<string, any>>）
+
+### Bug 修复
+- **JSON 反序列化错误**: 后端 type 字段为 Java Boolean，前端 radio 值从字符串 "0"/"1" 改为 true/false，Model 中 type 类型从 string 改为 boolean
+- **ele-modal X按钮错位**: component.less 添加 ele-modal 关闭按钮定位修复，有最大化按钮时右移 56px
+- **shopExpressTemplate/index.vue**: selection 绑定从 `:selection` 修正为 `v-model:selection`
+
+## 小程序端运费模板接入（guilixu-taro checkout）
+
+### 现状分析
+- checkout.tsx 运费硬编码"免运费"，零处 import shopExpressTemplate API
+- ShopGoods 模型中有 expressTemplateId 字段，运费模板与商品关联
+- ShopExpressTemplate 有 firstNum/firstAmount/extraNum/extraAmount 定价字段
+- 地址模型只有 province/city 字符串名，无数字 ID，地区匹配暂不可行
+
+### 实现方案
+采用主模板定价方案（不依赖地区匹配）：
+- 创建 src/utils/expressFee.ts：computeExpressFee() 工具函数
+- 按模板分组、合并同模板商品数量、应用计费公式
+- fee = firstAmount + extraAmount * ceil(max(0, Q - firstNum) / extraNum)
+- 修改 checkout.tsx：添加 expressFee 状态 + useEffect 自动计算 + 动态显示运费 + 纳入总价
+
+### 注意事项
+- 购物车 items 不包含 product 嵌套对象，cart checkout 时 expressTemplateId 为 undefined，运费显示为 0（免运费）
+- buyNow 流程 items 包含 product 数据，运费计算正常工作
+- 后端创建订单时会独立计算运费，前端仅用于展示预览
+
+## 修复 shopExpressTemplate 删除报错
+
+- 问题：删除运费模板时报错 "参数格式错误: id 的值 'undefined' 无法转换为 Integer"
+- 根因：后端返回的主键字段是 `id`，但前端代码用了 `row.shopExpressTemplateId`（Model 中定义了两个字段，实际后端只返回 `id`）
+- 修复文件：
+  - `src/views/shop/shopExpressTemplate/index.vue`：`row-key`、删除、批量删除均改为用 `row.id`
+  - `src/views/shop/shopExpressTemplateDetail/index.vue`：同上
+  - `src/views/shop/shopExpressTemplateDetail/components/shopExpressTemplateDetailEdit.vue`：下拉选择器 `field-names` 的 `value` 改为 `'id'`
+- 注意：该模块 Model 中 `shopExpressTemplateId` 和 `id` 并存，建议后续清理废弃字段
--- a/dist.zip
+++ b/dist.zip
--- a/src/api/shop/shopExpressTemplate/model/index.ts
+++ b/src/api/shop/shopExpressTemplate/model/index.ts
@@ -8,8 +8,8 @@ export interface ShopExpressTemplate {
  shopExpressTemplateId?: number;
  /** 旧字段ID（兼容） */
  id?: number;
-  /** 计费方式: 0=按件, 1=按重量 */
-  type?: string;
+  /** 计费方式: true=按件, false=按重量 */
+  type?: boolean;
  /** 模板名称 */
  title?: string;
  /** 首件价格 */
--- a/src/api/shop/shopExpressTemplateDetail/model/index.ts
+++ b/src/api/shop/shopExpressTemplateDetail/model/index.ts
@@ -10,8 +10,8 @@ export interface ShopExpressTemplateDetail {
  id?: number;
  /** 所属运费模板ID */
  templateId?: number;
-  /** 计费方式: 0=按件, 1=按重量 */
-  type?: string;
+  /** 计费方式: true=按件, false=按重量 */
+  type?: boolean;
  /** 省份ID */
  provinceId?: number;
  /** 城市ID */
@@ -46,7 +46,7 @@ export interface ShopExpressTemplateDetailParam extends PageParam {
  /** 所属运费模板ID */
  templateId?: number;
  /** 计费方式 */
-  type?: string;
+  type?: boolean;
  /** 状态 */
  status?: number;
  keywords?: string;
--- a/src/styles/component.less
+++ b/src/styles/component.less
@@ -85,3 +85,36 @@
    border-radius: 0 0 12px 12px;
  }
 }
+
+/* ele-modal 最大化按钮与关闭按钮位置修复 */
+.ele-modal .ant-modal-header {
+  .ant-modal-close {
+    position: absolute;
+    top: 0;
+    right: 0;
+    width: 30px;
+    height: 30px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    z-index: 10;
+  }
+
+  /* 当存在最大化按钮时，关闭按钮左移 */
+  .ele-modal-maximize-btn + .ant-modal-close,
+  .ele-modal-maximize-btn ~ .ant-modal-close {
+    right: 30px;
+  }
+}
+
+/* 针对 ant-modal 关闭按钮的兜底修复 */
+.ant-modal .ant-modal-close {
+  position: absolute;
+  top: 0;
+  right: 0;
+  width: 30px;
+  height: 30px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
--- a/src/views/shop/shopExpressTemplate/components/shopExpressTemplateEdit.vue
+++ b/src/views/shop/shopExpressTemplate/components/shopExpressTemplateEdit.vue
@@ -30,16 +30,16 @@
      </a-form-item>
      <a-form-item label="计费方式" name="type">
        <a-radio-group v-model:value="form.type">
-          <a-radio value="0">按件</a-radio>
-          <a-radio value="1">按重量</a-radio>
+          <a-radio :value="true">按件</a-radio>
+          <a-radio :value="false">按重量</a-radio>
        </a-radio-group>
      </a-form-item>
-      <a-form-item label="首件数量/重量" name="firstNum">
+      <a-form-item :label="form.type ? '首件数量' : '首重重量'" name="firstNum">
        <a-input-number
          :min="0"
          :precision="2"
          class="ele-fluid"
-          placeholder="请输入首件数量/重量"
+          :placeholder="form.type ? '请输入首件数量' : '请输入首重重量'"
          v-model:value="form.firstNum"
        />
      </a-form-item>
@@ -52,12 +52,12 @@
          v-model:value="form.firstAmount"
        />
      </a-form-item>
-      <a-form-item label="续件数量/重量" name="extraNum">
+      <a-form-item :label="form.type ? '续件数量' : '续重重量'" name="extraNum">
        <a-input-number
          :min="0"
          :precision="2"
          class="ele-fluid"
-          placeholder="请输入续件数量/重量"
+          :placeholder="form.type ? '请输入续件数量' : '请输入续重重量'"
          v-model:value="form.extraNum"
        />
      </a-form-item>
@@ -141,7 +141,7 @@
  const form = reactive<ShopExpressTemplate>({
    shopExpressTemplateId: undefined,
    id: undefined,
-    type: '0',
+    type: true,
    title: undefined,
    firstAmount: undefined,
    extraAmount: undefined,
--- a/src/views/shop/shopExpressTemplate/index.vue
+++ b/src/views/shop/shopExpressTemplate/index.vue
@@ -3,7 +3,7 @@
    <a-card :bordered="false" :body-style="{ padding: '16px' }">
      <ele-pro-table
        ref="tableRef"
-        row-key="shopExpressTemplateId"
+        row-key="id"
        :columns="columns"
        :datasource="datasource"
        :customRow="customRow"
@@ -21,8 +21,8 @@
        </template>
        <template #bodyCell="{ column, record }">
          <template v-if="column.key === 'type'">
-            <a-tag v-if="record.type === '0'" color="blue">按件</a-tag>
-            <a-tag v-else-if="record.type === '1'" color="cyan">按重量</a-tag>
+            <a-tag v-if="record.type === true" color="blue">按件</a-tag>
+            <a-tag v-else-if="record.type === false" color="cyan">按重量</a-tag>
            <span v-else>{{ record.type }}</span>
          </template>
          <template v-if="column.key === 'status'">
@@ -200,7 +200,7 @@
  /* 删除单个 */
  const remove = (row: ShopExpressTemplate) => {
    const hide = message.loading('请求中..', 0);
-    removeShopExpressTemplate(row.shopExpressTemplateId)
+    removeShopExpressTemplate(row.id)
      .then((msg) => {
        hide();
        message.success(msg);
@@ -226,7 +226,7 @@
      onOk: () => {
        const hide = message.loading('请求中..', 0);
        removeBatchShopExpressTemplate(
-          selection.value.map((d) => d.shopExpressTemplateId)
+          selection.value.map((d) => d.id)
        )
          .then((msg) => {
            hide();
--- a/src/views/shop/shopExpressTemplateDetail/components/shopExpressTemplateDetailEdit.vue
+++ b/src/views/shop/shopExpressTemplateDetail/components/shopExpressTemplateDetailEdit.vue
@@ -26,13 +26,13 @@
          placeholder="请选择所属运费模板"
          v-model:value="form.templateId"
          :options="templateOptions"
-          :field-names="{ label: 'title', value: 'shopExpressTemplateId' }"
+          :field-names="{ label: 'title', value: 'id' }"
        />
      </a-form-item>
      <a-form-item label="计费方式" name="type">
        <a-radio-group v-model:value="form.type">
-          <a-radio value="0">按件</a-radio>
-          <a-radio value="1">按重量</a-radio>
+          <a-radio :value="true">按件</a-radio>
+          <a-radio :value="false">按重量</a-radio>
        </a-radio-group>
      </a-form-item>
      <a-form-item label="省份ID" name="provinceId">
@@ -51,12 +51,12 @@
          v-model:value="form.cityId"
        />
      </a-form-item>
-      <a-form-item label="首件数量/重量" name="firstNum">
+      <a-form-item :label="form.type ? '首件数量' : '首重重量'" name="firstNum">
        <a-input-number
          :min="0"
          :precision="2"
          class="ele-fluid"
-          placeholder="请输入首件数量/重量"
+          :placeholder="form.type ? '请输入首件数量' : '请输入首重重量'"
          v-model:value="form.firstNum"
        />
      </a-form-item>
@@ -69,12 +69,12 @@
          v-model:value="form.firstAmount"
        />
      </a-form-item>
-      <a-form-item label="续件数量/重量" name="extraNum">
+      <a-form-item :label="form.type ? '续件数量' : '续重重量'" name="extraNum">
        <a-input-number
          :min="0"
          :precision="2"
          class="ele-fluid"
-          placeholder="请输入续件数量/重量"
+          :placeholder="form.type ? '请输入续件数量' : '请输入续重重量'"
          v-model:value="form.extraNum"
        />
      </a-form-item>
@@ -156,7 +156,7 @@
    shopExpressTemplateDetailId: undefined,
    id: undefined,
    templateId: undefined,
-    type: '0',
+    type: true,
    provinceId: undefined,
    cityId: undefined,
    firstNum: undefined,
--- a/src/views/shop/shopExpressTemplateDetail/index.vue
+++ b/src/views/shop/shopExpressTemplateDetail/index.vue
@@ -3,7 +3,7 @@
    <a-card :bordered="false" :body-style="{ padding: '16px' }">
      <ele-pro-table
        ref="tableRef"
-        row-key="shopExpressTemplateDetailId"
+        row-key="id"
        :columns="columns"
        :datasource="datasource"
        :customRow="customRow"
@@ -21,8 +21,8 @@
        </template>
        <template #bodyCell="{ column, record }">
          <template v-if="column.key === 'type'">
-            <a-tag v-if="record.type === '0'" color="blue">按件</a-tag>
-            <a-tag v-else-if="record.type === '1'" color="cyan">按重量</a-tag>
+            <a-tag v-if="record.type === true" color="blue">按件</a-tag>
+            <a-tag v-else-if="record.type === false" color="cyan">按重量</a-tag>
            <span v-else>{{ record.type }}</span>
          </template>
          <template v-if="column.key === 'status'">
@@ -214,7 +214,7 @@
  /* 删除单个 */
  const remove = (row: ShopExpressTemplateDetail) => {
    const hide = message.loading('请求中..', 0);
-    removeShopExpressTemplateDetail(row.shopExpressTemplateDetailId)
+    removeShopExpressTemplateDetail(row.id)
      .then((msg) => {
        hide();
        message.success(msg);
@@ -240,7 +240,7 @@
      onOk: () => {
        const hide = message.loading('请求中..', 0);
        removeBatchShopExpressTemplateDetail(
-          selection.value.map((d) => d.shopExpressTemplateDetailId)
+          selection.value.map((d) => d.id)
        )
          .then((msg) => {
            hide();