文档首页 / HareAdmin 开发手册

系统架构

架构总览

基于 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插件配置