开发文档

一、技术架构

• 框架：ThinkCMF（内核在 simplewind/：cmf 应用层、thinkphp 内核、extend 扩展、vendor 依赖），Composer 依赖含 topthink/think-captcha、phpmailer、qiniu/php-sdk、dompdf、phpoffice/phpexcel、mindplay/annotations、ezyang/htmlpurifier；PHP 7.2~8.0（推荐 7.4）/ MySQL 5.7+；
• 多应用：app/admin（后台 38 个控制器）、app/portal（内容门户/文章）、app/user（会员中心）、app/api、app/common；
• 前端源码：frontend_src/ 是前端的构建源码（配合 package.json / webpack.mix.js），改前端样式建议在源码里改再构建，避免直接改产物被覆盖。

二、目录结构

程序根/
├── index.php / public/index.php   # 入口
├── app/                  # 应用（admin / api / common / portal / user）
├── simplewind/           # ThinkCMF 内核
│   ├── cmf/              # CMF 框架层（模型、行为、助手）
│   ├── thinkphp/         # TP 内核
│   ├── extend/ vendor/   # 扩展与依赖
├── data/                 # 数据/配置（要可写）
├── db/                   # 建库脚本（install_full.sql 56 表 / schema_patch.sql / upgrade_*.sql）
├── public/               # 静态资源与上传
├── frontend_src/         # 前端源码（frontend / frontend_cli）
├── docs/                 # 开发说明（README_开发记录.md、nginx.conf.example、apache.htaccess）
├── demo_router.php       # 演示路由（本地起服务用）
└── xj_panel.php          # 授权验证 / 在线更新维护页

三、数据库

• 表前缀 cmf_，共 56 张（ThinkCMF 标准 + 租号业务）；
• CMF 基础：cmf_user（会员）、cmf_admin_menu / cmf_auth_access / cmf_auth_rule（后台权限）、cmf_option（配置）、cmf_nav / cmf_nav_menu、cmf_plugin / cmf_hook / cmf_hook_plugin（插件与钩子）、cmf_theme / cmf_theme_file（模板）、cmf_route；
• 内容：cmf_portal_post / cmf_portal_category / cmf_portal_tag*（文章/分类/标签）、cmf_slide / cmf_slide_item（轮播）、cmf_link；
• 租号业务：cmf_zuhao（账号商品）、cmf_zuhao_attr（属性/区服）、cmf_zuhao_order（订单）、cmf_zuhao_kanjia（砍价）、cmf_zuhao_pingjia（评价）、cmf_zuhao_shensu（申诉）、cmf_zuhao_view（浏览）、cmf_buyinfo / cmf_buyinfo_tuijian（求购/推荐）、cmf_lipei（理赔）、cmf_outline（大纲）、cmf_server、cmf_jiangli（奖励）；
• 资金：cmf_user_moneyinfo / cmf_user_moneyrecord（余额与流水）、cmf_user_tixian（提现）、cmf_user_bankcard、cmf_user_score_log（积分）、cmf_realname_order（实名）、cmf_recycle_bin（回收站）。

四、关键机制

4.1 CMF 钩子与插件

ThinkCMF 的扩展点是「钩子（hook）」：插件在 cmf_plugin 注册、通过 cmf_hook_plugin 绑定到钩子；加功能优先找现成钩子挂，而不是改核心。

4.2 模板机制

前台模板在 public/themes/（CMF 主题机制，cmf_theme 记录当前主题），后台模板在各应用 view/ 下。改前台看主题目录，不要改 simplewind/。

4.3 租号交易

下单（cmf_zuhao_order）→ 支付 → 发放账号信息 → 评价/理赔/申诉。资金流水统一走 cmf_user_moneyrecord。

五、二次开发指引

• 加后台菜单：后台「后台菜单」可视化添加（写 cmf_admin_menu），控制器放 app/admin/controller/；
• 加前台页面：app/portal 或 app/user 下加控制器 + 主题里加模板；
• 加钩子：在 simplewind/cmf 里查找现有钩子名，插件里用 hook('钩子名') 响应；
• 改库：新增升级脚本放 db/（可重复执行），模型类放 app/common/model/；
• 注意：data/ 目录保存配置与缓存，升级不覆盖；simplewind/ 与 vendor/ 属内核，别直接改。

六、授权与在线更新

后台相关目录在买家包内加密分发；xj_panel.php 支持「验证授权 / 在线更新」。更新沿用 CMF 的文件结构，保留 data/、public/upload/ 与 config；二开前先备份改过的文件。