Skip to content
On this page

Grow Admin 是什么?

Grow Admin 是一个基于 Vue 3 / Vite / TypeScript 的 Monorepo 管理后台框架。它采用 IOC 模块化架构,并通过组件驱动桥接层支持在 Element Plus、Naive UI、Ant Design Vue 三套 UI 组件库之间切换,业务代码无需感知底层实现。

核心特性

  • IOC 模块化:基于 Inversify 的依赖注入,业务模块以 Library 形式独立开发、按需装配
  • 组件驱动桥接Grow* 契约组件 + 驱动包,一套业务代码适配三套 UI 库
  • Monorepo 分层DesignRock(框架核心)与 DesignCornerstone(业务模块)职责清晰
  • 动态路由与菜单:静态基础路由 + 接口驱动动态注册,目录与叶子节点职责分离
  • 开箱即用:内置路由中间件、HTTP 基础设施、国际化、状态管理、主题与布局配置
  • 宿主应用模式sample 作为宿主,统一完成驱动初始化与模块装配

与其他 Admin 框架有什么不同?

传统 Admin 框架通常将业务代码、组件封装、工具函数全部堆叠在单一应用中,模块之间耦合紧密,难以独立演进。

Grow Admin 打破了这一结构,围绕 可组合、可替换、可演进 设计。

维度传统 AdminGrow Admin
项目组织单应用 + 可选 packagesMonorepo 分层(Rock / Cornerstone / configs)
模块装配手动 import + 注册IOC 容器自动装配,Library 约定式接入
UI 组件库绑定单一组件库契约组件 + 驱动桥接,运行时切换
业务模块与应用强耦合独立 npm 包,peer 依赖契约层

技术栈

仓库地址

推荐阅读顺序

文档按「先跑起来 → 懂结构 → 配好壳 → 打通权限与接口 → 写页面 → 拆模块」排列,建议按序阅读:

  1. 快速上手 — 先跑起来
  2. 架构 — 懂目录、模块装配、路由菜单
  3. 配置与主题 — 改项目名、主题色、语言
  4. 认证与权限 — 登录、守卫、权限模式
  5. 网络与数据 — 请求封装与 Mock
  6. 组件文档 — 组件库基础、SearchBar / ColumnBar 等具体用法
  7. 低代码集成 — 低代码工具链、代码沙箱与各设计器入口
  8. 系统管理 — 组织、人员、账号、角色、菜单与权限配置
  9. 业务开发 — 新建 Cornerstone 包
  10. 开发规范 — 上线前对照检查
  11. 包说明 — 查某个 npm 包是干什么的

文档导航

入门

章节说明
快速上手安装、启动、验证示例

架构

章节说明
架构设计理念为什么这样设计
项目结构Monorepo 目录与分层
IOC 模块化Library 与模块装配
路由与菜单静态路由 + 动态菜单

配置与主题

章节说明
项目配置projectSetting、环境变量
主题与颜色主题色、CSS 变量、UnoCSS
主题与语言亮暗模式、中英文切换

认证与权限

章节说明
认证与登录Token、守卫、登录流程
权限模式BACK / FRONT / MIXTURE 配置与开发

网络与数据

章节说明
HTTP 基础设施请求封装、环境区分、开发多代理
Mock 数据本地假接口

组件文档

章节说明
组件概览契约 / 预设分类与入口
SearchBar高级搜索栏
ColumnBar表格列设置
AbstractEle动态表单项
其他组件Iconify、SplitPane 等

系统管理

章节说明
系统管理概述设计原则、关系模型、模块一览
部门管理树表、迁移 / 合并 / 停用
岗位与职级编制、职级独立维护
人员管理任职、调岗、生命周期
账号管理绑定人员、权限明细
角色管理菜单 / 功能 / 数据权限
菜单管理功能权限、表与字段定义
组织架构图ECharts 关系图
权限联动与通用规则跨模块通用口径

业务开发

章节说明
业务模块开发新建 Cornerstone 包

规范与约定

章节说明
开发规范推荐做法、命令、包速查

包说明

章节说明
DesignRock 核心层框架 npm 包
DesignCornerstone 业务层业务 npm 包
构建配置Vite、TSConfig 等

包管理器

本项目使用 pnpm 管理 Monorepo 工作区,请使用 pnpm 安装依赖,不要使用 npm 或 yarn。