--- ## 🚀 重新定义企业级中后台开发体验 > **🎯 一个敏捷的，为开发者体验而生的企业级中后台解决方案** *在这里，当 `Bun` 的极致性能遇上 `Vue3` 的组合式 API，当 `TypeScript` 的类型安全拥抱 `UnoCSS` 的原子化样式...* ### 📊 项目成长图 **📈 项目数据概览** ### 🚀 想让这些数据更好看？一起来搞！ _{**💡 贡献不分大小，每个 PR 都让项目更好！** 文档错字、代码注释、新功能都欢迎！} --- ## ⚡ 为什么选择 Robot Admin？_{(肤白貌美大长腿)} ### 🔥 性能怪兽级别的开发体验 - **毫秒级热更新** - Bun + Vite7 化学反应，告别等待 - **智能类型提示** - TypeScript5.8 + 30+ 自定义组件，IDE 智能感知体验拉满 - **零配置开箱即用** - 一条命令启动，30 秒内搭建完整后台系统 ### 🎨 不只是一个管理系统，更是一个作品 - **30+ 精心打磨的演示页面（陆续追加）** - 每一个都是可直接用于生产的业务组件 - **7 种自定义指令** - 防抖、节流、长按、拖拽、权限...让开发更优雅 - **主题系统** - 深色/浅色模式/跟随系统 + 支持自定义扩展，随心所欲 ### 🛠️ 企业级架构，个人项目也能享受 - **RBAC 权限体系** - 菜单级、按钮级、接口级，权限控制细致入微 - **渐进式微前端** - 架构设计支持从单体到微前端的平滑演进 - **生产级工程化** - ESLint + Prettier + Husky，代码质量无忧 --- ## 🚀 快速开始（真的很快！）

> 🎉 **推荐使用 Bun** - 体验前所未有的安装速度 ```bash # 1. 克隆项目 git clone https://github.com/ChenyCHENYU/robot_admin.git # 2. 进入目录 cd robot_admin # 3. 安装依赖（如闪电般快速） bun install # 4. 启动项目（毫秒级启动） bun dev ``` **🔥 首次启动只需 2 秒不到，后续热更新不到 100ms！** 如果你还没有 Bun： ```bash npm install -g bun ```

**🔧 开发相关** ```bash bun dev # 开发环境启动 bun run build # 生产环境构建 bun run build:test # 测试环境构建 bun run build:staging # 预发布构建 bun run preview # 本地预览构建结果 ``` **📋 代码质量** ```bash bun run lint # 代码检查和修复 bun run format # 代码格式化 bun test:unit # 单元测试 ``` **🎯 类型检查** ```bash bun run type-watch # 监听模式类型检查 bun run type:check # 智能类型分析 ``` **📦 提交代码** ```bash bun run commit # 规范化提交（git cz） ``` **⚡ 其他命令** ```bash bun outdated # 检查依赖更新 bun clean # 清理缓存 ```

--- ## ✨ 核心亮点 ### 🏗️ 技术栈（高富帅阵容） **🎭 前端核心**     - **Vue 3.5.13** - 🔥 最新稳定版，Composition API 丝滑体验 - **TypeScript 5.8** - 🛡️ 类型安全，智能提示 - **Naive UI 2.41** - 🎨 颜值与性能并存的组件库 - **UnoCSS 66.0** - ⚡ 原子化CSS，按需生成，体积极小 **⚙️ 构建工具**    - **Bun 1.x** - 🚀 性能怪兽，安装速度提升10倍 - **Vite 7.0.6** - ⚡ 下一代构建工具，热更新极速 - **Sass 1.87** - 🎨 成熟的CSS预处理器 **🔧 开发工具**    - **ESLint 9.21** - 📏 代码质量守护者 - **Prettier 3.5** - ✨ 代码格式化 - **Oxlint 0.15** - 🦀 Rust编写的超快Linter - **Vitest 3.0** - 🧪 现代化测试框架 ### 🎯 功能矩阵（30+ 实用功能） #### 🔐 权限管理 - **RBAC权限体系** - 用户-角色-权限，灵活分配 - **动态路由** - 根据权限实时生成菜单 - **按钮级权限** - 精确到每一个操作按钮 - **接口级权限** - API调用权限控制 #### 📊 数据可视化 - **ECharts 5.6** - 企业级图表库 - **实时Dashboard** - 数据大屏展示 - **FullCalendar** - 完整的日程管理 - **AntV X6** - 专业流程图引擎 #### ✏️ 编辑器生态 - **WangEditor** - 富文本编辑器 - **Markdown编辑器** - 实时预览，语法高亮 - **代码编辑器** - 支持多语言语法高亮 - **JSON编辑器** - 结构化数据编辑 #### 📁 文件处理 - **Excel导入导出** - 支持复杂表格结构 - **ZIP批量下载** - 文件打包压缩 - **图片截图** - Html2canvas 网页截图 - **文件上传** - 多格式文件支持 #### 🎮 交互增强 **拖拽排序** - 列表、表格自由拖拽 | **3D展示** - Spline 3D场景 | **动画系统** - 流畅的页面转场 | **用户引导** - 新手引导系统 ### 🧩 组件库（开箱即用） **核心组件** - `C_Form` - 动态表单引擎，支持8种布局 - `C_Table` - 超级表格，支持虚拟滚动 - `C_Header` - 响应式头部组件 - `C_Menu` - 智能导航菜单 - `C_Icon` - 图标管理系统 - `C_Theme` - 主题切换组件 **业务组件** - `C_Code` - 代码编辑器组件 - `C_Markdown` - Markdown编辑器 - `C_Time` - 时间处理组件 - `C_Progress` - 进度展示组件 **等等等等...不一一赘述** ### 🎪 演示页面（手摸手私秘级的学习保姆） > **30+ 精心制作的演示页面，每一个都赤诚奔赴最佳实践**

🎨 基础组件展示

- 🎨 **图标组件** - 完整的图标系统使用指南 - 🏙️ **地区联动** - 省市区三级联动实现 - 📊 **进度条** - 多种样式进度展示 - ⏰ **时间组件** - 时间选择和格式化 - 📅 **日期选择** - 日期范围选择器 - 🌆 **城市选择** - 城市选择器组件

📝 表单与表格

- 📝 **表单布局** - 8种表单布局模式 - 🔍 **表单搜索** - 高级搜索功能 - 📋 **超级表格** - 表格的各种高级用法

✏️ 编辑器展示

- 📆 **日历组件** - FullCalendar完整功能 - 💻 **代码编辑器** - 多语言语法高亮 - 📖 **Markdown编辑器** - 实时预览编辑 - ✏️ **富文本编辑** - WangEditor完整功能

🛠️ 实用功能

- 📦 **导出ZIP** - 批量文件打包下载 - 📋 **复制功能** - 文本复制到剪贴板 - ⬇️ **批量下载** - 文件批量下载处理 - 🔄 **拖拽排序** - 列表项拖拽排序

🎯 自定义指令

      

- 📄 **v-copy** - 复制指令 - 💧 **v-watermark** - 水印指令 - 👆 **v-draggable** - 拖拽指令 - ⏱️ **v-debounce** - 防抖指令 - 🚦 **v-throttle** - 节流指令 - 👆 **v-longpress** - 长按指令 - 🔐 **v-permission** - 权限指令

--- ## 🏗️ 项目架构 ### 📁 目录结构（清晰明了）

``` Robot_Admin/ ├── 📁 src/ # 源代码目录 │ ├── 📁 api/ # 接口管理层 │ ├── 📁 components/ # 组件库 │ │ ├── 📁 global/ # 全局组件（10+ 核心组件） │ │ └── 📁 local/ # 局部组件 │ ├── 📁 views/ # 页面视图 │ │ ├── 📁 dashboard/ # 数据看板 │ │ ├── 📁 demo/ # 演示页面（30+ 功能展示） │ │ ├── 📁 sys-manage/ # 系统管理（用户、角色、权限、菜单） │ │ ├── 📁 login/ # 登录注册 │ │ └── 📁 home/ # 项目主页 │ ├── 📁 stores/ # Pinia状态管理 │ ├── 📁 composables/ # 组合式API │ ├── 📁 hooks/ # 自定义Hooks ```

``` │ ├── 📁 router/ # 路由配置 │ ├── 📁 utils/ # 工具函数 │ ├── 📁 types/ # TypeScript类型定义 │ ├── 📁 directives/ # 自定义指令（7个实用指令） │ ├── 📁 assets/ # 静态资源 │ └── 📁 plugins/ # 插件配置 ├── 📁 scripts/ # 构建脚本 ├── 📁 public/ # 静态资源 ├── ⚙️ vite.config.ts # Vite配置 ├── 🎨 unocss.config.ts # UnoCSS配置 ├── 📦 package.json # 项目配置 ├── 🔧 tsconfig.json # TypeScript配置 ├── 📏 eslint.config.ts # ESLint配置 └── 📖 README.md # 项目说明 ```

### 🔄 架构演进路线 ```mermaid graph LR A[🏠 Monomer
单体架构] --> B[📦 Monorepo
单仓多包] B --> C[🔗 MicroApp
微前端] C --> D[🚀 NestJS
全栈方案] A -.->|当前阶段| E[✅ 快速开发] B -.->|进行中| F[📚 组件库独立] C -.->|规划中| G[🔧 插件化架构] D -.->|愿景| H[🌟 PC/移动/桌面3端完整解决方案的大逼兜大满贯yy] ``` --- ## 🤝 加入 Robot Admin 开发大军 > **来啊，快活啊！一起搞事情啊！** 🎉 ### 🚀 30秒快速上手贡献

**📝 简单贡献（新手友好）** ```bash # 1. Fork + Clone git clone https://github.com/你的用户名/robot_admin.git # 2. 安装依赖 bun install # 3. 启动项目 bun dev # 4. 改代码，提交PR ``` **适合做什么？** - 🐛 修复文档错别字 - 📝 添加代码注释 - 🎨 优化界面样式 - 📊 新增演示页面

**🔥 高级贡献（老司机专用）** ```bash # 1. 讨论新功能 # 在 Issues/Discussions 里聊聊 # 2. 开发新功能 git checkout -b feat/awesome-feature # 3. 测试 + 提交 bun test && git commit -m "feat: 牛逼功能" # 4. 创建 PR ``` **可以搞什么？** - ⚡ 性能优化 - 🧩 新组件开发 - 🛠️ 工具函数 - 🎪 自定义指令

### 💡 贡献方向指南

🎨 UI/演示页面贡献 - 最容易上手，最有成就感

**什么是演示页面？** - 展示某个功能的完整使用案例 - 现在有 30+ 页面，目标是 50+ **怎么贡献？** - 在 `src/views/demo/` 下新建页面 - 展示一个完整的业务场景 - 代码要有注释，能复制粘贴直接用 **举个例子：** - 新的图表类型展示页 - 表单验证最佳实践 - 文件上传处理流程 - 权限控制使用案例

🧩 组件开发贡献 - 核心功能，影响力大

**全局组件标准：** - 放在 `src/components/global/` - 组件名以 `C_` 开头 - 必须有 TypeScript 类型定义 - 要有完整的使用文档 **当前急需：** - 更多的表单组件 - 数据展示组件 - 交互增强组件

🛠️ 工具函数贡献 - 小而美，实用性强

**放哪里？** - `src/utils/` 目录下 - 按功能分类建文件 **写什么？** - 日期时间处理 - 数据格式化 - 文件处理 - 网络请求封装 **要求：** - 要有单元测试 - 要有 JSDoc 注释 - 要考虑边界情况

### 🏆 贡献者激励

**🌟 新手村** 第1个PR 修复文档、优化样式

**🚀 开发者** 5个PR+ 新增功能、组件开发

**🧠 架构师** 10个PR+ 核心功能、性能优化

**👑 核心团队** 长期贡献 项目决策、技术指导

**🎁 贡献者福利：** - 📛 **GitHub 展示** - README 贡献者墙 - 💼 **简历亮点** - 开源项目经验 - 🎓 **技术成长** - 实战中学习最新技术 - 🤝 **人脉拓展** - 认识更多优秀开发者 ### 📞 贡献支持 **遇到问题？** - 📖 [详细贡献指南](./CONTRIBUTING.md) - 手把手教学 - 💬 [GitHub Discussions](https://github.com/ChenyCHENYU/robot_admin/discussions) - 讨论交流 - 📧 [邮件联系](mailto:ycyplus@gmail.com) - 直接沟通 **想要贡献但不知道做什么？** --- **💪 现在就开始你的第一个贡献吧！** --- ## 📱 响应式设计 > **尽量适配所有设备，无论是桌面、平板还是手机** - **🖥️ 桌面端** - 1200px+ 完整功能体验 - **📱 平板端** - 768px-1200px 适配优化 - **📱 手机端** - <768px 移动端友好 --- ## 🛠️ 开发者工具推荐 ### 📋 关于部分 vscode 插件使用

> 1. **Vscode Samge Translate 插件** - `desc：` 用于快速中英文翻译切换，并生成变量命名方式 - `cc` Ctrl+Shift+P， 选择 Samge 进行对应功能使用 - `key：` `Alt+x` 翻译成中文， `Alt+z` 翻译成英文 > 2. **any-rule 插件** - `desc：` 用于快速生成正则 - `use：` 右键 => 正则大全 - `key：` `@zz` 弹出正则选项,根据生成的选项,可以图解正则 > 3. **Better Comments 插件** - `desc：` 在js文件中,通过颜色标记区分注释评论描述 - `use：` //\* 绿色 //! 红色 //? 蓝色 - `key：` 注释修饰[* ! ? ] > 4. **code settings sync 插件** - `desc：` 用于快速团队同步 vscode 插件及配置 - `use：` [地址](https://marketplace.visualstudio.com/items?itemName=Alex-Chen.gitee-code-settings-sync) > 5. **Code Spell Checker 插件** - `desc：` 用于快速检查代码和文档拼写是否正确 - `use：` 将一些典型词，非语法错误的单词，报波浪提示后添加cspell.json，或通过灯泡添加 - `key：` 拼写后单词上方提示的黄色小灯泡💡

> 6. **CodeSnap 插件** - `desc：` 用于快速生成代码截图 - `use：` 右键 => 底部选项 CodeSnap > 7. **EmoJi 插件** - `desc：` 用于快速选择表情符号 - `use：` 输入 `Ctrl+Shift+P` => 输入 `emo` 行对应表情 - `key：` `F1 => emo` > 8. **JSON to JS 插件** - `desc：` 用于快速将json格式转换为js格式 - `use：` 从剪切板，选择转换，可选引号 3种 方式进行转换 - `key：` `Shift + Ctrl + Alt + V | S` 或 `F1 => Clipboard` > 9. **koroFileHeader 插件** - `desc：` 用于添加头部注释，函数注释 - `use：` 在文件头部使用快捷键，或自动识别生成，函数注释勾选使用快捷键生成 - `key：` `ctrl+win+i` 头部注释 `ctrl+win+t` 函数注释 > 10. **TODO Tree 插件** - `desc：` 用于快速高亮代码中的 TODO 等标记性注释 - `use：` 通过注释关键词的方式，高亮显示 - `key：` TODO: 待完成 | BUG: 问题 | TAG: 标签 | FIXME: 待修复 | HACK: 自定义 | MARK: 标记 > 11. **Turbo Console Log 插件** - `desc：` 用于快速生成 console 打印信息 - `use：` 通过选中变量，按下快捷键，生成打印句柄 - `key：` `ctrl+alt+l` 生成 `alt+shift+c` 注释所有 **+u** 启用所有 **+d** 删除所有

--- ## 🎨 主题定制 > **让你的后台系统拥有独特的视觉风格** ### 🌙 深色/浅色模式 - 一键切换，白嫖不懂爷的黑 - 自动跟随系统主题 - 自定义主题色彩（后续扩展） --- ## 🔒 安全与权限 ### 🛡️ 多层次权限控制 - **页面级权限** - 路由访问控制 - **菜单级权限** - 导航菜单显示控制 - **按钮级权限** - 操作按钮权限控制 - **接口级权限** - API调用权限验证 ### 🔐 身份认证 - `JWT Token` 认证 - 刷新Token自动续期（马上替换模拟的真实接口，给俺点时间） - 多终端登录管理（这个后续计划就整到位，做成开关配置的） - 密码强度验证 --- ## 📊 性能优化 ### ⚡ 构建优化 - **Tree Shaking** - 无用代码自动移除（考虑未来服务于中大型项目，也添加了相关配置，后面做一个插件） - **代码分割** - 按需加载，减少首屏时间 - **资源压缩** - CSS/JS/图片智能压缩 - **CDN加速** - 静态资源CDN部署 ### 🚀 运行时优化 - **虚拟滚动** - 大数据表格流畅渲染 - **组件懒加载** - 路由级别懒加载 - **图片懒加载** - 视口内图片按需加载 - **防抖节流** - 高频操作性能优化 ### ⚡ 性能基准测试 | 指标 | Robot Admin | 传统方案 | 提升幅度 | |:---:|:---:|:---:|:---:| | 🚀 首屏加载 | < 800ms | ~2.5s | **70%+** | | ⚡ 热更新速度 | < 100ms | ~1.5s | **90%+** | | 📦 构建速度 | < 30s | ~2min | **75%+** | | 💾 Bundle大小 | < 2MB | ~5MB | **60%+** | | 🔄 页面切换 | < 50ms | ~300ms | **85%+** | **测试验证**: HP 幽灵360, 16GB RAM, Node.js 22+ --- ## 🚀 部署方案 ### ☁️ 多环境支持 - **开发环境** - 本地开发调试 - **测试环境** - 功能测试验证 - **预发布环境** - 生产前最后验证 - **生产环境** - 线上正式环境 ### 📦 部署选项 - **Vercel** - 零配置部署 - **GitHub Pages** - 静态部署 - **Docker** - 容器化部署 - **传统服务器** - Nginx部署 --- ## 💻 系统要求 ### 🔧 开发环境 - **`Node.js`**: >= 20.19.0 (推荐 22.12+) - **`Bun`**: >= 1.2.19 (推荐最新版) - **内存**: >= 8GB RAM - **存储**: >= 1GB 可用空间 - **系统**: 不小于 Windows 10+, macOS 12+, Ubuntu 20.04+ ### ⚙️ 可选工具 - **VS Code**: 推荐编辑器 - **Git**: >= 2.20.0 - **Docker**: >= 20.0 (容器部署) ### 🌐 浏览器要求 - **Chrome**: >= 90 | **Firefox**: >= 88 - **Safari**: >= 14 | **Edge**: >= 90 --- ## 🆚 对比其他解决方案 > 社区有很多优秀的项目，这只是选样对比，仅供参考 | 特性对比 | Robot Admin | Ant Design Pro | Vue Element Admin | 其他框架 | |:---:|:---:|:---:|:---:|:---:| | 🚀 启动速度 | **Bun < 100ms** | npm ~2s | yarn ~1.5s | 普遍较慢 | | ⚡ 热更新速度 | **< 100ms 极速** | ~1.5s 等待 | ~1s 等待 | 普遍较慢 | | 📦 构建工具 | **Vite 7.x 最新** | Webpack/Vite | Webpack 4/5 | 工具多样 | | 🎨 UI 组件库 | **Naive UI 轻量** | Ant Design | Element Plus | 选择多样 | | 💪 TypeScript | **完整类型支持** | 基础支持 | 基础支持 | 支持程度不一 | | 🔧 自定义指令 | **7个实用指令** | 少量指令 | 基础指令 | 功能有限 | | 📊 演示页面 | **30+ 完整示例** | 有限示例 | 有限示例 | 基础示例 | | 🎯 学习成本 | **中等友好** | 较高门槛 | 中等门槛 | 差异较大 | | 📈 维护状态 | **🔥 积极维护** | 持续维护 | 持续维护 | 状态不一 | **🎯 选择 Robot Admin 的理由**: - 🚀 **性能优先**: Bun + Vite7 双引擎，开发体验极致 - 🧩 **组件丰富**: 30+ 业务组件，开箱即用 - 🎨 **设计现代**: Naive UI + UnoCSS，颜值与性能并存 - 📚 **学习友好**: 30+ 演示页面，每个都是裸奔最佳实践 --- ## 📈 路线图 ### 🎯 短期目标 (Q1 2025) - [ ] 🎨 主题系统完善 - [ ] 📱 移动端适配优化 - [ ] 🔧 UnoCSS配置优化 - [ ] 📊 性能监控集成 ### 🚀 中期规划 (Q2-Q3 2025) - [ ] 🏢 多租户系统支持 - [ ] 🔗 微前端架构支持 - [ ] 📚 组件库独立发布 - [ ] 🎨 可视化页面模板 ### 🌟 长期愿景 (Q4 2025+) - [ ] 🏗️ NestJS后端服务 - [ ] 🛠️ 低代码平台集成 - [ ] ☁️ 云原生部署方案 - [ ] 🔌 完整插件生态 --- ## 🌍 环境配置 ### ⚙️ 环境变量 ``` .env # 基础配置 .env.development # 开发环境 .env.test # 测试环境 .env.staging # 预发布环境 .env.production # 生产环境 ``` ### 🔧 构建命令 ```bash bun dev # 开发环境 bun run build:test # 测试环境构建 bun run build:staging # 预发布构建 bun run build # 生产环境构建 ``` --- ## 🖼️ 项目预览

 登录页面

 首页页面

> **🎯 [在线预览](https://www.robotadmin.cn/)** | **📖 [项目文档](https://www.tzagileteam.com)** 注意，若无法访问请关闭科学上网方式，某些ip有限制，或者直接访问 [备用地址](https://robot-admin-new.vercel.app/) --- ## 🖥️ 浏览器支持 **现代浏览器，拒绝IE**

[](http://godban.github.io/browsers-support-badges/) **Edge** Latest 2 versions

[](http://godban.github.io/browsers-support-badges/) **Firefox** Latest 2 versions

[](http://godban.github.io/browsers-support-badges/) **Chrome** Latest 2 versions

[](http://godban.github.io/browsers-support-badges/) **Safari** Latest 2 versions

--- ## 🔄 迁移指南 ### 从 Vue Element Admin 迁移 ```bash # 1. 安装依赖 bun install # 2. 迁移路由配置 # 从 router/index.js 迁移到 src/router/ # 路由结构基本兼容，需要调整meta字段 # 3. 迁移组件 # Element UI -> Naive UI # 组件API有差异，但迁移成本较低 # 4. 迁移状态管理 # Vuex -> Pinia # 更简洁的API，性能更好 ``` ### 从 Ant Design Pro 迁移 ```bash # 1. 调整构建工具 # Webpack -> Vite # 配置更简单，速度更快 # 2. 迁移组件库 # Ant Design -> Naive UI # 组件功能类似，样式更现代 # 3. TypeScript配置 # 已有完整配置，开箱即用 ``` --- ## 🛠️ 故障排除 ### ❌ Bun 安装失败 **解决方案:** ```bash # Windows 用户 curl -fsSL https://bun.sh/install | bash # macOS 用户 (推荐使用 Homebrew) brew install oven-sh/bun/bun # 或使用 npm 安装 npm install -g bun ``` ### ⚠️ 端口占用问题 **解决方案:** ```bash # 修改 vite.config.ts 中的端口 server: { port: 3001, // 改为其他端口 host: true } # 或启动时指定端口 bun dev --port 3001 ``` ### 🔧 TypeScript 类型错误 **解决方案:** ```bash # 重新生成类型文件 bun run type:check # 清除类型缓存 rm -rf node_modules/.cache bun install ``` ### 📦 构建失败 **解决方案:** ```bash # 检查依赖版本 bun outdated # 清除缓存重新安装 rm -rf node_modules bun.lockb bun install # 强制类型检查 bun run type-build ``` --- ## 🌟 生态系统 ### 🔗 相关项目 - **[Robot UI](https://github.com/ChenyCHENYU/robot-ui)** - 独立的组件库 (以后根据公司业务发展看吧) - **[Robot CLI](https://github.com/ChenyCHENYU/robot-cli)** - 脚手架工具 (这个正在搞，给点时间，开发中) - **[Robot Mobile](https://github.com/ChenyCHENYU/robot-mobile)** - 移动端解决方案 (规划中) - **[Robot Backend](https://github.com/ChenyCHENYU/robot-backend)** - NestJS 后端服务 (规划中) ### 🧩 插件生态 - **robot-plugin-charts** - 图表插件扩展 - **robot-plugin-editor** - 编辑器插件合集 - **robot-plugin-auth** - 权限插件增强 - **robot-plugin-deploy** - 部署工具插件 ### 📖 学习资源 - **[官方文档](https://www.tzagileteam.com)** - 完整的使用指南（马上出，正在规划大纲） - **[视频教程](https://space.bilibili.com/robot-admin)** - B站教学视频 (看使用情况吧，看时间) - **[在线课程](https://www.robotadmin.cn/course)** - 系统性学习课程 (规划中) - **[最佳实践](https://www.robotadmin.cn/best-practices)** - 实战经验分享，计划后面让团队伙伴基于业务场景做分享视频 --- ## 👥 社区 ### 💬 讨论与交流 - **[GitHub Discussions](https://github.com/ChenyCHENYU/robot-admin/discussions)** - 项目讨论区 - **[QQ群](https://qm.qq.com/robot-admin)** - 即时交流群 (申请中) - **[微信群](https://weixin.qq.com/robot-admin)** - 微信技术群 (规划中) - **[Discord](https://discord.gg/robot-admin)** - 国际化社区 (以后再说...) ### 🤝 贡献者 感谢所有为项目做出贡献的开发者： **成为贡献者:** - 🐛 报告 Bug | 💡 提出功能建议 | 📝 改进文档 | 🔧 提交代码 | 🌍 翻译文档 | 📢 推广项目 ### 🏆 特别鸣谢 - **Vue.js 团队** - 提供强大的框架基础 - **Naive UI 团队** - 提供优秀的组件库 - **Vite 团队** - 提供极速的构建工具 - **Bun 团队** - 提供革命性的运行时 - **所有 Star 和 Fork 的开发者** - 给予项目支持与信任 --- ## 🔒 安全政策 ### 🛡️ 安全漏洞报告 如果您发现安全漏洞，请通过以下方式报告： - **加密邮箱**: [ycyplus@gmail.com](mailto:ycyplus@gmail.com) (PGP公钥) - **私有议题**: [GitHub Security](https://github.com/ChenyCHENYU/robot-admin/security) **⚠️ 请勿在公开场所披露安全漏洞** ### 🔐 安全最佳实践 - 定期更新依赖包版本 - 使用 HTTPS 进行数据传输 - 实施内容安全策略 (CSP) - 启用跨站请求伪造 (CSRF) 保护 - 使用安全的 JWT Token 配置 --- ## 💰 赞助支持 如果这个项目对您有帮助，欢迎赞助支持项目持续发展： ### ☕ 请作者喝咖啡 ### 🏢 企业赞助 企业用户如需技术支持、定制开发、培训服务，请联系： - **邮箱**: [ycyplus@gmail.com](mailto:ycyplus@gmail.com) --- ## 📋 行为准则 我们致力于创建一个开放、包容、友好的社区环境。参与项目的所有人员都应遵守以下准则： ### ✅ 我们鼓励 - 🤝 友善和耐心的交流 - 🌍 尊重不同观点和经验 - 💡 建设性的反馈和批评 - 🔄 关注对社区最有利的事情 - ❤️ 对其他社区成员表现出同理心 ### ❌ 不被接受的行为 - 🚫 使用性别化语言或图像 - 🚫 恶意评论或人身攻击 - 🚫 公开或私下的骚扰行为 - 🚫 未经许可发布他人私人信息 - 🚫 其他可能被认为不当的行为 **违规处理**: 项目维护者有权移除、编辑或拒绝不符合行为准则的评论、提交、代码等。 --- ## 📄 更新日志 ### 🎉 v1.0.0 (2025-07-10) - ✨ 首个正式版本发布 - 🎨 30+ 核心组件完整实现 - 📊 30+ 演示页面全部完成 - 🔧 7个自定义指令实现 - 🛡️ 完整的权限管理系统 - 📱 响应式设计全面适配 - 🧪 测试覆盖率达到 85%+ ### 📋 完整更新日志 查看 [CHANGELOG.md](./CHANGELOG.md) 了解详细的版本历史。 --- ## ❓ 常见问题 #### 🔧 为什么推荐使用Bun？ Bun是新一代JavaScript运行时，相比npm/yarn： - 安装速度提升10倍+ - 内存占用更低 - 内置打包器、测试运行器 - 完全兼容Node.js生态 #### 🎨 如何自定义主题？ 1. 修改 `src/assets/css/theme.scss` 中的CSS变量 2. 使用 `C_Theme` 组件进行动态切换 3. 支持深色/浅色模式自动切换 #### 🔐 权限系统如何使用？ 系统支持4级权限控制： - 页面级：路由守卫控制 - 菜单级：动态菜单生成 - 按钮级：v-permission指令 - 接口级：axios拦截器 #### 📱 是否支持移动端？ 完全支持！项目采用响应式设计： - 桌面端：完整功能 - 平板端：适配优化 - 手机端：核心功能 --- ## 🌍 国际化支持 Robot Admin 是可以支持多语言的，让全球开发者都能便捷使用，但需要给我点时间完善： ### 🗣️ 支持语言 - 🇨🇳 **中文简体** - 默认语言 - 🇺🇸 **English** - 计划支持 - Others **其他** - 看使用情况吧 --- ## 📚 API 文档 ### 🔗 文档链接 - **[完整API文档](https://www.robotadmin.cn/api)** - 详细的接口说明 - **[组件文档](https://www.robotadmin.cn/components)** - 组件使用指南 - **[工具函数](https://www.robotadmin.cn/utils)** - 实用工具函数 - **[类型定义](https://www.robotadmin.cn/types)** - TypeScript 类型 --- ## 📊 示例项目 基于 Robot Admin 构建的真实项目案例： ### 🏢 企业项目 - **[某某系统(老版本)](https://demo-crm.robotadmin.cn)** - 其实蛮多的，涉敏不便公开 --- ## 📞 联系我们 **🧑‍💻 作者信息** - **姓名：** CHENY（前端咔啦咪 & 敏捷追光者） - **简介：** 一只小趴菜 | 🐔🐤🐓 菜鸡互啄 - **邮箱：** [ycyplus@gmail.com](mailto:ycyplus@gmail.com) - **GitHub：** [@ChenyCHENYU](https://github.com/ChenyCHENYU) **🔗 项目链接** - **预览地址：** [https://www.robotadmin.cn](https://www.robotadmin.cn) - **项目文档：** [https://www.tzagileteam.com](https://www.tzagileteam.com) - **GitHub仓库：** [Robot Admin](https://github.com/ChenyCHENYU/robot-admin) --- ## 🙏 致谢 ### 🌟 开源项目致谢 感谢以下优秀的开源项目，为 Robot Admin 提供了强大的技术支撑： **🚀 核心技术** - [Vue.js](https://vuejs.org/) - 渐进式JavaScript框架 - [Vite](https://vitejs.dev/) - 下一代前端构建工具 - [TypeScript](https://www.typescriptlang.org/) - 带类型的JavaScript - [Naive UI](https://www.naiveui.com/) - Vue 3 组件库 - [UnoCSS](https://uno.antfu.me/) - 即时原子化CSS引擎 - [Bun](https://bun.sh/) - 极速JavaScript运行时 **🛠️ 开发工具** - [Pinia](https://pinia.vuejs.org/) - Vue状态管理 - [Vue Router](https://router.vuejs.org/) - Vue路由管理 - [VueUse](https://vueuse.org/) - Vue组合式API工具集 - [ESLint](https://eslint.org/) - JavaScript代码检查 - [Prettier](https://prettier.io/) - 代码格式化工具 - [Vitest](https://vitest.dev/) - 单元测试框架 **📊 功能组件** - [ECharts](https://echarts.apache.org/) - 数据可视化图表库 - [AntV X6](https://x6.antv.vision/) - 图编辑引擎 - [FullCalendar](https://fullcalendar.io/) - 日历组件 - [WangEditor](https://www.wangeditor.com/) - 富文本编辑器 - [Highlight.js](https://highlightjs.org/) - 语法高亮库 ### 👨‍💻 特别感谢 - **Vue.js 团队** - 为现代前端开发奠定基础 - **Anthony Fu (@antfu)** - UnoCSS、unplugin等优秀工具的创作者 - **尤雨溪 (Evan You)** - Vue.js 的创造者和领导者 - **Naive UI 团队** - 提供优雅的Vue 3组件库 - **所有开源贡献者** - 让开源世界更美好 ### 🌟 社区支持 - **所有 Star 的开发者** - 给予项目信心和动力 - **提出 Issue 的用户** - 帮助项目发现和改进问题 - **贡献 PR 的开发者** - 让项目变得更好 - **推广项目的朋友** - 扩大项目影响力 - **使用项目的企业** - 验证项目的实用价值 > *"一个人可以走得很快，但一群人可以走得更远。感谢每一位支持 Robot Admin 的朋友！"* ### 🎯 持续改进 Robot Admin 将持续改进和完善，我们承诺： - 📈 **定期更新** - 跟进最新技术趋势 - 🐛 **快速修复** - 及时处理发现的问题 - 📚 **文档完善** - 持续改进使用文档 - 🤝 **社区建设** - 构建活跃的开发者社区 - 🌍 **生态扩展** - 丰富项目生态系统 --- ## 📜 开源许可 本项目基于 [MIT License](./LICENSE) 开源协议。 ``` MIT License Copyright (c) 2025 ChenY (Robot Admin) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. ``` **🎯 这意味着您可以：** - ✅ 免费使用本项目 - ✅ 修改源代码 - ✅ 商业使用 - ✅ 私有部署 - ✅ 分发和再许可 **📋 唯一要求：** - 📄 保留版权声明和许可证 ---