From 922d7aa03200fa293bbce565d43c58995ec58548 Mon Sep 17 00:00:00 2001
From: mitao <2763622819@qq.com>
Date: 星期五, 17 一月 2025 19:27:02 +0800
Subject: [PATCH] 添加接口备注

---
 land-admin/src/main/java/com/zzg/web/controller/state/StateDataCenterController.java |   46 ++++++++++++++++++++++++++++------------------
 1 files changed, 28 insertions(+), 18 deletions(-)

diff --git a/land-admin/src/main/java/com/zzg/web/controller/state/StateDataCenterController.java b/land-admin/src/main/java/com/zzg/web/controller/state/StateDataCenterController.java
index 39e2a3f..9d5b46f 100644
--- a/land-admin/src/main/java/com/zzg/web/controller/state/StateDataCenterController.java
+++ b/land-admin/src/main/java/com/zzg/web/controller/state/StateDataCenterController.java
@@ -20,23 +20,26 @@
 public class StateDataCenterController {
 
     private final StateDateCenterService dateCenterService;
-
+    // 计算最上面顶部统计数据
     @GetMapping(UrlConstants.STATE_DATA_CENTER_SUM)
-    public AjaxResult<ProjectAnalysisSumVO> dataCenterSum(@RequestParam(required = false) String location,
-                                                          @RequestParam(required = false) Integer projectStatus,
-                                                          @RequestParam(required = false)
-                                                          @DateTimeFormat(pattern = "yyyy-MM-dd") Date projectStartTime) {
+    public AjaxResult<ProjectAnalysisSumVO> dataCenterSum(
+            @RequestParam(required = false) String location,
+            @RequestParam(required = false) Integer projectStatus,
+            @RequestParam(required = false)
+            @DateTimeFormat(pattern = "yyyy-MM-dd") Date projectStartTime
+    ) {
         return AjaxResult.success(dateCenterService.projectSumCount(location, projectStatus, projectStartTime));
     }
-
+    // 项目统计-模拟征收超期项目
     @PostMapping(UrlConstants.STATE_DATA_CENTER_SUM_EXPIRED)
     public AjaxResult<PageInfo<ProjectStatusExpiredVO>> sumExpiredAgreement(@RequestBody(required = false) ProjectStatisticsBO statisticsBO) {
         return AjaxResult.success(dateCenterService.expiredProjectStatus(statisticsBO));
     }
 
-    //安置情况
+    // 安置情况 获取数据中心安置情况模块 中间的饼图
     @GetMapping(UrlConstants.STATE_DATA_CENTER_PLACEMENT_STATISTICS)
-    public AjaxResult<PlacementStatisticsVO> stateDataCenterPlacementStatistics(
+    public AjaxResult<PlacementStatisticsVO> stateDataCenterPlacementStatistics
+    (
             @RequestParam(required = false) String projectStreet,
             @RequestParam(required = false) @DateTimeFormat(pattern = "yyyy-MM-dd") Date projectStartTime,
             @RequestParam(required = false)  Integer type
@@ -44,29 +47,36 @@
     ) {
         return AjaxResult.success(dateCenterService.placementStatistics(projectStreet, projectStartTime,type));
     }
-
+    // 数据中心-安置情况柱状图
     @GetMapping(UrlConstants.STATE_DATA_CENTER_PLACEMENT_STATISTICS_STREET)
     public AjaxResult<PlacementStreetVO> stateDataCenterPlacementStatisticsStreet(
             @RequestParam(required = false) String projectStreet,
-            @RequestParam(required = false) @DateTimeFormat(pattern = "yyyy-MM-dd") Date projectStartTime) {
+            @RequestParam(required = false) @DateTimeFormat(pattern = "yyyy-MM-dd") Date projectStartTime
+    ) {
         return AjaxResult.success(dateCenterService.sumPlacementStreet(projectStreet, projectStartTime));
     }
-
+   // 获取数据中心安置情况模块 下方的分页查询
     @PostMapping(UrlConstants.STATE_DATA_CENTER_PLACEMENT_STATISTICS_PAGE)
-    public AjaxResult<PageInfo<TransitionPageVO>> stateDataCenterPlacementStatisticsPage(@RequestBody PlacementStatisticsBO placementStatisticsBO) throws ParseException {
+    public AjaxResult<PageInfo<TransitionPageVO>> stateDataCenterPlacementStatisticsPage(
+            @RequestBody PlacementStatisticsBO placementStatisticsBO
+    ) throws ParseException {
         return AjaxResult.success(dateCenterService.placementStatisticsPage(placementStatisticsBO));
     }
 
-    //项目资金
+    //项目资金 数据中心-项目资产统计 左侧数据
     @GetMapping(UrlConstants.STATE_DATA_CENTER_ASSET_SUM_MONEY)
-    public AjaxResult<AssetMoneyVO> stateCenterAssetSumMoney(@RequestParam(required = false)
-                                                             @DateTimeFormat(pattern = "yyyy-MM-dd") Date projectStartTime) {
+    public AjaxResult<AssetMoneyVO> stateCenterAssetSumMoney(
+            @RequestParam(required = false)
+            @DateTimeFormat(pattern = "yyyy-MM-dd") Date projectStartTime
+    ) {
         return AjaxResult.success(dateCenterService.sumAssetMoney(projectStartTime));
     }
-
+    // 数据中心-项目资产统计 右侧柱状图
     @GetMapping(UrlConstants.STATE_DATA_CENTER_ASSET_SUM_MONEY_GRAPH)
-    public AjaxResult<List<AssetGraphVO>> stateCenterAssetSumGraph(@RequestParam(required = false)
-                                                                   @DateTimeFormat(pattern = "yyyy-MM-dd") Date projectStartTime) {
+    public AjaxResult<List<AssetGraphVO>> stateCenterAssetSumGraph(
+            @RequestParam(required = false)
+            @DateTimeFormat(pattern = "yyyy-MM-dd") Date projectStartTime
+    ) {
         return AjaxResult.success(dateCenterService.listAssetGraph(projectStartTime));
     }
 }

--
Gitblit v1.7.1