From d676faa70442fbf19633bbb961fb46bc6ea4add6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=89=BE=E8=B4=A4=E5=87=8C?= <aixianling@sinoecare.com>
Date: Fri, 24 Apr 2026 17:57:06 +0800
Subject: [PATCH] =?UTF-8?q?docs(migration):=20=E6=B7=BB=E5=8A=A0=E6=B8=85?=
 =?UTF-8?q?=E6=B8=8A=E4=BC=A0=E5=A5=87PHP=E5=88=B0Vue+Node.js=E7=A7=BB?=
 =?UTF-8?q?=E6=A4=8D=E8=AE=A1=E5=88=92=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增 MIGRATION.md 详细记录PHP到Node.js架构迁移方案
- 包含项目背景、现有资产盘点、架构设计、任务清单等完整规划
- 记录后端补全、前端补全、PHP停用、部署运维四个阶段实施计划
- 提供技术决策、数据库说明、进度总览等关键信息
- 更新 .gitignore 添加 *_out.txt build_output.txt 构建输出文件过滤
- 修复 utils.js 路径引用问题确保代码正常运行
---
 .gitignore                                  |  4 +++
 MIGRATION.md => docs/MIGRATION.md           |  0
 module/server/koa/linuxdo.js                |  2 +-
 module/server/koa/login.js                  |  2 +-
 module/server/koa/middleware/ipFilter.js    |  2 +-
 module/server/koa/middleware/rateLimiter.js |  2 +-
 module/server/koa/registry.js               |  2 +-
 module/server/server_out.txt                |  3 ---
 module/server/start_out.txt                 |  1 -
 module/server/{ => utils}/utils.js          |  0
 module/web/build_out.txt                    | 27 ---------------------
 module/web/build_out2.txt                   | 25 -------------------
 module/web/build_output.txt                 | 27 ---------------------
 module/web/src/components/loading.vue       |  3 ---
 module/web/src/views/index.vue              |  5 ++--
 module/web/src/views/login.vue              | 11 ++++++++-
 module/web/vite.config.js                   |  1 +
 module/web/vite_out.txt                     | 11 ---------
 18 files changed, 23 insertions(+), 105 deletions(-)
 rename MIGRATION.md => docs/MIGRATION.md (100%)
 delete mode 100644 module/server/server_out.txt
 delete mode 100644 module/server/start_out.txt
 rename module/server/{ => utils}/utils.js (100%)
 delete mode 100644 module/web/build_out.txt
 delete mode 100644 module/web/build_out2.txt
 delete mode 100644 module/web/build_output.txt
 delete mode 100644 module/web/vite_out.txt

diff --git a/.gitignore b/.gitignore
index a547bf3..182ca1e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,6 +6,8 @@ yarn-debug.log*
 yarn-error.log*
 pnpm-debug.log*
 lerna-debug.log*
+*_out.txt
+build_output.txt
 
 node_modules
 dist
@@ -22,3 +24,5 @@ dist-ssr
 *.njsproj
 *.sln
 *.sw?
+
+.lingma
diff --git a/MIGRATION.md b/docs/MIGRATION.md
similarity index 100%
rename from MIGRATION.md
rename to docs/MIGRATION.md
diff --git a/module/server/koa/linuxdo.js b/module/server/koa/linuxdo.js
index d33c3a2..45a4ddd 100644
--- a/module/server/koa/linuxdo.js
+++ b/module/server/koa/linuxdo.js
@@ -2,7 +2,7 @@ import Router from 'koa-router'
 import mysql from '../mysql/index.js'
 import * as log4js from '../log4js.js'
 import config from '../config/index.js'
-import { encryptPassword } from '../utils.js'
+import { encryptPassword } from '../utils/utils.js'
 
 const router = new Router()
 
diff --git a/module/server/koa/login.js b/module/server/koa/login.js
index 36a1295..c736b86 100644
--- a/module/server/koa/login.js
+++ b/module/server/koa/login.js
@@ -3,7 +3,7 @@ import mysql from '../mysql/index.js'
 import jwt from 'jsonwebtoken'
 import * as log4js from '../log4js.js'
 import config from '../config/index.js'
-import { time, unixTime, encryptPassword, generateCode, getClientIp, isValidAccount, isValidEmail, getDeviceInfo } from '../utils.js'
+import { time, unixTime, encryptPassword, generateCode, getClientIp, isValidAccount, isValidEmail, getDeviceInfo } from '../utils/utils.js'
 import { sendCodeMail } from '../mail.js'
 
 const router = new Router()
diff --git a/module/server/koa/middleware/ipFilter.js b/module/server/koa/middleware/ipFilter.js
index 0fa9c65..35c0cb2 100644
--- a/module/server/koa/middleware/ipFilter.js
+++ b/module/server/koa/middleware/ipFilter.js
@@ -1,5 +1,5 @@
 import config from '../../config/index.js'
-import { getClientIp } from '../../utils.js'
+import { getClientIp } from '../../utils/utils.js'
 
 /**
  * IP 黑名单过滤中间件
diff --git a/module/server/koa/middleware/rateLimiter.js b/module/server/koa/middleware/rateLimiter.js
index 7f25f7d..ca49345 100644
--- a/module/server/koa/middleware/rateLimiter.js
+++ b/module/server/koa/middleware/rateLimiter.js
@@ -1,5 +1,5 @@
 import * as log4js from '../../log4js.js'
-import { getClientIp } from '../../utils.js'
+import { getClientIp } from '../../utils/utils.js'
 
 /**
  * 简单内存限流中间件（基于滑动窗口计数）
diff --git a/module/server/koa/registry.js b/module/server/koa/registry.js
index 94761c1..fddbd75 100644
--- a/module/server/koa/registry.js
+++ b/module/server/koa/registry.js
@@ -3,7 +3,7 @@ import mysql from '../mysql/index.js'
 import getGameDB from '../mysql/gameDB.js'
 import * as log4js from '../log4js.js'
 import config from '../config/index.js'
-import { time, unixTime, getClientIp } from '../utils.js'
+import { time, unixTime, getClientIp } from '../utils/utils.js'
 import { readFileSync, existsSync } from 'fs'
 import { fileURLToPath } from 'url'
 import { dirname, join } from 'path'
diff --git a/module/server/server_out.txt b/module/server/server_out.txt
deleted file mode 100644
index 056fd7e..0000000
--- a/module/server/server_out.txt
+++ /dev/null
@@ -1,3 +0,0 @@
-[19:26:51] [INFO] [koa] 🚀 Koa server running on port 3001
-[19:28:04] [WARN] [koa] 登录失败 testuser ::1
-[20:13:27] [INFO] [koa] 用户登录成功 aceykubbo ::1
diff --git a/module/server/start_out.txt b/module/server/start_out.txt
deleted file mode 100644
index 9600f3b..0000000
--- a/module/server/start_out.txt
+++ /dev/null
@@ -1 +0,0 @@
-[11:46:24] [INFO] [koa] 🚀 Koa server running on port 3001
diff --git a/module/server/utils.js b/module/server/utils/utils.js
similarity index 100%
rename from module/server/utils.js
rename to module/server/utils/utils.js
diff --git a/module/web/build_out.txt b/module/web/build_out.txt
deleted file mode 100644
index a9a4f4d..0000000
--- a/module/web/build_out.txt
+++ /dev/null
@@ -1,27 +0,0 @@
-npm warn Unknown user config "home". This will stop working in the next major version of npm.
-vite v7.3.1 building client environment for production...
-<script src="/static/js/md5.js"> in "/index.html" can't be bundled without type="module" attribute
-<script src="/static/js/common.js?v=1"> in "/index.html" can't be bundled without type="module" attribute
-transforming...
-✓ 1670 modules transformed.
-rendering chunks...
-computing gzip size...
-dist/index.html                          1.05 kB │ gzip:   0.49 kB
-dist/assets/agree-BLQpfDVx.css           1.37 kB │ gzip:   0.46 kB
-dist/assets/linuxdo-bind-DPWWajSf.css    1.77 kB │ gzip:   0.53 kB
-dist/assets/withdraw-DqWlBzRo.css        3.60 kB │ gzip:   0.81 kB
-dist/assets/login-BlSp8Yei.css           4.29 kB │ gzip:   1.16 kB
-dist/assets/index-KHprj2W-.css         378.12 kB │ gzip:  53.06 kB
-dist/assets/agree-C-28jhbg.js            0.92 kB │ gzip:   0.63 kB
-dist/assets/linuxdo-bind-CFqSeBhv.js     2.55 kB │ gzip:   1.25 kB
-dist/assets/index-7GZNUh9s.js            3.66 kB │ gzip:   1.94 kB
-dist/assets/withdraw-09hftHnJ.js         4.85 kB │ gzip:   2.24 kB
-dist/assets/login-kOeQ-hLG.js            6.67 kB │ gzip:   2.60 kB
-dist/assets/request-CitDfMDA.js         37.58 kB │ gzip:  15.14 kB
-dist/assets/index-DjlCHBNb.js          988.31 kB │ gzip: 326.73 kB
-
-(!) Some chunks are larger than 500 kB after minification. Consider:
-- Using dynamic import() to code-split the application
-- Use build.rollupOptions.output.manualChunks to improve chunking: https://rollupjs.org/configuration-options/#output-manualchunks
-- Adjust chunk size limit for this warning via build.chunkSizeWarningLimit.
-✓ built in 11.94s
diff --git a/module/web/build_out2.txt b/module/web/build_out2.txt
deleted file mode 100644
index 38096a2..0000000
--- a/module/web/build_out2.txt
+++ /dev/null
@@ -1,25 +0,0 @@
-npm warn Unknown user config "home". This will stop working in the next major version of npm.
-vite v7.3.1 building client environment for production...
-<script src="/static/js/md5.js"> in "/index.html" can't be bundled without type="module" attribute
-<script src="/static/js/common.js?v=1"> in "/index.html" can't be bundled without type="module" attribute
-transforming...
-✓ 1670 modules transformed.
-rendering chunks...
-computing gzip size...
-dist/index.html                           1.21 kB │ gzip:   0.54 kB
-dist/assets/agree-BLQpfDVx.css            1.37 kB │ gzip:   0.46 kB
-dist/assets/linuxdo-bind-DPWWajSf.css     1.77 kB │ gzip:   0.53 kB
-dist/assets/withdraw-DqWlBzRo.css         3.60 kB │ gzip:   0.81 kB
-dist/assets/login-Dg3cbkYJ.css            4.27 kB │ gzip:   1.16 kB
-dist/assets/index-KHprj2W-.css          378.12 kB │ gzip:  53.06 kB
-dist/assets/request-Cp8a3QvY.js           0.56 kB │ gzip:   0.42 kB
-dist/assets/agree-BcUYvO61.js             1.00 kB │ gzip:   0.67 kB
-dist/assets/linuxdo-bind-Dwzc1_1I.js      2.67 kB │ gzip:   1.31 kB
-dist/assets/index-DuMdIoFP.js             3.74 kB │ gzip:   1.98 kB
-dist/assets/index-C39LcZDB.js             4.34 kB │ gzip:   2.08 kB
-dist/assets/withdraw-BUvhXBBH.js          4.97 kB │ gzip:   2.30 kB
-dist/assets/login-kvI3nDLX.js             6.79 kB │ gzip:   2.67 kB
-dist/assets/vendor-axios-42ANG6Sg.js     37.09 kB │ gzip:  14.85 kB
-dist/assets/vendor-vue-CrCesgj8.js      105.59 kB │ gzip:  40.98 kB
-dist/assets/vendor-element-DlG_uBZr.js  878.48 kB │ gzip: 284.60 kB
-✓ built in 11.71s
diff --git a/module/web/build_output.txt b/module/web/build_output.txt
deleted file mode 100644
index b871ba5..0000000
--- a/module/web/build_output.txt
+++ /dev/null
@@ -1,27 +0,0 @@
-npm warn Unknown user config "home". This will stop working in the next major version of npm.
-vite v7.3.1 building client environment for production...
-<script src="/static/js/md5.js"> in "/index.html" can't be bundled without type="module" attribute
-<script src="/static/js/common.js?v=1"> in "/index.html" can't be bundled without type="module" attribute
-transforming...
-✓ 1670 modules transformed.
-rendering chunks...
-computing gzip size...
-dist/index.html                          1.05 kB │ gzip:   0.49 kB
-dist/assets/agree-BLQpfDVx.css           1.37 kB │ gzip:   0.46 kB
-dist/assets/linuxdo-bind-DPWWajSf.css    1.77 kB │ gzip:   0.53 kB
-dist/assets/withdraw-DqWlBzRo.css        3.60 kB │ gzip:   0.81 kB
-dist/assets/login-BlSp8Yei.css           4.29 kB │ gzip:   1.16 kB
-dist/assets/index-KHprj2W-.css         378.12 kB │ gzip:  53.06 kB
-dist/assets/agree-C-28jhbg.js            0.92 kB │ gzip:   0.63 kB
-dist/assets/linuxdo-bind-CFqSeBhv.js     2.55 kB │ gzip:   1.25 kB
-dist/assets/index-7GZNUh9s.js            3.66 kB │ gzip:   1.94 kB
-dist/assets/withdraw-09hftHnJ.js         4.85 kB │ gzip:   2.24 kB
-dist/assets/login-kOeQ-hLG.js            6.67 kB │ gzip:   2.60 kB
-dist/assets/request-CitDfMDA.js         37.58 kB │ gzip:  15.14 kB
-dist/assets/index-DjlCHBNb.js          988.31 kB │ gzip: 326.73 kB
-
-(!) Some chunks are larger than 500 kB after minification. Consider:
-- Using dynamic import() to code-split the application
-- Use build.rollupOptions.output.manualChunks to improve chunking: https://rollupjs.org/configuration-options/#output-manualchunks
-- Adjust chunk size limit for this warning via build.chunkSizeWarningLimit.
-✓ built in 17.40s
diff --git a/module/web/src/components/loading.vue b/module/web/src/components/loading.vue
index d4a8666..75b8526 100644
--- a/module/web/src/components/loading.vue
+++ b/module/web/src/components/loading.vue
@@ -5,7 +5,6 @@ const loadBar2MaxWidth = 200;
 let loadError = false;
 onMounted(()=>{
   const loadBox = document.getElementById('loadBox'),
-      logoImg = document.getElementById('logoImg'),
       loadBar1 = document.getElementById('loadBar1'),
       loadBar2 = document.getElementById('loadBar2');
 
@@ -18,7 +17,6 @@ onMounted(()=>{
         smallScreen = screenWidth <= 0,
         isHorizontal = isMobile() && screenHeight <= 590;
     if (loadBox) loadBox.style.paddingTop = (!isHorizontal ? (screenHeight / 4) : 50) + 'px';
-    if (logoImg) logoImg.width = isHorizontal || smallScreen ? 300 : 500;
     if (loadBar1) {
       loadBar1Width += 20;
       if (loadBar1Width > 100) loadBar1Width = 0;
@@ -73,7 +71,6 @@ onMounted(()=>{
 <template>
   <div id="logDiv" style="position:absolute; top: 31%; left: 50%;transform: translate(-50%,-50%)">
     <div style="display: flex;flex-direction: column; align-items: center;gap: 4px;justify-content: center">
-      <img id="logoImg" align="center" width="380" src="/login/logo.png" class="mb-20"/>
       <div id="label" style="color: #b4792e; font-size: 20px;">
         首次加载时间较长……请耐心等待，如长时间无响应 <span class="font_small">
                 <a onClick="window.location.reload()" class="link_color">请点此刷新</a> /
diff --git a/module/web/src/views/index.vue b/module/web/src/views/index.vue
index 47da459..8f8281d 100644
--- a/module/web/src/views/index.vue
+++ b/module/web/src/views/index.vue
@@ -32,13 +32,14 @@ onMounted(async () => {
   // 解析 JWT 获取账号信息
   const payload = parseJwt(token)
   if (!payload?.username) {
+    error.value = '登录信息无效，请重新登录'
     sessionStorage.removeItem('CQ-TOKEN')
-    router.replace('/login')
+    setTimeout(() => router.replace('/login'), 2000)
     return
   }
 
   const account = payload.username
-  const password = payload.password  // md5 密码哈希，用于游戏客户端鉴权
+  const password = payload.password || ''  // md5 密码哈希，用于游戏客户端鉴权
   const serverId = payload.server_id || 1
 
   // 调用 enter_game 接口，更新登录信息
diff --git a/module/web/src/views/login.vue b/module/web/src/views/login.vue
index 0d3ac34..49baf09 100644
--- a/module/web/src/views/login.vue
+++ b/module/web/src/views/login.vue
@@ -66,7 +66,16 @@ async function handleLogin() {
     if (res.code === 0) {
       sessionStorage.setItem('CQ-TOKEN', res.token)
       ElMessage.success(res.message || '登录成功')
-      setTimeout(() => router.push('/index'), 1500)
+      // 确保token被正确存储后再跳转
+      setTimeout(() => {
+        // 验证token是否已正确存储
+        const storedToken = sessionStorage.getItem('CQ-TOKEN')
+        if (storedToken) {
+          router.push('/index')
+        } else {
+          ElMessage.error('登录状态保存失败，请重试')
+        }
+      }, 1500)
     } else {
       ElMessage.error(res.message || '登录失败')
     }
diff --git a/module/web/vite.config.js b/module/web/vite.config.js
index 2f65681..909ba74 100644
--- a/module/web/vite.config.js
+++ b/module/web/vite.config.js
@@ -10,6 +10,7 @@ export default defineConfig({
     }
   },
   server: {
+    port: 3176,
     proxy: {
       '/api': {
         target: 'http://localhost:3001',
diff --git a/module/web/vite_out.txt b/module/web/vite_out.txt
deleted file mode 100644
index 587eeb5..0000000
--- a/module/web/vite_out.txt
+++ /dev/null
@@ -1,11 +0,0 @@
-npm warn Unknown user config "home". This will stop working in the next major version of npm.
-20:23:55 [vite] (client) Re-optimizing dependencies because vite config has changed
-
-  VITE v7.3.1  ready in 970 ms
-
-  ➜  Local:   http://localhost:5173/
-  ➜  Network: use --host to expose
-[@vue/compiler-sfc] `defineOptions` is a compiler macro and no longer needs to be imported.
-
-
-d:\code\chuanqi-qycq-web\module\web>
\ No newline at end of file