一套基于 .NET 10 + Vue 3 构建、高颜值、前后端分离的企业级多租户中后台管理系统

前言

做后台管理系统，总逃不过重复造轮子：每次新项目都要重搭登录、权限等基础功能，权限控制补丁越打越多，多租户实现更是牵一发而动全身。今天大姚给大家分享一套基于 .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 全栈实践的参考。

image

适用人群

• 想要一套"权限和多租户是真做了"的中后台起步模板，而不是又一个换皮的 admin；
• 正啃 .NET + Vue 全栈开发，想看看 DDD/CQRS、动态 API、RBAC+ABAC 这些概念如何落地成代码；
• 在搞 B2B SaaS 产品，需要租户隔离、套餐版本管理、权限白名单这些硬核功能一站式搞定。

核心功能模块

用户管理模块

• 支持用户的注册、登录、权限分配与角色管理。多种登录方式：账号密码、邮箱 / 短信验证码、OAuth2（GitHub / Google / QQ）、2FA（TOTP / 邮箱 / 短信）。

image

image

image

image

image

RBAC权限控制模块

• 角色层级继承（闭包表）、数据范围（本人 / 部门 / 租户）、字段级脱敏，确保数据的安全性与合规性。

image

image

租户管理模块

• 针对多租户场景，提供租户的创建、配置与管理功能。

image

image

代码生成模块

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

image

image

image

审计日志模块

• 访问 / API / 操作 / 异常 / 登录 / 实体变更 六类日志，各自独立写入。

image

image

image

image

系统设置模块

• 包含菜单管理、字典管理、参数配置、任务调度、缓存管理、服务监控等。

image

image

image

image

image

移动端展示

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

image

项目特点

• 高性能：基于 .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.*                        │
│         底层框架(认证 / 授权 / 数据 / 缓存 / 事件总线 / 多租户)         │
└─────────────────────────────────────────────────────────────┘

项目分层

image

项目技术栈

• 后端：.NET 10、SqlSugar（PostgreSQL / MySQL / MariaDB）、Redis、SignalR、Serilog、Scalar。
• 前端：Vue 3.5、TypeScript、Vite、Naive UI、Pinia、Tailwind CSS、Tiptap、vue-i18n。

image

项目运行

# 后端
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 推荐或自荐优秀项目（让优秀的项目和框架不被埋没🤞）。

• GitHub开源地址：https://github.com/YSGStudyHards/DotNetGuide/blob/main/docs/DotNet/DotNetProjectPicks.md
• Gitee开源地址：https://gitee.com/ysgdaydayup/DotNetGuide/blob/main/docs/DotNet/DotNetProjectPicks.md