# XiHan.BasicApp
**Repository Path**: oc-fork/XiHan.BasicApp
## Basic Information
- **Project Name**: XiHan.BasicApp
- **Description**: 曦寒应用存储库。基于 .Net + Vue 的超高颜值中后台内核。
开箱即用，提供 RBAC + ABAC 混合权限管理、多租户隔离、代码生成、实时通信、灰度发布、AI等核心能力，满足新型企业级中后台管理场景。属于曦寒懿（XiHanFun）开源生态的基础应用，拥有底座、组件、应用的完整生态。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://basicapp.xihanfun.com
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 101
- **Created**: 2026-07-17
- **Last Updated**: 2026-11-10
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
XiHan.BasicApp is a general-purpose admin kernel with separate frontend and backend, shipping identity, permissions, tenancy and auditing as a starting point for admin systems. It is the base application of the XiHanFun open-source ecosystem.
## Preview
Light and dark themes |
Dynamic color |
Preference center |
Schema-driven lists |
Command palette |
Multi-tenant control center |
## Features
| Area | Capabilities |
| --- | --- |
| Experience | Light and dark themes, Material You dynamic color, synced preferences, schema-driven lists, command palette, split view, small-screen layouts, 10 languages |
| Permissions and security | Server-side permission snapshots, field-level masking, role inheritance with separation of duties, time-limited delegation, guarded impersonation, an OAuth2 / OIDC server |
| Multi-tenancy | Column or per-tenant database isolation, edition gating and quotas, platform-managed operations |
| Auditing and operations | Access, operation, sign-in, exception, data change and permission change logs, end-to-end TraceId, field-level change history, reliable outbox delivery, asynchronous exports |
| Optional modules | Code generation, workflow, print designer, chat and an AI knowledge base, each removable as a unit |
| Engineering | Business APIs are operations: one contract serves HTTP, gRPC and MCP, and the frontend client is generated from it; a single source of truth for menus, routes and permission codes, with structural tests guarding the architecture |
See the [feature list](https://basicapp.docs.xihanfun.com/features) for the full set.
## Getting Started
```bash
git clone https://github.com/XiHanFun/XiHan.BasicApp.git
cd XiHan.BasicApp
cp .env.example .env
docker compose up -d --build
```
The backend image restores the [XiHan.Framework](https://github.com/XiHanFun/XiHan.Framework) packages from NuGet; on startup the schema upgrade and seed run before the backend starts. The frontend runs at `http://localhost:8080` and the backend API at `http://localhost:9710`. The initial account is `superadmin` with the `SUPERADMIN_PASSWORD` from `.env` (default `SuperAdmin@123`); change it at first sign-in. Replace every password and secret in `.env` with random values before deploying; see [Deployment](https://basicapp.docs.xihanfun.com/deployment) for the rest.
Local development needs the .NET 10 SDK, Node.js 24+, pnpm 11+ and PostgreSQL 14+; the backend references XiHan.Framework as NuGet packages, so a fresh clone builds on its own. See [Getting Started](https://basicapp.docs.xihanfun.com/getting-started) and the [backend](./backend/README.md) and [frontend](./frontend/README.md) engineering notes.
## Architecture
| Layer | Frontend | Backend |
| --- | --- | --- |
| Application | Pages and entry points | Host and optional modules |
| Kernel | Layouts, routing, requests and state | Identity, permissions, tenancy, auditing and messaging |
| Foundation | [XiHan.UI](https://github.com/XiHanFun/XiHan.UI) | [XiHan.Framework](https://github.com/XiHanFun/XiHan.Framework) |
## Ecosystem
| Project | Description |
| --- | --- |
| [XiHan.Framework](https://github.com/XiHanFun/XiHan.Framework) | A fast, lightweight, efficient, thoughtful .NET framework: microkernel, capability graph, pipeline execution |
| [XiHan.UI](https://github.com/XiHanFun/XiHan.UI) | A fast, lightweight, efficient and thoughtfully built framework-agnostic headless UI component library |
## Documentation
| Destination | Contents |
| --- | --- |
| [Documentation site](https://basicapp.docs.xihanfun.com) | Guides and topic docs |
| [Live demo](https://basicapp.xihanfun.com) | Try it online |
| [Backend notes](./backend/README.md) | Capability package tiers, projects and local development |
| [Frontend notes](./frontend/README.md) | Stack, layout and local development |
| [Changelog](https://basicapp.docs.xihanfun.com/changelog) | Release notes and upgrade advisories |
Ask an AI: [Zread](https://zread.ai/XiHanFun/XiHan.BasicApp) · [DeepWiki](https://deepwiki.com/XiHanFun/XiHan.BasicApp)
## Contributing
[Issues](https://github.com/XiHanFun/XiHan.BasicApp/issues) and pull requests are welcome; see the [contributing guide](https://docs.xihanfun.com/cosmos/contributing). Community: QQ group [462371834](https://qm.qq.com/q/qYp1Urv3z2). Support the project: [sponsorship page](https://docs.xihanfun.com/cosmos/sponsor).
## Acknowledgements
| Project | Influence |
| --- | --- |
| [VbenAdmin](https://github.com/vbenjs/vue-vben-admin) | The frontend project that started it all, inspiring parts of the architecture and visuals |
| [SoybeanAdmin](https://github.com/soybeanjs/soybean-admin), [LitheAdmin](https://github.com/tenianon/lithe-admin) | Inspiration for parts of the frontend visuals |
| [Admin.Core.ZR](https://gitee.com/izory/ZrAdminNetCore), [YuebonCore](https://gitee.com/yuebon/YuebonNetCore) | Inspiration for parts of the backend features |
| [NaiveUI](https://github.com/tusen-ai/naive-ui) | Early frontend view components |
## License
[MIT](./LICENSE) © 2021-Present XiHanFun and contributors. The XiHan.BasicApp logo, name, interface design and original visual expression belong to the author. 
