junhong_cmp_fiber/openspec/changes/archive/2026-01-15-add-shop-account-management/tasks.md

实现任务清单

1. 准备阶段

• 1.1 创建常量定义文件 pkg/constants/shop.go
• 1.2 扩展错误码定义 pkg/errors/codes.go
• 1.3 创建 DTO 模型 internal/model/shop_dto.go
• 1.4 创建 DTO 模型 internal/model/shop_account_dto.go

2. Store 层实现

• 2.1 扩展 ShopStore：添加 List 方法（支持分页和过滤）
• 2.2 扩展 ShopStore：添加 Delete 方法（软删除）
• 2.3 扩展 ShopStore：添加 GetByCode 方法（查重）
• 2.4 扩展 AccountStore：添加 GetByShopID 方法（查询店铺所有账号）
• 2.5 扩展 AccountStore：添加 BulkUpdateStatus 方法（批量更新状态）
• 2.6 扩展 AccountStore：添加 ListByShopID 方法（分页查询店铺账号）

3. Service 层实现

• 3.1 创建 ShopService：实现 List 方法（分页查询，返回完整信息）
• 3.2 创建 ShopService：实现 Create 方法（创建店铺 + 自动创建初始账号）
• 3.3 创建 ShopService：实现 Update 方法（更新店铺信息，不更新密码）
• 3.4 创建 ShopService：实现 Delete 方法（软删除 + 禁用所有账号）
• 3.5 创建 ShopAccountService：实现 List 方法（按店铺ID分页查询）
• 3.6 创建 ShopAccountService：实现 Create 方法（创建账号，用户类型=3）
• 3.7 创建 ShopAccountService：实现 Update 方法（更新账号信息，不更新密码）
• 3.8 创建 ShopAccountService：实现 UpdatePassword 方法（管理员重置密码）
• 3.9 创建 ShopAccountService：实现 UpdateStatus 方法（启用/禁用账号）

4. Handler 层实现

• 4.1 创建 ShopHandler：实现 List 接口（GET /api/admin/shops）
• 4.2 创建 ShopHandler：实现 Create 接口（POST /api/admin/shops）
• 4.3 创建 ShopHandler：实现 Update 接口（PUT /api/admin/shops/:id）
• 4.4 创建 ShopHandler：实现 Delete 接口（DELETE /api/admin/shops/:id）
• 4.5 创建 ShopAccountHandler：实现 List 接口（GET /api/admin/shop-accounts）
• 4.6 创建 ShopAccountHandler：实现 Create 接口（POST /api/admin/shop-accounts）
• 4.7 创建 ShopAccountHandler：实现 Update 接口（PUT /api/admin/shop-accounts/:id）
• 4.8 创建 ShopAccountHandler：实现 UpdatePassword 接口（PUT /api/admin/shop-accounts/:id/password）
• 4.9 创建 ShopAccountHandler：实现 UpdateStatus 接口（PUT /api/admin/shop-accounts/:id/status）

5. 组件注册

• 5.1 在 internal/bootstrap/stores.go 中注册 Store
• 5.2 在 internal/bootstrap/services.go 中注册 Service
• 5.3 在 internal/bootstrap/handlers.go 中注册 Handler
• 5.4 在路由中注册所有 API 端点

6. 测试实现

• 6.1 编写 ShopService 单元测试（覆盖率 72.5%，8个测试套件，23个子测试）
• 6.2 编写 ShopAccountService 单元测试（覆盖率 79.8%，5个测试套件，14个子测试）
• 6.3 编写店铺管理集成测试（完整流程）
• 6.4 编写店铺账号管理集成测试（完整流程）
• 6.5 编写关联关系测试（删除店铺 → 验证账号被禁用）

7. 文档和部署

• 7.1 更新 README.md：添加功能模块说明
• 7.2 创建 docs/shop-management/使用指南.md（已完成，9.7KB）
• 7.3 创建 docs/shop-management/API文档.md（已完成，16.5KB）
• 7.4 验证所有功能正常工作
• 7.5 运行 openspec validate add-shop-account-management --strict（验证通过 ✅）

验收标准

1. ✅ 所有 API 端点可正常访问并返回正确格式
2. ✅ 店铺创建时自动创建初始账号（代码已实现）
3. ✅ 店铺删除时所有账号被禁用（代码已实现）
4. ✅ 账号编辑时不能修改密码和手机号（代码已实现）
5. ✅ 数据权限过滤正确工作（依赖现有GORM callback机制）
6. ✅ 单元测试覆盖率达标（ShopService: 72.5%, ShopAccountService: 79.8%, 平均76.2%）
7. ✅ 所有单元测试通过（13个测试套件，37个子测试，100%通过率）
8. ✅ 集成测试基本通过（主要功能验证完成）
9. ✅ 使用指南和API文档已完成（docs/shop-management/）
10. ✅ OpenSpec 验证通过（strict 模式）