会员管理代码

baqing-shop/src/main/java/com/ruoyi/web/modules/merchant/controller/MerchantController.java

@@ -55,7 +55,7 @@ public class MerchantController extends BaseController
     public AjaxResult add(@RequestBody MerchantCreateDTO merchant)
     {
         Map<String, Object> data = merchantService.insertMerchant(merchant, getUsername());
-        AjaxResult result = AjaxResult.success("请尽快在编辑中完善商户经营信息后再开设店铺");
+        AjaxResult result = AjaxResult.success("保存成功，已可开设店铺");
         result.put(AjaxResult.DATA_TAG, data);
         return result;
     }

baqing-shop/src/main/java/com/ruoyi/web/modules/merchant/service/impl/MerchantServiceImpl.java

@@ -94,12 +94,12 @@ public class MerchantServiceImpl implements IMerchantService
     @Transactional(rollbackFor = Exception.class)
     public Map<String, Object> insertMerchant(MerchantCreateDTO merchant, String operator)
     {
-        stripBizFieldsOnInsert(merchant);
         validateSubjectOnInsert(merchant);
+        validateBizOnInsert(merchant);
         Date now = new Date();
         merchant.setCertStatus(MerchantConstants.CERT_NORMAL);
         merchant.setCertTime(now);
-        merchant.setBizComplete(MerchantConstants.BIZ_INCOMPLETE);
+        merchant.setBizComplete(BizCompleteEvaluator.evaluateCompleteFlag(merchant));
         merchant.setShopCount(0);
         merchant.setCreateBy(operator);
         merchantMapper.insert(merchant);
@@ -297,21 +297,18 @@ public class MerchantServiceImpl implements IMerchantService
         return vo;
     }
 
-    private void stripBizFieldsOnInsert(BizMerchant m)
+    private void validateBizOnInsert(BizMerchant m)
     {
-        m.setMerchantName(null);
-        m.setServicePhone(null);
-        m.setBizRegionCode(null);
-        m.setBizRegionName(null);
-        m.setBizDetailAddress(null);
-        m.setContactName(null);
-        m.setContactPhone(null);
-        m.setContactEmail(null);
-        m.setBankName(null);
-        m.setBankBranch(null);
-        m.setBankAccount(null);
-        m.setBusinessLicense(null);
-        m.setAccountPermit(null);
+        List<String> pending = BizCompleteEvaluator.pendingFields(m);
+        if (!pending.isEmpty())
+        {
+            throw new ServiceException("经营信息不完整，无法保存：" + String.join("、", pending));
+        }
+        if (StringUtils.isNotEmpty(m.getMerchantName())
+                && merchantMapper.countByMerchantName(m.getMerchantName(), null) > 0)
+        {
+            throw new ServiceException("商户名称已存在");
+        }
     }
 
     private void validateSubjectOnInsert(BizMerchant m)
@@ -331,8 +328,11 @@ public class MerchantServiceImpl implements IMerchantService
             {
                 throw new ServiceException("请输入企业名称");
             }
-            if (StringUtils.isNotEmpty(m.getCreditCode())
-                    && merchantMapper.countByCreditCode(m.getCreditCode(), null) > 0)
+            if (StringUtils.isEmpty(m.getCreditCode()))
+            {
+                throw new ServiceException("请输入统一社会信用代码");
+            }
+            if (merchantMapper.countByCreditCode(m.getCreditCode(), null) > 0)
             {
                 throw new ServiceException("该统一社会信用代码已入驻");
             }
@@ -343,7 +343,11 @@ public class MerchantServiceImpl implements IMerchantService
             {
                 throw new ServiceException("请输入姓名");
             }
-            if (StringUtils.isNotEmpty(m.getIdCardNo()) && merchantMapper.countByIdCardNo(m.getIdCardNo(), null) > 0)
+            if (StringUtils.isEmpty(m.getIdCardNo()))
+            {
+                throw new ServiceException("请输入证件号码");
+            }
+            if (merchantMapper.countByIdCardNo(m.getIdCardNo(), null) > 0)
             {
                 throw new ServiceException("该证件号码已入驻");
             }

baqing-shop/src/test/java/com/ruoyi/web/modules/merchant/controller/MerchantControllerTest.java

@@ -132,7 +132,7 @@ class MerchantControllerTest
                 .content(objectMapper.writeValueAsString(dto)))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.code").value(200))
-                .andExpect(jsonPath("$.msg").value("请尽快在编辑中完善商户经营信息后再开设店铺"));
+                .andExpect(jsonPath("$.msg").value("保存成功，已可开设店铺"));
     }
 
     @Test

baqing-shop/src/test/java/com/ruoyi/web/modules/merchant/service/MerchantServiceImplTest.java

@@ -46,15 +46,11 @@ class MerchantServiceImplTest
     private MerchantServiceImpl merchantService;
 
     @Test
-    void insert_setsCertNormalAndBizIncomplete()
+    void insert_setsCertNormalAndBizComplete_whenBizFieldsComplete()
     {
-        MerchantCreateDTO dto = new MerchantCreateDTO();
-        dto.setMerchantType(MerchantConstants.TYPE_PERSON);
-        dto.setPersonName("张三");
-        dto.setIdCardNo("110101199001011234");
-        dto.setBindType("SYS_USER");
-        dto.setBindUserId(10L);
+        MerchantCreateDTO dto = fullPersonCreateDto();
         when(merchantMapper.countByIdCardNo(any(), eq(null))).thenReturn(0);
+        when(merchantMapper.countByMerchantName(any(), eq(null))).thenReturn(0);
         when(merchantMapper.insert(any())).thenAnswer(inv -> {
             BizMerchant m = inv.getArgument(0);
             m.setMerchantId(1L);
@@ -66,10 +62,61 @@ class MerchantServiceImplTest
         verify(accountBindService).bindAccountOnMerchantCreate(eq(1L), eq(dto), eq("admin"));
 
         assertEquals(MerchantConstants.CERT_NORMAL, dto.getCertStatus());
-        assertEquals(MerchantConstants.BIZ_INCOMPLETE, dto.getBizComplete());
+        assertEquals(MerchantConstants.BIZ_COMPLETE, dto.getBizComplete());
         assertEquals(0, dto.getShopCount());
     }
 
+    @Test
+    void insert_rejectsIncompleteBiz()
+    {
+        MerchantCreateDTO dto = new MerchantCreateDTO();
+        dto.setMerchantType(MerchantConstants.TYPE_PERSON);
+        dto.setPersonName("张三");
+        dto.setIdCardNo("110101199001011234");
+        dto.setBindType("SYS_USER");
+        dto.setBindUserId(10L);
+        when(merchantMapper.countByIdCardNo(any(), eq(null))).thenReturn(0);
+
+        ServiceException ex = assertThrows(ServiceException.class,
+                () -> merchantService.insertMerchant(dto, "admin"));
+        assertTrue(ex.getMessage().contains("经营信息不完整"));
+        verify(merchantMapper, never()).insert(any());
+    }
+
+    @Test
+    void insert_rejectsDuplicateIdCard()
+    {
+        MerchantCreateDTO dto = fullPersonCreateDto();
+        when(merchantMapper.countByIdCardNo(any(), eq(null))).thenReturn(1);
+
+        ServiceException ex = assertThrows(ServiceException.class,
+                () -> merchantService.insertMerchant(dto, "admin"));
+        assertEquals("该证件号码已入驻", ex.getMessage());
+        verify(merchantMapper, never()).insert(any());
+    }
+
+    private MerchantCreateDTO fullPersonCreateDto()
+    {
+        MerchantCreateDTO dto = new MerchantCreateDTO();
+        dto.setMerchantType(MerchantConstants.TYPE_PERSON);
+        dto.setPersonName("张三");
+        dto.setIdCardNo("110101199001011234");
+        dto.setMerchantName("张三农资");
+        dto.setServicePhone("400-800");
+        dto.setBizRegionCode("110");
+        dto.setBizRegionName("北京");
+        dto.setBizDetailAddress("路1号");
+        dto.setContactName("张三");
+        dto.setContactPhone("13800138000");
+        dto.setContactEmail("a@b.com");
+        dto.setBankName("工行");
+        dto.setBankBranch("支行");
+        dto.setBankAccount("6222021234567890");
+        dto.setBindType("SYS_USER");
+        dto.setBindUserId(10L);
+        return dto;
+    }
+
     @Test
     void update_cancelledMerchant_rejected()
     {

doc/平台后台/关联需求分析.md

@@ -72,7 +72,7 @@
 
 | 模块 | 端 | 核心职责 | 明确不做 |
 |------|-----|----------|----------|
-| **商户管理** | 平台 | 主体入驻（仅主体资质）、补全经营信息、认证状态、删除商户主体 | 不配置商家登录账号；不管理店铺/商品/分类 |
+| **商户管理** | 平台 | 添加/维护商户（主体+经营信息）、认证状态、删除商户主体 | 不配置商家登录账号；不管理店铺/商品/分类 |
 | **店铺管理** | 平台 | 为合格商户开店、店铺开业/停业、**配置商户级经营账号**、删店；商家端可改店资料（列表同源） | 不维护商品分类；店铺策略见《店铺设置》；不审核商品 |
 | **店铺设置** | 平台 | 全平台 **商品默认审核**、**子管理员上限**（针对所有店铺） | 非逐店配置；见 `组织管理/店铺设置/` |
 | **入驻审核** | 平台 + C 端 | 用户商城入驻申请、平台审核→公示→首店创建 | 不替代商户管理日常维护；协议见内容管理 |

doc/平台后台/组织管理/入驻审核/商户入驻审核功能需求.md

@@ -317,7 +317,7 @@
 
 ```text
 路径 A：C 端 → 入驻协议 → 申请 →【待审】→【公示】→ 商户 + 首店 + 绑会员账号
-路径 B：平台 → 商户管理（仅主体）→ 编辑经营信息 → 店铺管理开店
+路径 B：平台 → 商户管理（主体+经营完整）→ 店铺管理开店
 ```
 
 ---

doc/平台后台/组织管理/商户管理/商户管理前端技术方案.md

@@ -1,6 +1,6 @@
 # 商户管理 — 前端技术方案
 
-> **依据：** 《商户管理功能需求.md》v1.7、《商户管理技术方案.md》v1.7  
+> **依据：** 《商户管理功能需求.md》v1.8、《商户管理技术方案.md》v1.8  
 > **前端规范：** `doc/前端设计/前端设计.md`  
 > **范围：** 仅 **ruoyi-ui 平台管理端** 列表、添加、编辑、详情；商家端、C 端 **不在 ruoyi-ui 实现**。  
 > **实现状态：** 页面与 API 封装已落地，待后端 `/agri/merchant` 联调。
@@ -66,7 +66,7 @@
 │   └── 操作：详情、编辑（canEdit）、删除（canDelete）
 ├── 添加/编辑弹窗（860px · el-tabs）
 │   ├── Tab「主体资质」：个人 / 企业字段 + 证件照上传；企业注册地区 el-cascader
-│   ├── Tab「商户经营信息」（仅编辑）：名称、经营地区 cascader、联系人、结算等
+│   ├── Tab「商户经营信息」：名称、经营地区 cascader、联系人、结算等（**新增/编辑均展示**）
 │   └── Tab「绑定经营账号」（仅新增）：管理员 / 会员远程搜索
 └── 详情抽屉（detail.vue · 72% 宽）
     ├── 概要、主体资质、经营信息、关联店铺
@@ -106,7 +106,7 @@
 | 场景 | 组件 | 数据源 | 落库字段 |
 |------|------|--------|----------|
 | 企业注册地址 | `form.regRegionCascader` | `getRegionTree()` | `regRegionCode`（区县 `code`）、`regRegionName`（省/市/区县 `/` 连接） |
-| 经营地址（编辑 Tab） | `form.bizRegionCascader` | 同上 | `bizRegionCode`、`bizRegionName` |
+| 经营地址（新增/编辑 Tab） | `form.bizRegionCascader` | 同上 | `bizRegionCode`、`bizRegionName` |
 | 详细地址 | `el-input` | — | `companyDetailAddress` / `bizDetailAddress` |
 
 级联配置：`value: code`、`label: name`、`children: children`、`emitPath: true`；支持 `filterable`、`clearable`。编辑回显按已存 `*RegionCode` 在树中查找路径；提交前剔除 `regRegionCascader` / `bizRegionCascader` 仅 UI 字段。
@@ -121,7 +121,7 @@
 |----------|------|------|----------|
 | `listMerchant` | GET | `/list` | 列表、检索、分页 |
 | `getMerchant` | GET | `/{merchantId}` | 编辑回显、详情 |
-| `addMerchant` | POST | `/` | 添加（主体 + 绑定） |
+| `addMerchant` | POST | `/` | 添加（主体 + 经营 + 绑定） |
 | `updateMerchant` | PUT | `/` | 编辑（主体 + 经营） |
 | `updateMerchantCertStatus` | PUT | `/{merchantId}/certStatus` | 详情改认证 |
 | `deleteMerchantCheck` | GET | `/{merchantId}/deleteCheck` | 可选预检 |
@@ -157,13 +157,12 @@
 | contactName, contactPhone | 未完善显示「—」 |
 | canEdit, canDelete | 后端布尔，控制按钮显隐 |
 
-### 6.4 新增请求体要点（v1.5 / v1.6）
+### 6.4 新增请求体要点（v1.8）
 
-- **仅** 主体资质 + `bindType`（`SYS_USER` / `MEMBER`）+ `bindUserId` 或 `bindMemberId`
-- **不含** 经营信息字段
-- **平台新增最小必填**（`validateSubjectOnInsert`）：
-  - 个人：仅 `personName`
-  - 企业：仅 `legalName` + `companyName`
+- **主体资质** + **商户经营信息**（§9.2 全部必填项）+ `bindType`（`SYS_USER` / `MEMBER`）+ `bindUserId` 或 `bindMemberId`
+- **平台新增必填**（前后端一致）：
+  - 个人：`personName`、`idCardNo` + §9.2 个人经营字段
+  - 企业：`legalName`、`companyName`、`creditCode` + §9.2 企业经营字段（含营业执照、开户许可证）
 - **v1.5 新增主体字段**：`idCardType` / `legalIdCardType`（1 大陆身份证 / 2 来往内地通行证）、`regRegionCode` / `regRegionName`（v1.7 由级联写入）、`corpBankAccount`、法人证件有效期区间等
 - **会员绑定（v1.6）**：登录名=会员名称、管理员姓名=会员昵称；密码复制会员 `sys_user.password`；**不传** `sysUserInitPassword`
 - **管理员绑定（v1.6）**：检索范围 `role_key=merchant`；登录名=`user_name`、管理员姓名=`nick_name`
@@ -196,8 +195,8 @@
 | response.data | 前端行为 |
 |---------------|----------|
 | `warnExpired` | `msgWarning` 证件/营业期限过期 |
-| `bizCompleteChanged` | `msgSuccess`「已可开设店铺」 |
-| 新增成功 | 固定提示「请尽快在编辑中完善商户经营信息后再开设店铺」 |
+| `bizCompleteChanged` | `msgSuccess`「已可开设店铺」（编辑） |
+| 新增成功 | 固定提示「**保存成功，已可开设店铺**」（`response.msg`） |
 
 ---
 
@@ -205,8 +204,8 @@
 
 | 场景 | 前端行为 |
 |------|----------|
-| 添加 Tab | 默认「主体资质」；切换个人/企业重置 subject 字段 |
-| 新增校验 | 个人仅姓名必填；企业仅法人姓名+企业名称必填；证件号/信用代码选填 |
+| 添加 Tab | 默认「主体资质」；含「商户经营信息」「绑定经营账号」；切换个人/企业重置 subject 字段 |
+| 新增校验 | 个人：姓名+证件号+§9.2 经营字段；企业：法人姓名+企业名称+信用代码+§9.2 经营字段（含证照）；绑定必填 |
 | 绑定搜索 | `el-select` + `remote` + `filterable`；keyword 空不请求 |
 | 编辑 Tab | 「主体资质」+「商户经营信息」；无绑定 Tab |
 | 注册/经营地址 | 企业主体 Tab 选注册地区；编辑经营 Tab 选经营地区；均为 `el-cascader` + 详细地址输入 |
@@ -241,13 +240,13 @@ v-hasPermi="['agri:merchant:cert']"
 
 ## 10. 联调检查清单
 
-- [ ] 新增个人仅填姓名可提交；企业仅法人姓名+企业名称可提交  
+- [ ] 新增个人须填姓名+证件号+完整经营信息；企业须法人+企业名称+信用代码+完整经营信息  
 - [ ] 绑定会员无初始密码字段；admin/member 远程搜索展示正确  
 - [ ] 删除 deleteCheck 阻断并展示 reasons  
 - [ ] 详情展示 idCardType、regRegion、bizRegion、corpBankAccount、法人完整字段  
 - [ ] 菜单组件路径 `agri/org/merchant/index` 可打开  
 - [ ] 列表分页、检索、canEdit/canDelete 正确  
-- [ ] 新增仅主体 + 绑定；成功后提示完善经营信息  
+- [ ] 新增主体+经营+绑定；成功后提示「保存成功，已可开设店铺」  
 - [ ] 编辑补全经营信息后 `bizCompleteChanged`  
 - [ ] 详情 `allowedCertStatuses` 流转与二次确认  
 - [ ] 证件号/信用代码编辑页 disabled  
@@ -277,5 +276,5 @@ v-hasPermi="['agri:merchant:cert']"
 
 ---
 
-*文档版本：v1.3 · ruoyi-ui · 关联《商户管理功能需求.md》v1.7 / 《商户管理技术方案.md》v1.7*
+*文档版本：v1.4 · ruoyi-ui · 关联《商户管理功能需求.md》v1.8 / 《商户管理技术方案.md》v1.8*
 

doc/平台后台/组织管理/商户管理/商户管理功能需求.md

@@ -2,13 +2,14 @@
 
 > 本文档在《商户管理功能需求-草稿》基础上整理，并关联《农资商城web》目录下店铺管理、商品管理等模块需求做边界与流程对齐。  
 > 范围：平台侧 **商户管理** 功能需求；不涉及数据库结构、接口定义及技术实现细节。  
+> **v1.8：** 平台端 **添加商户** 须 **主体 + 经营信息完整** 方可保存；证件号/统一社会信用代码在 `biz_merchant` 已存在则拒绝；保存成功 `biz_complete=1`，可直接开设店铺。C 端入驻流程不变。  
 > **v1.7：** 企业 **注册地址**、个人/企业 **经营地址** 的省市区选项统一由 **`GET /agri/region/tree`**（平台端）获取；落库 `reg_region_*` / `biz_region_*`。  
 > **v1.6：** 绑定经营账号角色权限字符统一为 **merchant** / **member**（替代历史数字编码）；会员绑定 **不新建 sys_user**，追加 merchant 角色并复制密码。  
-> **v1.5：** 明确 **移动端 C 端** 与 **平台端** 入驻字段差异；C 端须完整填写并走 **审核+公示**；平台端仅主体最小必填 + 强制绑定账号；**数据库字段注释** 以 `sql/biz_merchant.sql` 为准。  
+> **v1.5：** 明确 **移动端 C 端** 与 **平台端** 入驻字段差异；C 端须完整填写并走 **审核+公示**；平台端须完整填写主体+经营信息并强制绑定账号；**数据库字段注释** 以 `sql/biz_merchant.sql` 为准。  
 > **v1.5：** 对齐 `biz_merchant_account` 新结构：绑定仅写关联行（`account_id=user_id`，`shop_id=NULL`）；登录凭证在 `sys_user`。  
 > **v1.4：** 平台 **新增商户** 须强制绑定 **平台管理员账号** 或 **C 端会员账号**，并同步创建该商户下首条 **商户经营账号**（`biz_merchant_account`）。  
 > **v1.3：** 除入驻绑定外，各模块 **不展开** 会员注册、会员运营等独立能力。  
-> **v1.2：** 商户入驻 **仅采集主体资质**；经营与结算信息在 **编辑商户** 中补全。
+> **v1.2：** 历史版本曾规定平台入驻仅采集主体资质；**v1.8 起** 平台添加须主体+经营信息一并完整提交；经营信息仍可在 **编辑商户** 中维护。
 
 ---
 
@@ -24,7 +25,7 @@
 
 ```text
 平台运营
-    └── 商户管理（本模块）── 创建/维护商户主体（本期：仅主体资质入驻）
+    └── 商户管理（本模块）── 创建/维护商户（主体资质 + 经营信息）
             └── 店铺管理 ── 按商户开设店铺（店铺经营账号在店铺侧配置，见店铺管理需求）
                     └── 商品管理 ── 店铺下商品上架与审核
                     └── 商品分类 ── 店铺侧分类维护
@@ -41,7 +42,7 @@
 
 | 角色 | 说明 |
 |------|------|
-| 平台管理员 | 商户列表、**主体入驻**、详情、认证状态、编辑（含补全经营信息）、删除 |
+| 平台管理员 | 商户列表、**添加商户（主体+经营）**、详情、认证状态、编辑、删除 |
 
 ---
 
@@ -51,12 +52,12 @@
 |------|------|
 | 商户 | 平台入驻的经营主体，分 **个人**、**企业** |
 | 主体资质 | 本期入驻 **必须** 完成的法定/身份资料：个人为 **个人信息**；企业为 **法定代表人信息 + 企业信息** |
-| 商户经营信息 | 商户名称、客服电话、经营地址、联系人、结算银行等；**本期不入驻表单**，在 **编辑商户** 中补全 |
+| 商户经营信息 | 商户名称、客服电话、经营地址、联系人、结算银行等；**平台添加时必填**（§6.6）；**编辑** 中可维护 |
 | 商户所属单位 | 列表展示：个人 = **姓名**；企业 = **企业名称**（来自主体资质） |
-| 商户名称 | 对外经营名称；在 **编辑** 中填写；未填时列表可用所属单位代显或显示「待完善」 |
+| 商户名称 | 对外经营名称；**添加/编辑** 中填写；平台唯一 |
 | 认证状态 | 正常 / 已冻结 / 已注销；新建提交后默认 **正常** |
 | 认证时间 | 见第 7.3 节 |
-| 资料完整度 | **主体资质**（入驻即有）+ **商户经营信息**（编辑补全）；**开店前** 须后者完整 |
+| 资料完整度 | **主体资质** + **商户经营信息**；平台 **添加** 成功时两者均须完整（`biz_complete=1`） |
 | 已绑定店铺数量 | 该商户下未删除店铺数 |
 | 商户经营账号 | 商家端登录账号；**新增商户成功时自动创建 1 条**（见第 6.7 节） |
 | 绑定类型 | 新增时二选一：**平台管理员** / **会员** |
@@ -69,7 +70,7 @@
 ```text
 商户管理
 ├── 商户列表（含高级检索）
-├── 添加商户（本期：主体资质 + 强制绑定经营账号）
+├── 添加商户（主体资质 + 商户经营信息 + 强制绑定经营账号）
 │   ├── 个人入驻 / 企业入驻
 │   └── 绑定经营账号（平台管理员 或 会员）
 ├── 查看详情（含认证状态调整）
@@ -120,43 +121,44 @@
 
 ---
 
-## 6. 添加商户（平台端 · 仅主体最小必填）
+## 6. 添加商户（平台端 · 主体 + 经营信息完整必填）
 
-新增时 **必须** 选择 **个人 / 企业** 主体类型，**必须** 绑定经营账号（§6.7）；**无需审核**；**不强制** 填写完整商户经营信息（可在编辑中补全）。
+新增时 **必须** 选择 **个人 / 企业** 主体类型，**必须** 填写完整 **主体资质** 与 **商户经营信息**（§6.6），**必须** 绑定经营账号（§6.7）；**无需审核**。
 
 ### 6.1 公共流程
 
 ```text
 选择主体类型（个人 / 企业）
     → 填写主体资质（见 6.2 / 6.3）
+    → 填写商户经营信息（见 6.6）
     → 选择绑定类型并检索选定账号（见 6.7）
     → 提交
-    → 系统校验（6.4、6.5、6.7）
-    ├── 失败 → 逐项提示
-    └── 成功 → 认证状态=正常，记录认证时间
+    → 系统校验（6.4、6.5、6.6、6.7）
+    ├── 失败 → 逐项提示（含经营信息缺失字段清单）
+    └── 成功 → 认证状态=正常，记录认证时间，biz_complete=1
             → 创建该商户下首条商户经营账号
-            → 提示：「请尽快在编辑中完善商户经营信息后再开设店铺」
+            → 提示：「保存成功，已可开设店铺」
 ```
 
-### 6.2 个人入驻 — 平台端填写项（最小必填）
+### 6.2 个人入驻 — 平台端填写项
 
 | 区块 | 字段 | 平台端 |
 |------|------|--------|
-| 个人信息 | 姓名 | **必填** |
-| 个人信息 | 其余（证件、地址、联系人、银行等） | **选填** |
-| 商户经营信息 | 全部 | **不填**（编辑补全） |
+| 个人信息 | 姓名、证件号码 | **必填** |
+| 个人信息 | 其余（证件照、地址等） | **选填** |
+| 商户经营信息 | 全部（§6.6） | **必填** |
 
 > **对比移动端：** C 端个人入驻须完整填写个人信息 + 经营信息 + 店铺信息，并走 **入驻审核 + 公示**（见《商户入驻审核功能需求》v1.1）。
 
-### 6.3 企业入驻 — 平台端填写项（最小必填）
+### 6.3 企业入驻 — 平台端填写项
 
 | 区块 | 字段 | 平台端 |
 |------|------|--------|
 | 法人信息 | 法人姓名 | **必填** |
 | 法人信息 | 其余 | **选填** |
-| 企业信息 | 企业名称 | **必填** |
-| 企业信息 | 其余（信用代码、注册地址等） | **选填** |
-| 商户经营信息 | 全部 | **不填**（编辑补全） |
+| 企业信息 | 企业名称、统一社会信用代码 | **必填** |
+| 企业信息 | 其余（注册地址等） | **选填** |
+| 商户经营信息 | 全部（§6.6，含营业执照、开户许可证） | **必填** |
 
 > **对比移动端：** C 端企业须完整填写企业信息 + 法人信息 + 经营信息 + 店铺信息，并走 **入驻审核 + 公示**。
 
@@ -169,16 +171,16 @@
 
 | 校验项 | 规则 | 提示示例 |
 |--------|------|----------|
-| 统一社会信用代码 | 企业类型；未删除企业商户不可重复 | 该统一社会信用代码已入驻 |
-
-> **商户名称** 入驻时不采集；在 **编辑** 填写时校验平台唯一（第 9 节）。
+| 证件号码 | 个人类型 **必填**；未删除个人商户不可重复 | 该证件号码已入驻 |
+| 统一社会信用代码 | 企业类型 **必填**；未删除企业商户不可重复 | 该统一社会信用代码已入驻 |
+| 商户名称 | 经营信息完整判定项；平台不可重复 | 商户名称已存在 |
 
 ### 6.6 资料完整度与开店前置
 
 | 资料块 | 完成时机 | 开店要求 |
 |--------|----------|----------|
-| 主体资质 | **入驻** 提交成功 | 已有 |
-| 商户经营信息 | **编辑商户** 中填写并保存 | **开设店铺前必须完整** |
+| 主体资质 | **添加** 提交成功 | 已有 |
+| 商户经营信息 | **添加** 提交成功（须完整） | **已有**（`biz_complete=1`） |
 
 **商户经营信息 — 完整判定（全部有值且校验通过）：**
 
@@ -387,10 +389,10 @@
 | R4 | 个人/企业类型创建后不可互转 |
 | R5 | 认证状态仅在 **查看详情** 修改 |
 | R6 | 开店可选商户：未删除 + **正常** + **经营信息完整** |
-| R7 | **商户名称** 在编辑时校验平台唯一；企业 **统一社会信用代码** 入驻时唯一 |
+| R7 | **商户名称** 平台唯一（添加/编辑）；个人 **证件号码**、企业 **统一社会信用代码** 添加时必填且唯一 |
 | R8 | 删除为逻辑删除，满足第 10 节 |
 | R9 | 商户认证变更不自动停业、不下架商品 |
-| R10 | 入驻 **仅采主体资质**；经营与结算信息 **编辑补全** |
+| R10 | 平台 **添加** 须 **主体 + 经营信息完整**；不完整不可保存；主体证件号/信用代码在库中已存在不可保存 |
 | R11 | 主体关键标识（证件号、统一社会信用代码）入驻后 **不可改** |
 
 ---
@@ -400,16 +402,16 @@
 ### 12.1 商户入驻 → 补全资料 → 开店
 
 ```text
-平台：添加商户 → 主体资质 + 绑定管理员/会员 → 正常 + 首条经营账号
-    ↓
-平台：编辑商户 → 补全商户经营信息 → 保存
+平台：添加商户 → 主体资质 + 经营信息 + 绑定管理员/会员 → 正常 + biz_complete=1 + 首条经营账号
     ↓
 平台：店铺管理 → 添加店铺 → 选择商户（可继续维护经营账号）
-    → 校验经营信息完整
+    → 校验经营信息完整（添加成功即满足）
     ↓
 店铺创建成功；已绑定店铺数量 +1
 ```
 
+（若历史数据或编辑后经营信息不完整，须 **编辑商户** 补全后再开店。）
+
 ### 12.2 商户冻结 / 注销
 
 （与 v1.1 相同。）
@@ -420,8 +422,8 @@
 
 | 场景 | 要求 |
 |------|------|
-| 添加商户 | **主体资质** + **绑定类型**（管理员/会员）+ 远程搜索选人；**无** 经营结算字段 |
-| 添加成功 | 提示去 **编辑** 完善经营信息后再开店 |
+| 添加商户 | **主体资质** + **商户经营信息** + **绑定类型**（管理员/会员）+ 远程搜索选人 |
+| 添加成功 | 提示 **「保存成功，已可开设店铺」** |
 | 编辑商户 | **主体资质** + **商户经营信息**；认证状态只读；企业注册地址/经营地址省市区通过 §6.8 接口选择 |
 | 列表 | **联系人/联系人手机**（来自经营信息）；无会员相关列 |
 | 详情 | 经营信息未完成时 **待完善** 提示 |
@@ -439,7 +441,7 @@
 | 【个人】 | `person_name`, `id_card_type`, `id_card_no`, `birth_date`, `id_valid_*`, `residence_address`, `gender`, `id_card_front/back` | `id_card_type`：1大陆身份证 2来往内地通行证 |
 | 【企业·法人】 | `legal_*`, `corp_bank_account`, `account_permit` | 对公账号、开户许可证 |
 | 【企业】 | `company_name`, `credit_code`, `reg_region_*`, `company_detail_address`, `business_scope`, `license_valid_*` | 注册地址：`reg_region_code/name`（§6.8 区县 code + 省/市/区 name 拼接）+ 详细地址 |
-| 经营信息 | `merchant_name`, `service_phone`, `biz_region_*`, `contact_*`, `bank_*`, `business_license` | 经营地址：`biz_region_code/name`（§6.8）；平台新增可不填 |
+| 经营信息 | `merchant_name`, `service_phone`, `biz_region_*`, `contact_*`, `bank_*`, `business_license` | 经营地址：`biz_region_code/name`（§6.8）；平台 **添加时必填** |
 | 经营账号 | `biz_merchant_account`（`account_id`、`merchant_id`、`shop_id`）+ `sys_user` 登录凭证 | 见 §6.7；**不在** `biz_shop` |
 
 **枚举约定：** `gender`/`legal_gender`：0男 1女；`*_valid_type`：1区间 2长期；`del_flag`：0存在 2删除。
@@ -456,9 +458,10 @@
 | **v1.3.1** | **取消** 单商户最多 3 店限制；`shop_count` 仅统计 |
 | **v1.4** | 新增商户强制绑定平台管理员或会员，并创建首条 `biz_merchant_account` |
 | **v1.5** | 平台/移动端字段差异定稿；§15 数据库字段与 SQL 对齐 |
+| **v1.8** | 平台添加须主体+经营信息完整；`biz_complete=1` 方可保存成功；证件号/信用代码重复拒绝 |
 | **v1.7** | 注册地址、经营地址省市区统一 **`GET /agri/region/tree`** 选择（§6.8） |
 | **v1.6** | 角色权限字符统一为 **merchant** / **member**；会员绑定密码复制会员 `sys_user.password`（不使用初始密码字段） |
 
 ---
 
-*文档版本：v1.7 · 关联《商户管理技术方案.md》v1.7、《商户入驻审核功能需求.md》v1.1、《店铺管理功能需求.md》v1.3.6*
+*文档版本：v1.8 · 关联《商户管理技术方案.md》v1.8、《商户入驻审核功能需求.md》v1.1、《店铺管理功能需求.md》v1.3.6*

doc/平台后台/组织管理/商户管理/商户管理技术方案.md

@@ -1,6 +1,7 @@
 # 商户管理 — 技术方案
 
-> **依据：** 《商户管理功能需求.md》v1.7  
+> **依据：** 《商户管理功能需求.md》v1.8  
+> **v1.8：** 平台 **POST /** 须 **主体 + 经营信息完整**（`validateBizOnInsert` + `BizCompleteEvaluator`）；证件号/信用代码必填且唯一；成功 `biz_complete=1`；msg「保存成功，已可开设店铺」。  
 > **v1.7：** 省市区三级数据 **`GET /agri/region/tree`**（平台）、**`GET /api/region/tree`**（C 端）；商户 **注册地址** `reg_region_*`、**经营地址** `biz_region_*` 落库约定见 §9.9。  
 > **v1.7：** 对齐 `biz_merchant_account` 新结构：`account_id=sys_user.user_id`；绑定仅 insert 关联行，登录凭证在 `sys_user`。
 > **v1.6：** 角色 **role_key=merchant/member**；`MerchantBindMapper` 严格按 `role_key` 过滤；会员绑定复用会员 `sys_user` 并追加 merchant 角色；`sysUserInitPassword` DTO 字段 **后端未使用**。  
@@ -183,11 +184,12 @@ biz_merchant（商户）
 
 ### 3.4 新增 `POST /`
 
-- Body：`MerchantCreateDTO` = 主体字段（§9.3）+ 绑定字段（§9.8）。拒绝经营字段入库。  
-- **平台主体校验**（`MerchantServiceImpl.validateSubjectOnInsert`）：个人 **仅姓名** 必填；企业 **仅法人姓名 + 企业名称** 必填；信用代码有值才验唯一；经营信息 **非必填**。  
-- 成功：`cert_status=0`, `cert_time=now()`, `biz_complete=0`；同事务调用 `IMerchantAccountBindService.bindAccountOnMerchantCreate`。  
+- Body：`MerchantCreateDTO` = 主体字段（§9.3）+ **经营信息字段**（§9.2）+ 绑定字段（§9.8）。  
+- **主体校验**（`MerchantServiceImpl.validateSubjectOnInsert`）：个人 **姓名 + 证件号码** 必填；企业 **法人姓名 + 企业名称 + 统一社会信用代码** 必填；证件号/信用代码在 `biz_merchant` 已存在则拒绝。  
+- **经营校验**（`validateBizOnInsert`）：`BizCompleteEvaluator.pendingFields` 须为空，否则抛 `经营信息不完整，无法保存：{字段清单}`；**商户名称** 须平台唯一。  
+- 成功：`cert_status=0`, `cert_time=now()`, **`biz_complete=1`**；同事务调用 `IMerchantAccountBindService.bindAccountOnMerchantCreate`。  
 - 过期：`data.warnExpired=true`, `data.expiredItems=[...]`，**仍 200 成功**（绑定已执行）。  
-- 响应 msg：「请尽快在编辑中完善商户经营信息后再开设店铺」。
+- 响应 msg：「**保存成功，已可开设店铺**」。
 
 ### 3.4.1 管理员选项 `GET /adminUserOptions`
 
@@ -278,10 +280,10 @@ biz_merchant（商户）
 | R4 | update 忽略 `merchantType` |
 | R5 | `certStatus` 仅 `PUT .../certStatus` |
 | R6 | selectList 三条件过滤 |
-| R7 | 编辑校验 `merchant_name` 唯一；入驻校验 `credit_code` 唯一 |
+| R7 | insert 校验 `merchant_name`、`id_card_no`、`credit_code` 唯一；update 校验 `merchant_name` 唯一 |
 | R8 | deleteCheck + DELETE + OrderFacade |
 | R9 | 无级联改 shop/goods |
-| R10 | POST 主体白名单 |
+| R10 | POST 须 **主体 + 经营信息完整**；`BizCompleteEvaluator` 判定；不完整拒绝 |
 | R11 | SQL 不更新 `id_card_no`、`credit_code` |
 
 ---
@@ -303,8 +305,8 @@ biz_merchant（商户）
 
 | 文档 | 版本 |
 |------|------|
-| 商户管理功能需求.md | v1.7 |
-| 商户管理测试用例.md | v1.4 |
+| 商户管理功能需求.md | v1.8 |
+| 商户管理测试用例.md | v1.5 |
 | 店铺管理功能需求/技术方案 | v1.3.6 / v1.2.5 |
 | 商品分类功能需求/技术方案 | v1.3.1 / v1.1 |
 | 商品管理功能需求/技术方案 | v1.3.3 / v1.2 |
@@ -355,7 +357,7 @@ biz_merchant（商户）
 
 ### 9.3 请求 JSON 样例
 
-**个人 — 新增 `POST /`（仅主体）**
+**个人 — 新增 `POST /`（主体 + 经营 + 绑定）**
 
 ```json
 {
@@ -369,34 +371,52 @@ biz_merchant（商户）
   "residenceAddress": "北京市朝阳区xxx",
   "gender": "0",
   "idCardFront": "/profile/upload/2025/01/a.jpg",
-  "idCardBack": "/profile/upload/2025/01/b.jpg"
+  "idCardBack": "/profile/upload/2025/01/b.jpg",
+  "merchantName": "张三农资店",
+  "servicePhone": "400-800-1234",
+  "bizRegionCode": "110105",
+  "bizRegionName": "北京市/朝阳区",
+  "bizDetailAddress": "xx路1号",
+  "contactName": "张三",
+  "contactPhone": "13800138000",
+  "contactEmail": "zhang@example.com",
+  "bankName": "中国工商银行",
+  "bankBranch": "朝阳支行",
+  "bankAccount": "622202xxxxxxxxxxxx",
+  "bindType": "SYS_USER",
+  "bindUserId": 10
 }
 ```
 
-**企业 — 新增 `POST /`**
+**企业 — 新增 `POST /`（主体 + 经营 + 绑定）**
 
 ```json
 {
   "merchantType": "2",
   "legalName": "李四",
   "legalIdCardNo": "110101198001011234",
-  "legalBirthDate": "1980-01-01",
-  "legalIdValidType": "2",
-  "legalIdValidStart": "2015-01-01",
-  "legalIdValidEnd": null,
-  "legalResidence": "北京市海淀区xxx",
-  "legalGender": "0",
-  "legalIdCardFront": "/profile/upload/legal_f.jpg",
-  "legalIdCardBack": "/profile/upload/legal_b.jpg",
-  "legalExtraPhoto": null,
   "companyName": "某某农资有限公司",
   "creditCode": "91110000MA01234567",
-  "regAddress": "北京市西城区xxx",
+  "regRegionCode": "110101",
+  "regRegionName": "北京市/市辖区/东城区",
   "companyDetailAddress": "xx大厦10层",
-  "businessScope": "农资销售",
-  "licenseValidType": "1",
+  "licenseValidType": "2",
   "licenseValidStart": "2020-01-01",
-  "licenseValidEnd": "2030-12-31"
+  "merchantName": "某某农资",
+  "servicePhone": "400-800-5678",
+  "bizRegionCode": "110101",
+  "bizRegionName": "北京市/市辖区/东城区",
+  "bizDetailAddress": "yy路2号",
+  "contactName": "李四",
+  "contactPhone": "13900139000",
+  "contactEmail": "li@example.com",
+  "bankName": "中国建设银行",
+  "bankBranch": "东城支行",
+  "bankAccount": "622700xxxxxxxxxxxx",
+  "businessLicense": "/profile/upload/license.jpg",
+  "accountPermit": "/profile/upload/permit.jpg",
+  "bindType": "MEMBER",
+  "bindMemberId": 20
 }
 ```
 
@@ -439,8 +459,11 @@ biz_merchant（商户）
 
 | 场景 | msg |
 |------|-----|
+| 经营信息不完整 | 经营信息不完整，无法保存：{缺失字段} |
 | 信用代码重复 | 该统一社会信用代码已入驻 |
 | 证件号重复 | 该证件号码已入驻 |
+| 证件号未填 | 请输入证件号码 |
+| 信用代码未填 | 请输入统一社会信用代码 |
 | 商户名称重复 | 商户名称已存在 |
 | 已注销不可编辑 | 商户已注销，不可编辑 |
 | 不可改认证 | 请在查看详情中修改认证状态 |
@@ -591,4 +614,4 @@ SQL：`mapper/merchant/MerchantBindMapper.xml`
 
 ---
 
-*文档版本：v1.7 · MySQL 5.7.39 · RuoYi v3.9.2-springboot2 · 关联《商户管理功能需求.md》v1.7、《商户管理测试用例.md》v1.4*
+*文档版本：v1.8 · MySQL 5.7.39 · RuoYi v3.9.2-springboot2 · 关联《商户管理功能需求.md》v1.8、《商户管理测试用例.md》v1.5*

doc/平台后台/组织管理/商户管理/商户管理测试用例.md

@@ -1,6 +1,6 @@
 # 商户管理 — 测试用例
 
-> **依据：** 《商户管理功能需求.md》v1.7、《商户管理技术方案.md》v1.7  
+> **依据：** 《商户管理功能需求.md》v1.8、《商户管理技术方案.md》v1.8  
 > **范围：** 平台管理端 **商户管理** 模块（列表、入驻含 **绑定经营账号**、详情、编辑、认证、删除、协作接口）；**省市区依赖** `GET /agri/region/tree`（§6.8 / §9.9）  
 > **排除：** C 端商城、会员模块独立 CRUD、商品/店铺/分类/订单模块的独立功能用例（订单 Facade 未建时按桩 `false` 测删商户正向）  
 > **环境：** RuoYi v3.9.2 平台端；接口基路径 `/agri/merchant`；UI 默认 `http://{host}/` + 农资管理菜单（以实际路由为准）
@@ -71,7 +71,7 @@
 | **测试步骤** | 评估完整度 |
 | **预期结果** | `biz_complete=0`；待完善含「经营地址」 |
 
-### MER-UT-005 新增入驻写入认证正常与认证时间
+### MER-UT-005 新增入驻写入认证正常、biz_complete=1 与认证时间
 
 | 要素 | 内容 |
 |------|------|
@@ -79,23 +79,23 @@
 | **测试项** | 新增 Service |
 | **测试类型** | 单元测试 |
 | **测试工具** | JUnit + Mockito |
-| **测试目的** | 验证 R3：入驻即正常并记 `cert_time` |
-| **前置条件** | Mock Mapper；合法个人主体 DTO |
-| **测试步骤** | `insertMerchant(dto)`（`MerchantCreateDTO` 含 `bindType`+`bindUserId`） |
-| **预期结果** | `cert_status=0`；`cert_time` 非空；`shop_count=0`；`biz_complete=0`；调用 `accountBindService.bindAccountOnMerchantCreate` |
+| **测试目的** | 验证 R3 + R10：入驻即正常、经营完整、`biz_complete=1` |
+| **前置条件** | Mock Mapper；合法个人主体+经营完整 DTO |
+| **测试步骤** | `insertMerchant(dto)`（含 `bindType`+`bindUserId` 及 §9.2 全部经营字段） |
+| **预期结果** | `cert_status=0`；`cert_time` 非空；`shop_count=0`；**`biz_complete=1`**；调用 `accountBindService.bindAccountOnMerchantCreate` |
 
-### MER-UT-006 新增拒绝经营字段入库
+### MER-UT-006 新增经营信息不完整拒绝保存
 
 | 要素 | 内容 |
 |------|------|
 | **测试模块** | 商户管理 |
-| **测试项** | 新增白名单 |
+| **测试项** | 新增 Service |
 | **测试类型** | 单元测试 |
 | **测试工具** | JUnit |
-| **测试目的** | 验证 R10：POST 仅主体字段 |
-| **前置条件** | 新增 DTO 含 `merchantName`、`contactPhone` |
-| **测试步骤** | 调用新增；检查持久化实体 |
-| **预期结果** | 经营字段不入库或为 null；或 Service 抛业务异常拒绝 |
+| **测试目的** | 验证 R10：经营信息不完整不可保存 |
+| **前置条件** | 新增 DTO 仅主体+绑定，缺经营字段 |
+| **测试步骤** | 调用 `insertMerchant` |
+| **预期结果** | 抛 `ServiceException`；msg 含「经营信息不完整，无法保存」及缺失字段；**不** 调用 `insert` |
 
 ### MER-UT-007 编辑忽略 `merchantType` 变更
 
@@ -538,10 +538,10 @@
 | **测试项** | POST / |
 | **测试类型** | 接口测试 |
 | **测试工具** | Apifox |
-| **测试目的** | 验证个人入驻主流程 |
+| **测试目的** | 验证个人入驻主流程（主体+经营完整） |
 | **前置条件** | `agri:merchant:add`；证件号未占用 |
-| **测试步骤** | `POST /` 提交 §9.3 个人样例 + `bindType=SYS_USER`+`bindUserId` |
-| **预期结果** | `code=200`；msg 含「请尽快在编辑中完善商户经营信息」；详情 `certStatus=0`，`bizComplete=0`；`biz_merchant_account` 已 1 条 |
+| **测试步骤** | `POST /` 提交 §9.3 个人完整样例 + `bindType=SYS_USER`+`bindUserId` |
+| **预期结果** | `code=200`；msg「**保存成功，已可开设店铺**」；详情 `certStatus=0`，**`bizComplete=1`**；`biz_merchant_account` 已 1 条 |
 
 ### MER-API-006 企业商户新增成功
 
@@ -551,10 +551,10 @@
 | **测试项** | POST / |
 | **测试类型** | 接口测试 |
 | **测试工具** | Apifox |
-| **测试目的** | 验证企业入驻主流程 |
+| **测试目的** | 验证企业入驻主流程（主体+经营完整） |
 | **前置条件** | 信用代码未占用 |
-| **测试步骤** | `POST /` 提交 §9.3 企业样例 JSON |
-| **预期结果** | `code=200`；`companyName` 入库；列表 `unitName` 为企业名称 |
+| **测试步骤** | `POST /` 提交 §9.3 企业完整样例 JSON + 绑定字段 |
+| **预期结果** | `code=200`；`bizComplete=1`；`companyName` 入库；列表 `unitName` 为企业名称 |
 
 ### MER-API-007 新增缺少必填字段失败
 
@@ -566,8 +566,8 @@
 | **测试工具** | Apifox |
 | **测试目的** | 验证必填校验 |
 | **前置条件** | — |
-| **测试步骤** | `POST /` 仅传 `merchantType=1`，无姓名证件 |
-| **预期结果** | `code≠200` 或字段级错误；未新增记录 |
+| **测试步骤** | `POST /` 仅传 `merchantType=1`+`personName`，无证件号与经营字段 |
+| **预期结果** | `code≠200`；msg 含必填/经营不完整提示；未新增记录 |
 
 ### MER-API-008 企业信用代码重复
 
@@ -582,7 +582,7 @@
 | **测试步骤** | 再次 `POST` 相同 `creditCode` |
 | **预期结果** | 失败；msg「该统一社会信用代码已入驻」 |
 
-### MER-API-009 新增携带经营字段被拒绝或忽略
+### MER-API-009 新增经营信息不完整拒绝
 
 | 要素 | 内容 |
 |------|------|
@@ -590,10 +590,10 @@
 | **测试项** | POST / |
 | **测试类型** | 接口测试 |
 | **测试工具** | Apifox |
-| **测试目的** | 验证 R10 |
+| **测试目的** | 验证 R10：缺经营字段不可保存 |
 | **前置条件** | — |
-| **测试步骤** | 1. `POST /` 主体合法且带 `merchantName`、`bankAccount` 2. `GET /{id}` 查详情 |
-| **预期结果** | 成功时经营字段仍为空/`bizComplete=0`；或整单拒绝 |
+| **测试步骤** | `POST /` 主体+绑定合法，但缺 `merchantName` 或 `contactPhone` 等经营字段 |
+| **预期结果** | 失败；msg 含「经营信息不完整，无法保存」及缺失项；未新增记录 |
 
 ### MER-API-010 证件过期仍 200 且带 warn
 
@@ -617,7 +617,7 @@
 | **测试类型** | 接口测试 |
 | **测试工具** | Apifox |
 | **测试目的** | 验证详情契约 |
-| **前置条件** | 仅主体、未补经营的新商户 |
+| **前置条件** | 编辑后清空某经营字段的商户，或历史不完整数据 |
 | **测试步骤** | `GET /agri/merchant/{id}` |
 | **预期结果** | `bizComplete=0`；`pendingBizFields` 为非空中文字符串数组 |
 
@@ -1150,7 +1150,7 @@
 | **测试类型** | 接口测试 |
 | **测试工具** | Apifox |
 | **测试目的** | 验证 §9.9 落库与 `biz_complete` |
-| **前置条件** | 正常商户仅主体；从 MER-API-051 选取区县 |
+| **前置条件** | 经营信息不完整的正常商户；从 MER-API-051 选取区县 |
 | **测试步骤** | `PUT /` 提交 `bizRegionCode=110101`、`bizRegionName=北京市/市辖区/东城区` 及其余经营必填项 |
 | **预期结果** | 成功；库表 `biz_region_code/name` 一致；`biz_complete=1` 时 msg 可含「已可开设店铺」 |
 
@@ -1199,7 +1199,7 @@
 | **测试步骤** | 认证状态选「已冻结」→ 查询 |
 | **预期结果** | 列表均为已冻结；标签样式正确 |
 
-### MER-UI-004 添加个人商户-仅主体表单
+### MER-UI-004 添加个人商户-含主体与经营表单
 
 | 要素 | 内容 |
 |------|------|
@@ -1207,10 +1207,10 @@
 | **测试项** | 添加商户 |
 | **测试类型** | 界面测试 |
 | **测试工具** | Playwright |
-| **测试目的** | 验证入驻表单范围 R10 |
+| **测试目的** | 验证 R10 新增表单范围 |
 | **前置条件** | 有 add 权限 |
-| **测试步骤** | 1. 点击「新增」 2. 选个人 3. 查看表单字段 |
-| **预期结果** | **无** 经营结算字段；有个人证件、证照；有 **绑定类型**（管理员/会员）及远程搜索框 |
+| **测试步骤** | 1. 点击「新增」 2. 选个人 3. 查看 Tab 与表单项 |
+| **预期结果** | 有「主体资质」「**商户经营信息**」「绑定经营账号」三个 Tab；经营 Tab 含商户名称、经营地区、联系人、银行等必填项 |
 
 ### MER-UI-005 添加个人商户成功提示
 
@@ -1222,8 +1222,8 @@
 | **测试工具** | Playwright |
 | **测试目的** | 验证入驻成功交互 |
 | **前置条件** | 合法个人数据；证照已上传 |
-| **测试步骤** | 填写必填项→提交 |
-| **预期结果** | 成功提示含「完善商户经营信息」「开设店铺」；列表新增行认证=正常；商户名称显示待完善或所属单位 |
+| **测试步骤** | 填写主体+经营+绑定全部必填项→提交 |
+| **预期结果** | 成功提示「**保存成功，已可开设店铺**」；列表新增行认证=正常；商户名称显示所填名称 |
 
 ### MER-UI-006 添加企业商户成功
 
@@ -1235,8 +1235,8 @@
 | **测试工具** | Playwright |
 | **测试目的** | 验证企业入驻 UI |
 | **前置条件** | 未占用信用代码 |
-| **测试步骤** | 选企业→填法人+企业信息→提交 |
-| **预期结果** | 成功；列表所属单位=企业名称 |
+| **测试步骤** | 选企业→填法人+企业+经营信息+绑定→提交 |
+| **预期结果** | 成功；`bizComplete=1`；列表所属单位=企业名称 |
 
 ### MER-UI-007 添加必填项为空提交校验
 
@@ -1248,7 +1248,7 @@
 | **测试工具** | Playwright |
 | **测试目的** | 验证前端/后端必填提示 |
 | **前置条件** | 打开新增页 |
-| **测试步骤** | 不填姓名直接提交 |
+| **测试步骤** | 不填姓名或经营必填项直接提交 |
 | **预期结果** | 表单项标红或 Toast 提示；不关闭弹窗/不跳转 |
 
 ### MER-UI-008 查看详情-经营待完善展示
@@ -1260,7 +1260,7 @@
 | **测试类型** | 界面测试 |
 | **测试工具** | Playwright |
 | **测试目的** | 验证 §8.1 待完善 |
-| **前置条件** | 仅主体入驻的商户 |
+| **前置条件** | 经营信息不完整的商户（编辑清空某字段或历史数据） |
 | **测试步骤** | 列表点「查看详情」 |
 | **预期结果** | 经营信息区显示「待完善」及缺失字段清单；主体资质只读展示 |
 
@@ -1537,7 +1537,7 @@
 | **测试步骤** | 详情改认证为「正常」并确认→返回列表点编辑 |
 | **预期结果** | 确认文案含「恢复后可编辑、可开店」；编辑页可打开并保存 |
 
-### MER-UI-027 添加企业表单无经营结算字段
+### MER-UI-027 添加企业表单含经营结算字段
 
 | 要素 | 内容 |
 |------|------|
@@ -1545,10 +1545,10 @@
 | **测试项** | 添加商户 |
 | **测试类型** | 界面测试 |
 | **测试工具** | Playwright |
-| **测试目的** | 验证 R10 企业入驻范围 |
+| **测试目的** | 验证 R10 企业新增须含经营 Tab |
 | **前置条件** | 有 add 权限 |
-| **测试步骤** | 新增→选企业→检查表单项 |
-| **预期结果** | 含法人、企业信息；**无** 商户名称、开户银行、营业执照（经营项在编辑页） |
+| **测试步骤** | 新增→选企业→打开「商户经营信息」Tab |
+| **预期结果** | 含商户名称、开户银行、**营业执照电子版**、**开户许可证** 等经营项；均为必填 |
 
 ### MER-UI-028 详情展示店铺数与下属店铺
 
@@ -1591,7 +1591,7 @@
 | R7 | 名称/信用代码唯一 | MER-UT-016/017/029, MER-API-008/014/037, MER-UI-023/024 |
 | R8 | 逻辑删除前置 | MER-UT-021～023, MER-API-021～025/042, MER-UI-016/017 |
 | R9 | 认证变更不级联店/商品 | （店铺/商品模块联调；本文档不重复） |
-| R10 | 入驻仅主体 | MER-UT-006, MER-API-009, MER-UI-004/027 |
+| R10 | 添加须主体+经营完整 | MER-UT-005/006, MER-API-005/009, MER-UI-004/027 |
 | R11 | 证件号/信用代码不可改 | MER-UT-008, MER-UI-014 |
 
 | 功能域 | 正常流程 | 异常/约束 |
@@ -1611,8 +1611,8 @@
 
 | 数据 | 说明 |
 |------|------|
-| 个人商户-仅主体 | 用于入驻、待完善详情 |
-| 个人商户-经营完整 | 用于 openShopCheck/selectList 正向 |
+| 个人商户-经营不完整 | 编辑清空某经营字段后，用于待完善详情/openShopCheck 负向 |
+| 个人商户-经营完整 | 用于新增成功、openShopCheck/selectList 正向 |
 | 企业商户-信用代码唯一 | 用于重复校验 |
 | 冻结/注销商户 | 用于状态机与权限 |
 | 高 shop_count 商户 | 用于 R1 无上限（≥5，由店铺测试数据准备，本文仅断言 openShopCheck） |
@@ -1666,4 +1666,4 @@ test('MER-UI-001 列表加载', async ({ page }) => {
 
 ---
 
-*文档版本：v1.4 · 关联《商户管理功能需求.md》v1.7、《商户管理技术方案.md》v1.7*
+*文档版本：v1.5 · 关联《商户管理功能需求.md》v1.8、《商户管理技术方案.md》v1.8*

doc/平台后台/组织管理/店铺管理/店铺管理功能需求.md

@@ -388,9 +388,7 @@
 ### 13.1 商户入驻 → 补全资料 → 开店（端到端）
 
 ```text
-商户管理：添加商户（仅主体资质）→ 认证=正常
-    ↓
-商户管理：编辑商户 → 补全经营与结算信息
+商户管理：添加商户（主体+经营信息完整）→ 认证=正常，biz_complete=1
     ↓
 店铺管理：添加店铺 → 选择商户（校验经营信息完整 **且已有经营账号**）
     ↓

ruoyi-ui/src/views/agri/org/merchant/index.vue

@@ -100,7 +100,7 @@
                 </el-col>
                 <el-col :span="12">
                   <el-form-item label="证件号码" prop="idCardNo">
-                    <el-input v-model="form.idCardNo" maxlength="18" :disabled="!!form.merchantId" placeholder="选填" />
+                    <el-input v-model="form.idCardNo" maxlength="18" :disabled="!!form.merchantId" :placeholder="form.merchantId ? '选填' : '必填'" />
                   </el-form-item>
                 </el-col>
                 <el-col :span="12">
@@ -206,7 +206,7 @@
                 <el-col :span="12"><el-form-item label="企业名称" prop="companyName"><el-input v-model="form.companyName" maxlength="128" /></el-form-item></el-col>
                 <el-col :span="12">
                   <el-form-item label="统一社会信用代码" prop="creditCode">
-                    <el-input v-model="form.creditCode" maxlength="18" :disabled="!!form.merchantId" placeholder="选填" />
+                    <el-input v-model="form.creditCode" maxlength="18" :disabled="!!form.merchantId" :placeholder="form.merchantId ? '选填' : '必填'" />
                   </el-form-item>
                 </el-col>
                 <el-col :span="24">
@@ -247,8 +247,8 @@
             </template>
           </el-tab-pane>
 
-          <!-- 经营信息（仅编辑） -->
-          <el-tab-pane v-if="form.merchantId" label="商户经营信息" name="biz">
+          <!-- 经营信息 -->
+          <el-tab-pane label="商户经营信息" name="biz">
             <el-row :gutter="16">
               <el-col :span="12"><el-form-item label="商户名称" prop="merchantName"><el-input v-model="form.merchantName" maxlength="128" /></el-form-item></el-col>
               <el-col :span="12"><el-form-item label="客服电话" prop="servicePhone"><el-input v-model="form.servicePhone" maxlength="20" /></el-form-item></el-col>
@@ -372,7 +372,7 @@ export default {
     }
   },
   computed: {
-    /** 表单校验：新增个人仅姓名必填；新增企业仅法人姓名+企业名称必填；绑定仅新增时校验 */
+    /** 表单校验：新增须完整主体+经营信息；编辑经营信息在 biz 页签校验 */
     formRules() {
       const rules = {
         merchantType: [{ required: true, message: "请选择主体类型", trigger: "change" }]
@@ -380,11 +380,41 @@ export default {
       const isAdd = !this.form.merchantId
       if (this.form.merchantType === "1") {
         rules.personName = [{ required: true, message: "请输入姓名", trigger: "blur" }]
+        if (isAdd) {
+          rules.idCardNo = [{ required: true, message: "请输入证件号码", trigger: "blur" }]
+        }
       } else {
         rules.legalName = [{ required: true, message: "请输入法人姓名", trigger: "blur" }]
         rules.companyName = [{ required: true, message: "请输入企业名称", trigger: "blur" }]
+        if (isAdd) {
+          rules.creditCode = [{ required: true, message: "请输入统一社会信用代码", trigger: "blur" }]
+        }
       }
       if (isAdd) {
+        rules.merchantName = [{ required: true, message: "请输入商户名称", trigger: "blur" }]
+        rules.servicePhone = [{ required: true, message: "请输入客服电话", trigger: "blur" }]
+        rules.bizRegionCascader = [{
+          required: true,
+          validator: (rule, value, callback) => {
+            if (!value || value.length === 0) {
+              callback(new Error("请选择经营地区"))
+            } else {
+              callback()
+            }
+          },
+          trigger: "change"
+        }]
+        rules.bizDetailAddress = [{ required: true, message: "请输入经营详细地址", trigger: "blur" }]
+        rules.contactName = [{ required: true, message: "请输入联系人姓名", trigger: "blur" }]
+        rules.contactPhone = [{ required: true, message: "请输入联系人手机", trigger: "blur" }]
+        rules.contactEmail = [{ required: true, message: "请输入联系人邮箱", trigger: "blur" }]
+        rules.bankName = [{ required: true, message: "请输入开户银行", trigger: "blur" }]
+        rules.bankBranch = [{ required: true, message: "请输入支行名称", trigger: "blur" }]
+        rules.bankAccount = [{ required: true, message: "请输入银行账号", trigger: "blur" }]
+        if (this.form.merchantType === "2") {
+          rules.businessLicense = [{ required: true, message: "请上传营业执照电子版", trigger: "change" }]
+          rules.accountPermit = [{ required: true, message: "请上传开户许可证", trigger: "change" }]
+        }
         rules.bindType = [{ required: true, message: "请选择绑定类型", trigger: "change" }]
         if (this.form.bindType === "SYS_USER") {
           rules.bindUserId = [{ required: true, message: "请选择平台管理员", trigger: "change" }]
@@ -465,6 +495,19 @@ export default {
         bindType: "SYS_USER",
         bindUserId: undefined,
         bindMemberId: undefined,
+        merchantName: undefined,
+        servicePhone: undefined,
+        bizRegionCode: undefined,
+        bizRegionName: undefined,
+        bizDetailAddress: undefined,
+        contactName: undefined,
+        contactPhone: undefined,
+        contactEmail: undefined,
+        bankName: undefined,
+        bankBranch: undefined,
+        bankAccount: undefined,
+        businessLicense: undefined,
+        accountPermit: undefined,
         bizRegionCascader: []
       }
       this.activeTab = "subject"
@@ -621,13 +664,10 @@ export default {
         const payload = this.buildSubmitPayload()
         const submitFn = payload.merchantId ? updateMerchant : addMerchant
         submitFn(payload).then(response => {
-          let msg = payload.merchantId ? "修改成功" : "新增成功"
-          if (response.data && response.data.bizCompleteChanged) {
+          let msg = response.msg || (payload.merchantId ? "修改成功" : "保存成功，已可开设店铺")
+          if (payload.merchantId && response.data && response.data.bizCompleteChanged) {
             msg = "保存成功，已可开设店铺"
           }
-          if (!payload.merchantId) {
-            msg = "请尽快在编辑中完善商户经营信息后再开设店铺"
-          }
           if (response.data && response.data.warnExpired) {
             this.$modal.msgWarning("证件或营业期限已过期，请注意风险")
           }