系统架构
架构总览
基于 MVC。ThinkPHP 8 多应用:admin / index / api / common(及可选 store 等)。
目录结构
项目根目录
├── addons/ # 插件
├── app/
│ ├── admin/ # 后台
│ ├── api/ # 接口(Settings、会员等)
│ ├── common/ # 公共库、服务、模型
│ ├── index/ # 前台 / 会员
│ └── …
├── config/ # 含 yetuadmin.php
├── extend/
├── public/
│ ├── assets/
│ │ ├── css/ # yetu-admin-content.css 等
│ │ ├── js/ # backend / frontend / yetuadmin.js
│ │ ├── libs/ # 第三方组件
│ │ └── vendor/ # BS5 / AdminLTE4 / Font Awesome 等
│ ├── uploads/
│ └── index.php
├── runtime/
├── vendor/
├── composer.json
└── think
前端静态资源以仓库内 public/assets 与 Composer 管理为主。
应用模块
admin:后台核心(配置、权限、插件、生成器、业务)index:站点前台与会员中心api:App / 小程序 / 开放接口(如/api/settings/module)common:基类、库、服务(禁止直访)
后台壳:AdminLTE 4 + Bootstrap 5。业务页脚本优先内联于视图,或复用 Form / Table API(见「前端介绍」)。
功能模块文件
app/admin/controller/Example.php
app/admin/model/Example.php
app/admin/view/example/index.html
# 可选:public/assets/js/backend/example.js(优先视图内联)
界面文案进 yt_lang。插件代码在 addons/{name}/,安装后可映射到 app/admin。
版本规范
三类版本分开,不要混用:
- 产品 SemVer —
config/yetuadmin.php→yetuadmin.version(如5.0.1)。用于系统升级、插件商店faversion、后台「系统版本」展示。 - 资源缓存戳 — 配置项
asset_version(运行时仍兼容旧键site.version)。保存系统配置或清除缓存时自动更新,不是产品版本号。 清除缓存或保存系统配置时自动更新,不在系统配置页展示。 - App 客户端强更 — 不在核心。需要时安装 App Version 插件,调用
/addons/appversion/api/check。
git pull 只同步代码里的产品版本;各环境数据库里的缓存戳仍可能不同,清缓存或保存一次系统配置即可对齐资源版本。
核心数据表
核心库表的 COMMENT 默认使用英文。CRUD / 生成器从 information_schema 读取。插件自有表同样建议英文注释,便于生成器标题保持语言中立。注释中不要写市场/地区分割措辞。
| 表 | 用途 |
|---|---|
yt_admin | 管理员账号 |
yt_admin_log | 管理员操作日志 |
yt_auth_group | 管理员分组 |
yt_auth_group_access | 管理员分组关联 |
yt_auth_rule | 权限节点 / 菜单 |
yt_config | 系统配置 |
yt_attachment | 附件 |
yt_lang / yt_lang_list | 界面翻译 / 语言列表 |
yt_content_lang | 内容多语言 |
yt_user / yt_user_group / yt_user_rule | 会员 / 会员组 / 会员规则 |
yt_user_token / yt_user_third | 会员 Token / 第三方绑定 |
yt_user_money_log / yt_user_score_log | 余额 / 积分流水 |
yt_sms / yt_ems | 短信 / 邮件验证码 |
yt_region / yt_currency | 地区 / 货币 |
yt_addon_config | 插件配置 |