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模式）

cmd/api/docs.go

@@ -6,6 +6,7 @@ import (
 
 	"github.com/break/junhong_cmp_fiber/internal/bootstrap"
 	"github.com/break/junhong_cmp_fiber/internal/handler/admin"
+	"github.com/break/junhong_cmp_fiber/internal/handler/h5"
 	"github.com/break/junhong_cmp_fiber/internal/routes"
 	"github.com/break/junhong_cmp_fiber/pkg/openapi"
 )
@@ -16,27 +17,39 @@ import (
 // 生成失败时记录错误但不影响程序继续运行
 func generateOpenAPIDocs(outputPath string, logger *zap.Logger) {
 	// 1. 创建生成器
-	adminDoc := openapi.NewGenerator("Admin API", "1.0")
+	adminDoc := openapi.NewGenerator("君鸿卡管系统 API", "1.0.0")
 
 	// 2. 创建临时 Fiber App 用于路由注册
 	app := fiber.New()
 
 	// 3. 创建 Handler（使用 nil 依赖,因为只需要路由结构）
+	adminAuthHandler := admin.NewAuthHandler(nil, nil)
+	h5AuthHandler := h5.NewAuthHandler(nil, nil)
 	accHandler := admin.NewAccountHandler(nil)
 	roleHandler := admin.NewRoleHandler(nil)
 	permHandler := admin.NewPermissionHandler(nil)
+	shopHandler := admin.NewShopHandler(nil)
+	shopAccHandler := admin.NewShopAccountHandler(nil)
 
 	handlers := &bootstrap.Handlers{
-		Account:    accHandler,
-		Role:       roleHandler,
-		Permission: permHandler,
+		AdminAuth:   adminAuthHandler,
+		H5Auth:      h5AuthHandler,
+		Account:     accHandler,
+		Role:        roleHandler,
+		Permission:  permHandler,
+		Shop:        shopHandler,
+		ShopAccount: shopAccHandler,
 	}
 
-	// 4. 注册路由到文档生成器
+	// 4. 注册后台路由到文档生成器
 	adminGroup := app.Group("/api/admin")
-	routes.RegisterAdminRoutes(adminGroup, handlers, adminDoc, "/api/admin")
+	routes.RegisterAdminRoutes(adminGroup, handlers, &bootstrap.Middlewares{}, adminDoc, "/api/admin")
 
-	// 5. 保存规范到指定路径
+	// 5. 注册 H5 路由到文档生成器
+	h5Group := app.Group("/api/h5")
+	routes.RegisterH5Routes(h5Group, handlers, &bootstrap.Middlewares{}, adminDoc, "/api/h5")
+
+	// 6. 保存规范到指定路径
 	if err := adminDoc.Save(outputPath); err != nil {
 		logger.Error("生成 OpenAPI 文档失败", zap.String("path", outputPath), zap.Error(err))
 		return