new

internal/infrastructure/http/handlers/api_handler.go

@@ -468,6 +468,77 @@ func (h *ApiHandler) GetAdminApiCalls(c *gin.Context) {
 	h.responseBuilder.Success(c, result, "获取API调用记录成功")
 }
 
+// ExportAdminApiCalls 导出管理端API调用记录
+// @Summary 导出管理端API调用记录
+// @Description 管理员导出API调用记录，支持Excel和CSV格式
+// @Tags API调用管理
+// @Accept json
+// @Produce application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,text/csv
+// @Security Bearer
+// @Param user_ids query string false "用户ID列表，逗号分隔"
+// @Param product_ids query string false "产品ID列表，逗号分隔"
+// @Param start_time query string false "开始时间" format(date-time)
+// @Param end_time query string false "结束时间" format(date-time)
+// @Param format query string false "导出格式" Enums(excel, csv) default(excel)
+// @Success 200 {file} file "导出文件"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未认证"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/admin/api-calls/export [get]
+func (h *ApiHandler) ExportAdminApiCalls(c *gin.Context) {
+	// 解析查询参数
+	filters := make(map[string]interface{})
+
+	// 用户ID筛选
+	if userIds := c.Query("user_ids"); userIds != "" {
+		filters["user_ids"] = userIds
+	}
+
+	// 产品ID筛选
+	if productIds := c.Query("product_ids"); productIds != "" {
+		filters["product_ids"] = productIds
+	}
+
+	// 时间范围筛选
+	if startTime := c.Query("start_time"); startTime != "" {
+		if t, err := time.Parse("2006-01-02 15:04:05", startTime); err == nil {
+			filters["start_time"] = t
+		}
+	}
+	if endTime := c.Query("end_time"); endTime != "" {
+		if t, err := time.Parse("2006-01-02 15:04:05", endTime); err == nil {
+			filters["end_time"] = t
+		}
+	}
+
+	// 获取导出格式，默认为excel
+	format := c.DefaultQuery("format", "excel")
+	if format != "excel" && format != "csv" {
+		h.responseBuilder.BadRequest(c, "不支持的导出格式")
+		return
+	}
+
+	// 调用应用服务导出数据
+	fileData, err := h.appService.ExportAdminApiCalls(c.Request.Context(), filters, format)
+	if err != nil {
+		h.logger.Error("导出API调用记录失败", zap.Error(err))
+		h.responseBuilder.BadRequest(c, "导出API调用记录失败")
+		return
+	}
+
+	// 设置响应头
+	contentType := "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
+	filename := "API调用记录.xlsx"
+	if format == "csv" {
+		contentType = "text/csv;charset=utf-8"
+		filename = "API调用记录.csv"
+	}
+
+	c.Header("Content-Type", contentType)
+	c.Header("Content-Disposition", "attachment; filename="+filename)
+	c.Data(200, contentType, fileData)
+}
+
 // getIntQuery 获取整数查询参数
 func (h *ApiHandler) getIntQuery(c *gin.Context, key string, defaultValue int) int {
 	if value := c.Query(key); value != "" {
@@ -477,3 +548,116 @@ func (h *ApiHandler) getIntQuery(c *gin.Context, key string, defaultValue int) i
 	}
 	return defaultValue
 }
+
+// GetUserBalanceAlertSettings 获取用户余额预警设置
+// @Summary 获取用户余额预警设置
+// @Description 获取当前用户的余额预警配置
+// @Tags 用户设置
+// @Accept json
+// @Produce json
+// @Success 200 {object} map[string]interface{} "获取成功"
+// @Failure 401 {object} map[string]interface{} "未授权"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/user/balance-alert/settings [get]
+func (h *ApiHandler) GetUserBalanceAlertSettings(c *gin.Context) {
+	userID := c.GetString("user_id")
+	if userID == "" {
+		h.responseBuilder.Unauthorized(c, "用户未登录")
+		return
+	}
+
+	settings, err := h.appService.GetUserBalanceAlertSettings(c.Request.Context(), userID)
+	if err != nil {
+		h.logger.Error("获取用户余额预警设置失败",
+			zap.String("user_id", userID),
+			zap.Error(err))
+		h.responseBuilder.InternalError(c, "获取预警设置失败")
+		return
+	}
+
+	h.responseBuilder.Success(c, settings, "获取成功")
+}
+
+// UpdateUserBalanceAlertSettings 更新用户余额预警设置
+// @Summary 更新用户余额预警设置
+// @Description 更新当前用户的余额预警配置
+// @Tags 用户设置
+// @Accept json
+// @Produce json
+// @Param request body map[string]interface{} true "预警设置"
+// @Success 200 {object} map[string]interface{} "更新成功"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未授权"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/user/balance-alert/settings [put]
+func (h *ApiHandler) UpdateUserBalanceAlertSettings(c *gin.Context) {
+	userID := c.GetString("user_id")
+	if userID == "" {
+		h.responseBuilder.Unauthorized(c, "用户未登录")
+		return
+	}
+
+	var request struct {
+		Enabled    bool    `json:"enabled" binding:"required"`
+		Threshold  float64 `json:"threshold" binding:"required,min=0"`
+		AlertPhone string  `json:"alert_phone" binding:"required"`
+	}
+
+	if err := c.ShouldBindJSON(&request); err != nil {
+		h.responseBuilder.BadRequest(c, "请求参数错误: "+err.Error())
+		return
+	}
+
+	err := h.appService.UpdateUserBalanceAlertSettings(c.Request.Context(), userID, request.Enabled, request.Threshold, request.AlertPhone)
+	if err != nil {
+		h.logger.Error("更新用户余额预警设置失败",
+			zap.String("user_id", userID),
+			zap.Error(err))
+		h.responseBuilder.InternalError(c, "更新预警设置失败")
+		return
+	}
+
+	h.responseBuilder.Success(c, gin.H{}, "更新成功")
+}
+
+// TestBalanceAlertSms 测试余额预警短信
+// @Summary 测试余额预警短信
+// @Description 发送测试预警短信到指定手机号
+// @Tags 用户设置
+// @Accept json
+// @Produce json
+// @Param request body map[string]interface{} true "测试参数"
+// @Success 200 {object} map[string]interface{} "发送成功"
+// @Failure 400 {object} map[string]interface{} "请求参数错误"
+// @Failure 401 {object} map[string]interface{} "未授权"
+// @Failure 500 {object} map[string]interface{} "服务器内部错误"
+// @Router /api/v1/user/balance-alert/test-sms [post]
+func (h *ApiHandler) TestBalanceAlertSms(c *gin.Context) {
+	userID := c.GetString("user_id")
+	if userID == "" {
+		h.responseBuilder.Unauthorized(c, "用户未登录")
+		return
+	}
+
+	var request struct {
+		Phone     string  `json:"phone" binding:"required,len=11"`
+		Balance   float64 `json:"balance" binding:"required"`
+		AlertType string  `json:"alert_type" binding:"required,oneof=low_balance arrears"`
+	}
+
+	if err := c.ShouldBindJSON(&request); err != nil {
+		h.responseBuilder.BadRequest(c, "请求参数错误: "+err.Error())
+		return
+	}
+
+	err := h.appService.TestBalanceAlertSms(c.Request.Context(), userID, request.Phone, request.Balance, request.AlertType)
+	if err != nil {
+		h.logger.Error("发送测试预警短信失败",
+			zap.String("user_id", userID),
+			zap.Error(err))
+		h.responseBuilder.InternalError(c, "发送测试短信失败")
+		return
+	}
+
+	h.responseBuilder.Success(c, gin.H{}, "测试短信发送成功")
+}