From 8f3d4ce067d4b39b05849f086188af6ce5d564b3 Mon Sep 17 00:00:00 2001
From: wanshenmean <cathay_xy@163.com>
Date: 星期一, 30 三月 2026 11:05:27 +0800
Subject: [PATCH] docs: 添加首页仪表盘图表功能设计
---
Code/WMS/docs/superpowers/specs/2026-03-30-dashboard-chart-design.md | 204 +++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 204 insertions(+), 0 deletions(-)
diff --git a/Code/WMS/docs/superpowers/specs/2026-03-30-dashboard-chart-design.md b/Code/WMS/docs/superpowers/specs/2026-03-30-dashboard-chart-design.md
new file mode 100644
index 0000000..7e62974
--- /dev/null
+++ b/Code/WMS/docs/superpowers/specs/2026-03-30-dashboard-chart-design.md
@@ -0,0 +1,204 @@
+# 棣栭〉浠〃鐩樺浘琛ㄥ姛鑳借璁�
+
+## 1. 姒傝堪
+
+鍦� WMS 鍓嶇棣栭〉娣诲姞浠〃鐩樺浘琛紝灞曠ず浠撳簱鐨勫嚭鍏ュ簱缁熻鍜屽簱瀛樻暟鎹�傛暟鎹熀浜庝换鍔″畬鎴愭椂闂达紙TaskInfo.ActualEndTime锛夎繘琛岀粺璁°��
+
+## 2. 椤甸潰甯冨眬
+
+閲囩敤娣峰悎甯冨眬锛氶《閮ㄥぇ鍥惧睍绀鸿秼鍔匡紝涓嬫柟缃戞牸灞曠ず瀵规瘮鍜岃鎯呫��
+
+```
+鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹� 鏈湀鍑哄叆搴撹秼鍔匡紙鎶樼嚎+鏌辩姸缁勫悎鍥撅級 鈹�
+鈹溾攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹� 浠婃棩鍑哄叆搴撳姣� 鈹� 鏈懆鍑哄叆搴撳姣� 鈹�
+鈹� 锛堟煴鐘跺浘锛� 鈹� 锛堟煴鐘跺浘锛� 鈹�
+鈹溾攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹尖攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹� 鏈湀鍑哄叆搴撳姣� 鈹� 褰撳墠搴撳瓨鎬婚噺 鈹�
+鈹� 锛堟煴鐘跺浘锛� 鈹� 锛堟暟瀛楀崱鐗囷級 鈹�
+鈹溾攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹尖攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹� 搴撳瓨搴撻緞鍒嗗竷 鈹� 鍚勪粨搴撳簱瀛樺垎甯� 鈹�
+鈹� 锛堟煴鐘跺浘锛� 鈹� 锛堟煴鐘跺浘锛� 鈹�
+鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹粹攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+```
+
+## 3. 鍚庣鎺ュ彛璁捐
+
+### 3.1 鎬昏鎺ュ彛
+
+**GET** `/api/Dashboard/Overview`
+
+杩斿洖棣栭〉鍔犺浇鏃堕渶瑕佺殑鎵�鏈夋眹鎬绘暟瀛楋紝涓�娆¤皟鐢ㄨ幏鍙栧叧閿寚鏍囥��
+
+**鍝嶅簲鏁版嵁锛�**
+```json
+{
+ "Status": true,
+ "Data": {
+ "TodayInbound": 120,
+ "TodayOutbound": 95,
+ "MonthInbound": 3500,
+ "MonthOutbound": 3200,
+ "TotalStock": 45000
+ }
+}
+```
+
+### 3.2 姣忔棩缁熻鎺ュ彛
+
+**GET** `/api/Dashboard/DailyStats?days=30`
+
+杩斿洖杩慛澶╃殑姣忔棩鍑哄叆搴撶粺璁°��
+
+**鍝嶅簲鏁版嵁锛�**
+```json
+{
+ "Status": true,
+ "Data": [
+ { "Date": "2026-03-01", "Inbound": 120, "Outbound": 95 },
+ { "Date": "2026-03-02", "Inbound": 150, "Outbound": 130 },
+ ...
+ ]
+}
+```
+
+### 3.3 姣忓懆缁熻鎺ュ彛
+
+**GET** `/api/Dashboard/WeeklyStats?weeks=12`
+
+杩斿洖杩慛鍛ㄧ殑姣忓懆鍑哄叆搴撶粺璁°��
+
+**鍝嶅簲鏁版嵁锛�**
+```json
+{
+ "Status": true,
+ "Data": [
+ { "Week": "2026-W09", "Inbound": 850, "Outbound": 780 },
+ { "Week": "2026-W10", "Inbound": 920, "Outbound": 870 },
+ ...
+ ]
+}
+```
+
+### 3.4 姣忔湀缁熻鎺ュ彛
+
+**GET** `/api/Dashboard/MonthlyStats?months=12`
+
+杩斿洖杩慛鏈堢殑姣忔湀鍑哄叆搴撶粺璁°��
+
+**鍝嶅簲鏁版嵁锛�**
+```json
+{
+ "Status": true,
+ "Data": [
+ { "Month": "2025-04", "Inbound": 3500, "Outbound": 3200 },
+ { "Month": "2025-05", "Inbound": 3800, "Outbound": 3600 },
+ ...
+ ]
+}
+```
+
+### 3.5 搴撳瓨搴撻緞鍒嗗竷鎺ュ彛
+
+**GET** `/api/Dashboard/StockAgeDistribution`
+
+杩斿洖搴撳瓨搴撻緞鍒嗗竷鏁版嵁銆�
+
+**鍝嶅簲鏁版嵁锛�**
+```json
+{
+ "Status": true,
+ "Data": [
+ { "Range": "7澶╁唴", "Count": 12000 },
+ { "Range": "7-30澶�", "Count": 18000 },
+ { "Range": "30-90澶�", "Count": 10000 },
+ { "Range": "90澶╀互涓�", "Count": 5000 }
+ ]
+}
+```
+
+### 3.6 鍚勪粨搴撳簱瀛樺垎甯冩帴鍙�
+
+**GET** `/api/Dashboard/StockByWarehouse`
+
+杩斿洖鍚勪粨搴撶殑搴撳瓨鏁伴噺鍒嗗竷銆�
+
+**鍝嶅簲鏁版嵁锛�**
+```json
+{
+ "Status": true,
+ "Data": [
+ { "Warehouse": "浠撳簱A", "Count": 15000 },
+ { "Warehouse": "浠撳簱B", "Count": 12000 },
+ { "Warehouse": "浠撳簱C", "Count": 18000 }
+ ]
+}
+```
+
+## 4. 鎶�鏈疄鐜�
+
+### 4.1 鍚庣瀹炵幇
+
+**鏂板鏂囦欢锛�**
+- `WIDESEA_WMSServer/Controllers/Dashboard/DashboardController.cs` - 浠〃鐩樻帶鍒跺櫒
+
+**鏁版嵁鏉ユ簮锛�**
+- `TaskInfo` 琛細`ActualEndTime` 瀛楁鍒ゆ柇浠诲姟瀹屾垚鏃堕棿
+- `TaskType`锛�1=鍏ュ簱浠诲姟锛�2=鍑哄簱浠诲姟
+- `StockInfo` 琛細褰撳墠搴撳瓨鏁版嵁锛宍CreateTime` 浣滀负鍏ュ簱鏃堕棿璁＄畻搴撻緞
+
+**缁熻鏁版嵁閫昏緫锛�**
+- 鎸� `ActualEndTime` 鐨勬棩鏈�/鍛�/鏈堝垎缁勭粺璁′换鍔℃暟閲�
+- 搴撻緞 = 褰撳墠鏃堕棿 - `CreateTime`
+
+### 4.2 鍓嶇瀹炵幇
+
+**淇敼鏂囦欢锛�**
+- `WIDESEA_WMSClient/src/views/Home.vue` - 鏇挎崲涓虹┖鐧界殑棣栭〉
+
+**鍥捐〃缁勪欢锛�**
+- 澶嶇敤 `src/views/charts/bigdata.vue` 涓殑 ECharts 浣跨敤妯″紡
+- 浣跨敤 ECharts 5.0.2
+
+**椤甸潰缁撴瀯锛�**
+```
+Home.vue
+鈹溾攢鈹� 鏈湀瓒嬪娍鍥撅紙鎶樼嚎+鏌辩姸缁勫悎锛�
+鈹溾攢鈹� 浠婃棩/鏈懆/鏈湀鍑哄叆搴撳姣旓紙鏌辩姸鍥撅級
+鈹溾攢鈹� 褰撳墠搴撳瓨鎬婚噺锛堟暟瀛楀崱鐗囷級
+鈹溾攢鈹� 搴撳瓨搴撻緞鍒嗗竷锛堟煴鐘跺浘锛�
+鈹斺攢鈹� 鍚勪粨搴撳簱瀛樺垎甯冿紙鏌辩姸鍥撅級
+```
+
+**API 璋冪敤锛�**
+- 棣栭〉鍔犺浇鏃惰皟鐢� Overview 鎺ュ彛鑾峰彇姹囨�绘暟鎹�
+- 鍚勫浘琛ㄧ粍浠� mounted 鏃惰皟鐢ㄥ搴旀帴鍙ｈ幏鍙栬缁嗘暟鎹�
+
+## 5. 瀹炵幇浠诲姟
+
+### 鍚庣
+1. 鍒涘缓 DashboardController
+2. 瀹炵幇 Overview 鎺ュ彛
+3. 瀹炵幇 DailyStats 鎺ュ彛
+4. 瀹炵幇 WeeklyStats 鎺ュ彛
+5. 瀹炵幇 MonthlyStats 鎺ュ彛
+6. 瀹炵幇 StockAgeDistribution 鎺ュ彛
+7. 瀹炵幇 StockByWarehouse 鎺ュ彛
+
+### 鍓嶇
+1. 閲嶅啓 Home.vue锛屼娇鐢� ECharts 瀹炵幇浠〃鐩樺竷灞�
+2. 瀹炵幇 Overview 鎺ュ彛璋冪敤
+3. 瀹炵幇鍚勫浘琛ㄧ粍浠�
+4. 璋冩暣鍥捐〃鏍峰紡鍜屽搷搴斿紡甯冨眬
+
+## 6. 棰勮鏂囦欢鍙樻洿
+
+**鏂板锛�**
+- `WIDESEA_WMSServer/Controllers/Dashboard/DashboardController.cs`
+
+**淇敼锛�**
+- `WIDESEA_WMSClient/src/views/Home.vue`
+
+**鍙傝�冿細**
+- `WIDESEA_WMSClient/src/views/charts/bigdata.vue` - ECharts 浣跨敤绀轰緥
--
Gitblit v1.9.3