From 9b5875e6fbfc80b546ec87e7ff50ebdbe3051d30 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=B5=B5=E5=BF=A0=E6=9E=97?= <170083662@qq.com> Date: Wed, 12 Aug 2026 10:01:03 +0800 Subject: [PATCH] =?UTF-8?q?feat(shopExpressTemplateDetail):=20=E6=94=AF?= =?UTF-8?q?=E6=8C=81=E3=80=8C=E4=B8=8D=E5=8F=91=E8=B4=A7=E9=BB=91=E5=90=8D?= =?UTF-8?q?=E5=8D=95=E3=80=8D=E9=85=8D=E9=80=81=E6=A8=A1=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增配送模式三态选择（0全国/1指定配送/2指定不发货） - 编辑表单中增加“配送模式”单选，mode=2时复用多选地区组件选择不发货地区 - 保存时根据模式调整 regionMode 和 regionIds 字段，确保模式与地区同步 - 列表页配送地区列新增不发货黑名单显示，聚合城市码为省份名并支持省名去重 - 加载地区时建立城市ID到省份ID映射，实现城市码聚合显示省名功能 - 适配旧数据兼容性，支持单值旧数据和全国模式显示 - 表单校验强化，指定配送/不发货模式下必须选择有效地区 - 完成端到端链路功能闭环，前端支持黑名单配置，后端按租户生效配送限制 --- .workbuddy/memory/2026-08-12.md | 15 ++++ .workbuddy/memory/MEMORY.md | 5 +- .../shopExpressTemplateDetailEdit.vue | 84 ++++++++++++++----- .../shop/shopExpressTemplateDetail/index.vue | 58 +++++++++---- 4 files changed, 122 insertions(+), 40 deletions(-) create mode 100644 .workbuddy/memory/2026-08-12.md diff --git a/.workbuddy/memory/2026-08-12.md b/.workbuddy/memory/2026-08-12.md new file mode 100644 index 0000000..e66f334 --- /dev/null +++ b/.workbuddy/memory/2026-08-12.md @@ -0,0 +1,15 @@ +# 2026-08-12 工作记录 + +## 偏远地区不发货 — 如何让远端用户无法下单（tenant 10606） + +- 用户已 `UPDATE shop_goods set express_template_id=11 WHERE express_template_id IS NULL and tenant_id=10606`，以为这就禁了偏远地区下单。实际结论：**这条只绑运费模板（算运费用），没有生成「不发货黑名单」数据，不会拦截下单**。 +- 后端拦截已端到端接通：`OrderBusinessService.createOrder` → `validateDeliveryRegionIfNeeded`(第87行) → `DeliveryRegionChecker`（按 tenant_id 查 `shop_express_template_detail` 中 region_mode=2 且 status=0 的明细，收货地址行政区划码命中即抛"XX暂不配送，请更换收货地址"）。 +- 链路确认：guilixu-taro `BaseUrl=https://shop-api.websoft.top/api`、`TenantId=10606`，下单走 guilixu-java(db_guilixu)；单租户下买家 tenantId=10606，校验能命中黑名单。✅ +- **admin 前端明细编辑表单未暴露 regionMode=2（只 0/1）**，故黑名单只能 SQL 直插 `shop_express_template_detail`(region_mode=2, region_ids=偏远省6位码逗号串, status=0, tenant_id=10606, template_id=11)。已给 INSERT 模板与省码清单。 +- 注意：黑名单是**租户级、全店生效**（不区分绑定哪个模板）；自提(deliveryType=1)/selfTakeMerchantId 下单跳过校验。 + +## 补上后台「不发货黑名单」UI 模式（已交付） +- 改 `src/views/shop/shopExpressTemplateDetail/components/shopExpressTemplateDetailEdit.vue`：新增「配送模式」三态 radio(0全国/1指定配送/2指定不发货)；mode=2 复用 `RegionMultiSelect` 选地区，保存写 region_mode=2 + region_ids(城市码逗号串)；回显按 region_mode 初始化。 +- 改 `src/views/shop/shopExpressTemplateDetail/index.vue`：「配送地区」列按 region_mode 显示「不发货：xxx / 配送：xxx / 默认全国」，城市码聚合为省名显示。 +- 类型检查（vue-tsc）确认本次改动无新错误（唯一相关报错是预存的 `$router` 用法，原文件即有，未引入）。 +- 结论：黑名单现可经后台 UI 配置；SQL 直插仍作为备选（二者后台存城市码、SQL 存省份码，后端比对为编码集合 contains，都生效、互不冲突）。 diff --git a/.workbuddy/memory/MEMORY.md b/.workbuddy/memory/MEMORY.md index b090a16..98b460d 100644 --- a/.workbuddy/memory/MEMORY.md +++ b/.workbuddy/memory/MEMORY.md @@ -43,8 +43,9 @@ - **后端（guilixu-java）已完整实现**：entity/param/迁移SQL/DeliveryRegionChecker/RegionCodeResolver/OrderBusinessService 接入（第 87 行调用 validateDeliveryRegionIfNeeded）均就位。 - **关键事实（用户 2026-08-06 18:09 纠正）：guilixu-admin 的「商城」接口实际调 `https://shop-api.websoft.top`（= guilixu-java）**。前端 shopExpressTemplateDetail 用默认 `@/utils/request`，baseURL = MODULES_API_URL = localStorage ApiUrl || VITE_API_URL；本部署的 ApiUrl 即 shop-api.websoft.top/api。故 guilixu-java 是生效后端，其实现正确生效，不是死代码。 - **结论：本功能（admin 配置）无需改 mp-java**（本部署 商城不走 mp-java）。 -- **端到端风险（待确认）**：下单校验读 guilixu-java 的 db_guilixu。若「用户端小程序 guilixu-taro 的 下单」走 mp-java（不同库 modules），黑名单配置不被 下单看到、不发货地区不拦截，需确认 下单后端；若 下单也走 guilixu-java 则功能完整闭环。 -- **剩余工作 = 纯前端（guilixu-admin）**：model 加 regionMode/regionIds + 新建双栏多选地区组件（替换单路径级联 RegionsSelect，支持"全国/指定配送/指定不发货"模式切换＋多选多省）+ 编辑表单模式切换 + 列表回显模式与地区汇总。 +- **端到端链路已确认打通（2026-08-12）**：用户端 `guilixu-taro` 的 `BaseUrl = https://shop-api.websoft.top/api`（config/env.js 全环境），`TenantId='10606'`，下单 `POST /shop/shop-order` 即走 guilixu-java(db_guilixu)；且单租户下买家 tenantId=10606（微信支付证书也依赖此值），故 `DeliveryRegionChecker` 按 `tenant_id=10606` 能命中黑名单。✅ 功能完整闭环。 +- **✅ 后台 UI 已支持「不发货黑名单」模式（2026-08-12 完成）**：`shopExpressTemplateDetailEdit.vue` 已加「配送模式」三态 radio（0全国/1指定配送/2指定不发货）；mode=2 复用 `RegionMultiSelect` 选地区，保存写 `region_mode=2` + `region_ids`(城市码逗号串)；回显按 `region_mode` 初始化。列表页 `index.vue` 的「配送地区」列按 `region_mode` 显示「不发货：xxx / 配送：xxx / 默认全国」，并把城市码聚合为省名。后端比对是编码集合 contains，故后台存城市码与 SQL 存省份码都正确拦截、互不冲突。 +- 仍可用 SQL 直接 INSERT 黑名单明细（region_mode=2, region_ids=偏远省码, status=0, tenant_id=10606）作为备选，无需经过 UI。 - 接口方案文档：`docs/运费模板-不发货地区-接口方案.md`。 ### shopGoods status 字段（上架/下架） diff --git a/src/views/shop/shopExpressTemplateDetail/components/shopExpressTemplateDetailEdit.vue b/src/views/shop/shopExpressTemplateDetail/components/shopExpressTemplateDetailEdit.vue index 505b5cb..d1cba5e 100644 --- a/src/views/shop/shopExpressTemplateDetail/components/shopExpressTemplateDetailEdit.vue +++ b/src/views/shop/shopExpressTemplateDetail/components/shopExpressTemplateDetailEdit.vue @@ -20,12 +20,31 @@ styleResponsive ? { md: 19, sm: 19, xs: 24 } : { flex: '1' } " > + + + 全国 + 指定配送 + 指定不发货 + + - -
不选则默认全国
+ + { cityIds.value = val; - if (val.length) { - form.regionIds = val.join(','); - form.regionMode = 1; - } else { + form.regionIds = val.length ? val.join(',') : undefined; + }; + + /* 切换配送模式 */ + const onModeChange = () => { + // 切到「全国」时清空已选地区 + if (form.regionMode === 0) { + cityIds.value = []; form.regionIds = undefined; - form.regionMode = 0; } }; @@ -207,18 +229,27 @@ formRef.value .validate() .then(() => { + // 指定配送/不发货模式下必须选择地区 + if (form.regionMode === 1 || form.regionMode === 2) { + if (!cityIds.value.length) { + message.error( + form.regionMode === 2 ? '请选择不发货地区' : '请选择配送地区' + ); + return; + } + } loading.value = true; const formData = { ...form }; // 确保templateId和type从父级继承 formData.templateId = props.templateId; formData.type = props.templateType ?? true; - // 多选配送区域（regionMode=1 指定配送，0=全国；regionIds 存城市编码逗号串） - if (cityIds.value.length) { - formData.regionIds = cityIds.value.join(','); - formData.regionMode = 1; - } else { + // 配送模式：0=全国（无地区）；1=指定配送；2=指定不发货；后两者 regionIds 存城市编码逗号串 + if (form.regionMode === 0) { formData.regionIds = undefined; formData.regionMode = 0; + } else { + formData.regionIds = cityIds.value.join(','); + formData.regionMode = form.regionMode; } const saveOrUpdate = isUpdate.value ? updateShopExpressTemplateDetail @@ -244,20 +275,29 @@ if (visible) { if (props.data) { assignObject(form, props.data); + if (form.regionMode == null) { + form.regionMode = 0; + } isUpdate.value = true; } else { isUpdate.value = false; form.templateId = props.templateId; form.type = props.templateType ?? true; + form.regionMode = 0; } - // 回显多选配送区域（regionIds 存城市编码） - if (form.regionIds) { - cityIds.value = form.regionIds.split(',').filter(Boolean); - } else if (form.cityId) { - // 兼容旧单值数据 - cityIds.value = [String(form.cityId)]; + // 回显多选配送区域（仅 1=指定配送 / 2=指定不发货 带地区，regionIds 存城市编码） + if (form.regionMode === 1 || form.regionMode === 2) { + if (form.regionIds) { + cityIds.value = form.regionIds.split(',').filter(Boolean); + } else if (form.cityId) { + // 兼容旧单值数据 + cityIds.value = [String(form.cityId)]; + } else { + cityIds.value = []; + } } else { cityIds.value = []; + form.regionIds = undefined; } } else { resetFields(); diff --git a/src/views/shop/shopExpressTemplateDetail/index.vue b/src/views/shop/shopExpressTemplateDetail/index.vue index 242d21d..bf95c5b 100644 --- a/src/views/shop/shopExpressTemplateDetail/index.vue +++ b/src/views/shop/shopExpressTemplateDetail/index.vue @@ -92,6 +92,8 @@ // 地区ID→名称映射 const regionMap = ref>({}); + // 城市ID→省份ID映射（用于把城市码聚合显示为省名） + const cityToProvince = ref>({}); // 表格选中数据 const selection = ref([]); @@ -128,26 +130,25 @@ align: 'center', width: 150, customRender: ({ record }) => { - // 多选配送区域（regionIds 逗号分隔的城市编码） - const cityIds = (record.regionIds || '') + const mode = record.regionMode; + const ids = (record.regionIds || '') .split(',') .filter(Boolean); - if (cityIds.length) { - const names = cityIds.map( - (id: string) => regionMap.value[id] || id - ); - const text = names.join('、'); - // 过长截断并支持 tooltip 悬浮查看全部 - if (text.length > 22) { - return h( - 'span', - { title: text }, - text.slice(0, 22) + '…' - ); + if (mode === 2) { + // 指定不发货（黑名单） + if (!ids.length) { + return h('span', { style: { color: '#bbb' } }, '不发货（未配置地区）'); } - return text; + const text = '不发货：' + aggregateProvinces(ids).join('、'); + return renderRegionText(text, 26); } - // 兼容旧单值数据 + if (mode === 1) { + // 指定配送（白名单） + if (!ids.length) return '默认全国'; + const text = aggregateProvinces(ids).join('、'); + return renderRegionText(text, 22); + } + // 兼容旧数据 / 全国 const province = record.provinceId ? regionMap.value[String(record.provinceId)] : ''; @@ -286,19 +287,44 @@ }; }; + /* 把城市编码数组聚合为去重的省份名称数组（兼容直接存省份码的场景） */ + const aggregateProvinces = (ids: string[]) => { + const set = new Set(); + ids.forEach((id) => { + const prov = cityToProvince.value[id]; + if (prov) { + set.add(regionMap.value[prov] || prov); + } else { + set.add(regionMap.value[id] || id); + } + }); + return [...set]; + }; + + /* 过长截断并支持 tooltip 悬浮查看全部 */ + const renderRegionText = (text: string, max = 22) => { + if (text.length > max) { + return h('span', { title: text }, text.slice(0, max) + '…'); + } + return text; + }; + /* 加载地区数据，建立ID→名称映射 */ onMounted(() => { getRegionsData().then((data) => { const map: Record = {}; + const c2p: Record = {}; data.forEach((province) => { map[province.value] = province.label; if (province.children) { province.children.forEach((city) => { map[city.value] = city.label; + c2p[city.value] = province.value; }); } }); regionMap.value = map; + cityToProvince.value = c2p; }); });