v0.1

internal/infrastructure/http/handlers/product_admin_handler.go

@@ -1,9 +1,11 @@
 package handlers
 
 import (
+	"strconv"
 	"tyapi-server/internal/application/product"
 	"tyapi-server/internal/application/product/dto/commands"
 	"tyapi-server/internal/application/product/dto/queries"
+	"tyapi-server/internal/application/product/dto/responses"
 	"tyapi-server/internal/shared/interfaces"
 
 	"github.com/gin-gonic/gin"
@@ -84,7 +86,9 @@ func (h *ProductAdminHandler) CreateProduct(c *gin.Context) {
 // @Router /api/v1/admin/products/{id} [put]
 func (h *ProductAdminHandler) UpdateProduct(c *gin.Context) {
 	var cmd commands.UpdateProductCommand
-	if err := h.validator.ValidateParam(c, &cmd); err != nil {
+	cmd.ID = c.Param("id")
+	if cmd.ID == "" {
+		h.responseBuilder.BadRequest(c, "产品ID不能为空")
 		return
 	}
 	if err := h.validator.BindAndValidate(c, &cmd); err != nil {
@@ -254,7 +258,7 @@ func (h *ProductAdminHandler) UpdateSubscriptionPrice(c *gin.Context) {
 
 // ListProducts 获取产品列表（管理员）
 // @Summary 获取产品列表
-// @Description 管理员获取产品列表，支持筛选
+// @Description 管理员获取产品列表，支持筛选和分页
 // @Tags 产品管理
 // @Accept json
 // @Produce json
@@ -263,30 +267,76 @@ func (h *ProductAdminHandler) UpdateSubscriptionPrice(c *gin.Context) {
 // @Param page_size query int false "每页数量" default(10)
 // @Param keyword query string false "搜索关键词"
 // @Param category_id query string false "分类ID"
-// @Param status query string false "产品状态"
+// @Param is_enabled query bool false "是否启用"
+// @Param is_visible query bool false "是否可见"
+// @Param is_package query bool false "是否组合包"
+// @Param sort_by query string false "排序字段"
+// @Param sort_order query string false "排序方向" Enums(asc, desc)
 // @Success 200 {object} responses.ProductListResponse "获取产品列表成功"
 // @Failure 400 {object} map[string]interface{} "请求参数错误"
 // @Failure 401 {object} map[string]interface{} "未认证"
 // @Failure 500 {object} map[string]interface{} "服务器内部错误"
 // @Router /api/v1/admin/products [get]
 func (h *ProductAdminHandler) ListProducts(c *gin.Context) {
-	var query queries.ListProductsQuery
-	if err := h.validator.ValidateQuery(c, &query); err != nil {
-		return
+	// 解析查询参数
+	page := h.getIntQuery(c, "page", 1)
+	pageSize := h.getIntQuery(c, "page_size", 10)
+
+	// 构建筛选条件
+	filters := make(map[string]interface{})
+
+	// 搜索关键词筛选
+	if keyword := c.Query("keyword"); keyword != "" {
+		filters["keyword"] = keyword
 	}
 
-	// 设置默认值
-	if query.Page <= 0 {
-		query.Page = 1
-	}
-	if query.PageSize <= 0 {
-		query.PageSize = 10
-	}
-	if query.PageSize > 100 {
-		query.PageSize = 100
+	// 分类ID筛选
+	if categoryID := c.Query("category_id"); categoryID != "" {
+		filters["category_id"] = categoryID
 	}
 
-	result, err := h.productAppService.ListProducts(c.Request.Context(), &query)
+	// 启用状态筛选
+	if isEnabled := c.Query("is_enabled"); isEnabled != "" {
+		if enabled, err := strconv.ParseBool(isEnabled); err == nil {
+			filters["is_enabled"] = enabled
+		}
+	}
+
+	// 可见状态筛选
+	if isVisible := c.Query("is_visible"); isVisible != "" {
+		if visible, err := strconv.ParseBool(isVisible); err == nil {
+			filters["is_visible"] = visible
+		}
+	}
+
+	// 产品类型筛选
+	if isPackage := c.Query("is_package"); isPackage != "" {
+		if pkg, err := strconv.ParseBool(isPackage); err == nil {
+			filters["is_package"] = pkg
+		}
+	}
+
+	// 排序字段
+	sortBy := c.Query("sort_by")
+	if sortBy == "" {
+		sortBy = "created_at"
+	}
+
+	// 排序方向
+	sortOrder := c.Query("sort_order")
+	if sortOrder == "" {
+		sortOrder = "desc"
+	}
+
+	// 构建分页选项
+	options := interfaces.ListOptions{
+		Page:     page,
+		PageSize: pageSize,
+		Sort:     sortBy,
+		Order:    sortOrder,
+	}
+
+	result, err := h.productAppService.ListProducts(c.Request.Context(), filters, options)
 	if err != nil {
 		h.logger.Error("获取产品列表失败", zap.Error(err))
 		h.responseBuilder.InternalError(c, "获取产品列表失败")
@@ -296,6 +346,16 @@ func (h *ProductAdminHandler) ListProducts(c *gin.Context) {
 	h.responseBuilder.Success(c, result, "获取产品列表成功")
 }
 
+// getIntQuery 获取整数查询参数
+func (h *ProductAdminHandler) getIntQuery(c *gin.Context, key string, defaultValue int) int {
+	if value := c.Query(key); value != "" {
+		if intValue, err := strconv.Atoi(value); err == nil && intValue > 0 {
+			return intValue
+		}
+	}
+	return defaultValue
+}
+
 // GetProductDetail 获取产品详情（管理员）
 // @Summary 获取产品详情
 // @Description 管理员获取产品详细信息
@@ -329,6 +389,233 @@ func (h *ProductAdminHandler) GetProductDetail(c *gin.Context) {
 	h.responseBuilder.Success(c, result, "获取产品详情成功")
 }
 
+// GetAvailableProducts 获取可选子产品列表
+// @Summary 获取可选子产品列表
+// @Description 管理员获取可选作组合包子产品的产品列表
+// @Tags 产品管理
+// @Accept json
+// @Produce json
+// @Security Bearer
+// @Param exclude_package_id query string false "排除的组合包ID"
+// @Param keyword query string false "搜索关键词"
+// @Param category_id query string false "分类ID"
+// @Param page query int false "页码" default(1)
+// @Param page_size query int false "每页数量" default(20)
+// @Success 200 {object} responses.ProductListResponse "获取可选产品列表成功"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未认证"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/admin/products/available [get]
+func (h *ProductAdminHandler) GetAvailableProducts(c *gin.Context) {
+	var query queries.GetAvailableProductsQuery
+	if err := h.validator.ValidateQuery(c, &query); err != nil {
+		return
+	}
+
+	// 设置默认值
+	if query.Page <= 0 {
+		query.Page = 1
+	}
+	if query.PageSize <= 0 {
+		query.PageSize = 20
+	}
+	if query.PageSize > 100 {
+		query.PageSize = 100
+	}
+
+	result, err := h.productAppService.GetAvailableProducts(c.Request.Context(), &query)
+	if err != nil {
+		h.logger.Error("获取可选产品列表失败", zap.Error(err))
+		h.responseBuilder.InternalError(c, "获取可选产品列表失败")
+		return
+	}
+
+	h.responseBuilder.Success(c, result, "获取可选产品列表成功")
+}
+
+// AddPackageItem 添加组合包子产品
+// @Summary 添加组合包子产品
+// @Description 管理员向组合包添加子产品
+// @Tags 产品管理
+// @Accept json
+// @Produce json
+// @Security Bearer
+// @Param id path string true "组合包ID"
+// @Param command body commands.AddPackageItemCommand true "添加子产品命令"
+// @Success 200 {object} map[string]interface{} "添加成功"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未认证"
+// @Failure 404 {object} map[string]interface{} "产品不存在"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/admin/products/{id}/package-items [post]
+func (h *ProductAdminHandler) AddPackageItem(c *gin.Context) {
+	packageID := c.Param("id")
+	if packageID == "" {
+		h.responseBuilder.BadRequest(c, "组合包ID不能为空")
+		return
+	}
+
+	var cmd commands.AddPackageItemCommand
+	if err := h.validator.BindAndValidate(c, &cmd); err != nil {
+		return
+	}
+
+	err := h.productAppService.AddPackageItem(c.Request.Context(), packageID, &cmd)
+	if err != nil {
+		h.logger.Error("添加组合包子产品失败", zap.Error(err), zap.String("package_id", packageID))
+		h.responseBuilder.BadRequest(c, err.Error())
+		return
+	}
+
+	h.responseBuilder.Success(c, nil, "添加组合包子产品成功")
+}
+
+// UpdatePackageItem 更新组合包子产品
+// @Summary 更新组合包子产品
+// @Description 管理员更新组合包子产品信息
+// @Tags 产品管理
+// @Accept json
+// @Produce json
+// @Security Bearer
+// @Param id path string true "组合包ID"
+// @Param item_id path string true "子产品项目ID"
+// @Param command body commands.UpdatePackageItemCommand true "更新子产品命令"
+// @Success 200 {object} map[string]interface{} "更新成功"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未认证"
+// @Failure 404 {object} map[string]interface{} "产品不存在"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/admin/products/{id}/package-items/{item_id} [put]
+func (h *ProductAdminHandler) UpdatePackageItem(c *gin.Context) {
+	packageID := c.Param("id")
+	itemID := c.Param("item_id")
+	if packageID == "" || itemID == "" {
+		h.responseBuilder.BadRequest(c, "参数不能为空")
+		return
+	}
+
+	var cmd commands.UpdatePackageItemCommand
+	if err := h.validator.BindAndValidate(c, &cmd); err != nil {
+		return
+	}
+
+	err := h.productAppService.UpdatePackageItem(c.Request.Context(), packageID, itemID, &cmd)
+	if err != nil {
+		h.logger.Error("更新组合包子产品失败", zap.Error(err), zap.String("package_id", packageID), zap.String("item_id", itemID))
+		h.responseBuilder.BadRequest(c, err.Error())
+		return
+	}
+
+	h.responseBuilder.Success(c, nil, "更新组合包子产品成功")
+}
+
+// RemovePackageItem 移除组合包子产品
+// @Summary 移除组合包子产品
+// @Description 管理员从组合包移除子产品
+// @Tags 产品管理
+// @Accept json
+// @Produce json
+// @Security Bearer
+// @Param id path string true "组合包ID"
+// @Param item_id path string true "子产品项目ID"
+// @Success 200 {object} map[string]interface{} "移除成功"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未认证"
+// @Failure 404 {object} map[string]interface{} "产品不存在"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/admin/products/{id}/package-items/{item_id} [delete]
+func (h *ProductAdminHandler) RemovePackageItem(c *gin.Context) {
+	packageID := c.Param("id")
+	itemID := c.Param("item_id")
+	if packageID == "" || itemID == "" {
+		h.responseBuilder.BadRequest(c, "参数不能为空")
+		return
+	}
+
+	err := h.productAppService.RemovePackageItem(c.Request.Context(), packageID, itemID)
+	if err != nil {
+		h.logger.Error("移除组合包子产品失败", zap.Error(err), zap.String("package_id", packageID), zap.String("item_id", itemID))
+		h.responseBuilder.BadRequest(c, err.Error())
+		return
+	}
+
+	h.responseBuilder.Success(c, nil, "移除组合包子产品成功")
+}
+
+// ReorderPackageItems 重新排序组合包子产品
+// @Summary 重新排序组合包子产品
+// @Description 管理员重新排序组合包子产品
+// @Tags 产品管理
+// @Accept json
+// @Produce json
+// @Security Bearer
+// @Param id path string true "组合包ID"
+// @Param command body commands.ReorderPackageItemsCommand true "重新排序命令"
+// @Success 200 {object} map[string]interface{} "排序成功"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未认证"
+// @Failure 404 {object} map[string]interface{} "产品不存在"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/admin/products/{id}/package-items/reorder [put]
+func (h *ProductAdminHandler) ReorderPackageItems(c *gin.Context) {
+	packageID := c.Param("id")
+	if packageID == "" {
+		h.responseBuilder.BadRequest(c, "组合包ID不能为空")
+		return
+	}
+
+	var cmd commands.ReorderPackageItemsCommand
+	if err := h.validator.BindAndValidate(c, &cmd); err != nil {
+		return
+	}
+
+	err := h.productAppService.ReorderPackageItems(c.Request.Context(), packageID, &cmd)
+	if err != nil {
+		h.logger.Error("重新排序组合包子产品失败", zap.Error(err), zap.String("package_id", packageID))
+		h.responseBuilder.BadRequest(c, err.Error())
+		return
+	}
+
+	h.responseBuilder.Success(c, nil, "重新排序组合包子产品成功")
+}
+
+// UpdatePackageItems 批量更新组合包子产品
+// @Summary 批量更新组合包子产品
+// @Description 管理员批量更新组合包子产品配置
+// @Tags 产品管理
+// @Accept json
+// @Produce json
+// @Security Bearer
+// @Param id path string true "组合包ID"
+// @Param command body commands.UpdatePackageItemsCommand true "批量更新命令"
+// @Success 200 {object} map[string]interface{} "更新成功"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未认证"
+// @Failure 404 {object} map[string]interface{} "产品不存在"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/admin/products/{id}/package-items/batch [put]
+func (h *ProductAdminHandler) UpdatePackageItems(c *gin.Context) {
+	packageID := c.Param("id")
+	if packageID == "" {
+		h.responseBuilder.BadRequest(c, "组合包ID不能为空")
+		return
+	}
+
+	var cmd commands.UpdatePackageItemsCommand
+	if err := h.validator.BindAndValidate(c, &cmd); err != nil {
+		return
+	}
+
+	err := h.productAppService.UpdatePackageItems(c.Request.Context(), packageID, &cmd)
+	if err != nil {
+		h.logger.Error("批量更新组合包子产品失败", zap.Error(err), zap.String("package_id", packageID))
+		h.responseBuilder.BadRequest(c, err.Error())
+		return
+	}
+
+	h.responseBuilder.Success(c, nil, "批量更新组合包子产品成功")
+}
+
 // ListCategories 获取分类列表（管理员）
 // @Summary 获取分类列表
 // @Description 管理员获取产品分类列表
@@ -467,3 +754,166 @@ func (h *ProductAdminHandler) GetSubscriptionStats(c *gin.Context) {
 
 	h.responseBuilder.Success(c, result, "获取订阅统计成功")
 }
+
+// GetProductApiConfig 获取产品API配置
+// @Summary 获取产品API配置
+// @Description 管理员获取产品的API配置信息，如果不存在则返回空配置
+// @Tags 产品管理
+// @Accept json
+// @Produce json
+// @Security Bearer
+// @Param id path string true "产品ID"
+// @Success 200 {object} responses.ProductApiConfigResponse "获取API配置成功"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未认证"
+// @Failure 404 {object} map[string]interface{} "产品不存在"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/admin/products/{id}/api-config [get]
+func (h *ProductAdminHandler) GetProductApiConfig(c *gin.Context) {
+	productID := c.Param("id")
+	if productID == "" {
+		h.responseBuilder.BadRequest(c, "产品ID不能为空")
+		return
+	}
+
+	result, err := h.productAppService.GetProductApiConfig(c.Request.Context(), productID)
+	if err != nil {
+		// 如果是配置不存在的错误，返回空配置而不是错误
+		if err.Error() == "record not found" || err.Error() == "产品API配置不存在" {
+			// 返回空的配置结构，让前端可以创建新配置
+			emptyConfig := &responses.ProductApiConfigResponse{
+				ID:              "",
+				ProductID:       productID,
+				RequestParams:   []responses.RequestParamResponse{},
+				ResponseFields:  []responses.ResponseFieldResponse{},
+				ResponseExample: map[string]interface{}{},
+			}
+			h.responseBuilder.Success(c, emptyConfig, "获取API配置成功")
+			return
+		}
+		
+		h.logger.Error("获取产品API配置失败", zap.Error(err), zap.String("product_id", productID))
+		h.responseBuilder.NotFound(c, "产品不存在")
+		return
+	}
+
+	h.responseBuilder.Success(c, result, "获取API配置成功")
+}
+
+// CreateProductApiConfig 创建产品API配置
+// @Summary 创建产品API配置
+// @Description 管理员为产品创建API配置
+// @Tags 产品管理
+// @Accept json
+// @Produce json
+// @Security Bearer
+// @Param id path string true "产品ID"
+// @Param request body responses.ProductApiConfigResponse true "API配置信息"
+// @Success 201 {object} map[string]interface{} "API配置创建成功"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未认证"
+// @Failure 409 {object} map[string]interface{} "API配置已存在"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/admin/products/{id}/api-config [post]
+func (h *ProductAdminHandler) CreateProductApiConfig(c *gin.Context) {
+	productID := c.Param("id")
+	if productID == "" {
+		h.responseBuilder.BadRequest(c, "产品ID不能为空")
+		return
+	}
+
+	var configResponse responses.ProductApiConfigResponse
+	if err := h.validator.BindAndValidate(c, &configResponse); err != nil {
+		return
+	}
+
+	if err := h.productAppService.CreateProductApiConfig(c.Request.Context(), productID, &configResponse); err != nil {
+		h.logger.Error("创建产品API配置失败", zap.Error(err), zap.String("product_id", productID))
+		h.responseBuilder.BadRequest(c, err.Error())
+		return
+	}
+
+	h.responseBuilder.Created(c, nil, "API配置创建成功")
+}
+
+// UpdateProductApiConfig 更新产品API配置
+// @Summary 更新产品API配置
+// @Description 管理员更新产品的API配置
+// @Tags 产品管理
+// @Accept json
+// @Produce json
+// @Security Bearer
+// @Param id path string true "产品ID"
+// @Param request body responses.ProductApiConfigResponse true "API配置信息"
+// @Success 200 {object} map[string]interface{} "API配置更新成功"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未认证"
+// @Failure 404 {object} map[string]interface{} "产品或配置不存在"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/admin/products/{id}/api-config [put]
+func (h *ProductAdminHandler) UpdateProductApiConfig(c *gin.Context) {
+	productID := c.Param("id")
+	if productID == "" {
+		h.responseBuilder.BadRequest(c, "产品ID不能为空")
+		return
+	}
+
+	var configResponse responses.ProductApiConfigResponse
+	if err := h.validator.BindAndValidate(c, &configResponse); err != nil {
+		return
+	}
+
+	// 先获取现有配置以获取配置ID
+	existingConfig, err := h.productAppService.GetProductApiConfig(c.Request.Context(), productID)
+	if err != nil {
+		h.logger.Error("获取现有API配置失败", zap.Error(err), zap.String("product_id", productID))
+		h.responseBuilder.NotFound(c, "产品API配置不存在")
+		return
+	}
+
+	if err := h.productAppService.UpdateProductApiConfig(c.Request.Context(), existingConfig.ID, &configResponse); err != nil {
+		h.logger.Error("更新产品API配置失败", zap.Error(err), zap.String("product_id", productID))
+		h.responseBuilder.BadRequest(c, err.Error())
+		return
+	}
+
+	h.responseBuilder.Success(c, nil, "API配置更新成功")
+}
+
+// DeleteProductApiConfig 删除产品API配置
+// @Summary 删除产品API配置
+// @Description 管理员删除产品的API配置
+// @Tags 产品管理
+// @Accept json
+// @Produce json
+// @Security Bearer
+// @Param id path string true "产品ID"
+// @Success 200 {object} map[string]interface{} "API配置删除成功"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未认证"
+// @Failure 404 {object} map[string]interface{} "产品或配置不存在"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/admin/products/{id}/api-config [delete]
+func (h *ProductAdminHandler) DeleteProductApiConfig(c *gin.Context) {
+	productID := c.Param("id")
+	if productID == "" {
+		h.responseBuilder.BadRequest(c, "产品ID不能为空")
+		return
+	}
+
+	// 先获取现有配置以获取配置ID
+	existingConfig, err := h.productAppService.GetProductApiConfig(c.Request.Context(), productID)
+	if err != nil {
+		h.logger.Error("获取现有API配置失败", zap.Error(err), zap.String("product_id", productID))
+		h.responseBuilder.NotFound(c, "产品API配置不存在")
+		return
+	}
+
+	if err := h.productAppService.DeleteProductApiConfig(c.Request.Context(), existingConfig.ID); err != nil {
+		h.logger.Error("删除产品API配置失败", zap.Error(err), zap.String("product_id", productID))
+		h.responseBuilder.BadRequest(c, err.Error())
+		return
+	}
+
+	h.responseBuilder.Success(c, nil, "API配置删除成功")
+}