feat(plugin): timeseries 聚合 API — date_trunc 时间序列

crates/erp-plugin/src/handler/data_handler.rs

@@ -9,7 +9,8 @@ use erp_core::types::{ApiResponse, PaginatedResponse, TenantContext};
 
 use crate::data_dto::{
     AggregateItem, AggregateQueryParams, BatchActionReq, CountQueryParams, CreatePluginDataReq,
-    PatchPluginDataReq, PluginDataListParams, PluginDataResp, UpdatePluginDataReq,
+    PatchPluginDataReq, PluginDataListParams, PluginDataResp, TimeseriesItem, TimeseriesParams,
+    UpdatePluginDataReq,
 };
 use crate::data_service::{PluginDataService, resolve_manifest_id};
 use crate::state::PluginState;
@@ -457,3 +458,43 @@ where
 
     Ok(Json(ApiResponse::ok(items)))
 }
+
+#[utoipa::path(
+    get,
+    path = "/api/v1/plugins/{plugin_id}/{entity}/timeseries",
+    params(TimeseriesParams),
+    responses(
+        (status = 200, description = "时间序列数据", body = ApiResponse<Vec<TimeseriesItem>>),
+    ),
+    security(("bearer_auth" = [])),
+    tag = "插件数据"
+)]
+/// GET /api/v1/plugins/{plugin_id}/{entity}/timeseries — 时间序列聚合
+pub async fn get_plugin_timeseries<S>(
+    State(state): State<PluginState>,
+    Extension(ctx): Extension<TenantContext>,
+    Path((plugin_id, entity)): Path<(Uuid, String)>,
+    Query(params): Query<TimeseriesParams>,
+) -> Result<Json<ApiResponse<Vec<TimeseriesItem>>>, AppError>
+where
+    PluginState: FromRef<S>,
+    S: Clone + Send + Sync + 'static,
+{
+    let manifest_id = resolve_manifest_id(plugin_id, ctx.tenant_id, &state.db).await?;
+    let fine_perm = compute_permission_code(&manifest_id, &entity, "list");
+    require_permission(&ctx, &fine_perm)?;
+
+    let result = PluginDataService::timeseries(
+        plugin_id,
+        &entity,
+        ctx.tenant_id,
+        &state.db,
+        &params.time_field,
+        &params.time_grain,
+        params.start,
+        params.end,
+    )
+    .await?;
+
+    Ok(Json(ApiResponse::ok(result)))
+}