From 4528e1dff4193f528998a87550e444bff655a5c3 Mon Sep 17 00:00:00 2001
From: Junjie <DELL@qq.com>
Date: 星期二, 20 一月 2026 14:51:44 +0800
Subject: [PATCH] #
---
docs/WCS部署手册.md | 411 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
docs/WCS部署手册.pdf | 0
2 files changed, 411 insertions(+), 0 deletions(-)
diff --git "a/docs/WCS\351\203\250\347\275\262\346\211\213\345\206\214.md" "b/docs/WCS\351\203\250\347\275\262\346\211\213\345\206\214.md"
new file mode 100644
index 0000000..a63d51b
--- /dev/null
+++ "b/docs/WCS\351\203\250\347\275\262\346\211\213\345\206\214.md"
@@ -0,0 +1,411 @@
+# WCS 浠撳簱鎺у埗绯荤粺閮ㄧ讲鎵嬪唽
+
+
+
+## 绯荤粺姒傝堪
+
+鏈」鐩槸 **WCS (Warehouse Control System)** 浠撳簱鎺у埗绯荤粺锛屽熀浜� Spring Boot 2.5.14 鏋勫缓锛岀敤浜庢帶鍒跺拰鍗忚皟浠撳簱鑷姩鍖栬澶囷紝鍖呮嫭锛�
+
+* **鍫嗗灈鏈� (Crn/DualCrn)** - 璐х墿瀛樺彇璁惧
+
+* **RGV 绌挎杞�** - 杞ㄩ亾绌挎杩愯緭璁惧
+
+* **杈撻�佺珯 (Devp)** - 浼犻�佸甫杈撻�佽澶�
+
+* **鏉＄爜鎵弿浠� (Barcode)** - 璐х墿璇嗗埆璁惧
+
+### 鎶�鏈爤
+
+| 缁勪欢 | 鐗堟湰 | 璇存槑 |
+| ------------ | ------ | ------- |
+| Java | 1.8 | 杩愯鏃剁幆澧� |
+| Spring Boot | 2.5.14 | 搴旂敤妗嗘灦 |
+| MySQL | 5.7 | 涓绘暟鎹簱 |
+| Redis | 5.0+ | 缂撳瓨涓庢秷鎭槦鍒� |
+| MyBatis-Plus | 2.3.2 | ORM 妗嗘灦 |
+| Tomcat | 鍐呭祵/澶栫疆 | Web 瀹瑰櫒 |
+
+***
+
+## 鐜瑕佹眰
+
+### 纭欢瑕佹眰
+
+| 椤圭洰 | 鏈�浣庨厤缃� | 鎺ㄨ崘閰嶇疆 |
+| --- | ------ | ----------- |
+| CPU | 4 鏍� | 8 鏍�+ |
+| 鍐呭瓨 | 8 GB | 16 GB+ |
+| 纭洏 | 100 GB | 500 GB+ SSD |
+| 缃戠粶 | 鍗冨厗缃戝崱 | 鍗冨厗缃戝崱 |
+
+### 杞欢瑕佹眰
+
+| 杞欢 | 鐗堟湰 | 蹇呴渶 |
+| ------ | ----------- | ----- |
+| JDK | 1.8.x | 鉁� |
+| MySQL | 5.7+ 鎴� 8.0+ | 鉁� |
+| Redis | 5.0+ | 鉁� |
+| Maven | 3.6+ | 鉁� 鏋勫缓鏃� |
+| Tomcat | 9.x (鍙��) | 鉂� |
+
+### 缃戠粶绔彛
+
+| 绔彛 | 鐢ㄩ�� | 鍗忚 |
+| ---- | --------- | ---- |
+| 9090 | WCS 搴旂敤鏈嶅姟 | HTTP |
+| 3306 | MySQL 鏁版嵁搴� | TCP |
+| 6379 | Redis 缂撳瓨 | TCP |
+| 璁惧绔彛 | PLC/璁惧閫氫俊 | TCP |
+
+> \[!IMPORTANT]
+> 纭繚闃茬伀澧欏紑鏀句笂杩扮鍙ｏ紝涓� WCS 鏈嶅姟鍣ㄨ兘澶熻闂墍鏈夎澶囩殑 IP 鍦板潃鍜岀鍙ｃ��
+
+***
+
+## 渚濊禆瀹夎
+
+### 1. 瀹夎 JDK 1.8
+
+```bash
+# Windows - 涓嬭浇骞跺畨瑁� Oracle JDK 鎴� OpenJDK 1.8
+# 璁剧疆鐜鍙橀噺
+JAVA_HOME=C:\Program Files\Java\jdk1.8.0_xxx
+PATH=%JAVA_HOME%\bin;%PATH%
+
+# 楠岃瘉瀹夎
+java -version
+```
+
+### 2. 瀹夎 MySQL
+
+```bash
+# 瀹夎 MySQL 5.7+
+# 鍒涘缓鏁版嵁搴�
+mysql -u root -p
+CREATE DATABASE wcs CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+```
+
+### 3. 瀹夎 Redis
+
+```bash
+# Windows: 涓嬭浇 Redis for Windows
+# Linux:
+sudo apt install redis-server
+sudo systemctl enable redis-server
+sudo systemctl start redis-server
+
+# 楠岃瘉杩炴帴
+redis-cli ping
+```
+
+### 4. 瀹夎鑷畾涔夋鏋�
+
+椤圭洰渚濊禆 `cn.cool:framework:3.4.0`锛岄渶鎵嬪姩瀹夎鍒版湰鍦� Maven 浠撳簱锛�
+
+```bash
+cd version/lib
+mvn install:install-file -Dfile=framework-3.4.0.jar -DgroupId=cn.cool -DartifactId=framework -Dversion=3.4.0 -Dpackaging=jar -DgeneratePom=true
+```
+
+***
+
+## 閰嶇疆璇存槑
+
+涓婚厤缃枃浠朵綅浜� `src/main/resources/application.yml`
+
+### 鏍稿績閰嶇疆椤�
+
+```yaml
+# === 绯荤粺鐗堟湰 ===
+app:
+ version: 1.0.2.1 # 绯荤粺鐗堟湰鍙�
+ version-type: prd # prd=鐢熶骇鐜, dev=寮�鍙戠幆澧�
+
+# === 鏈嶅姟閰嶇疆 ===
+server:
+ port: 9090 # 鏈嶅姟绔彛
+ servlet:
+ context-path: /wcs # 涓婁笅鏂囪矾寰�
+ shutdown: graceful # 浼橀泤鍏抽棴
+
+# === 鏁版嵁搴撻厤缃� ===
+spring:
+ datasource:
+ driver-class-name: com.mysql.jdbc.Driver
+ url: jdbc:mysql://127.0.0.1:3306/wcs?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai
+ username: root # 淇敼涓哄疄闄呯敤鎴峰悕
+ password: root # 淇敼涓哄疄闄呭瘑鐮�
+
+# === Redis 閰嶇疆 ===
+ redis:
+ host: 127.0.0.1 # Redis 鍦板潃
+ port: 6379 # Redis 绔彛
+ database: 0 # 鏁版嵁搴撶储寮�
+ # password: 123456 # 濡傛湁瀵嗙爜锛屽彇娑堟敞閲�
+
+# === 鏃ュ織閰嶇疆 ===
+logging:
+ file:
+ path: /stock/out/wcs/logs # 鏃ュ織瀛樺偍璺緞
+
+# === Swagger API 鏂囨。 ===
+swagger:
+ enable: false # 鐢熶骇鐜寤鸿鍏抽棴
+
+# === License 閰嶇疆 ===
+license:
+ subject: crnWcsDev
+ publicAlias: publicCert
+ storePass: public_zhongyang_123456789
+ licensePath: license.lic
+ publicKeysStorePath: publicCerts.keystore
+
+# === 璁惧鏃ュ織閰嶇疆 ===
+deviceLogStorage:
+ type: file # mysql 鎴� file
+ loggingPath: /stock/out/wcs/deviceLogs
+ expireDays: 7 # 鏃ュ織淇濈暀澶╂暟
+```
+
+> \[!WARNING]
+> **鐢熶骇鐜閮ㄧ讲鍓嶅繀椤讳慨鏀癸細**
+>
+> * 鏁版嵁搴撶敤鎴峰悕鍜屽瘑鐮�
+>
+> * Redis 瀵嗙爜锛堝鏈夛級
+>
+> * `swagger.enable` 璁剧疆涓� `false`
+>
+> * `app.version-type` 璁剧疆涓� `prd`
+
+***
+
+## 鏁版嵁搴撻厤缃�
+
+### 1. 鍒涘缓鏁版嵁搴�
+
+```sql
+CREATE DATABASE wcs CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+CREATE USER 'wcs'@'%' IDENTIFIED BY 'your_password';
+GRANT ALL PRIVILEGES ON wcs.* TO 'wcs'@'%';
+FLUSH PRIVILEGES;
+```
+
+### 2. 瀵煎叆鏁版嵁搴撶粨鏋�
+
+鏁版嵁搴撳浠芥枃浠朵綅浜� `src/main/resources/sql/` 鐩綍锛�.nb3 鏍煎紡锛屼娇鐢� Navicat 瀵煎叆锛夈��
+
+### 3. 鏍稿績鏁版嵁琛�
+
+| 琛ㄥ悕 | 璇存槑 |
+| ------------------- | ------ |
+| `rcs_device_config` | 璁惧閰嶇疆琛� |
+| `sys_user` | 绯荤粺鐢ㄦ埛琛� |
+| `sys_config` | 绯荤粺閰嶇疆琛� |
+| `wrk_mast` | 宸ヤ綔浠诲姟涓昏〃 |
+| `loc_mast` | 搴撲綅涓昏〃 |
+| `bas_*` | 鍩虹鏁版嵁琛� |
+
+### 4. 璁惧閰嶇疆琛� (rcs\_device\_config)
+
+閮ㄧ讲鏃堕渶瑕佸湪 `rcs_device_config` 琛ㄤ腑閰嶇疆璁惧淇℃伅锛�
+
+| 瀛楁 | 璇存槑 | 绀轰緥 |
+| ------------- | ---------------- | -------------------- |
+| `ip` | 璁惧 IP 鍦板潃 | 192.168.1.100 |
+| `port` | 璁惧绔彛 | 502 |
+| `device_type` | 璁惧绫诲瀷 | Crn/DualCrn/Rgv/Devp |
+| `device_no` | 璁惧缂栧彿 | 1 |
+| `thread_impl` | 绾跨▼瀹炵幇绫� | ZySiemensCrnThread |
+| `fake` | 鏄惁铏氭嫙璁惧 (1=鏄�,0=鍚�) | 0 |
+
+**璁惧绫诲瀷涓庣嚎绋嬪疄鐜板鐓э細**
+
+| 璁惧绫诲瀷 | 绾跨▼瀹炵幇绫� |
+| ---------------- | ----------------------------------- |
+| Crn (鍫嗗灈鏈�) | ZySiemensCrnThread |
+| DualCrn (鍙屽伐浣嶅爢鍨涙満) | ZySiemensDualCrnThread |
+| Rgv (绌挎杞�) | ZyRgvThread |
+| Devp (杈撻�佺珯) | ZyStationThread / ZyStationV3Thread |
+
+***
+
+## 鏋勫缓涓庨儴缃�
+
+### 鏂瑰紡涓�锛歐AR 鍖呴儴缃诧紙鎺ㄨ崘鐢熶骇鐜锛�
+
+```bash
+# 1. 鏋勫缓 WAR 鍖�
+cd zy-wcs-master
+mvn clean package -DskipTests
+
+# 2. WAR 鍖呯敓鎴愪綅缃�
+target/wcs.war
+
+# 3. 閮ㄧ讲鍒� Tomcat
+cp target/wcs.war $TOMCAT_HOME/webapps/
+
+# 4. 鍚姩 Tomcat
+$TOMCAT_HOME/bin/startup.sh # Linux
+$TOMCAT_HOME/bin/startup.bat # Windows
+```
+
+### 鏂瑰紡浜岋細鍐呭祵 Tomcat 鍚姩锛堝紑鍙�/娴嬭瘯锛�
+
+```bash
+# 鐩存帴杩愯鎵撳寘鍚庣殑 WAR
+java -jar target/wcs.war
+```
+
+***
+
+## 鍚姩涓庨獙璇�
+
+### 1. 鍚姩椤哄簭
+
+```
+1. MySQL 鏁版嵁搴�
+2. Redis 鏈嶅姟
+3. WCS 搴旂敤鏈嶅姟
+```
+
+### 2. 楠岃瘉鏈嶅姟
+
+```bash
+# 妫�鏌ユ湇鍔＄鍙�
+netstat -tlnp | grep 9090
+
+# 璁块棶鍋ュ悍妫�鏌ユ帴鍙�
+curl http://localhost:9090/wcs/views/index.html
+```
+
+### 3. 璁块棶绯荤粺
+
+鎵撳紑娴忚鍣ㄨ闂細`http://<鏈嶅姟鍣↖P>:9090/wcs`
+
+***
+
+## 鏃ュ織涓庣洃鎺�
+
+### 鏃ュ織鏂囦欢浣嶇疆
+
+| 鏃ュ織绫诲瀷 | 璺緞 |
+| ---- | ------------------------------- |
+| 搴旂敤鏃ュ織 | `/stock/out/wcs/logs/info.log` |
+| 閿欒鏃ュ織 | `/stock/out/wcs/logs/error.log` |
+| 璁惧鏃ュ織 | `/stock/out/wcs/deviceLogs/` |
+
+### 鏃ュ織閰嶇疆
+
+鏃ュ織閫氳繃 `logback-spring.xml` 閰嶇疆锛�
+
+* **鏃ュ織绾у埆锛�** INFO
+
+* **鍗曟枃浠跺ぇ灏忥細** 10MB
+
+* **淇濈暀鍘嗗彶锛�** 10 澶�
+
+* **璁惧鏃ュ織杩囨湡锛�** 7 澶� (鍙湪 application.yml 涓厤缃�)
+
+***
+
+
+
+## 鍒濆鍖栬澶囬厤缃�
+
+閰嶇疆闇�瑕佺殑璁惧IP銆佺鍙ｇ瓑淇℃伅锛屽闇�浣跨敤浠跨湡锛屽垯鍚敤浠跨湡銆傝澶囬厤缃慨鏀硅繃鍚庯紝闇�瑕侀噸鍚▼搴忥紒
+
+
+
+
+
+## 瀵煎叆鍦板浘
+
+浣跨敤鏍囧噯Excel鍦板浘杩涜瀵煎叆锛屽鍏ュ畬鎴愬悗杩涜鍒濆鍖栧簱浣嶏紙杈撳叆妤煎眰锛夛紝绯荤粺浼氳嚜鍔ㄥ垵濮嬪寲搴撲綅淇℃伅
+
+
+
+
+
+
+
+## 鍫嗗灈鏈哄弬鏁拌缃�
+
+璁剧疆鍫嗗灈鏈烘帶鍒舵帓鍙枫�佹繁搴撲綅鎺掑彿锛堝崟娣卞垯璁剧疆绌烘暟缁勶級
+
+鍏ョ珯銆佸嚭绔欏弬鏁癉emo锛�
+
+stationId锛氱珯鐐圭紪鍙�
+
+deviceNo锛氱珯鐐筆LC缂栧彿
+
+deviceRow锛氬爢鍨涙満鎵ц鎺�
+
+deviceBay锛氬爢鍨涙満鎵ц鍒�
+
+deviceLev锛氬爢鍨涙満鎵ц灞�
+
+```bash
+[{"stationId":1003,"deviceNo":1,"deviceRow":1,"deviceBay":1,"deviceLev":1}]
+```
+
+
+
+娉ㄦ剰锛氬弻宸ヤ綅鍫嗗灈鏈洪厤缃浉浼�
+
+
+
+## 绔欑偣璁惧鍖哄煙缁戝畾
+
+绔欑偣涓庡爢鍨涙満杩涜鍏ュ簱鍏宠仈缁戝畾锛屽璁剧疆浜嗙粦瀹氬叧绯诲垯WCS浼氫紭鍏堜笂鎶ヨ鍖哄煙璁惧銆傛湭璁剧疆鐨勫尯鍩熸寜榛樿瑙勫垯涓婃姤
+
+
+
+
+
+## 鍑哄簱鍖哄煙缁戝畾
+
+鍑哄簱绔欎笌鍑哄簱鍖哄煙缁戝畾閰嶇疆锛岃缃粦瀹氬尯鍩熷叧鑱斿悗锛屽厑璁竁MS绯荤粺鍑哄簱浠诲姟涓嬪彂鍖哄煙缂栧彿銆傞粯璁ゆ湭璁剧疆鍖哄煙缁戝畾鍏宠仈鏃讹紝WMS绯荤粺鍑哄簱浠诲姟涓嬪彂蹇呴』鎼哄甫鍑哄簱绔欑偣缂栧彿
+
+
+
+
+
+## 涓绘帶鐩戞帶鐢婚潰
+
+鏀寔鎷栨嫿绉诲姩銆佺缉鏀惧ぇ灏忋�佺偣鍑讳氦浜掋�傚乏渚т俊鎭尯鍩熷彲鏌ョ湅璁惧淇℃伅銆佷笅鍙戞帶鍒舵寚浠�
+
+
+
+
+
+## WCS涓婃姤閰嶇疆
+
+WCS涓婃姤WMS锛堢涓夋柟绯荤粺锛夐渶瑕侀厤缃秷鎭�氱煡Uri鍜屾秷鎭�氱煡Path锛屾秷鎭�氱煡鍐呭鏍煎紡瑙乄CS API鏂囨。
+
+
+
+
+
+## WCS鍏ュ簱璇锋眰閰嶇疆
+
+WCS璇锋眰WMS锛堢涓夋柟绯荤粺锛夎繘琛屽叆搴撴帴鍙ｉ厤缃�
+
+
+
+
+
+## AI鍔熻兘
+
+WCS榛樿鏀寔AI鍔熻兘銆侫I鑳藉姏鍏峰涓�閿瘖鏂郴缁熷拰閫氳繃鑷劧璇█涓嶹CS绯荤粺杩涜瀵硅瘽銆�
+
+涓�閿瘖鏂郴缁燂細AI浼氳皟鐢╓CS寮�鏀剧殑鏁版嵁锛岄拡瀵硅澶囧疄鏃舵棩蹇椼�佷换鍔＄姸鎬併�佽澶囩姸鎬佺瓑鎯呭喌缁煎悎鍒嗘瀽绯荤粺杩愯鎯呭喌
+
+瀵硅瘽锛氬彲鍜ㄨAI鍏充簬WCS绯荤粺闂
+
+
+
+
+
+
+
diff --git "a/docs/WCS\351\203\250\347\275\262\346\211\213\345\206\214.pdf" "b/docs/WCS\351\203\250\347\275\262\346\211\213\345\206\214.pdf"
new file mode 100644
index 0000000..d639438
--- /dev/null
+++ "b/docs/WCS\351\203\250\347\275\262\346\211\213\345\206\214.pdf"
Binary files differ
--
Gitblit v1.9.1