ListPendingCollections

internal/app/controller/monitor/monitor_controller.go

@@ -215,3 +215,51 @@ func (c *Controller) ListTaskExecutionLogs(ctx *gin.Context) {
 	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(data), total)
 	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取任务执行日志成功", resp, actionType, "获取任务执行日志成功", req)
 }
+
+// ListPendingCollections godoc
+// @Summary      获取待采集请求列表
+// @Description  根据提供的过滤条件，分页获取待采集请求
+// @Tags         数据监控
+// @Security     BearerAuth
+// @Produce      json
+// @Param        query query dto.ListPendingCollectionRequest true "查询参数"
+// @Success      200 {object} controller.Response{data=dto.ListPendingCollectionResponse}
+// @Router       /api/v1/monitor/pending-collections [get]
+func (c *Controller) ListPendingCollections(ctx *gin.Context) {
+	const actionType = "获取待采集请求列表"
+
+	var req dto.ListPendingCollectionRequest
+	if err := ctx.ShouldBindQuery(&req); err != nil {
+		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
+		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
+		return
+	}
+
+	opts := repository.PendingCollectionListOptions{
+		DeviceID:  req.DeviceID,
+		OrderBy:   req.OrderBy,
+		StartTime: req.StartTime,
+		EndTime:   req.EndTime,
+	}
+	if req.Status != nil {
+		status := models.PendingCollectionStatus(*req.Status)
+		opts.Status = &status
+	}
+
+	data, total, err := c.monitorService.ListPendingCollections(opts, req.Page, req.PageSize)
+	if err != nil {
+		if errors.Is(err, repository.ErrInvalidPagination) {
+			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
+			controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", req)
+			return
+		}
+
+		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
+		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取待采集请求失败: "+err.Error(), actionType, "服务层查询失败", req)
+		return
+	}
+
+	resp := dto.NewListPendingCollectionResponse(data, total, req.Page, req.PageSize)
+	c.logger.Infof("%s: 成功, 获取到 %d 条记录, 总计 %d 条", actionType, len(data), total)
+	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取待采集请求成功", resp, actionType, "获取待采集请求成功", req)
+}

internal/app/dto/monitor_dto.go

@@ -247,3 +247,56 @@ func NewListTaskExecutionLogResponse(data []models.TaskExecutionLog, total int64
 		},
 	}
 }
+
+// --- PendingCollection ---
+
+// ListPendingCollectionRequest 定义了获取待采集请求列表的请求参数
+type ListPendingCollectionRequest struct {
+	Page      int        `form:"page,default=1"`
+	PageSize  int        `form:"pageSize,default=10"`
+	DeviceID  *uint      `form:"device_id"`
+	Status    *string    `form:"status"`
+	StartTime *time.Time `form:"start_time" time_format:"rfc3339"`
+	EndTime   *time.Time `form:"end_time" time_format:"rfc3339"`
+	OrderBy   string     `form:"order_by"`
+}
+
+// PendingCollectionDTO 是用于API响应的待采集请求结构
+type PendingCollectionDTO struct {
+	CorrelationID   string                         `json:"correlation_id"`
+	DeviceID        uint                           `json:"device_id"`
+	CommandMetadata models.UintArray               `json:"command_metadata"`
+	Status          models.PendingCollectionStatus `json:"status"`
+	FulfilledAt     *time.Time                     `json:"fulfilled_at"`
+	CreatedAt       time.Time                      `json:"created_at"`
+}
+
+// ListPendingCollectionResponse 是获取待采集请求列表的响应结构
+type ListPendingCollectionResponse struct {
+	List       []PendingCollectionDTO `json:"list"`
+	Pagination PaginationDTO          `json:"pagination"`
+}
+
+// NewListPendingCollectionResponse 从模型数据创建列表响应 DTO
+func NewListPendingCollectionResponse(data []models.PendingCollection, total int64, page, pageSize int) *ListPendingCollectionResponse {
+	dtos := make([]PendingCollectionDTO, len(data))
+	for i, item := range data {
+		dtos[i] = PendingCollectionDTO{
+			CorrelationID:   item.CorrelationID,
+			DeviceID:        item.DeviceID,
+			CommandMetadata: item.CommandMetadata,
+			Status:          item.Status,
+			FulfilledAt:     item.FulfilledAt,
+			CreatedAt:       item.CreatedAt,
+		}
+	}
+
+	return &ListPendingCollectionResponse{
+		List: dtos,
+		Pagination: PaginationDTO{
+			Total:    total,
+			Page:     page,
+			PageSize: pageSize,
+		},
+	}
+}

internal/app/service/monitor_service.go

@@ -7,9 +7,10 @@ import (
 
 // MonitorService 定义了监控相关的业务逻辑服务
 type MonitorService struct {
-	sensorDataRepo       repository.SensorDataRepository
-	deviceCommandLogRepo repository.DeviceCommandLogRepository
-	executionLogRepo     repository.ExecutionLogRepository
+	sensorDataRepo        repository.SensorDataRepository
+	deviceCommandLogRepo  repository.DeviceCommandLogRepository
+	executionLogRepo      repository.ExecutionLogRepository
+	pendingCollectionRepo repository.PendingCollectionRepository
 	// 在这里可以添加其他超表模型的仓库依赖
 }
 
@@ -18,11 +19,13 @@ func NewMonitorService(
 	sensorDataRepo repository.SensorDataRepository,
 	deviceCommandLogRepo repository.DeviceCommandLogRepository,
 	executionLogRepo repository.ExecutionLogRepository,
+	pendingCollectionRepo repository.PendingCollectionRepository,
 ) *MonitorService {
 	return &MonitorService{
-		sensorDataRepo:       sensorDataRepo,
-		deviceCommandLogRepo: deviceCommandLogRepo,
-		executionLogRepo:     executionLogRepo,
+		sensorDataRepo:        sensorDataRepo,
+		deviceCommandLogRepo:  deviceCommandLogRepo,
+		executionLogRepo:      executionLogRepo,
+		pendingCollectionRepo: pendingCollectionRepo,
 	}
 }
 
@@ -45,3 +48,8 @@ func (s *MonitorService) ListPlanExecutionLogs(opts repository.PlanExecutionLogL
 func (s *MonitorService) ListTaskExecutionLogs(opts repository.TaskExecutionLogListOptions, page, pageSize int) ([]models.TaskExecutionLog, int64, error) {
 	return s.executionLogRepo.ListTaskExecutionLogs(opts, page, pageSize)
 }
+
+// ListPendingCollections 负责处理查询待采集请求列表的业务逻辑
+func (s *MonitorService) ListPendingCollections(opts repository.PendingCollectionListOptions, page, pageSize int) ([]models.PendingCollection, int64, error) {
+	return s.pendingCollectionRepo.List(opts, page, pageSize)
+}