alien_cloud/alien-store-platform/接口文档/17-身份验证接口逻辑变更说明.md

商户身份验证接口逻辑变更说明

变更时间

2025-01-xx

变更原因

原有接口 /alienStore/ali/getIdInfo 在 alien-store 服务中业务逻辑有修改，需要同步更新到 alien-store-platform 服务中的 /merchantAuth/verifyIdInfo 接口。

业务逻辑变更对比

原逻辑（已废弃）

用户端（appType=0）

// 简单查询 life_user 表
size = lifeUserMapper.selectCount(
    new LambdaQueryWrapper<LifeUser>()
        .eq(LifeUser::getIdCard, idCard)
        .eq(LifeUser::getRealName, name)
);

商家端（appType=1）

// 简单查询 store_user 表
size = storeUserMapper.selectCount(
    new LambdaQueryWrapper<StoreUser>()
        .eq(StoreUser::getIdCard, idCard)
        .eq(StoreUser::getName, name)
);

---

新逻辑（当前使用）

用户端（appType=0）

// 查询未注销的用户（增加 logout_flag=0 条件）
size = lifeUserMapper.selectCount(
    new LambdaQueryWrapper<LifeUser>()
        .eq(LifeUser::getIdCard, idCard)
        .eq(LifeUser::getRealName, name)
        .eq(LifeUser::getLogoutFlag, 0)  // 新增：只查询未注销的用户
);

变更说明：

• 增加了 logout_flag = 0 条件
• 只允许未注销的用户使用该身份证进行认证
• 已注销的用户（logout_flag=1）可以使用相同身份证重新注册

商家端（appType=1）

// 查询已入住或审核中的商家（多步骤查询）
// 1. 根据身份证和姓名查询商户用户
List<StoreUser> storeUserList = storeUserMapper.selectList(
    new LambdaQueryWrapper<StoreUser>()
        .eq(StoreUser::getIdCard, idCard)
        .eq(StoreUser::getName, name)
);

// 2. 获取这些商户用户绑定的店铺ID
List<Integer> storeIds = storeUserList.stream()
        .map(StoreUser::getStoreId)
        .filter(Objects::nonNull)
        .collect(Collectors.toList());

// 3. 查询非审核失败状态的店铺
if (!storeIds.isEmpty()) {
    size = storeInfoMapper.selectCount(
        new LambdaQueryWrapper<StoreInfo>()
            .in(StoreInfo::getId, storeIds)
            .notIn(StoreInfo::getStoreApplicationStatus, 2)  // 排除审核失败的店铺
    );
}

变更说明：

• 不再直接统计 store_user 表记录数
• 改为查询商户用户绑定的店铺信息
• 只统计非审核失败状态的店铺（storeApplicationStatus != 2）
• 审核失败的店铺（status=2）可以使用相同身份证重新申请

---

店铺审核状态说明

状态值	状态名称	说明	是否允许重复使用身份证
0	待审核	店铺申请已提交，等待审核	❌ 不允许
1	审核通过	店铺申请审核通过，正常营业	❌ 不允许
2	审核失败	店铺申请被拒绝	✅ 允许

---

业务场景说明

场景1：用户注销后重新注册

原逻辑问题：

• 用户注销账号后，身份证仍然被占用
• 无法使用相同身份证重新注册

新逻辑解决：

• 查询时只统计未注销的用户（logout_flag=0）
• 已注销的用户（logout_flag=1）不会被统计
• 用户可以使用相同身份证重新注册

场景2：商家审核失败后重新申请

原逻辑问题：

• 商家申请被拒绝后，身份证仍然被占用
• 无法使用相同身份证重新申请店铺

新逻辑解决：

• 查询时排除审核失败的店铺（storeApplicationStatus=2）
• 审核失败的店铺不会阻止重新申请
• 商家可以使用相同身份证重新提交申请

场景3：一人一店限制

业务规则：

• 一个身份证只能有一个有效的店铺
• 有效店铺：待审核（status=0）或审核通过（status=1）
• 审核失败的店铺不算在内

---

代码变更详情

变更文件

alien-store-platform/src/main/java/shop/alien/storeplatform/service/impl/MerchantAuthServiceImpl.java

新增依赖

import shop.alien.entity.store.StoreInfo;
import shop.alien.mapper.StoreInfoMapper;
import java.util.List;
import java.util.Objects;
import java.util.stream.Collectors;

关键代码变更

1. 用户端查询

// 旧代码
userWrapper.eq(LifeUser::getIdCard, idCard)
           .eq(LifeUser::getRealName, name);

// 新代码
userWrapper.eq(LifeUser::getIdCard, idCard)
           .eq(LifeUser::getRealName, name)
           .eq(LifeUser::getLogoutFlag, 0);  // 新增

2. 商家端查询

// 旧代码（直接查询）
LambdaQueryWrapper<StoreUser> storeWrapper = new LambdaQueryWrapper<>();
storeWrapper.eq(StoreUser::getIdCard, idCard)
           .eq(StoreUser::getName, name);
size = storeUserMapper.selectCount(storeWrapper);

// 新代码（多表联查）
// 第一步：查询商户用户
List<StoreUser> storeUserList = storeUserMapper.selectList(storeUserWrapper);

// 第二步：提取店铺ID
List<Integer> storeIds = storeUserList.stream()
        .map(StoreUser::getStoreId)
        .filter(Objects::nonNull)
        .collect(Collectors.toList());

// 第三步：查询有效店铺
if (!storeIds.isEmpty()) {
    size = storeInfoMapper.selectCount(
        new LambdaQueryWrapper<StoreInfo>()
            .in(StoreInfo::getId, storeIds)
            .notIn(StoreInfo::getStoreApplicationStatus, 2)
    );
}

---

测试用例

测试用例1：用户端 - 未注销用户

# 场景：用户已注册且未注销
# 期望：返回"该身份证已实名认证过"
curl -X GET "http://localhost:8080/merchantAuth/verifyIdInfo?name=张三&idCard=110101199001011234&appType=0"

测试用例2：用户端 - 已注销用户

# 场景：用户已注销（logout_flag=1）
# 期望：可以重新注册，返回"身份验证成功"
curl -X GET "http://localhost:8080/merchantAuth/verifyIdInfo?name=李四&idCard=110101199001011235&appType=0"

测试用例3：商家端 - 有审核通过的店铺

# 场景：商家有审核通过的店铺（status=1）
# 期望：返回"该身份证已实名认证过"
curl -X GET "http://localhost:8080/merchantAuth/verifyIdInfo?name=王五&idCard=110101199001011236&appType=1"

测试用例4：商家端 - 只有审核失败的店铺

# 场景：商家只有审核失败的店铺（status=2）
# 期望：可以重新申请，返回"身份验证成功"
curl -X GET "http://localhost:8080/merchantAuth/verifyIdInfo?name=赵六&idCard=110101199001011237&appType=1"

测试用例5：商家端 - 有待审核的店铺

# 场景：商家有待审核的店铺（status=0）
# 期望：返回"该身份证已实名认证过"
curl -X GET "http://localhost:8080/merchantAuth/verifyIdInfo?name=孙七&idCard=110101199001011238&appType=1"

---

数据库字段说明

life_user 表

-- logout_flag 字段
logout_flag TINYINT DEFAULT 0 COMMENT '注销标记(0:未注销, 1:已注销)'

store_info 表

-- store_application_status 字段
store_application_status TINYINT DEFAULT 0 COMMENT '店铺申请审核状态(0:待审核, 1:审核通过, 2:审核失败)'

---

影响范围

接口行为变更

1. 用户端：已注销用户现在可以使用相同身份证重新注册
2. 商家端：审核失败的商家现在可以使用相同身份证重新申请

向后兼容性

• ✅ 接口路径不变
• ✅ 请求参数不变
• ✅ 响应格式不变
• ⚠️ 业务逻辑变更（更宽松的验证规则）

潜在风险

• 无风险，变更使业务逻辑更加合理
• 允许用户在注销后重新注册
• 允许商家在审核失败后重新申请

---

部署注意事项

1. 数据库检查

   • 确认 life_user 表有 logout_flag 字段
   • 确认 store_info 表有 store_application_status 字段

2. 代码部署

   • 直接部署即可，无需额外配置
   • 无需数据迁移

3. 测试验证

   • 验证已注销用户可以重新注册
   • 验证审核失败的商家可以重新申请
   • 验证正常用户和商家仍然被正确拦截

---

版本信息

版本	日期	说明
v1.0.0	2025-01-xx	初始版本
v1.1.0	2025-01-xx	同步 alien-store 最新业务逻辑

---

变更人员： AI Assistant
审核状态： 待审核
测试状态： 待测试