From 0005d58f6888dd3e4524784d1b6f103f9b1c588e Mon Sep 17 00:00:00 2001
From: wanshenmean <cathay_xy@163.com>
Date: 星期一, 30 三月 2026 18:33:22 +0800
Subject: [PATCH] 合并
---
Code/WMS/docs/superpowers/specs/2026-03-30-dashboard-chart-design.md | 223 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 223 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..5e46ed1
--- /dev/null
+++ b/Code/WMS/docs/superpowers/specs/2026-03-30-dashboard-chart-design.md
@@ -0,0 +1,223 @@
+# 棣栭〉浠〃鐩樺浘琛ㄥ姛鑳借璁�
+
+## 1. 姒傝堪
+
+鍦� WMS 鍓嶇棣栭〉娣诲姞浠〃鐩樺浘琛紝灞曠ず浠撳簱鐨勫嚭鍏ュ簱缁熻鍜屽簱瀛樻暟鎹�傛暟鎹熀浜庝换鍔″畬鎴愭椂闂磋繘琛岀粺璁°��
+
+> **鏁版嵁鏉ユ簮璇存槑锛�** 宸插畬鎴愪换鍔″瓨鍌ㄥ湪鍘嗗彶琛� `Dt_Task_Hty` 涓紝浣跨敤 `InsertTime`锛堜换鍔″畬鎴愬悗绉诲叆鍘嗗彶鐨勬椂闂达級浣滀负浠诲姟瀹屾垚鏃堕棿銆�
+
+## 2. 椤甸潰甯冨眬
+
+閲囩敤娣峰悎甯冨眬锛氶《閮ㄥぇ鍥惧睍绀鸿秼鍔匡紝涓嬫柟缃戞牸灞曠ず瀵规瘮鍜岃鎯呫��
+
+```
+鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹� 鏈湀鍑哄叆搴撹秼鍔匡紙鍏ㄥ锛屾姌绾�+鏌辩姸缁勫悎锛� 鈹�
+鈹溾攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹� 浠婃棩鍑哄叆搴撳姣� 鈹� 鏈懆鍑哄叆搴撳姣� 鈹�
+鈹� 锛堟煴鐘跺浘锛� 鈹� 锛堟煴鐘跺浘锛� 鈹�
+鈹溾攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹尖攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹� 鏈湀鍑哄叆搴撳姣� 鈹� 褰撳墠搴撳瓨鎬婚噺 鈹�
+鈹� 锛堟煴鐘跺浘锛� 鈹� 锛堟暟瀛楀崱鐗囷級 鈹�
+鈹溾攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹尖攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+鈹� 搴撳瓨搴撻緞鍒嗗竷 鈹� 鍚勪粨搴撳簱瀛樺垎甯� 鈹�
+鈹� 锛堟煴鐘跺浘锛� 鈹� 锛堟煴鐘跺浘锛� 鈹�
+鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹粹攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�
+```
+
+> 绗竴琛岋紙鏈湀瓒嬪娍鍥撅級锛氬叏瀹芥樉绀�
+> 涓嬫柟 2x2 缃戞牸锛�4涓浘琛ㄥ潎鍖�鍒嗗竷
+
+## 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`
+
+杩斿洖杩慛澶╃殑姣忔棩鍑哄叆搴撶粺璁°��
+
+**鍙傛暟锛�**
+- `days`锛氬ぉ鏁帮紝榛樿 30锛屾渶澶� 365
+- 缁熻鍩轰簬鏈嶅姟鍣ㄦ湰鍦版椂闂达紝褰撴棩鏁版嵁鍖呭惈褰撴棩缁熻
+
+**鍝嶅簲鏁版嵁锛�**
+```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`
+
+杩斿洖杩慛鍛ㄧ殑姣忓懆鍑哄叆搴撶粺璁°�傚懆浠庡懆涓�寮�濮嬭绠椼��
+
+**鍙傛暟锛�**
+- `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`
+
+杩斿洖杩慛鏈堢殑姣忔湀鍑哄叆搴撶粺璁°��
+
+**鍙傛暟锛�**
+- `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` - 浠〃鐩樻帶鍒跺櫒
+
+**鏁版嵁鏉ユ簮锛�**
+- `Dt_Task_Hty` 琛細宸插畬鎴愪换鍔＄殑鍘嗗彶琛紝浣跨敤 `InsertTime` 浣滀负浠诲姟瀹屾垚鏃堕棿
+- `TaskTypeEnum` 鏋氫妇锛氬叆搴撲换鍔¤寖鍥� 500-600锛堝 `Inbound=510`锛夛紝鍑哄簱浠诲姟鑼冨洿 100-200锛堝 `Outbound=100`锛�
+- `Dt_StockInfo` 琛細褰撳墠搴撳瓨鏁版嵁锛屼娇鐢� `CreateDate` 浣滀负鍏ュ簱鏃堕棿璁＄畻搴撻緞
+
+**缁熻鏁版嵁閫昏緫锛�**
+- 鎸� `InsertTime` 鐨勬棩鏈�/鍛�/鏈堝垎缁勭粺璁′换鍔℃暟閲�
+- 鍏ュ簱鍒ゆ柇锛歚TaskType >= 500 && TaskType < 600`
+- 鍑哄簱鍒ゆ柇锛歚TaskType >= 100 && TaskType < 200`
+- 搴撻緞 = 褰撳墠鏃堕棿 - `CreateDate`
+
+### 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