前言
做后台管理系统,总逃不过重复造轮子:每次新项目都要重搭登录、权限等基础功能,权限控制补丁越打越多,多租户实现更是牵一发而动全身。今天大姚给大家分享一套基于 .NET 10 + Vue 3 构建、开源(MIT License)、高颜值、前后端分离的企业级多租户中后台管理系统:XiHan.BasicApp 。
项目介绍
XiHan.BasicApp 是一套基于 .NET 10 + Vue 3 构建、开源(MIT License)、高颜值、前后端分离的企业级多租户中后台管理系统。后端遵循 DDD(领域驱动设计)分层与 CQRS(命令查询职责分离)模式,应用服务经动态 API 直接暴露为 REST 接口;前端使用 Vue 3 + TypeScript + Naive UI,提供了现代化的用户界面和良好的开发体验。系统内置了完整的身份、权限、租户与审计能力,既可作为中后台项目的起点,也可作为 .NET + Vue 全栈实践的参考。

适用人群
- 想要一套"权限和多租户是真做了"的中后台起步模板,而不是又一个换皮的 admin;
- 正啃 .NET + Vue 全栈开发,想看看 DDD/CQRS、动态 API、RBAC+ABAC 这些概念如何落地成代码;
- 在搞 B2B SaaS 产品,需要租户隔离、套餐版本管理、权限白名单这些硬核功能一站式搞定。
核心功能模块
用户管理模块
- 支持用户的注册、登录、权限分配与角色管理。多种登录方式:账号密码、邮箱 / 短信验证码、OAuth2(GitHub / Google / QQ)、2FA(TOTP / 邮箱 / 短信)。





RBAC权限控制模块
- 角色层级继承(闭包表)、数据范围(本人 / 部门 / 租户)、字段级脱敏,确保数据的安全性与合规性。


租户管理模块
- 针对多租户场景,提供租户的创建、配置与管理功能。


代码生成模块
- 单表 / 树形 / 主从三种模式,从实体、DTO、API 到前端页面一键生成,提高开发效率,减少重复劳动。



审计日志模块
- 访问 / API / 操作 / 异常 / 登录 / 实体变更 六类日志,各自独立写入。




系统设置模块
- 包含菜单管理、字典管理、参数配置、任务调度、缓存管理、服务监控等。





移动端展示
很多后台的"移动端"就是把 PC 页面硬塞进小屏。XiHan.BasicApp 是按移动端交互重新做的登录、工作台、菜单、命令面板、消息中心,体验接近原生 App:

项目特点
- 高性能: 基于 .NET 优化的高性能架构,确保应用程序高效运行。
- 模块化: 采用模块化设计,各组件松耦合,便于扩展和维护。
- 易用性: 简洁的 API 设计和丰富的约定,降低学习成本。
- 跨平台: 支持 Windows、Linux、macOS 等多种操作系统平台。
- 安全性: 内置完善的身份认证与授权体系,保障应用安全。
- 可扩展: 灵活的插件体系,满足各种定制化需求。
- DDD支持: 原生支持领域驱动设计,便于构建复杂业务系统。
系统架构
XiHan.BasicApp 系统分为框架层、模块层与主应用层,每个模块内部遵循 DDD 分层(Domain / Application / Infrastructure)。
┌─────────────────────────────────────────────────────────────┐
│ XiHan.BasicApp.WebHost │
│ (启动入口与模块聚合) │
├──────────────────────────────┬──────────────────────────────┤
│ XiHan.BasicApp.Saas │ XiHan.BasicApp.CodeGeneration│
│ (RBAC / 多租户 / 审计) │ (代码生成与模板管理) │
├──────────────────────────────┴──────────────────────────────┤
│ XiHan.BasicApp.Web.Core │
│ (Web 核心能力 / 动态 API / 网关 / 灰度) │
├─────────────────────────────────────────────────────────────┤
│ XiHan.BasicApp.Core │
│ (基础应用能力 / DDD / CQRS / 模块化) │
├─────────────────────────────────────────────────────────────┤
│ XiHan.Framework.* │
│ 底层框架(认证 / 授权 / 数据 / 缓存 / 事件总线 / 多租户) │
└─────────────────────────────────────────────────────────────┘
项目分层

项目技术栈
- 后端 :.NET 10、SqlSugar(PostgreSQL / MySQL / MariaDB)、Redis、SignalR、Serilog、Scalar。
- 前端 :Vue 3.5、TypeScript、Vite、Naive UI、Pinia、Tailwind CSS、Tiptap、vue-i18n。

项目运行
# 后端
git clone https://github.com/XiHanFun/XiHan.BasicApp.git
cd XiHan.BasicApp/backend
dotnet run --project src/main/XiHan.BasicApp.WebHost --launch-profile Development
# 前端(另开一个终端)
cd ../frontend
pnpm install && pnpm dev
首次启动会自动建表 + 初始化种子数据,默认管理员账号 superadmin。后端 API 文档在 http://127.0.0.1:9708/scalar。
项目源码地址
更多项目实用功能和特性欢迎前往项目开源地址查看👀,别忘了给项目一个Star支持💖。
- GitHub: https://github.com/XiHanFun/XiHan.BasicApp
- Gitee: https://gitee.com/XiHanFun/XiHan.BasicApp
- 源码导读: https://deepwiki.com/XiHanFun/XiHan.BasicApp
- 在线预览: https://basicapp.xihanfun.com
优秀项目和框架精选
该项目已收录至C#/.NET/.NET Core优秀项目和框架精选中,关注该精选合集,可以及时了解C#、.NET和.NET Core领域的最新动态、优质项目与最佳实践,帮助.NET开发者提升开发效率和项目质量。欢迎大家提交 PR 推荐或自荐优秀项目(让优秀的项目和框架不被埋没🤞 )。