From a7b66e3e78a1de7ea88897d4450b5f2e397f9e34 Mon Sep 17 00:00:00 2001
From: wanshenmean <cathay_xy@163.com>
Date: 星期一, 30 三月 2026 12:14:13 +0800
Subject: [PATCH] docs: 修复库存3D查看器设计文档问题
---
Code/WMS/docs/superpowers/specs/2026-03-30-stock-chat-3d-design.md | 59 ++++++++++++++++++++++++++++++++++++++++++-----------------
1 files changed, 42 insertions(+), 17 deletions(-)
diff --git a/Code/WMS/docs/superpowers/specs/2026-03-30-stock-chat-3d-design.md b/Code/WMS/docs/superpowers/specs/2026-03-30-stock-chat-3d-design.md
index b70fc23..10c8488 100644
--- a/Code/WMS/docs/superpowers/specs/2026-03-30-stock-chat-3d-design.md
+++ b/Code/WMS/docs/superpowers/specs/2026-03-30-stock-chat-3d-design.md
@@ -54,16 +54,21 @@
- 鍙充笂瑙�/搴曢儴棰滆壊鍥句緥
- 璇存槑姣忕棰滆壊浠ｈ〃鐨勮揣浣嶇姸鎬�
-### 3.2 璐т綅鐘舵�侀鑹茬紪鐮�
+### 3.2 璐т綅鐘舵�侀鑹茬紪鐮侊紙棰滆壊浼樺厛绾э細locationStatus > stockStatus锛�
-| 鐘舵�� | 棰滆壊 | Hex |
-|------|------|-----|
-| 绌鸿揣浣� | 鏆楃伆 | `#4a4a4a` |
-| 鏈夊簱瀛� | 钃濊壊 | `#409EFF` |
-| 搴撳瓨绱у紶 (<10%) | 姗欒壊 | `#E6A23C` |
-| 宸叉弧 | 缁胯壊 | `#67C23A` |
-| 閿佸畾/鍐荤粨 | 绾㈣壊 | `#F56C6C` |
-| 绂佺敤 | 娣辩伆 | `#2d2d2d` |
+**棰滆壊鍒ゅ畾瑙勫垯锛堟寜浼樺厛绾ч『搴忥級锛�**
+
+1. **`locationStatus = 3`锛堢鐢級** 鈫� 娣辩伆 `#2d2d2d`锛堟渶楂樹紭鍏堢骇锛�
+2. **`locationStatus = 2`锛堥攣瀹氾級** 鈫� 绾㈣壊 `#F56C6C`
+3. **`locationStatus = 1`锛堝崰鐢級涓� `stockStatus = 0`锛堟棤璐э級** 鈫� 鏆楃伆 `#4a4a4a`
+4. **`locationStatus = 1`锛堝崰鐢級涓� `stockStatus = 1`锛堟湁璐э級** 鈫� 钃濊壊 `#409EFF`
+5. **`locationStatus = 1`锛堝崰鐢級涓� `stockStatus = 2`锛堝簱瀛樼揣寮� <10%锛�** 鈫� 姗欒壊 `#E6A23C`
+6. **`locationStatus = 1`锛堝崰鐢級涓� `stockStatus = 3`锛堝凡婊� 鈮�90%锛�** 鈫� 缁胯壊 `#67C23A`
+7. **`locationStatus = 0`锛堢┖锛�** 鈫� 鏆楃伆 `#4a4a4a`
+
+**闃堝�煎畾涔夛細**
+- 搴撳瓨绱у紶锛歚stockQuantity / maxCapacity < 10%`
+- 宸叉弧锛歚stockQuantity / maxCapacity 鈮� 90%`
## 4. 鍚庣 API
@@ -83,6 +88,8 @@
"maxRow": 10,
"maxColumn": 20,
"maxLayer": 5,
+ "materielCodeList": ["M001", "M002", "M003"],
+ "batchNoList": ["B20260301", "B20260302"],
"locations": [
{
"locationId": 1,
@@ -103,6 +110,13 @@
}
}
```
+
+**璇存槑**锛�
+- `locationStatus`: 0=绌�, 1=鍗犵敤, 2=閿佸畾, 3=绂佺敤
+- `stockStatus`: 0=鏃犺揣, 1=鏈夎揣, 2=搴撳瓨绱у紶, 3=宸叉弧
+- `maxCapacity`: 璐т綅鏈�澶у閲忥紙鐢ㄤ簬璁＄畻濉厖鐜囷級
+- `materielCodeList`: 褰撳墠浠撳簱鎵�鏈夌墿鏂欑紪鍙峰垪琛紙鐢ㄤ簬绛涢�変笅鎷夛級
+- `batchNoList`: 褰撳墠浠撳簱鎵�鏈夋壒娆″彿鍒楄〃锛堢敤浜庣瓫閫変笅鎷夛級
**璇存槑**锛�
- `locationStatus`: 0=绌�, 1=鍗犵敤, 2=閿佸畾, 3=绂佺敤
@@ -148,8 +162,13 @@
<!-- 宸ュ叿鏍� -->
<div class="toolbar">
- <el-select v-model="filterStatus" placeholder="搴撳瓨鐘舵�佺瓫閫�" clearable />
- <el-select v-model="filterMateriel" placeholder="鐗╂枡绛涢��" clearable />
+ <el-select v-model="filterStockStatus" placeholder="搴撳瓨鐘舵�佺瓫閫�" clearable>
+ <el-option label="鏈夎揣" :value="1" />
+ <el-option label="搴撳瓨绱у紶" :value="2" />
+ <el-option label="宸叉弧" :value="3" />
+ </el-select>
+ <el-select v-model="filterMaterielCode" placeholder="鐗╂枡绛涢��" clearable :options="materielCodeList" />
+ <el-select v-model="filterBatchNo" placeholder="鎵规绛涢��" clearable :options="batchNoList" />
<el-button @click="resetCamera">閲嶇疆瑙嗚</el-button>
</div>
@@ -201,8 +220,9 @@
### 7.4 鐩告満鑱氱劍鍔ㄧ敾
-- 浣跨敤 `TWEEN` 鎴栨墜鍔ㄦ彃鍊煎钩婊戠Щ鍔ㄧ浉鏈�
+- 浣跨敤绠�鍗曠嚎鎬ф彃鍊硷紙lerp锛夊钩婊戠Щ鍔ㄧ浉鏈�
- 鐩爣浣嶇疆锛氳揣浣嶅潗鏍� + 鍋忕Щ閲�
+- 鎻掑�煎叕寮忥細`camera.position.lerp(target, 0.05)` 姣忓抚鎵ц
## 8. 鎬ц兘浼樺寲
@@ -225,9 +245,14 @@
}
```
-## 10. 寰呰ˉ鍏�
+## 10. 瀹炵幇娉ㄦ剰浜嬮」
-- [ ] 鍚庣 `Get3DLayout` API 瀹炵幇
-- [ ] SignalR Hub 閰嶇疆
-- [ ] 璐т綅棰滆壊涓庡悗绔姸鎬佹灇涓惧榻�
-- [ ] 绛涢�夊姛鑳藉叿浣撳瓧娈电‘璁�
+### 10.1 鍚庣浜や粯鐗�
+- `Get3DLayout` API 瀹炵幇锛岃繑鍥炵粨鏋勮 4.1
+- SignalR Hub 閰嶇疆锛坄/stockHub`锛夛紝鎺ㄩ�� `stockUpdated` 浜嬩欢
+- 璐т綅棰滆壊鍒ゅ畾閫昏緫鎸� 3.2 瑙勫垯鍦ㄥ悗绔垨鍓嶇瀹炵幇鍧囧彲
+
+### 10.2 鍓嶇绛涢�夎仈鍔�
+- `filterStockStatus`銆乣filterMaterielCode`銆乣filterBatchNo` 涓夎�呰仈鍔�
+- 绛涢�夌粨鏋滈珮浜樉绀猴紝闈炲尮閰嶈揣浣嶅彉鏆楋紙opacity: 0.3锛�
+- 绛涢�変负绌烘椂鏄剧ず鍏ㄩ儴璐т綅姝ｅ父棰滆壊
--
Gitblit v1.9.3