【更新】madong 5.x 企业级极速开发框架

一、框架总览

madong 5.x 是基于 Webman 2.2 + Workerman 5.1 开发的企业级极速开发框架系统，以「轻量化、高效率、易二开」为核心设计理念，专注通用业务生产级解决方案，从架构、安全、权限、代码生成、性能全维度优化，打造 Webman 生态优质后台开发底座。

仓库地址：https://gitee.com/motion-code/madong-admin
官方文档：https://madong.tech
讨论交流：点击链接加入群聊：690671595
项目演示：https://demo.madong.tech/ 账号：admin 密码：123456

二、核心技术栈（现代化强栈）

核心优势

• 常驻内存运行，无重复请求初始化开销
• 协程 + 异步 IO 模型，高并发能力拉满
• 全面适配 PHP8.2+ 注解、强类型、新特性
• 代码架构干净整洁，二次开发自由度极高

三、架构设计

1. 清晰分层架构

• Controller：请求入口、参数校验、接口分发
• Service：核心业务逻辑封装
• DAO：数据访问层统一封装
• Model：数据表结构与模型定义
• Middleware：请求拦截、权限校验、日志记录

2. 目录结构（标准化）

madong/
├─ backend/      后端（Webman 核心）
│  ├─ app/       业务代码（adminapi / api）
│  ├─ core/      框架核心（JWT、权限、代码生成器）
│  ├─ config/    全局配置中心
│  └─ plugin/    插件扩展目录
└─ frontend/     双前端分离架构

3. 双前端精准技术栈

• 管理后台：Vue3 + Vite + Element Plus
• 门户前台：Nuxt4.x + Element Plus

  前台支持 SSR 服务端渲染，完美适配搜索引擎 SEO 优化

4. 架构亮点

• 注解驱动自动路由，极简开发
• 通用 CRUD 基类封装，大幅减少重复代码
• 模块化设计，无冗余耦合
• 双端适配，一套后端支撑管理端+官网前台

四、核心能力（生产级硬实力）

1. 增强版 JWT 认证体系

• Token 黑名单机制，登出即时失效
• 令牌自动刷新、旧凭证强制作废
• 账号封禁、全员下线管控
• 多终端登录策略灵活配置

2. 三层企业级权限系统

1. 菜单+按钮权限：权限标识精准控制
2. 接口级权限：注解无感控制，零代码判断
3. 数据权限六大规则：
   • 全部数据、自定义部门、本部门
   • 本部门及子部门、仅本人数据、混合模式

3. 全能代码生成器

一键快速生成全套业务代码：

• 后端：控制器、服务层、模型、验证器、路由、权限
• 前端：Element Plus 表格、表单、搜索、导出组件
  快速完成常规业务开发，效率成倍提升。

4. 自动 API 文档（OpenAPI/Swagger）

代码注解自动同步生成接口文档：

• 自动识别请求/响应参数
• 关联接口权限标识
• 在线调试、参数校验预览
• 极大提升前后端协作效率

5. 内置基础业务模块

系统配置、数据字典、操作日志、登录审计、文件管理、安全防护等通用功能开箱即用，无需重复造轮子。

五、性能与安全（生产环境放心用）

性能优势

• Webman 常驻内存，超低资源消耗
• 数据库 / Redis 协程连接池
• 异步任务、防抖处理、请求优化
• 高并发场景稳定低延迟，适合长期部署

安全防护

• 增强型 JWT 全链路安全机制
• 全局请求参数强校验过滤
• 全链路操作日志自动记录
• 安全响应头、跨域防护、数据权限自动注入

六、与传统框架对比（优势明显）

七、快速部署（3 步上线）

# 1. 拉取项目源码
git clone https://gitee.com/motion-code/madong-admin.git
cd madong-admin/backend

# 2. 安装项目依赖
composer install

# 3. 一键拉取前端资源
php webman madong-download:frontend

# 4. 启动 Webman 服务
php start.php start

访问安装向导：
http://127.0.0.1:8001/install

八、适用场景

• 企业级管理后台、OA、CRM、进销存系统
• 企业官网、展示门户、需要 SEO 的前台项目
• 内部运维平台、数据管理中心、业务中台
• 外包项目快速落地、敏捷开发交付
• 传统老旧 PHP 项目现代化重构升级

九、Skills技能库, 喜欢AI IDE开发的直接下载，放到对应的目录。

https://gitee.com/motion-code/skills

.trae
.claude
.codebuddy

十、项目截图

总结

madong 聚焦开发者真实需求，
融合 Webman 高性能内核 + 双端现代化前端 + 工程化规范设计，
为企业与开发者提供轻量化、稳定、高效的一站式开发解决方案。

极简开发、稳定运行、易于维护，让 PHP 后台开发更简单、更高效。

开源关注与社区共建

仓库：https://gitee.com/motion-code/madong-admin
官网：https://madong.tech

项目永久开源、免费商用，持续迭代维护。
欢迎 Star、Fork、提交 PR & Issue，一同共建繁荣的 Webman 开源生态！