ZsAdmin「智数」轻量级 PHP 框架 V1.3.1 正式发布
ZsAdmin「智数」
一、项目简介
ZsAdmin「智数」是一套基于 ThinkPHP 8.1.4 构建的轻量级后台管理与社区应用系统，由个人开发者张先生维护。后台 UI 采用 Bootstrap v5.3.3 框架自主开发，iframe 多标签布局、响应式适配，风格现代统一。
系统采用 「核心 + 插件 + 主题」 架构：内核只保留后台管理、权限、用户等基础能力，社区、网盘、统计等功能全部以插件形式按需安装，前台主题亦可独立切换。开箱即用：内置 Web 安装向导（环境检测 → 数据库配置 → 管理员创建 → 一键安装），配合远程应用市场，几分钟即可完成从部署到功能扩展的全流程。
二、核心功能
| 模块 | 说明 |
|---|---|
| 后台管理 | Bootstrap 5.3.3 自研 UI、iframe 多标签布局、动态菜单、站点配置、文件管理、操作日志 |
| 权限体系 | Session 登录 + RBAC（管理员 / 用户组 / 权限规则 / 菜单）四级管控 |
| 用户与社区 | 前台用户管理、用户等级（成长值）、行为奖励、积分 / 金币资产流水 |
| 插件系统 | 功能插件 + 主题包双目录（plugins/、themes/）、Hook 挂载点、插件路由注册、独立后台菜单 |
| 应用市场 | 远程应用市场对接，插件 / 主题在线安装与升级，核心系统在线升级 |
| 存储抽象 | 本地文件管理 / 云储存 / 光鸭云盘 / 夸克网盘 / 百度网盘，随插件动态启用 |
| 安全防护 | HTML 白名单净化、验证码、操作留痕、站点一键关闭 |
三、技术架构
| 维度 | 技术栈 |
|---|---|
| 后端 | PHP 8.0+（推荐 8.5）、ThinkPHP 8.1.4、think-orm、think-view、think-captcha、think-filesystem |
| 前端 | Bootstrap v5.3.3 自研 admin UI，配套 Bootstrap Table、ApexCharts 图表、Flatpickr 日期选择 |
| 数据库 | MySQL 8.0（兼容 5.7+），utf8mb4 |
| 部署 | Nginx（兼容 Apache），Composer 管理依赖 |
四、产品优势
1. 轻量内核，插件化扩展
内核仅保留基础管理能力，社区、网盘、统计等均以插件按需安装，装多少、跑多少。插件通过统一 Hook 机制（filterHtml、renderSlot、afterTopicSave 等）挂入业务流程，无需修改核心代码即可扩展发帖、回复、渲染等环节，升级核心无冲突。
2. Bootstrap 5.3.3 自研后台 UI
后台界面完全基于 Bootstrap v5.3.3 自主开发，非套用现成模板：视觉风格统一可控、组件按需引入、无冗余依赖，二次开发和定制更自由；天然响应式，桌面 / 平板 / 手机一套代码全适配。
3. 完整的应用市场生态
内置远程应用市场对接，插件、主题在线浏览、一键安装 / 卸载 / 升级，核心系统也支持在线升级；升级过程采用路径白名单机制（仅覆盖 app/、view/ 等目录），用户数据、配置、插件目录绝不触碰，安全省心。
4. 性能优化到位
- 启动编译缓存：插件安装表、路由、Hook 能力在安装/变更时编译为 runtime/plugin_boot.php，请求时免查库、免扫描目录、免反射；
- 游客页面缓存：前台游客 GET 请求整页缓存，浏览器侧 private/no-store + Vary: Cookie 防止登录态串页；
- 懒加载 Session：非必要不启动 Session，降低会话开销。
5. 精细化用户运营
内置成长值等级体系（成长值 = 积分 + 金币 + 发帖 + 回帖）、行为奖励规则引擎（发帖 / 回帖等动作奖励积分金币，支持每日上限）与统一的资产流水账本，配合金币汇率换算（人民币 ↔ 金币），社区激励与变现闭环开箱即得。
6. 多存储、多主题，灵活部署
上传存储抽象为驱动接口，本地 / 云储存 / 夸克 / 百度网盘随插件即插即用；主题与功能插件分离（themes/），活动主题优先、缺文件自动回退宿主视图，换肤不动业务。
7. 安全细节全面
后台 RBAC 逐节点鉴权、富文本 HTML 白名单净化防 XSS、登录验证码、管理员操作全程留痕（oplog）、附件引用追踪防误删、站点一键关闭维护，生产环境一键关闭调试模式。
8. 安装零门槛
Web 向导式安装：环境自动检测、数据库连接测试、管理员一键创建，安装锁定机制（install.lock）防止重复安装，未安装访问任意页面自动跳转引导。
