# 1.1 项目介绍

:::tip 概述
EasyGoAdmin 是企业级多租户后台管理基座，后端基于 GoFrame v2 框架，前端基于 Vue3 + Element Plus，完全前后端分离架构。内置完善的 RBAC 权限体系（权限颗粒度精细至按钮级别）、多租户数据隔离、角色行级数据权限，预置用户、角色、菜单、部门、岗位、职级、日志、字典、配置、参数、定时任务、代码生成器等基础功能模块，开箱即用。
:::

## 软件说明

基于 Go 1.27、GoFrame v2.10、Vue3、TypeScript、Vite、ElementPlus 等技术栈构建的企业级前后端分离后台管理系统，支持 MySQL、PostgreSQL、SQL Server、Oracle、SQLite 五种数据库，通过配置文件一键切换，并内置五方言整库迁移工具。

后端采用 Go 语言，基于 GoFrame v2 框架、gdb 数据库操作、gmeta 反射注解等主流技术栈；前端基于 Vue3、TypeScript、Vite 构建，采用 ElementPlus 框架，遵循前后端分离主流设计思想。

系统采用完全前后端分离架构，前端通过 API 调用后端服务实现数据交互。25 张业务表落地 27 个业务模块，全部平铺实现（auth/index + system7 + data7 + content3 + monitor7 + tool4）。

## 技术栈特性

+ **声明式 CRUD**：ModuleSpec 泛型基座 + 生命周期钩子，子类只需声明差异点（筛选、字典、文件字段、钩子），即可获得完整增删改查能力
+ **类型安全**：Go 强类型 + 请求结构体 gvalid 标签，运行时自动验证请求参数
+ **分层架构**：controller（HTTP）→ service 接口（依赖倒置）→ logic（业务）→ dao（数据），职责清晰
+ **基座复用**：ModuleSpec + logic/base.go 共享能力层组合式复用，无继承地狱
+ **模块可插拔**：业务模块位于 `internal/logic` 单包平铺，每模块一文件，同包 init 自动注册
+ **多数据库支持**：通过 `database.default.type` 一键切换五种数据库，五驱动全部预注册
+ **中间件可扩展**：CORS、响应兜底、限流、演示模式、认证、租户、日志七层中间件链式处理
+ **RBAC 权限**：后端 gmeta 标签 + 前端指令双重校验，精确到按钮级
+ **多租户隔离**：全局模型钩子自动处理 tenant_id 过滤与填充，业务代码零感知
+ **代码生成器**：根据数据库表结构一键生成前后端 CRUD 代码，同步创建菜单、权限节点、字典与路由

## 集成模块

+ **登录认证**：JWT 双令牌认证、图形验证码、OAuth2 兼容（refresh_token 轮换）、登录日志记录
+ **个人中心**：个人信息修改、头像上传、密码重置
+ **用户管理**：用户数据录入与管理，支持密码加密、头像上传、Excel 导入导出、城市编解码
+ **角色管理**：基于 RBAC 权限架构体系，支持权限分配与四档数据权限（全部/本部门及以下/本部门/仅本人）
+ **菜单管理**：权限菜单数据管理以及菜单节点权限数据管理
+ **部门管理**：组织架构部门数据管理，树形结构，删除有子级/用户守卫
+ **岗位管理**：用户岗位属性数据统一维护管理
+ **职级管理**：用户职级属性数据统一维护管理，支持 Excel 导入导出
+ **日志管理**：登录日志、操作日志、任务日志管理维护，中间件自动异步记录
+ **参数管理**：系统核心参数的定义和管理
+ **配置管理**：动态配置参数的统一管理和设置（配置 + 配置项两级结构）
+ **字典管理**：字典数据、字典项数据的管理和维护，进程内 300s 缓存驱动 {field}Text 显示
+ **通知公告**：通知、公告等站内数据的管理
+ **行政区划**：全国行政区划数据管理和维护（大数据量表，级联懒加载）
+ **文件模板**：系统中使用的文件模板上传和管理
+ **文件上传**：统一的文件上传服务，两段式上传（临时中转 → 表单保存转正）
+ **友情链接**：外部链接和合作伙伴链接数据管理
+ **文章管理**：文章内容发布和管理，支持富文本编辑（[IMG_URL] 持久化契约）
+ **任务调度**：定时任务定义和统一调度管理（数据驱动、HTTP/本地双形态、多实例执行锁）
+ **代码生成**：根据数据库表结构一键生成前后端 CRUD 代码（HTTP + CLI 双入口）
+ **分类管理**：文章分类、商品分类等树形分类数据管理
+ **租户管理**：多租户数据隔离，租户状态与过期管理，事务化开户
+ **在线用户**：在线会话查看与强退（双令牌一并拉黑，防刷新复活）
+ **服务器监控**：运行时信息、内存、磁盘、数据库与缓存连通性监控
+ **缓存监控**：Redis INFO 解析（内存降级时返回 memory 模式标识）

## 软件出处

+ 软件名称：EasyGoAdmin 前后端分离 GoFrame+ElementPlus 版本
+ 软件协议：Apache-2.0
+ 官网网址：[https://www.easygoadmin.vip](https://www.easygoadmin.vip)
+ Gitee 仓库：[https://gitee.com/easygoadmin/EasyGoAdmin_GoFrame_EleVue](https://gitee.com/easygoadmin/EasyGoAdmin_GoFrame_EleVue)
+ 文档网址：[http://docs.goframe.elevue.easygoadmin.vip](http://docs.goframe.elevue.easygoadmin.vip/)

## 适用场景

| 场景 | 说明 |
|------|------|
| 企业内部管理系统 | RBAC 权限 + 部门树 + 数据权限，完整的组织架构管控 |
| 多租户 SaaS 平台 | 租户隔离 + 开户事务 + 租户用户上限 + 过期管理 |
| 快速交付项目底座 | 代码生成器一键产出 CRUD 全套代码，分钟级搭建业务模块 |
| 多数据库历史项目 | 五方言支持 + 整库迁移器，跨库迁移有实测记录 |