feat: update audit platform workspace

fastapi_modules/fastapi_leaudit/controllers/homeController.py

@@ -2,13 +2,13 @@
 
 from typing import Any
 
-from fastapi import Depends
+from fastapi import Depends, Query
 
 from fastapi_common.fastapi_common_security.security import verify_access_token
 from fastapi_common.fastapi_common_web.controller import BaseController
 from fastapi_common.fastapi_common_web.domain.responses import Result
 
-from fastapi_modules.fastapi_leaudit.domian.vo.homeVo import HomeEntryModuleVO
+from fastapi_modules.fastapi_leaudit.domian.vo.homeVo import HomeDashboardStatisticsVO, HomeEntryModuleVO
 from fastapi_modules.fastapi_leaudit.services import IHomeService
 from fastapi_modules.fastapi_leaudit.services.impl.homeServiceImpl import HomeServiceImpl
 
@@ -25,3 +25,24 @@ class HomeController(BaseController):
             """获取当前用户可见的首页入口模块。"""
             Data = await self.HomeService.GetEntryModules(UserId=int(payload["user_id"]))
             return Result.success(data=Data)
+
+        @self.router.get("/statistics/dashboard", response_model=Result[HomeDashboardStatisticsVO])
+        async def GetDashboardStatistics(
+            today: str | None = Query(None, description="统计基准日期，格式 YYYY-MM-DD"),
+            type_ids: str | None = Query(None, description="文档类型ID，逗号分隔"),
+            entry_module_id: int | None = Query(None, description="入口模块ID"),
+            payload: dict[str, Any] = Depends(verify_access_token),
+        ):
+            """获取首页统计卡片数据。"""
+            typeIds = [
+                int(item)
+                for item in str(type_ids or "").split(",")
+                if item.strip().isdigit() and int(item.strip()) > 0
+            ]
+            Data = await self.HomeService.GetDashboardStatistics(
+                UserId=int(payload["user_id"]),
+                Today=today,
+                TypeIds=typeIds,
+                EntryModuleId=entry_module_id,
+            )
+            return Result.success(data=Data)