# Onezan PHP开发通用框架

**Repository Path**: xiaolog/onezan-admin

## Basic Information

- **Project Name**: Onezan PHP开发通用框架
- **Description**: 壹站 onezan-admin 采用“核心框架 + 多应用”的架构：核心层提供注册中心与聚合输出（菜单/权限/路由/消息队列），针对各行业定制开发交付能力。
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-06-14
- **Last Updated**: 2026-08-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OneZan Admin

基于 **ThinkPHP 8 + Vue 3 + TDesign** 的模块化多应用管理平台。

## 特性

- **零耦合架构** — 核心框架（`core/`）与业务应用完全分离，开发应用无需修改核心代码
- **多应用支持** — 一个平台承载多个独立应用，各自拥有完整的后端模块、前端页面和数据库表
- **插件系统** — 通过 `manifest.json` 声明式定义模块、菜单、权限、路由和事件钩子
- **CLI 脚手架** — `php think make module {app} {code}` 一键生成控制器、服务层、仓储层、验证器、路由
- **双 API 网关** — 管理端 `/adminapi`（JWT 鉴权 + 权限校验）与公开 `/api`，路由自动注册
- **队列引擎** — 内置任务队列的注册、分发与驱动管理
- **扩展聚合** — 导航、权限、设置、消息等核心功能跨应用自动聚合

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | PHP 8.0+ / ThinkPHP 8 / Think ORM / JWT |
| 前端 | Vue 3 / TypeScript / Vite 6 / TDesign Vue Next |
| 状态管理 | Pinia |
| 图表 | ECharts 5 |
| 富文本 | WangEditor |
| 国际化 | Vue I18n |
| 集成 | 微信 (EasyWeChat) / 支付宝 / 邮件 |

## 目录结构

```
├── api/                  # 后端 (ThinkPHP 8)
│   ├── core/             # 核心引擎（除 applications 外禁止修改，框架升级时可改良）
│   ├── applications/     # 业务应用包（唯一允许修改）
│   │   └── sample/       # 示例应用
│   ├── config/           # 配置文件
│   └── route/            # 顶层路由
├── admin/                # 前端 (Vue 3)
│   └── src/
│       ├── core/         # 核心页面与 API（除 applications 外禁止修改，框架升级时可改良）
│       └── applications/ # 应用前端页面（唯一允许修改）
└── skills/               # AI 开发辅助规则
```

## 快速开始

### 后端

```bash
cd api
composer install
cp .example.env .env   # 编辑数据库等配置
php think migrate:run
php think run -p 8787
```

### 前端

```bash
cd admin
npm install
npm run dev
```

## 示例应用

项目内置 `sample` 示例应用，演示了文章管理（分类、富文本、图片、音频）、订单管理、支付、统计看板、系统设置等完整功能模块。

## 相关链接

🌐 官方网址：[https://framework.onezan.cn](https://framework.onezan.cn)  
📖 文档地址：[https://framework.onezan.cn/docs](https://framework.onezan.cn/docs)

## 开源使用须知

1. 允许用于个人学习、毕业设计、教学案例、公益事业、商业使用；

2. 本框架应用源代码所有权和著作权归 OneZan 官方所有，基于 onezan-admin 框架开发的应用，所有权和著作权归应用开发商所有。但必须明确声明是基于 onezan-admin 框架开发，请自觉遵守，否则产生的一切任何后果责任由侵权者自负；

3. 禁止修改框架代码并再次发布框架衍生版等与 onezan-admin 框架产生恶意竞争或对抗的行为；

4. 本框架源码全部开源，包括前端、后端，无任何加密；

5. 商用请仔细审查代码和漏洞，不得用于任一国家许可范围之外的商业应用，产生的一切任何后果责任自负；

6. 一切事物有个人喜好的标准，本开源代码意在分享，不喜勿喷。