From 7de1396e315896dbc72a9d54e44f77434ea90f18 Mon Sep 17 00:00:00 2001
From: wlzboy <66905212@qq.com>
Date: 星期日, 14 十二月 2025 23:47:34 +0800
Subject: [PATCH] feat:增加企业微信自动登录

---
 企业微信免登功能使用说明.md |  155 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 155 insertions(+), 0 deletions(-)

diff --git "a/\344\274\201\344\270\232\345\276\256\344\277\241\345\205\215\347\231\273\345\212\237\350\203\275\344\275\277\347\224\250\350\257\264\346\230\216.md" "b/\344\274\201\344\270\232\345\276\256\344\277\241\345\205\215\347\231\273\345\212\237\350\203\275\344\275\277\347\224\250\350\257\264\346\230\216.md"
new file mode 100644
index 0000000..4c7d22b
--- /dev/null
+++ "b/\344\274\201\344\270\232\345\276\256\344\277\241\345\205\215\347\231\273\345\212\237\350\203\275\344\275\277\347\224\250\350\257\264\346\230\216.md"
@@ -0,0 +1,155 @@
+# 浼佷笟寰俊鍏嶇櫥鍔熻兘浣跨敤璇存槑
+
+## 鍔熻兘姒傝堪
+
+浼佷笟寰俊鍏嶇櫥鍔熻兘鍏佽鐢ㄦ埛閫氳繃浼佷笟寰俊瀹㈡埛绔洿鎺ョ櫥褰曠郴缁燂紝鏃犻渶杈撳叆鐢ㄦ埛鍚嶅拰瀵嗙爜锛屾彁鍗囩敤鎴蜂綋楠屻��
+
+## 瀹炵幇鍘熺悊
+
+1. 鐢ㄦ埛鍦ㄤ紒涓氬井淇″鎴风涓闂郴缁烾RL
+2. 绯荤粺妫�娴嬪埌浼佷笟寰俊鐜锛岃嚜鍔ㄨ烦杞埌浼佷笟寰俊鎺堟潈椤甸潰
+3. 鐢ㄦ埛纭鎺堟潈鍚庯紝浼佷笟寰俊杩斿洖鎺堟潈code
+4. 绯荤粺閫氳繃code鑾峰彇鐢ㄦ埛淇℃伅骞跺畬鎴愮櫥褰�
+
+## 鏂囦欢缁撴瀯
+
+```
+鍓嶇锛�
+- app/pages/qylogin.vue          # 绉诲姩绔厤鐧婚〉闈�
+- ruoyi-ui/src/views/system/qywechat/autologin.vue  # PC绔厤鐧绘祴璇曢〉闈�
+- ruoyi-ui/src/router/modules/qywechat.js  # 璺敱閰嶇疆
+
+鍚庣锛�
+- ruoyi-admin/src/main/java/com/ruoyi/web/controller/system/QyWechatLoginController.java  # 鍏嶇櫥鎺у埗鍣�
+- ruoyi-system/src/main/java/com/ruoyi/system/mapper/SysUserMapper.java  # 鐢ㄦ埛Mapper鎺ュ彛
+- ruoyi-system/src/main/resources/mapper/system/SysUserMapper.xml  # 鐢ㄦ埛Mapper XML
+- ruoyi-system/src/main/java/com/ruoyi/system/service/ISysUserService.java  # 鐢ㄦ埛鏈嶅姟鎺ュ彛
+- ruoyi-system/src/main/java/com/ruoyi/system/service/impl/SysUserServiceImpl.java  # 鐢ㄦ埛鏈嶅姟瀹炵幇
+```
+
+## 閰嶇疆瑕佹眰
+
+### 1. 浼佷笟寰俊閰嶇疆
+
+鍦ㄧ郴缁熼厤缃腑娣诲姞浠ヤ笅閰嶇疆椤癸細
+
+```sql
+-- 浼佷笟寰俊鍚敤寮�鍏�
+INSERT INTO sys_config VALUES (NULL, '浼佷笟寰俊鍚敤寮�鍏�', 'qy_wechat.enable', 'true', 'Y', '绯荤粺鍐呯疆', '鏄惁鍚敤浼佷笟寰俊鍔熻兘', '1', '1', '2025-12-14 10:00:00', 'admin', '2025-12-14 10:00:00', 'admin', NULL);
+
+-- 浼佷笟寰俊CorpID
+INSERT INTO sys_config VALUES (NULL, '浼佷笟寰俊CorpID', 'qy_wechat.corp_id', 'your_corp_id', 'Y', '绯荤粺鍐呯疆', '浼佷笟寰俊浼佷笟ID', '1', '1', '2025-12-14 10:00:00', 'admin', '2025-12-14 10:00:00', 'admin', NULL);
+
+-- 浼佷笟寰俊搴旂敤Secret锛堢敤浜庤幏鍙栫敤鎴蜂俊鎭級
+INSERT INTO sys_config VALUES (NULL, '浼佷笟寰俊搴旂敤Secret', 'qy_wechat.corp_secret', 'your_corp_secret', 'Y', '绯荤粺鍐呯疆', '浼佷笟寰俊搴旂敤瀵嗛挜', '1', '1', '2025-12-14 10:00:00', 'admin', '2025-12-14 10:00:00', 'admin', NULL);
+
+-- 浼佷笟寰俊灏忕▼搴廠ecret锛堢敤浜庤幏鍙朅ccessToken锛�
+INSERT INTO sys_config VALUES (NULL, '浼佷笟寰俊灏忕▼搴廠ecret', 'qy_wechat.miniprogram_secret', 'your_miniprogram_secret', 'Y', '绯荤粺鍐呯疆', '浼佷笟寰俊鍏宠仈灏忕▼搴忓瘑閽�', '1', '1', '2025-12-14 10:00:00', 'admin', '2025-12-14 10:00:00', 'admin', NULL);
+
+-- 浼佷笟寰俊AgentId
+INSERT INTO sys_config VALUES (NULL, '浼佷笟寰俊AgentId', 'qy_wechat.agent_id', 'your_agent_id', 'Y', '绯荤粺鍐呯疆', '浼佷笟寰俊搴旂敤ID', '1', '1', '2025-12-14 10:00:00', 'admin', '2025-12-14 10:00:00', 'admin', NULL);
+```
+
+### 2. 鐢ㄦ埛缁戝畾
+
+闇�瑕佸皢绯荤粺鐢ㄦ埛涓庝紒涓氬井淇＄敤鎴疯繘琛岀粦瀹氾紝鍦╜sys_user`琛ㄤ腑璁剧疆`qy_wechat_user_id`瀛楁銆�
+
+## 浣跨敤娴佺▼
+
+### 绉诲姩绔娇鐢�
+
+1. 鐢ㄦ埛鍦ㄤ紒涓氬井淇′腑鎵撳紑绯荤粺URL
+2. 绯荤粺鑷姩璺宠浆鍒板厤鐧婚〉闈� `/pages/qylogin`
+3. 椤甸潰妫�娴嬩紒涓氬井淇＄幆澧冨苟鑾峰彇鎺堟潈code
+4. 璋冪敤鍚庣鍏嶇櫥鎺ュ彛瀹屾垚鐧诲綍
+
+### PC绔祴璇�
+
+1. 鐧诲綍绯荤粺鍚庡彴
+2. 杩涘叆銆愪紒涓氬井淇°��->銆愬厤鐧绘祴璇曘�戣彍鍗�
+3. 杈撳叆浼佷笟寰俊鎺堟潈code杩涜娴嬭瘯
+
+## 鎺ュ彛璇存槑
+
+### 鍏嶇櫥鎺ュ彛
+
+```
+POST /system/qywechat/autoLogin
+
+璇锋眰鍙傛暟锛�
+{
+  "code": "浼佷笟寰俊鎺堟潈code"
+}
+
+鍝嶅簲缁撴灉锛�
+{
+  "code": 200,
+  "msg": "鐧诲綍鎴愬姛",
+  "data": {
+    "token": "鐧诲綍浠ょ墝",
+    "user": {
+      // 鐢ㄦ埛淇℃伅
+    }
+  }
+}
+```
+
+## 娉ㄦ剰浜嬮」
+
+1. 浼佷笟寰俊鍏嶇櫥鍔熻兘浠呮敮鎸佸湪浼佷笟寰俊瀹㈡埛绔腑浣跨敤
+2. 闇�瑕佹纭厤缃紒涓氬井淇″簲鐢ㄧ殑鍙俊鍩熷悕
+3. 鐢ㄦ埛蹇呴』鍏堢粦瀹氫紒涓氬井淇¤处鍙锋墠鑳戒娇鐢ㄥ厤鐧诲姛鑳�
+4. 纭繚鏈嶅姟鍣ㄨ兘澶熻闂紒涓氬井淇PI鎺ュ彛
+
+## 甯歌闂
+
+### 1. 鎺堟潈澶辫触
+
+**闂鐜拌薄**锛氭彁绀�"鑾峰彇鐢ㄦ埛淇℃伅澶辫触"
+
+**瑙ｅ喅鏂规**锛�
+- 妫�鏌ヤ紒涓氬井淇￠厤缃槸鍚︽纭�
+- 纭搴旂敤鐨勫彲淇″煙鍚嶉厤缃�
+- 妫�鏌ョ綉缁滄槸鍚﹁兘璁块棶浼佷笟寰俊API
+
+### 2. 鐢ㄦ埛鏈粦瀹�
+
+**闂鐜拌薄**锛氭彁绀�"璇ヤ紒涓氬井淇¤处鍙锋湭缁戝畾绯荤粺鐢ㄦ埛"
+
+**瑙ｅ喅鏂规**锛�
+- 鍦ㄧ敤鎴风鐞嗕腑鎵惧埌瀵瑰簲鐢ㄦ埛
+- 璁剧疆`qy_wechat_user_id`瀛楁涓轰紒涓氬井淇＄敤鎴稩D
+
+### 3. 鐧诲綍寮傚父
+
+**闂鐜拌薄**锛氭彁绀�"鐧诲綍寮傚父"
+
+**瑙ｅ喅鏂规**锛�
+- 鏌ョ湅绯荤粺鏃ュ織瀹氫綅鍏蜂綋閿欒
+- 妫�鏌ョ敤鎴风姸鎬佹槸鍚︽甯�
+- 纭绯荤粺閰嶇疆鏄惁瀹屾暣
+
+## 鎵╁睍鍔熻兘
+
+### 1. 鑷姩璺宠浆閰嶇疆
+
+鍙互鍦ㄥ墠绔〉闈腑閰嶇疆鑷姩璺宠浆閫昏緫锛�
+
+```javascript
+// 妫�鏌ヤ紒涓氬井淇＄幆澧�
+isWxWorkEnvironment() {
+  const userAgent = navigator.userAgent.toLowerCase()
+  return userAgent.includes('wxwork')
+}
+```
+
+### 2. 鐢ㄦ埛缁戝畾鎺ュ彛
+
+鍙互寮�鍙戠敤鎴风粦瀹氫紒涓氬井淇＄殑鎺ュ彛锛�
+
+```java
+@PostMapping("/bind")
+public AjaxResult bindQyWechatUser(@RequestBody BindRequest request) {
+  // 瀹炵幇鐢ㄦ埛缁戝畾閫昏緫
+}
+```
\ No newline at end of file

--
Gitblit v1.9.1