From c200bc37b5781762bf86d6599f83c47369413303 Mon Sep 17 00:00:00 2001 From: wanshenmean <cathay_xy@163.com> Date: 星期一, 30 三月 2026 11:22:12 +0800 Subject: [PATCH] docs: 修正仪表盘设计文档中的关键错误 --- Code/WMS/docs/superpowers/specs/2026-03-30-dashboard-chart-design.md | 57 ++++++++++++++++++++++++++++++++++++++------------------- 1 files changed, 38 insertions(+), 19 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 index 7e62974..2c0983f 100644 --- 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 @@ -2,7 +2,9 @@ ## 1. 姒傝堪 -鍦� WMS 鍓嶇棣栭〉娣诲姞浠〃鐩樺浘琛紝灞曠ず浠撳簱鐨勫嚭鍏ュ簱缁熻鍜屽簱瀛樻暟鎹�傛暟鎹熀浜庝换鍔″畬鎴愭椂闂达紙TaskInfo.ActualEndTime锛夎繘琛岀粺璁°�� +鍦� WMS 鍓嶇棣栭〉娣诲姞浠〃鐩樺浘琛紝灞曠ず浠撳簱鐨勫嚭鍏ュ簱缁熻鍜屽簱瀛樻暟鎹�傛暟鎹熀浜庝换鍔″畬鎴愭椂闂磋繘琛岀粺璁°�� + +> **鏁版嵁鏉ユ簮璇存槑锛�** 宸插畬鎴愪换鍔″瓨鍌ㄥ湪鍘嗗彶琛� `Dt_Task_Hty` 涓紝浣跨敤 `InsertTime`锛堜换鍔″畬鎴愬悗绉诲叆鍘嗗彶鐨勬椂闂达級浣滀负浠诲姟瀹屾垚鏃堕棿銆� ## 2. 椤甸潰甯冨眬 @@ -10,18 +12,21 @@ ``` 鈹屸攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹� -鈹� 鏈湀鍑哄叆搴撹秼鍔匡紙鎶樼嚎+鏌辩姸缁勫悎鍥撅級 鈹� -鈹溾攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹� -鈹� 浠婃棩鍑哄叆搴撳姣� 鈹� 鏈懆鍑哄叆搴撳姣� 鈹� -鈹� 锛堟煴鐘跺浘锛� 鈹� 锛堟煴鐘跺浘锛� 鈹� -鈹溾攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹尖攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹� -鈹� 鏈湀鍑哄叆搴撳姣� 鈹� 褰撳墠搴撳瓨鎬婚噺 鈹� -鈹� 锛堟煴鐘跺浘锛� 鈹� 锛堟暟瀛楀崱鐗囷級 鈹� -鈹溾攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹尖攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹� -鈹� 搴撳瓨搴撻緞鍒嗗竷 鈹� 鍚勪粨搴撳簱瀛樺垎甯� 鈹� -鈹� 锛堟煴鐘跺浘锛� 鈹� 锛堟煴鐘跺浘锛� 鈹� -鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹粹攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹� +鈹� 鏈湀鍑哄叆搴撹秼鍔匡紙鍏ㄥ锛屾姌绾�+鏌辩姸缁勫悎锛� 鈹� +鈹溾攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹� +鈹� 浠婃棩鍑哄叆搴撳姣� 鈹� 鏈懆鍑哄叆搴撳姣� 鈹� +鈹� 锛堟煴鐘跺浘锛� 鈹� 锛堟煴鐘跺浘锛� 鈹� +鈹溾攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹尖攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹� +鈹� 鏈湀鍑哄叆搴撳姣� 鈹� 褰撳墠搴撳瓨鎬婚噺 鈹� +鈹� 锛堟煴鐘跺浘锛� 鈹� 锛堟暟瀛楀崱鐗囷級 鈹� +鈹溾攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹尖攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹� +鈹� 搴撳瓨搴撻緞鍒嗗竷 鈹� 鍚勪粨搴撳簱瀛樺垎甯� 鈹� +鈹� 锛堟煴鐘跺浘锛� 鈹� 锛堟煴鐘跺浘锛� 鈹� +鈹斺攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹粹攢鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹�鈹� ``` + +> 绗竴琛岋紙鏈湀瓒嬪娍鍥撅級锛氬叏瀹芥樉绀� +> 涓嬫柟 2x2 缃戞牸锛�4涓浘琛ㄥ潎鍖�鍒嗗竷 ## 3. 鍚庣鎺ュ彛璁捐 @@ -45,11 +50,17 @@ } ``` +> 娉細搴撳瓨鏁伴噺鍗曚綅涓�"鎵樼洏鏁�"鎴�"鐢佃姱鏁�"锛屽彇鍐充簬瀹為檯涓氬姟缁熻鍙ｅ緞銆� + ### 3.2 姣忔棩缁熻鎺ュ彛 **GET** `/api/Dashboard/DailyStats?days=30` 杩斿洖杩慛澶╃殑姣忔棩鍑哄叆搴撶粺璁°�� + +**鍙傛暟锛�** +- `days`锛氬ぉ鏁帮紝榛樿 30锛屾渶澶� 365 +- 缁熻鍩轰簬鏈嶅姟鍣ㄦ湰鍦版椂闂达紝褰撴棩鏁版嵁鍖呭惈褰撴棩缁熻 **鍝嶅簲鏁版嵁锛�** ```json @@ -67,7 +78,10 @@ **GET** `/api/Dashboard/WeeklyStats?weeks=12` -杩斿洖杩慛鍛ㄧ殑姣忓懆鍑哄叆搴撶粺璁°�� +杩斿洖杩慛鍛ㄧ殑姣忓懆鍑哄叆搴撶粺璁°�傚懆浠庡懆涓�寮�濮嬭绠椼�� + +**鍙傛暟锛�** +- `weeks`锛氬懆鏁帮紝榛樿 12 **鍝嶅簲鏁版嵁锛�** ```json @@ -86,6 +100,9 @@ **GET** `/api/Dashboard/MonthlyStats?months=12` 杩斿洖杩慛鏈堢殑姣忔湀鍑哄叆搴撶粺璁°�� + +**鍙傛暟锛�** +- `months`锛氭湀鏁帮紝榛樿 12 **鍝嶅簲鏁版嵁锛�** ```json @@ -144,18 +161,20 @@ - `WIDESEA_WMSServer/Controllers/Dashboard/DashboardController.cs` - 浠〃鐩樻帶鍒跺櫒 **鏁版嵁鏉ユ簮锛�** -- `TaskInfo` 琛細`ActualEndTime` 瀛楁鍒ゆ柇浠诲姟瀹屾垚鏃堕棿 -- `TaskType`锛�1=鍏ュ簱浠诲姟锛�2=鍑哄簱浠诲姟 -- `StockInfo` 琛細褰撳墠搴撳瓨鏁版嵁锛宍CreateTime` 浣滀负鍏ュ簱鏃堕棿璁＄畻搴撻緞 +- `Dt_Task_Hty` 琛細宸插畬鎴愪换鍔＄殑鍘嗗彶琛紝浣跨敤 `InsertTime` 浣滀负浠诲姟瀹屾垚鏃堕棿 +- `TaskTypeEnum` 鏋氫妇锛氬叆搴撲换鍔¤寖鍥� 500-600锛堝 `Inbound=510`锛夛紝鍑哄簱浠诲姟鑼冨洿 100-200锛堝 `Outbound=100`锛� +- `Dt_StockInfo` 琛細褰撳墠搴撳瓨鏁版嵁锛屼娇鐢� `CreateDate` 浣滀负鍏ュ簱鏃堕棿璁＄畻搴撻緞 **缁熻鏁版嵁閫昏緫锛�** -- 鎸� `ActualEndTime` 鐨勬棩鏈�/鍛�/鏈堝垎缁勭粺璁′换鍔℃暟閲� -- 搴撻緞 = 褰撳墠鏃堕棿 - `CreateTime` +- 鎸� `InsertTime` 鐨勬棩鏈�/鍛�/鏈堝垎缁勭粺璁′换鍔℃暟閲� +- 鍏ュ簱鍒ゆ柇锛歚TaskType >= 500 && TaskType < 700` +- 鍑哄簱鍒ゆ柇锛歚TaskType >= 100 && TaskType < 300` +- 搴撻緞 = 褰撳墠鏃堕棿 - `CreateDate` ### 4.2 鍓嶇瀹炵幇 **淇敼鏂囦欢锛�** -- `WIDESEA_WMSClient/src/views/Home.vue` - 鏇挎崲涓虹┖鐧界殑棣栭〉 +- `WIDESEA_WMSClient/src/views/Home.vue` - 閲嶅啓涓虹┖鐧界殑棣栭〉锛屾坊鍔犱华琛ㄧ洏鍥捐〃 **鍥捐〃缁勪欢锛�** - 澶嶇敤 `src/views/charts/bigdata.vue` 涓殑 ECharts 浣跨敤妯″紡 -- Gitblit v1.9.3