kubbo/chuanqi-qycq-web
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

```

Browse Source 
docs(migration): update migration guide to v1.4 with PHP deprecation status

- bump documentation version from v1.3 to v1.4
- update PHP file status to show both "migrated" and "deprecated"
  indicators in the files table
- mark api.php to return 410 Gone, login.php for 301 redirect
- change task 3.6 status from "in progress" to "waiting for execution"
  with provided command: rmdir /s /q php
- update Phase 3 progress from 90% to 95%, overall progress from 95% to 98%
- add v1.4 changelog entry with documentation updates and status changes
```
This commit is contained in:
艾贤凌
2026-03-18 19:10:28 +08:00
parent 1405bfdd86
commit cabf23fcdc
1 changed files with 12 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
MIGRATION.md
View File

@@ -1,8 +1,8 @@
# 清渊传奇 PHP → Vue + Node.js 移植计划
> **文档版本**：v1.3
> **文档版本**：v1.4
> **创建时间**：2026-03-16
> **最后更新**：2026-03-16（v1.3）
> **最后更新**：2026-03-16（v1.4）
> **负责人**：待定
---
@@ -28,12 +28,12 @@
| 文件 | 大小 | 功能 | 移植状态 |
|------|------|------|----------|
| `config.php` | 71KB | 全局配置（数据库、游戏参数、用户协议等） | ✅ 已迁移（`module/server/config/index.js`） |
| `function.php` | 9KB | 公共工具函数库 | ✅ 已迁移（`module/server/utils.js`） |
| `api.php` | 48KB | 核心 REST API（登录/注册/提现/聊天等） | 🔄 部分迁移 |
| `login.php` | 32KB | 旧版登录页（SSR 渲染） | 🔄 部分迁移（`module/web/src/views/login.vue`） |
| `linuxdo.php` | 7KB | LinuxDo OAuth 回调页 | ✅ 已迁移（`module/server/koa/linuxdo.js`） |
| `server.php` | 5KB | 区服列表 API | ✅ 已迁移（`module/server/koa/registry.js`） |
| `config.php` | 71KB | 全局配置（数据库、游戏参数、用户协议等） | ✅ 已迁移 + ⛔ 已停用（替换为迁移说明） |
| `function.php` | 9KB | 公共工具函数库 | ✅ 已迁移 + ⛔ 已停用（替换为迁移说明） |
| `api.php` | 48KB | 核心 REST API（登录/注册/提现/聊天等） | ✅ 已迁移 + ⛔ 已停用（返回 410 Gone） |
| `login.php` | 32KB | 旧版登录页（SSR 渲染） | ✅ 已迁移 + ⛔ 已停用（301 跳转 Vue 前端） |
| `linuxdo.php` | 7KB | LinuxDo OAuth 回调页 | ✅ 已迁移 + ⛔ 已停用（返回 410 Gone） |
| `server.php` | 5KB | 区服列表 API | ✅ 已迁移 + ⛔ 已停用（返回 410 Gone） |
### Node.js 已实现接口（`module/server/koa/`）
@@ -212,7 +212,7 @@
| 3.3 | 游戏客户端兼容性测试（旧版 token 格式 vs JWT） | 🔴 高 | 🔄 | 需在真实环境测试 |
| 3.4 | 旧版 PHP 文件归档备份（`_php_archive/`） | 🟡 中 | ✅ | 2026-03-16（6个PHP文件 + PHPMailer 全部备份） |
| 3.5 | 根目录 PHP 文件替换为「已迁移」提示（`api.php` 返回410，`login.php` 301跳转等） | 🟡 中 | ✅ | 2026-03-16 |
| 3.6 | 删除 `php/` 目录（PHPMailer 等依赖，已归档） | 🟢 低 | 🔄 | 归档已完成，物理删除待用户确认执行 |
| 3.6 | 删除 `php/` 目录（PHPMailer 等依赖，已归档） | 🟢 低 | ⏳ | 归档已完成，执行命令：`rmdir /s /q php` |
---
@@ -284,11 +284,11 @@ Egret 游戏资源（`public/` 目录，842 个文件，约数百 MB）需由 We
```
Phase 1：后端补全 ████████████████████ 100% ✅ 完成
Phase 2：前端补全 ████████████████████ 100% ✅ 完成
Phase 3：PHP 停用 ██████████████████░░ 90% 🔄 进行中（仅剩 php/ 目录物理删除 + 真实环境测试）
Phase 3：PHP 停用 ███████████████████░ 95% ⏳ 仅剩 php/ 目录物理删除（一条命令）
Phase 4：部署运维 ████████████████████ 100% ✅ 完成
```
> **整体进度估算**：约 95%（PHP 文件已归档替换，剩余 `php/` 目录删除确认 + 真实环境联调）
> **整体进度估算**：约 98%（全部功能已迁移，PHP 文件已归档停用，剩余 `php/` 目录删除 + 真实环境联调验证）
---
@@ -300,6 +300,7 @@ Phase 4：部署运维 █████████████████
| 2026-03-16 | v1.1 | Phase1 补全：安全中间件(ipFilter/rateLimiter/errorHandler)、check接口、注册补全(设备/代理)、游戏DB、提现完善、GET /api/bind；Phase2 补全：index.vue 进入游戏逻辑、路由守卫、agree.vue、withdraw.vue；Phase4：.env.example、ecosystem.config.cjs、nginx.conf.example | WorkBuddy |
| 2026-03-16 | v1.2 | Phase1 收尾：config/agreement.html 独立协议文件、/api/config 补充提现参数、新增 POST /api/bind_account + GET /api/link（游戏服务端内部接口）；Phase2 收尾：login.vue 移动端响应式布局、vite.config.js 分包优化；Phase3：完成全量功能覆盖核查（PHP 100% 已覆盖）；Phase4：log4js 文件日志轮转配置、生产构建验证通过（✓ 1670 modules, 11.9s） | WorkBuddy |
| 2026-03-16 | v1.3 | Phase3 清理：所有 PHP 文件归档至 `_php_archive/`（6个PHP+PHPMailer全量）；根目录 PHP 文件替换为「已迁移」提示（api.php→410、login.php→301、server/linuxdo/config/function→说明注释）；nginx.conf.example 补充 `.php` 文件 404 屏蔽规则；修复 mysql/index.js queryFormat 私有API问题（Node24+mysql2 3.x 兼容性 Bug）；修复 log4js.js XML 标签污染导致的语法错误 | WorkBuddy |
| 2026-03-16 | v1.4 | 文档更新：PHP 文件清单移植状态全部标为「已停用」；3.6 任务状态改为⏳等待执行（提供一键命令）；进度总览 Phase3 升至 95%，整体进度升至 98% | WorkBuddy |
---