# 系统管理中心

**Repository Path**: ruovea-app/RuoVea.System

## Basic Information

- **Project Name**: 系统管理中心
- **Description**: 用户/角色/权限/菜单/租户/OAuth2/短信/邮件/通知/日志/工作台
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-26
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Web, FDE

## README

# 🌈 RuoVea.System — 系统管理中心

## 📖 项目介绍

RuoVea.System 是采用 .NET 8 + Vue 3 构建的企业级系统管理中心，基于 RuoVea 组件生态，提供用户、角色、菜单、机构、租户等基础管理能力，并扩展短信、邮件、站内信、登录日志、日程、首页工作台、OAuth2 开放平台、社交登录等系统级服务。所有 NuGet 包由 [RuoVea](https://gitee.com/ruovea) 开源提供。

- **技术先进**：.NET 8、Vue 3.5+、Composition API、TypeScript 5.7+、Vite 5.4+
- **动态 WebAPI**：后端服务类自动注册为 API，无需手动编写 Controller
- **RBAC 权限**：颗粒度到按钮级别的权限控制
- **国际化**：6 语言（zh-cn / zh-tw / en / ja-jp / fr-fr / vi-vn）
- **响应式设计**：适配手机、平板、PC
- **Docker 部署**：提供前端 + 后端容器化部署方案

## 📸 功能模块截图

> 以下截图按菜单路由（数据库 SysMenu 表）逐页重新截图，覆盖登录页、工作台及全部 18 个业务页面，并附带各可编辑列表页的「新增」编辑弹窗截图。

### 登录页
<img src="Doc/img/00_login.png" alt="登录页" width="860"/>

### 工作台
<img src="Doc/img/00_home.png" alt="工作台" width="860"/>

### 短信渠道
<img src="Doc/img/system_smsChannel.png" alt="短信渠道" width="860"/>

### 短信模板
<img src="Doc/img/system_smsTemplate.png" alt="短信模板" width="860"/>

### 短信日志
<img src="Doc/img/system_smsLog.png" alt="短信日志" width="860"/>

### 邮箱账号
<img src="Doc/img/system_mailAccount.png" alt="邮箱账号" width="860"/>

### 邮件模板
<img src="Doc/img/system_mailTemplate.png" alt="邮件模板" width="860"/>

### 邮件日志
<img src="Doc/img/system_mailLog.png" alt="邮件日志" width="860"/>

### 站内信模板
<img src="Doc/img/system_notifyTemplate.png" alt="站内信模板" width="860"/>

### 站内信
<img src="Doc/img/system_notifyMessage.png" alt="站内信" width="860"/>

### 登录日志
<img src="Doc/img/system_loginLog.png" alt="登录日志" width="860"/>

### 日程管理
<img src="Doc/img/system_schedule.png" alt="日程管理" width="860"/>

### 首页管理
<img src="Doc/img/system_homePage.png" alt="首页管理" width="860"/>

### 组件管理
<img src="Doc/img/system_homeComponent.png" alt="组件管理" width="860"/>

### 组件分类
<img src="Doc/img/system_homeComponentCategory.png" alt="组件分类" width="860"/>

### 用户应用
<img src="Doc/img/system_homeAppUser.png" alt="用户应用" width="860"/>

### 社交客户端
<img src="Doc/img/system_socialClient.png" alt="社交客户端" width="860"/>

### 社交用户
<img src="Doc/img/system_socialUser.png" alt="社交用户" width="860"/>

### OAuth2 客户端
<img src="Doc/img/system_oauth2Client.png" alt="OAuth2 客户端" width="860"/>

### OAuth2 令牌
<img src="Doc/img/system_oauth2Token.png" alt="OAuth2 令牌" width="860"/>

## 🛠️ 技术栈

| 技术 | 版本 | 说明 |
| --- | --- | --- |
| .NET | 8.0 | 后端 API 框架 |
| SqlSugarCore | — | ORM 框架 |
| RuoVea.DynamicWebApi | — | 动态 WebAPI 生成 |
| RuoVea.OmiApi.* | 8.0.* | 基础模块 NuGet 包（Auth/System/Dict/Article/Notice/Reports/Log/Config/Upload） |
| Vue | 3.5+ | 前端框架 |
| TypeScript | 5.7+ | 类型系统 |
| Vite | 5.4+ | 构建工具 |
| Element Plus | 2.8+ | UI 组件库 |
| Pinia | 2.2+ | 状态管理 |
| Vue Router | 4.5+ | 路由管理（后端控制） |
| Vue I18n | 10.0+ | 国际化 |
| ECharts | 5.5+ | 数据可视化 |
| Axios | 1.7+ | HTTP 客户端 |
| WangEditor | 5.1+ | 富文本编辑器 |
| Vue Grid Layout | 3.0+ | 栅格布局（仪表盘） |
| Vue Signature Pad | 3.0+ | 电子签名 |
| Vue 3 Tree Org | 4.2+ | 组织架构图 |
| VForm3 | 3.0+ | 表单设计 |
| @Vue Office | 1.6+ | 文档预览 |
| SortableJS | 1.15+ | 拖拽排序 |

## 📦 核心功能

### 系统管理
- **用户管理**：用户信息管理、角色分配、状态管理
- **角色管理**：角色创建、权限配置、菜单分配
- **菜单管理**：菜单配置、权限设置、路由管理、拖拽排序
- **组织架构**：部门管理、组织层级设置
- **字典类型管理**：分类编码、名称配置，支持跳转四种字典值视图
- **配置管理**：系统配置、参数设置
- **缓存管理**：缓存监控、缓存清理
- **日志管理**：操作日志、异常日志、访问日志、差异日志

### 内容管理 (Article)
- **文章列表**：分页查询 + 标题/状态搜索，WangEditor 富文本编辑
- **文章编辑**：封面图片上传、分类下拉、标签多选、SEO 设置
- **分类管理**：树形上级节点选择，编码正则校验
- **标签管理**：简洁 CRUD

### 字典值管理 (DictValue)
- **常规管理**：标准 CRUD，14 种标签类型自由切换
- **动态组件**：输入控件智能适配，code 仅新增时显示
- **定制管理**：tagType 固定，aed 参数控制按钮权限
- **图片管理**：图片上传预览，表格缩略图 + 点击放大

### 报表管理 (Reports)
- **图表配置**：柱状图、折线图、饼图、仪表盘、统计卡片
- **数据源管理**：MySql/SqlServer/Sqlite/Oracle/PostgreSQL 连接管理
- **SQL 管理**：SQL 编辑 + 字段解析 + 拖拽排序 + 格式化预设 + 查询字典
- **仪表盘**：可拖拽图表布局（vue-grid-layout）
- **报表查询**：Element Plus 表格查询 + ECharts 图表预览
- **QueryByCode**：通过 code 参数访问报表

### 通知公告
- 系统通知 + SignalR 实时推送 + 已读/未读持久化

### 其他功能
- **文件管理**：文件上传、预览
- **代码生成**：模板代码快速生成
- **文档预览**：支持 docx、excel、pdf
- **电子签名**：在线签名功能

## 🌍 字典值视图对照

| 视图 | 路由 | 特点 |
|------|------|------|
| 常规管理 | /business/dictvalue/nomal | 标准 CRUD，14 种 tagType 自由切换 |
| 动态组件 | /business/dictvalue/dynamic | 输入控件智能适配，code 仅新增时显示 |
| 定制管理 | /business/dictvalue/custom | tagType 固定，aed 按钮可控 |
| 图片管理 | /business/dictvalue/image | 图片上传预览，表格缩略图 |

## 🌐 浏览器支持

| 浏览器 | 最低版本 |
| --- | --- |
| Edge | 88+ |
| Firefox | 78+ |
| Chrome | 87+ |
| Safari | 13+ |

> Vue 3 及 Element Plus 不支持 IE11 及之前版本。

## 🚀 快速开始

### 环境要求

- .NET 8 SDK
- Node.js >= 16.0.0
- pnpm >= 6.0.0（推荐）或 npm >= 7.0.0

### 后端启动

```bash
# 修改数据库配置：RuoVea.System.Entry/Config/DbConnstring.json（默认 Sqlite）
dotnet restore
dotnet run --project RuoVea.System.Entry
# Swagger: http://localhost:5000/swagger
```

### 前端启动

```bash
cd Web
pnpm install
pnpm dev        # http://localhost:3000
pnpm build      # 构建到 dist/
```

### Docker 部署

```bash
docker build -t ruovea-admin-master .
docker run -d -p 5000:80 --name ruovea-master ruovea-admin-master
```

## 📁 项目结构

```
ruovea-admin/
├── RuoVea.System.Entry/        # 入口项目
│   ├── Config/               #   配置文件（DB、JWT、CORS、Swagger 等）
│   ├── Controllers/          #   Swagger 授权控制器
│   ├── Extensions/           #   本地化扩展
│   ├── Filters/              #   日志过滤器
│   └── Program.cs            #   应用启动入口
├── RuoVea.System.Server/       # 业务逻辑层
│   ├── Dto/                  #   数据传输对象
│   ├── Language/             #   国际化资源文件
│   ├── Models/               #   数据模型
│   ├── SeedData/             #   种子数据
│   └── Service/              #   业务服务
├── Web/                      # Vue 3 前端
│   └── src/
│       ├── api/              #   API 服务层（按域分组）
│       ├── components/       #   通用组件
│       ├── i18n/             #   国际化（lang/框架级 + pages/页面级）
│       ├── layout/           #   布局组件
│       ├── router/           #   路由（后端控制）
│       ├── stores/           #   Pinia 状态管理
│       ├── utils/            #   工具函数
│   └── views/            # 页面组件
│       ├── business/     #     自有业务（demo）；article/dictvalue/report 等由 @ruovea/* 插件包提供
│       ├── dashboard/    #     工作台
│       ├── error/        #     错误页
│       ├── system/       #     系统管理（cache/file/infoSetting/server）
│       └── login/        #     登录
├── Doc/                      # 项目文档
│   ├── bat/                  #   构建与运行脚本
│   ├── Docker/               #   Docker 部署文件
│   └── img/                  #   截图
├── CLAUDE.md                 # 项目编码规范（AI 自动加载）
├── RuoVea.System.sln           # 解决方案文件
├── LICENSE                   # MIT 许可证
└── README.md
```

## 🎨 特色功能

### 1. 完善的权限管理
- 基于角色的权限控制（RBAC）
- 细粒度的菜单权限和按钮权限
- 权限缓存和动态加载

### 2. 丰富的通用组件
- **字典组件**：数据字典快速使用
- **富文本编辑器**：集成 WangEditor
- **电子签名**：支持在线签名
- **组织架构图**：可视化组织层级
- **文档预览**：支持多种文档格式
- **拖拽验证**：图片拖拽验证
- **图标选择器**：丰富的图标库
- **表格组件**：多功能表格封装

### 3. 国际化支持
- 内置 6 种语言
- 支持动态切换语言
- 框架级 + 页面级分层管理，自动 glob 导入

### 4. 主题定制
- 多种预设主题
- 自定义主题颜色
- 布局配置持久化

## 📚 开发文档

| 文档 | 说明 |
|------|------|
| [CLAUDE.md](CLAUDE.md) | 项目专属编码规范 v1.0（AI 自动加载，新增/修改代码必读；附录 6.1 含 RuoVea 组件文档导航） |
| [Web/README.md](Web/README.md) | 前端说明 |
| [Web/USE_WIKI.md](Web/USE_WIKI.md) | 使用手册 |
| [Web/CHANGELOG.md](Web/CHANGELOG.md) | 更新日志 |

## 📄 许可证

本项目基于 [RuoVea](https://gitee.com/ruovea) 开源组件生态，采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。

---

**RuoVea.System** — 企业级后台管理系统基座！