# NET10-Blazor

**Repository Path**: bookmark311/net10-blazor

## Basic Information

- **Project Name**: NET10-Blazor
- **Description**: Net10-Blazor - 基于 .NET 10 Blazor Server 的企业级管理后台，基于 .NET 10 最新特性 与 Blazor Server 交互模式 构建的企业级后台管理系统架构。采用整洁架构（Clean Architecture）设计，内置完善的权限控制、实时通信与国际化支持。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2026-08-06
- **Last Updated**: 2026-08-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 🚀 Net10-Blazor - 基于 .NET 10 Blazor Server 的企业级管理后台

> 基于 **.NET 10 最新特性** 与 **Blazor Server 交互模式** 构建的企业级后台管理系统架构。采用整洁架构（Clean Architecture）设计，内置完善的权限控制、实时通信与任务调度机制。

[![.NET](https://img.shields.io/badge/.NET-10.0-blueviolet)](https://dotnet.microsoft.com/)
[![Blazor](https://img.shields.io/badge/Blazor-Server-5C2D91)](https://dotnet.microsoft.com/apps/aspnet/web-apps/blazor)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

---

## 📸 项目截图
> 💡 提示：实际运行截图放入 `doc/screenshots/` 文件夹中

| 登录界面 |登录配置 | 仪表盘 | 
| :---: | :---: | :---: |
| ![Login](./doc/screenshots/登陆.png) | ![Login](./doc/screenshots/登录页配置.png) | ![Dashboard](./doc/screenshots/首页.png) | 

| 用户管理 | 菜单管理 | 待办提办 |
| :---: | :---: | :---: |
| ![RBAC](./doc/screenshots/用户管理.png) | ![RBAC](./doc/screenshots/菜单管理.png) | ![RBAC](./doc/screenshots/待办管理.png) |

| SQL监控 | 系统监控 | 在线人数 |
| :---: | :---: | :---: |
| ![System](./doc/screenshots/sql监控.png) | ![System](./doc/screenshots/系统监控.png) | ![System](./doc/screenshots/在线人数.png) |
---

## ✨ 核心特性
- 🧩 **Blazor Server 交互模式**：采用 .NET 10 最新 `InteractiveServerRenderMode`，结合 Bootstrap Blazor 组件库，享受极致的服务端渲染体验与丰富的 UI 交互。
- 🛡️ **企业级权限体系**：基于 **RBAC (Role-Based Access Control)** 的细粒度权限控制，结合 Cookie 与 JWT 混合认证，支持接口级与方法级的权限策略。
- 🔔 **SignalR 实时通知**：集成 SignalR 实现实时消息推送、在线用户统计与公告通知。
- 📊 **全链路监控**：内置 SQL 执行监控、系统资源（CPU/内存/磁盘）监控、操作日志审计与日志查看器。
- ⏰ **后台任务调度**：内置轻量级任务调度中心，支持定时报表生成、日志清理、公告状态自动刷新等。
- 🌍 **多语言国际化**：内置完善的本地化支持，开箱即用的中英文切换。
- 🏗️ **整洁架构分层**：严格遵循 Domain → Application → Infrastructure → API → UI 依赖倒置原则。

---

## 📂 项目结构
采用标准的 Clean Architecture 分层设计：

```text
src/
├── CoreMe.slnx                  # 解决方案文件
├── CoreMe.Domain/               # 📦 领域层 (Entities, Enums, Interfaces)
├── CoreMe.Application/          # 📦 应用层 (Services, DTOs, AutoMapper, Authorization)
├── CoreMe.Infrastructure/       # 📦 基础设施层 (SqlSugar DbContext, Snowflake ID, Email)
├── CoreMe.Api/                  # 📦 API 接口层 (Controllers, Filters, Hubs, Middlewares)
├── CoreMe.Task/                 # 📦 后台任务层 (Scheduling, Jobs: DailyReport, LogCleanup)
└── CoreMe/
    └── CoreMe.Server/           # 🖥️ 宿主层 (Blazor UI, Components, Pages)
```

---

## 🛠️ 技术栈
| 类别 | 技术选型 |
| :--- | :--- |
| **核心框架** | .NET 10, ASP.NET Core |
| **前端交互** | Blazor Server (Interactive Mode) |
| **UI 组件库** | Bootstrap Blazor |
| **ORM** | SqlSugar (支持多种数据库) |
| **认证授权** | Identity, JWT, Policy-Based Authorization |
| **实时通信** | SignalR |
| **日志组件** | NLog |
| **ID 生成** | 雪花算法 (Snowflake ID) |

---

## 🏁 快速开始

### 1. 克隆与还原
```bash
git clone https://gitee.com/bookmark311/net10-blazor.git
cd net10-blazor/src
dotnet restore
```

### 2. 配置数据库
修改 `CoreMe.Server/appsettings.json` 或 `CoreMe.Infrastructure` 中的连接字符串配置。系统启动时支持自动创建表与初始化基础数据。

### 3. 运行
```bash
cd CoreMe/CoreMe.Server
dotnet run
```
访问 `https://localhost:5001` 或 `http://localhost:5000`。

> **默认账号/密码**: `admin` / `123456`

---

## 🔑 核心模块说明

- **Auth (认证授权)**：`/api/auth/login`，支持账号密码登录、刷新 Token、验证码（滑块/图形）与多角色切换。
- **System (系统管理)**：用户管理、角色管理、公司/部门管理、菜单管理、公告管理、个性化设置。
- **Monitor (监控中心)**：
  - **SQL Monitor**：记录并统计所有 SQL 执行情况，支持慢查询分析。
  - **System Monitor**：实时获取服务器 CPU、内存、磁盘使用情况。
  - **Log Viewer**：查看系统运行日志。
- **Task (任务中心)**：可视化管理后台定时任务（启用/禁用、查看历史执行记录）。

---

## 🤝 参与贡献
1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交变更 (`git commit -m 'feat: add some feature'`)
4. 推送分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

> 💡 **作者**：郑鹏 | **协议**：MIT License