# yiiframe3

**Repository Path**: hjp0725/yiiframe3

## Basic Information

- **Project Name**: yiiframe3
- **Description**: YiiFrame3采用Bootstrap3+adminlte2＋yii2，基于 RageFrame 快速开发引擎，为「办公场景」而生的通用后台快速开发框架，采用「插件 + 模块 + 多入口」的微核架构，面向**CMS、CRM、ERP、OA、电子商务、门户网站、社区**等大型业务系统，可一键生成前后端代码、接口文档和插件包，真正做到「不写重复代码，只关注业务」。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-28
- **Last Updated**: 2026-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 一、定位与理念

YiiFrame3采用Bootstrap3+adminlte2＋yii2，基于 RageFrame 快速开发引擎，为「办公场景」而生的通用后台快速开发框架，采用「插件 + 模块 + 多入口」的微核架构，面向**CMS、CRM、ERP、OA、电子商务、门户网站、社区**等大型业务系统，可一键生成前后端代码、接口文档和插件包，真正做到「不写重复代码，只关注业务」。

## 二、核心特色

1. **插件化微核**
    
    - 功能即插件，可独立安装/卸载/升级，不影响核心；
        
    - 官方提供插件市场，支持在线一键更新。
        
2. **多入口隔离**  
    -Backend（总后台）  
    -Merchant（企业端/SaaS 子后台）  
    -Frontend（PC 前端）  
    -Html5（移动端）  
    -Console（定时任务）  
    -Api（内部接口）  
    -OAuth2 Server（开放接口）  
    -MerApi（企业接口）  
    各入口独立模块、独立主题、独立路由，代码隔离清晰。
    
3. **一键生成代码**
    
    - 选择数据表 → 绑定表单控件 → 自动生成 **Model + CRUD + API + 路由 + 菜单 + 权限节点**；
        
    - 表单控件（日期、上传、省市、富文本、经纬度等）勾选即用，无需手写视图。
        
4. **企业级 RBAC**
    
    - 无限层级父子权限组；
        
    - 按钮、链接、插件、字段级细粒度控制；
        
    - 支持数据权限（按部门、按企业隔离）。
        
5. **前后端分离友好**
    
    - 内置 RESTful 规范 + OAuth2 Server；
        
    - 自动生成 Swagger/OpenAPI 文档；
        
    - 提供 Uni-App 前端模板（一套代码编译到 H5、小程序、App）。
        
6. **云存储一键切换**
    
    - 本地、阿里云 OSS、腾讯云 COS、七牛等通过配置切换；
        
    - 统一 Flysystem 接口，新增存储只需写 1 个驱动类。
        
7. **工作流引擎**
    
    - 可视化设计流程；
        
    - 支持条件分支、表单权限；
        
    - 与审批记录、消息、钉钉/企微提醒打通。
        
8. **监控与日志**
    
    - 异常自动进数据库，可钉钉实时推送；
        
    - 队列、Redis、SQL、内存占用一目了然。
        

## 三、技术栈

| 层级    | 选型                       | 说明                     |
| :---- | :----------------------- | :--------------------- |
| 后端框架  | Yii2 2.0.53+             | 成熟稳定，支持懒加载、依赖注入        |
| 前端 UI | Bootstrap 3 + AdminLTE 2 | 响应式，PC/平板/手机自适应        |
| 数据库   | MySQL 5.7             | 支持 JSON、虚拟列，兼容 MariaDB |
| 缓存    | Redis / File             | 内置缓存组件，可一键切换           |
| 队列    | Yii2-Queue + Redis       | 异步发邮件、上链、生成报表          |
| 接口    | RESTful + OAuth2         | 官方提供 Uni-App、小程序 SDK   |
| 语言包   | 简体中文、繁体、英语、日语            | 可后台在线翻译                |
| 包管理   | Composer 2.x             | 全组件化，支持私有源             |

## 四、开箱即用功能

1. **系统管理**
    
    - 菜单、部门、岗位、员工、角色、权限、字典、附件、日志、在线用户、定时任务、队列监控。
        
2. **办公自动化（OA）**
    
    - 请假、加班、出差、报销、用章、用车、物品申领、合同审批；
        
    - 表单设计器 + 流程设计器；
        
    - 待办、已办、抄送、转交、加签、退回、委托。
        
3. **人事考勤**
    
    - 员工档案、合同、奖惩、社保、培训、考核、履历；
        
    - 班次、排班、打卡、补卡、外出、调休、年假自动计算。
        
4. **CMS & 内容**
    
    - 文章、分类、标签、广告、留言、友情链接；
        
    - 多语言、页面静态化、访问统计。
        
5. **商城 & 支付**
    
    - 商品、SKU、优惠券、订单、物流、售后；
        
    - 微信、支付宝、银联、PayPal、Stripe 统一网关；
        
    - 支持分账、退款、对账、合并支付。
        
6. **开发工具**
    
    - Gii 增强版：一键生成 Model/CURD/API/文档/菜单/权限；
        
    - 代码在线编辑、SQL 在线执行、队列实时监控；
        
    - 表单控件 16+、Excel 导入导出、二维码/条形码、图片裁剪/水印。
        

## 五、目录结构（典型安装后）

```
addon/                          插件目录
common/                         公共库
api/                            接口应用（REST入口）
backend/                        后台应用
merchant/                       企业端应用（SaaS）
frontend/                       PC端应用 （官网）
html5/                          移动端应用（公众号）
console/                        定时任务 & 队列
vendor/                         Composer 包
services/                       服务层（懒加载）
web/                            统一 入口
```

## 六、环境要求

- PHP ≥ 7.2（推荐 7.3）
    
- MySQL ≥ 5.7.34（或 MariaDB 10.2+）
    
- Redis ≥ 3.0（缓存 & 队列）
    
- Composer ≥ 2.0
    
- Nginx / Apache（含伪静态）
    

一键安装脚本（Linux）：

```bash
git clone https://gitee.com/hjp0725/yiiframe3
cd yiiframe3
composer install
php init          # 选择 dev/prod
php yii migrate/up
```
默认账号密码admin/123456

## 七、适用场景

| 场景          | 说明                                       |
| :---------- | :--------------------------------------- |
| 企业 OA / 审批流 | 内置请假、报销、合同、用章等 20+ 流程，可视化设计              |
| SaaS 多租户    | 商户隔离、套餐计费、在线充值、套餐到期自动降级                  |
| 商城 / 小程序    | 商品、订单、支付、物流、售后、分销、拼团、砍价                  |
| 内容门户        | 文章、视频、图库、广告、评论、TAG、静态化                   |
| 接口中台        | 统一对外 REST / OAuth2，前端可 Vue、React、Uni-App |

## 八、生态与文档

- 官方文档：[http://doc.yiiframe.com](http://doc.yiiframe.com/)
    
- 插件市场（内置）
    
- GitHub：[https://github.com/hjp0725/yiiframe3](https://github.com/hjp0725/yiiframe3)
    
- Gitee：[https://gitee.com/hjp0725/yiiframe3](https://gitee.com/hjp0725/yiiframe3)
    
- 示例项目：UniOA（UniApp + YiiFrame 办公系统）
    
## 九、一句话总结

YiiFrame = **Yii2 的成熟稳定 + Bootstrap 的漂亮界面 + 插件化的高扩展 + 代码生成的极速开发**，让你把精力花在业务创新，而不是重复造轮子。

## 十、免责声明

1. 本软件是基于RageFrame二次开发的开源框架，仅作学习交流使用。
2. 本软件**按“现状”提供**，作者与贡献者在法律允许的最大范围内**不承担任何明示或暗示的担保责任**，包括但不限于适销性、特定用途适用性、数据准确性或无侵权保证。  
3. 用户**自行承担**因使用、修改、分发本软件而产生的全部风险；因本软件导致的任何直接或间接损失（包括但不限于数据丢失、业务中断、信息泄露、第三方索赔），作者及贡献者**不承担任何责任**。  
4. 本软件所集成的第三方组件（含前端框架、支付 SDK、云存储驱动等）之**版权、专利、商标、服务条款**由其各自权利人负责，使用前应**仔细阅读并遵守**对应组件的授权协议与隐私政策；若产生纠纷，与本软件作者无关。  
5. 本软件**非医疗、金融、执法、航空航天、核能**等高风险领域专用系统，若将其用于上述场景或任何**可能危害人身、财产安全**的环境，所产生的一切后果由用户自行承担。  
6. 本软件内置的**一键生成代码、工作流、表单设计器**等功能仅为辅助开发工具，生成的业务逻辑、SQL 语句、权限规则等**需经专业开发/审计人员二次确认**后方可上线；因直接使用生成代码导致的性能、安全、合规问题，作者概不负责。  
7. 用户通过本软件插件市场下载或安装的**第三方插件、主题、支付通道、短信网关**等，均系独立开发者提供，其**合法性、安全性、准确性**由插件作者承担；请在安装前**自行审查**源码、权限与数据流向，并**在测试环境充分验证**。  
8. 本软件**不提供永久维护承诺**，社区版本更新、文档修正、漏洞响应时间**取决于开源贡献者精力**，建议商业项目购买官方或第三方技术支持服务，以获得 SLA 保障。  
9. 若您**不同意**本免责声明之任何条款，请**立即停止使用并删除**本软件及相关衍生作品；继续下载、安装、复制、修改、分发即视为**完全理解并接受**本声明全部内容。

## 特别鸣谢

感谢以下的项目，排名不分先后

Rageframe2：http://www.rageframe.com

Yii：http://www.yiiframework.com

EasyWechat：https://easywechat.com

Bootstrap：http://getbootstrap.com

AdminLTE：https://adminlte.io