# 可婕后端管理 **Repository Path**: mofees/kegie-admin ## Basic Information - **Project Name**: 可婕后端管理 - **Description**: 可婕后端管理系统 是一个专注于提供高效、稳定API服务的开源项目，提供高效、灵活的API构建工具，支持快速开发和部署，适用于多种后端应用。 - **Primary Language**: C# - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2026-08-18 - **Last Updated**: 2026-08-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 🌈 KeGie.Admin — 主系统框架 ## 📖 项目介绍 KeGie.Admin 是采用 .NET 8 + Vue 3 构建的企业级后台管理系统，基于 RuoVea 组件生态，提供完整的基础管理 + 业务扩展能力。所有 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 部署**：提供前端 + 后端容器化部署方案 ## 📸 功能模块截图 ### 登录页面 支持账号密码登录，包含验证码功能。 ![登录页面](Doc/img/login.png) ### 仪表盘 仪表盘展示系统概览、数据统计和关键指标，支持自定义栅格布局。 ![仪表盘](Doc/img/dashbard.png) 仪表盘管理支持创建、编辑、预览三种模式： | 管理模式 | 预览模式 | |----------|----------| | ![仪表盘管理](Doc/img/dashboard-admin.png) | ![仪表盘预览](Doc/img/dashboard-view.png) | ![仪表盘编辑](Doc/img/dashboard-edit.png) ### 菜单管理 菜单的增删改查、权限设置和路由配置，支持拖拽排序，支持 DIR/MENU/BTN 三种类型。 ![菜单管理](Doc/img/菜单管理.png) ### 角色管理 角色的创建、权限配置和菜单分配，实现细粒度的权限控制。 ![角色管理](Doc/img/角色管理.png) ### 账号管理 用户信息的管理、角色分配和权限设置，包含用户状态管理。 ![账号管理](Doc/img/账号管理.png) ### 机构管理 组织架构的管理，包括部门的增删改查和层级设置。 ![机构管理](Doc/img/机构管理.png) ### 字典管理 字典类型的分类管理，支持从类型列表一键跳转四种字典值视图。 ![字典管理](Doc/img/字典管理.png) ### 文章管理 文章列表/编辑（WangEditor 富文本编辑器）、分类管理、标签管理。 ### 报表管理 图表配置、数据源管理、SQL 管理、可拖拽仪表盘、报表查询/图表预览。 ![图表配置列表](Doc/img/chartConfig.png) ![图表配置编辑](Doc/img/chartConfig-edit.png) ![图表配置预览](Doc/img/chartConfig-view.png) ![数据源管理](Doc/img/dataSource.png) ![报表定义列表](Doc/img/definition.png) ![报表定义编辑](Doc/img/definition-edit.png) ![SQL 管理](Doc/img/definition-sql.png) ![QueryByCode](Doc/img/queryByCode.png) ### 访问日志 用户登录和访问记录的审计监控。 ![访问日志](Doc/img/访问日志.png) ### 差异日志 系统数据变更历史的追踪审计。 ![差异日志](Doc/img/差异日志.png) ## 🛠️ 技术栈 | 技术 | 版本 | 说明 | | --- | --- | --- | | .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 # 修改数据库配置：KeGie.Admin.Entry/Config/DbConnstring.json（默认 Sqlite） dotnet restore dotnet run --project KeGie.Admin.Entry # Swagger: http://localhost:5000/swagger ``` ### 前端启动 ```bash cd Web pnpm install pnpm dev # http://localhost:3000 pnpm build # 构建到 dist/ ``` ### Docker 部署 ```bash docker build -t kegie-admin-master . docker run -d -p 5000:80 --name kegie-master kegie-admin-master ``` ## 📁 项目结构 ``` kegie-admin/ ├── KeGie.Admin.Entry/ # 入口项目 │ ├── Config/ # 配置文件（DB、JWT、CORS、Swagger 等） │ ├── Controllers/ # Swagger 授权控制器 │ ├── Extensions/ # 本地化扩展 │ ├── Filters/ # 日志过滤器 │ └── Program.cs # 应用启动入口 ├── KeGie.Admin.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 自动加载） ├── KeGie.Admin.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) 文件。 --- **KeGie.Admin** — 企业级后台管理系统基座！