开发文档

产品使用文档与部署教程,持续更新中

首页>文档>开发文档

云枢游戏交易系统 · 开发文档

一、技术架构

  • 框架:ThinkPHP 6/8 多应用(Composer 版:topthink/framework、think-orm、think-filesystem、think-multi-app),PHP 8.0+(推荐 8.1)/ MySQL 5.7+;
  • 双栈结构:新业务在 app/(TP 多应用),历史交易系统在 legacy/(老 CMS,表前缀 yjcode_),两套共用同一数据库,通过入口与路由挂载共存;
  • 多入口应用:app/ 下同时有 admin(后台)、index(首页)、user/my(用户中心)、product/shop(商品店铺)、task/renwu(任务)、news/help(内容)、api/msg(接口与消息)、youxicms(老系统桥接)等子应用;
  • 授权方式:无加密包(明文分发)+ 核心文件授权验证,后台跳转 /youxicms/authorize.php 激活。

二、目录结构

程序根/
├── public/index.php      # Web 入口
├── app/                  # 新系统(TP 多应用)
│   ├── admin/ api/ common/ index/   # 主应用
│   ├── my/ user/ shop/ product/     # 用户中心与商品
│   ├── task/ renwu/ news/ help/     # 任务与内容
│   ├── youxicms/                    # 老系统桥接
│   └── ...(另有 m/ mt/ msg/ reg/ search/ serve/ tp/ native-work 等子应用)
├── legacy/               # 老交易系统(yjcode 系)
│   ├── admin/ api/ aop/ assets/ config/ ...
│   └── Nginx伪静态.txt    # legacy 的伪静态规则
├── config/               # 配置(app/cache/cookie/database/log/...)
├── route/app.php         # 路由
├── database/             # 建库脚本(schema_data_2025.sql / schema_data_current.sql)
├── tools/ deploy/        # 运维工具与部署脚本
├── install.sh / install.bat   # 安装脚本(含建库)
└── view/                 # 公共视图

三、数据库

  • 共 94 张表;历史表前缀 yjcode_(如 yjcode_user、yjcode_goods→yjcode_pro、yjcode_order、yjcode_admin、yjcode_tixian、yjcode_task 系列);
  • 新功能表(如 collection / collectionprice / baidu / 360url / xiongzhangurl 等采集与 SEO 表);
  • 升级脚本按版本放 database/:schema_data_2025.sql(当前版)与 schema_data_current.sql(随包最新),安装时导入其一即可。

四、关键机制

4.1 新老系统共存

app/youxicms 与 legacy/ 负责老系统的登录态与页面;改老页面时直接改 legacy/ 下对应文件,改新页面走 app/ 对应子应用的 controller + view(TP8 模板语法)。两边共享 yjcode_user 会员体系。

4.2 任务 / 悬赏 / 交易

任务类功能表:yjcode_renwu(任务)、yjcode_renwujie(接单)、yjcode_renwulog(流水)、yjcode_task*(旧任务体系);商品交易表:yjcode_pro / yjcode_shop* / yjcode_order* / yjcode_paykami。改业务优先顺着 Model 找表,不要直接拼 SQL。

4.3 权限

后台权限沿用老系统的 yjcode_admin + 菜单权限;新加的后台控制器要同时在后台菜单表登记并在权限里放行,否则登录后台看不到菜单。

五、二次开发指引

  • 加一个后台页面:app/admin/controller/ 新建控制器 → 视图放 view/admin/(TP8 模板)→ 后台菜单表加记录;
  • 改前台页面:app/index/view/ 下找对应模板;老页面在 legacy/ 对应目录(老模板引擎,注意别与 TP8 语法混用);
  • 新表:写在 database/ 下新建升级 SQL(可重复执行写法:CREATE TABLE IF NOT EXISTS),并在 app/common/model/ 建模型;
  • 注意:legacy/config/xjlicense.php、legacy/youxicms/license.php、legacy/youxicms/update.php 是授权链路文件,别删改结构;伪静态要同时配 legacy/Nginx伪静态.txt 里的规则,否则老页面 404。

六、授权与更新

本程序明文分发、核心文件带授权验证:后台未激活时会跳到 /youxicms/authorize.php(接口 AJAX 返回 401)。激活后同一页面可用于查看授权状态;在线更新请先备份 legacy/ 与 app/ 里改过的文件。