feat(shopExpressTemplateDetail): 支持「不发货黑名单」配送模式

- 新增配送模式三态选择（0全国/1指定配送/2指定不发货）
- 编辑表单中增加“配送模式”单选，mode=2时复用多选地区组件选择不发货地区
- 保存时根据模式调整 regionMode 和 regionIds 字段，确保模式与地区同步
- 列表页配送地区列新增不发货黑名单显示，聚合城市码为省份名并支持省名去重
- 加载地区时建立城市ID到省份ID映射，实现城市码聚合显示省名功能
- 适配旧数据兼容性，支持单值旧数据和全国模式显示
- 表单校验强化，指定配送/不发货模式下必须选择有效地区
- 完成端到端链路功能闭环，前端支持黑名单配置，后端按租户生效配送限制

.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，都生效、互不冲突）。

.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 则功能完整闭环。
+- **端到端链路已确认打通（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` 能命中黑名单。✅ 功能完整闭环。
-- **剩余工作 = 纯前端（guilixu-admin）**：model 加 regionMode/regionIds + 新建双栏多选地区组件（替换单路径级联 RegionsSelect，支持"全国/指定配送/指定不发货"模式切换＋多选多省）+ 编辑表单模式切换 + 列表回显模式与地区汇总。
+- **✅ 后台 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 字段（上架/下架）

src/views/shop/shopExpressTemplateDetail/components/shopExpressTemplateDetailEdit.vue

@@ -20,12 +20,31 @@
         styleResponsive ? { md: 19, sm: 19, xs: 24 } : { flex: '1' }
       "
     >
+      <a-form-item label="配送模式" name="regionMode">
+        <a-radio-group v-model:value="form.regionMode" @change="onModeChange">
+          <a-radio :value="0">全国</a-radio>
+          <a-radio :value="1">指定配送</a-radio>
+          <a-radio :value="2">指定不发货</a-radio>
+        </a-radio-group>
+      </a-form-item>
       <a-form-item label="配送地区">
-        <RegionMultiSelect
+        <template v-if="form.regionMode === 0">
-          :value="cityIds"
+          <span class="rms-tip">全国发货，无需选择地区</span>
-          @update:value="onCityIdsChange"
+        </template>
-        />
+        <template v-else>
-        <div class="rms-tip">不选则默认全国</div>
+          <RegionMultiSelect
+            :value="cityIds"
+            :placeholder="form.regionMode === 2 ? '选择不发货地区' : '选择配送地区'"
+            @update:value="onCityIdsChange"
+          />
+          <div class="rms-tip">
+            {{
+              form.regionMode === 2
+                ? '选中地区将不配送，用户下单会被拦截'
+                : '不选则默认全国（建议切换到"全国"模式）'
+            }}
+          </div>
+        </template>
       </a-form-item>
       <a-form-item :label="templateType ? '首件数量' : '首重重量'" name="firstNum">
         <a-input-number
@@ -187,15 +206,18 @@
 
   const { resetFields } = useForm(form, rules);
 
-  /* 城市选中变化，同步到 form.regionIds / regionMode（1=指定配送白名单，0=全国） */
+  /* 城市选中变化，同步到 form.regionIds（模式由 radio 决定：1=指定配送，2=指定不发货） */
   const onCityIdsChange = (val: string[]) => {
     cityIds.value = val;
-    if (val.length) {
+    form.regionIds = val.length ? val.join(',') : undefined;
-      form.regionIds = val.join(',');
+  };
-      form.regionMode = 1;
+
-    } else {
+  /* 切换配送模式 */
+  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 存城市编码逗号串）
+        // 配送模式：0=全国（无地区）；1=指定配送；2=指定不发货；后两者 regionIds 存城市编码逗号串
-        if (cityIds.value.length) {
+        if (form.regionMode === 0) {
-          formData.regionIds = cityIds.value.join(',');
-          formData.regionMode = 1;
-        } else {
           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 存城市编码）
+        // 回显多选配送区域（仅 1=指定配送 / 2=指定不发货 带地区，regionIds 存城市编码）
-        if (form.regionIds) {
+        if (form.regionMode === 1 || form.regionMode === 2) {
-          cityIds.value = form.regionIds.split(',').filter(Boolean);
+          if (form.regionIds) {
-        } else if (form.cityId) {
+            cityIds.value = form.regionIds.split(',').filter(Boolean);
-          // 兼容旧单值数据
+          } else if (form.cityId) {
-          cityIds.value = [String(form.cityId)];
+            // 兼容旧单值数据
+            cityIds.value = [String(form.cityId)];
+          } else {
+            cityIds.value = [];
+          }
         } else {
           cityIds.value = [];
+          form.regionIds = undefined;
         }
       } else {
         resetFields();

src/views/shop/shopExpressTemplateDetail/index.vue

@@ -92,6 +92,8 @@
 
   // 地区ID→名称映射
   const regionMap = ref<Record<string, string>>({});
+  // 城市ID→省份ID映射（用于把城市码聚合显示为省名）
+  const cityToProvince = ref<Record<string, string>>({});
 
   // 表格选中数据
   const selection = ref<ShopExpressTemplateDetail[]>([]);
@@ -128,26 +130,25 @@
       align: 'center',
       width: 150,
       customRender: ({ record }) => {
-        // 多选配送区域（regionIds 逗号分隔的城市编码）
+        const mode = record.regionMode;
-        const cityIds = (record.regionIds || '')
+        const ids = (record.regionIds || '')
           .split(',')
           .filter(Boolean);
-        if (cityIds.length) {
+        if (mode === 2) {
-          const names = cityIds.map(
+          // 指定不发货（黑名单）
-            (id: string) => regionMap.value[id] || id
+          if (!ids.length) {
-          );
+            return h('span', { style: { color: '#bbb' } }, '不发货（未配置地区）');
-          const text = names.join('、');
-          // 过长截断并支持 tooltip 悬浮查看全部
-          if (text.length > 22) {
-            return h(
-              'span',
-              { title: text },
-              text.slice(0, 22) + '…'
-            );
           }
-          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<string>();
+    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<string, string> = {};
+      const c2p: Record<string, string> = {};
       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;
     });
   });
 </script>