feat: 完成B端认证系统和商户管理模块测试补全
主要变更: - 新增B端认证系统(后台+H5):登录、登出、Token刷新、密码修改 - 完善商户管理和商户账号管理功能 - 补全单元测试(ShopService: 72.5%, ShopAccountService: 79.8%) - 新增集成测试(商户管理+商户账号管理) - 归档OpenSpec提案(add-shop-account-management, implement-b-end-auth-system) - 完善文档(使用指南、API文档、认证架构说明) 测试统计: - 13个测试套件,37个测试用例,100%通过率 - 平均覆盖率76.2%,达标 OpenSpec验证:通过(strict模式)
This commit is contained in:
136
openspec/specs/shop-management/spec.md
Normal file
136
openspec/specs/shop-management/spec.md
Normal file
@@ -0,0 +1,136 @@
|
||||
# shop-management Specification
|
||||
|
||||
## Purpose
|
||||
TBD - created by archiving change add-shop-account-management. Update Purpose after archive.
|
||||
## Requirements
|
||||
### Requirement: 店铺分页列表查询
|
||||
|
||||
系统 SHALL 提供店铺分页列表查询功能,支持按店铺名称模糊查询,返回详细的店铺信息。
|
||||
|
||||
#### Scenario: 查询所有店铺(平台管理员)
|
||||
|
||||
- **WHEN** 平台管理员访问店铺列表(不传店铺名称过滤条件)
|
||||
- **THEN** 返回所有未删除的店铺列表
|
||||
- **AND** 包含分页信息(总数、当前页、每页数量)
|
||||
- **AND** 每条记录包含:店铺名称、店铺编号、上级店铺名称、层级、联系人、联系电话、省市区(合并字段)、创建时间、创建人
|
||||
|
||||
#### Scenario: 按店铺名称模糊查询
|
||||
|
||||
- **WHEN** 用户传入店铺名称查询参数(如"华东")
|
||||
- **THEN** 返回店铺名称包含"华东"的所有店铺
|
||||
- **AND** 使用 LIKE 模糊匹配
|
||||
- **AND** 支持分页
|
||||
|
||||
#### Scenario: 代理账号查询(数据权限过滤)
|
||||
|
||||
- **WHEN** 代理账号访问店铺列表
|
||||
- **THEN** 只返回当前店铺及所有下级店铺
|
||||
- **AND** 通过 GORM Callback 自动应用过滤条件
|
||||
- **AND** 支持分页
|
||||
|
||||
#### Scenario: 空结果处理
|
||||
|
||||
- **WHEN** 查询条件无匹配结果
|
||||
- **THEN** 返回空数组
|
||||
- **AND** 总数为 0
|
||||
- **AND** HTTP 状态码 200
|
||||
|
||||
### Requirement: 店铺新增
|
||||
|
||||
系统 SHALL 提供店铺新增功能,支持完整的店铺信息录入,并自动创建店铺初始账号。
|
||||
|
||||
#### Scenario: 新增一级代理店铺
|
||||
|
||||
- **WHEN** 用户提交新增店铺请求(未填写上级店铺)
|
||||
- **AND** 提供店铺名称、店铺编号、联系电话、初始密码
|
||||
- **THEN** 创建店铺记录,层级设为 1
|
||||
- **AND** 自动创建初始账号(用户类型=3,shop_id=新店铺ID)
|
||||
- **AND** 账号手机号和登录账号使用联系电话
|
||||
- **AND** 密码使用 bcrypt 加密
|
||||
- **AND** 返回新创建的店铺信息
|
||||
|
||||
#### Scenario: 新增下级代理店铺
|
||||
|
||||
- **WHEN** 用户提交新增店铺请求(填写上级店铺ID)
|
||||
- **THEN** 验证上级店铺存在且未删除
|
||||
- **AND** 计算层级(上级层级 + 1)
|
||||
- **AND** 验证层级不超过 7
|
||||
- **AND** 创建店铺记录
|
||||
- **AND** 自动创建初始账号
|
||||
|
||||
#### Scenario: 店铺编号唯一性校验
|
||||
|
||||
- **WHEN** 用户提交的店铺编号已存在(未删除记录)
|
||||
- **THEN** 返回错误码 2101(店铺编号已存在)
|
||||
- **AND** HTTP 状态码 400
|
||||
- **AND** 不创建店铺记录
|
||||
|
||||
#### Scenario: 层级超过限制
|
||||
|
||||
- **WHEN** 用户尝试创建第 8 级店铺
|
||||
- **THEN** 返回错误码 2102(超过最大层级限制)
|
||||
- **AND** HTTP 状态码 400
|
||||
|
||||
#### Scenario: 联系电话必填校验
|
||||
|
||||
- **WHEN** 用户提交新增请求时未填写联系电话
|
||||
- **THEN** 返回参数验证错误
|
||||
- **AND** HTTP 状态码 400
|
||||
|
||||
### Requirement: 店铺编辑
|
||||
|
||||
系统 SHALL 提供店铺编辑功能,支持更新店铺信息,但不允许修改密码和登录账号。
|
||||
|
||||
#### Scenario: 更新店铺基本信息
|
||||
|
||||
- **WHEN** 用户提交编辑店铺请求(更新店铺名称、联系人等)
|
||||
- **THEN** 验证店铺存在且未删除
|
||||
- **AND** 更新允许编辑的字段
|
||||
- **AND** 更新 updater 字段为当前用户ID
|
||||
- **AND** 返回更新后的店铺信息
|
||||
|
||||
#### Scenario: 不允许修改店铺编号
|
||||
|
||||
- **WHEN** 编辑请求中包含店铺编号字段
|
||||
- **THEN** 忽略该字段
|
||||
- **AND** 不更新店铺编号
|
||||
|
||||
#### Scenario: 不允许修改上级店铺
|
||||
|
||||
- **WHEN** 编辑请求中包含上级店铺字段
|
||||
- **THEN** 忽略该字段
|
||||
- **AND** 不更新上级店铺和层级
|
||||
|
||||
#### Scenario: 编辑不存在的店铺
|
||||
|
||||
- **WHEN** 用户尝试编辑不存在或已删除的店铺
|
||||
- **THEN** 返回错误码 2103(店铺不存在)
|
||||
- **AND** HTTP 状态码 404
|
||||
|
||||
### Requirement: 店铺删除
|
||||
|
||||
系统 SHALL 提供店铺删除功能,执行软删除并同步禁用店铺下的所有账号。
|
||||
|
||||
#### Scenario: 删除店铺并禁用账号
|
||||
|
||||
- **WHEN** 用户提交删除店铺请求
|
||||
- **THEN** 验证店铺存在且未删除
|
||||
- **AND** 执行软删除(设置 deleted_at)
|
||||
- **AND** 查询该店铺的所有账号(shop_id = 店铺ID)
|
||||
- **AND** 批量更新所有账号状态为 0(禁用)
|
||||
- **AND** 使用事务保证原子性
|
||||
- **AND** 返回成功响应
|
||||
|
||||
#### Scenario: 删除不存在的店铺
|
||||
|
||||
- **WHEN** 用户尝试删除不存在或已删除的店铺
|
||||
- **THEN** 返回错误码 2103(店铺不存在)
|
||||
- **AND** HTTP 状态码 404
|
||||
|
||||
#### Scenario: 删除有下级店铺的店铺
|
||||
|
||||
- **WHEN** 用户尝试删除有下级店铺的店铺
|
||||
- **THEN** 返回错误码 2104(存在下级店铺,无法删除)
|
||||
- **AND** HTTP 状态码 400
|
||||
- **AND** 不执行删除操作
|
||||
|
||||
Reference in New Issue
Block a user