XiHan.BasicApp 基础应用
企业级中后台内核。 后端基于 .NET 与 XiHan.Framework，前端基于 Vue 与 XiHan.UI，开箱即带多租户、RBAC + 数据范围 + 字段脱敏的权限体系、代码生成与实时通信等能力。它既是一套可直接投产的中后台起点，也是学习 .NET + Vue 全栈实践、以及 XiHan.Framework 用法的最佳参考。
它是什么
XiHan.BasicApp 采用前后端分离架构：
- 后端 遵循 DDD 分层与 CQRS，应用服务经动态 API 直接暴露为 REST 接口，无需写 Controller
- 前端 使用 Vue + TypeScript + XiHan.UI，Schema 驱动的列表页、权限/租户/偏好三重感知
系统内置完整的身份、权限、租户与审计能力。你可以拿它当项目脚手架直接改，也可以只读它的代码学习框架怎么用。
从这里开始
还在做技术选型？先读 为什么选择曦寒 —— 它适合什么项目、和其它中后台方案的区别、以及它的短板。
已经决定动手？按这个顺序走：
文档地图
入门
- 为什么选择曦寒 —— 选型指南：适合什么项目、四条方案路线的取舍、它的短板
- 系统概述 —— 定位、技术栈、能力全景、按角色的阅读路线
- 开发环境 —— Docker 起数据库与 Redis
- 快速开始 —— 跑起来并调通第一个接口
- 目录结构与代码地图 —— 「我要改 X 该去哪个文件」
架构
- 架构总览 —— 全景、四条贯穿全局的设计、数据流
- 后端架构 —— 分层、模块装配、DDD、DI 约定、种子
- 前端架构 —— 五层结构、启动引导、请求时序
- 请求生命周期 —— 中间件管道逐段、401/403/423、UoW 收尾
- 数据模型 —— 实体基类、审计与软删、多租户列、全表清单
- 缓存与异步 —— 缓存条目、精准失效、队列消费
- 健康与可观测性 ——
/health、数据库/Redis/Qdrant 探测、OpenTelemetry
身份与访问
- 身份与认证 —— 多种登录、JWT 双令牌、会话、2FA
- 权限模型 —— RBAC、权限码、数据范围、字段脱敏
- 组织架构 —— 部门树与闭包表、岗位、用户归属
- 多租户与版本 —— 字段级隔离、租户切换、版本门控
业务功能
前端开发
- 前端开发指南 —— 技术栈、api 层、SignalR、常用组件
- Schema 驱动页面 · 路由与菜单 · 权限与脱敏 · 主题与国际化
二次开发与参考
- 二次开发 —— 加功能纵切片 / 加独立模块 / 加前端页
- 接口对接指南 —— 响应信封、业务码、怎么获取 token、分页协议
- 配置参考 ——
appsettings全量配置节 - 功能清单 · 常见问题 · 部署 · 更新日志
给 AI 工具
文档站在构建期另外产出几份纯文本，与本站同源：
| 地址 | 内容 |
|---|---|
/llms.txt | 全站索引，每行一页 |
/llms-full.txt | 全站正文 |
/llms-backend.txt | 后端手册全部章节 |
/llms-frontend.txt | 前端手册全部章节 |
只需要一页时，把地址后缀改为 .md，如 https://basicapp.docs.xihanfun.com/backend/permission.md；每页正文右上角的「取本页 Markdown」指向的也是它。
技术栈速览
| 端 | 关键技术 |
|---|---|
| 后端 | .NET · XiHan.Framework · SqlSugar（PostgreSQL/MySQL/MariaDB）· Redis · SignalR · Serilog · Scalar |
| 前端 | Vue · TypeScript · Vite · XiHan.UI · Pinia · Tailwind CSS · Tiptap · vue-i18n |
在线体验
- 在线用例：https://basicapp.xihanfun.com
- 源码：GitHub · Gitee
与 XiHan.Framework 的关系
XiHan.BasicApp 构建在 XiHan.Framework 之上——框架提供认证、授权、数据、缓存、事件总线、多租户、动态 API 等底层能力，BasicApp 在其上实现具体的中后台业务。想先理解底层机制，建议先读框架快速上手。