gxwebsoft
a228dcb96b
- model中省市多选字段由provinceIds/cityIds改为regionMode/regionIds - RegionMultiSelect组件去除update:provinceIds事件，改仅emit update:value - 编辑弹窗中城市选择变化同步更新form.regionIds和form.regionMode字段 - 回显数据时从regionIds拆分赋值，不再使用provinceIds/cityIds - 列表页customRender展示使用record.regionIds反查城市名 - 解决前端提交字段与后端实体不匹配导致数据未保存问题 - 确保本次改动完全兼容后端现有regionMode/regionIds机制，无需后端改动
6.2 KiB
6.2 KiB
项目长期记忆
项目结构
关键项目路径
- 管理后台：
/Users/gxwebsoft/VUE/guilixu-admin（Vue3 + Ant Design Vue） - 用户端小程序：
/Users/gxwebsoft/VUE/guilixu-taro（Taro + React） - 商家端小程序：
/Users/gxwebsoft/VUE/xinlong-shop-taro（Taro + React）
⚠️ 跨项目教训（重要）
- 商家端发货/门店/订单相关功能在 xinlong-shop-taro，不要改到 guilixu-taro
- 用户端订单详情等功能在 guilixu-taro
- 跨项目改动前，先用 grep/glob 在多个候选项目里确认"哪个项目有该功能源码"，再动手
- 已发生两次误改 guilixu-taro 的教训（useClerk 全局上下文、订单详情 deliveryType 修复）
业务约定
deliveryType 配送方式枚举
0= 快递配送1= 无需发货 / 自提2= 商家送货
来源：管理后台 src/views/shop/shopOrder/components/deliveryModal.vue
Java 后端架构（重要）
双后端 / MODULES_API_URL 模式（2026-07-25 分析结论）
- mp-java（
/Users/gxwebsoft/JAVA/mp-java）= 独立的「modules 服务」，用modules库；cms(235类)、shop 等业务模块都在它这里，持续高频开发。 - guilixu-java（
/Users/gxwebsoft/JAVA/guilixu-java）= 桂礼序主后端，用db_guilixu库；是 mp-java 的「子集分叉」。 - guilixu-admin 前端已预设双基地址：
SERVER_API_URL(主后端) +MODULES_API_URL(localStorage ApiUrl / VITE_API_URL)。 - ⚠️ 运行时实际指向以
localStorage ApiUrl为准（2026-08-06 用户纠正）：guilixu-admin 的「商城」接口实际调https://shop-api.websoft.top（= guilixu-java），并非 mp-java。判断"改哪个后端才生效"不能默认 MODULES_API_URL=mp-java，必须查 ApiUrl 运行时配置。 cms 接口另走VITE_CMS_API_URL=cms-api.websoft.top（mp-java）。 - 结论（仅限 cms 模块）：guilixu-java 里的 cms 包(152类)是 mp-java cms 的旧分叉子集、且前端并不调它（前端调 modules 服务），属重复/死代码，应删除而非复制或扩展。
- 复制「整个 cms 到 guilixu-java」不可行：mp-java 完整 cms 的 CmsApp/CmsWebsiteService 依赖
project模块（guilixu-java 没有），会编译失败。 - 注意：mp-java 与 guilixu-java 是独立 git 仓库（
git.websoft.top/gxwebsoft/mp-java.git与guilixu-java.git），各自独立部署、独立库。
⚠️ 双后端改动同步规则（2026-08-05 修正）
- cms 模块改动：仅 mp-java（guilixu-java 的 cms 是死代码）。
- shop 等共享业务模块（如
ShopGoodsController/ Service / Mapper / task）：mp-java 与 guilixu-java 都有活代码且结构一致（同com.gxwebsoft.shop包），用户确认改动要两端同步（例：2026-08-05 shopGoods/data统计优化，两端各改 6 处）。 - 改动前先 grep 两端确认文件是否存在，避免只改一处导致另一端行为不一致。
⚠️ 运费模板不发货地区需求（2026-08-06 结论，已按用户纠正修正）
- 需求：运费模板支持「不发货地区(黑名单)」，ShopExpressTemplateDetail 加 regionMode/regionIds 字段 + DeliveryRegionChecker 下单校验。
- 后端（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，支持"全国/指定配送/指定不发货"模式切换＋多选多省）+ 编辑表单模式切换 + 列表回显模式与地区汇总。
- 接口方案文档：
docs/运费模板-不发货地区-接口方案.md。
shopGoods status 字段（上架/下架）
0= 已上架 / 上架1= 待上架 / 下架2= 待审核，3= 审核不通过- 编辑表单「状态」radio 绑定
form.status：0=上架、1=下架。 - 一键上下架、批量上下架均通过
updateShopGoods({ ...record, status })直接改 status 实现（不额外用 isShow 字段）。 - 列表 tag 仍显示：0=已上架、1=待上架、2=待审核、3=审核不通过。
运费模板配送地区多选（2026-08-11 已实现前端）
- 需求：配送地区选择从「省+市单选级联」升级为「省+市两级多选穿梭弹窗」（仿客户截图双栏：左候选/右已选）。
- 前端组件：
src/components/RegionMultiSelect/index.vue（树形可展开，省级"选择"=选该省全部市，市级可单独选；@update:value 城市编码数组）。 - 直接对接后端已有的
regionMode(0=全国/1=指定配送白名单/2=不发货黑名单) +regionIds(逗号分隔城市编码串) 机制，无需后端改动。城市编码即regions-data.json的 city value(6位)，与regionIds完全一致。 - 数据字段：model 用
regionMode/regionIds（已有字段，非新建）；旧provinceId/cityId仅作回显兼容。 - 列表多值展示：
index.vuecustomRender 遍历regionIds反查 regionMap，超 22 字截断 + tooltip。 - 下单校验
DeliveryRegionChecker读regionIds直接生效（regionMode=2 为不发货黑名单）。 - ⚠️ 教训：第一版误用
provinceIds/cityIds字段名，与后端regionMode/regionIds不匹配，MyBatis-Plus 自动忽略未知字段导致"没存"。改字段名对接即可，不必新增后端字段。