# Nasty

**Repository Path**: moper/Nasty

## Basic Information

- **Project Name**: Nasty
- **Description**: Admin后端框架，还处于开发阶段
- **Primary Language**: C#
- **License**: EPL-1.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-02-10
- **Last Updated**: 2025-09-15

## Categories & Tags

**Categories**: backend

**Tags**: None

## README

# Nasty Admin 框架

Nasty 是一个基于 Asp.Net Core 和 Ant Design（React）构建的现代化 Admin 框架，旨在提供一套高效、灵活的企业级后台解决方案。它集成了多种实用功能模块，适用于快速开发和部署管理后台系统。

## 当前开发核心

- **代码重构**：持续整理和优化现有代码结构，提升代码可维护性和可扩展性。
- **文档完善**：编写详尽的开发文档，帮助开发者快速上手。

## 计划开发清单

- **快速生成代码模块**：支持快速生成增删改查基础模块，提升开发效率。
- **网关与负载均衡**：计划集成 Ocelot 实现网关和负载均衡功能，增强系统架构灵活性。

## 项目介绍

Nasty 采用 Asp.Net Core 作为后端框架，结合 Ant Design Pro 实现前端界面，具备以下核心特性：

### 核心技术栈

- **ORM 框架**：使用 [SqlSugar](https://sugardemo.blazor.zone/) 作为核心 ORM，支持高性能数据库操作。
- **权限模型**：采用角色与权限分离的设计，简化权限校验逻辑，提升系统安全性。
- **模块化架构**：采用模块化设计，便于功能扩展和维护。

### 已实现功能模块

1. **文件系统**
   - 使用 [MinIO](https://min.io/) 作为文件存储服务。
   - 提供文件上传、下载、访问等接口，支持 S3 协议。

2. **Excel 导出**
   - 使用 [EPPlus](https://epplussoftware.com/docs/5.7/articles/licenseexception.html) 生成 Excel 文件。
   - 支持导出数据并存储至 MinIO，提供客户端下载接口。

3. **用户、角色、权限、部门、字典等基础模块**
   - 提供完整的用户管理、角色分配、权限控制、部门组织结构及字典配置功能。

4. **流水号生成器**
   - 支持生成有序的特定规则流水号（如 `SF10001`, `KF10001`）。

5. **API 日志**
   - 提供控制器 API 调用日志记录功能，便于系统监控和调试。

6. **消息通知模块**
   - 支持用户消息推送、已读/未读状态管理。

7. **极简工作流**
   - 提供轻量级工作流引擎，支持流程定义、审批、驳回、委托等操作。

8. **定时任务**
   - 集成 Quartz.NET，支持定时任务调度和日志记录。

### 权限设计思想

Nasty 的权限设计采用**角色驱动**的方式，所有权限控制最终都指向角色或权限本身，避免了传统权限模型中“令出多门”的问题。

- **角色与权限关系**：角色是权限的集合，所有权限校验最终都指向角色或权限。
- **控制器权限配置**：支持配置 `Roles` 和 `Permissions`，并可通过 `IsUnion` 控制校验逻辑（与/或）。
- **灵活的权限控制**：支持细粒度权限控制，适用于各种业务场景。

## 开发文档

### 后端架构

- **模块划分**：项目采用模块化设计，每个功能模块独立封装，便于维护和扩展。
- **依赖注入**：使用 Autofac 实现依赖注入，提升代码可测试性和可维护性。
- **API 文档**：集成 Swagger，提供可视化 API 文档和调试界面。

### 前端架构

- **前端框架**：基于 [Ant Design Pro](https://pro.ant.design/) 构建，提供丰富的 UI 组件和布局。
- **权限控制**：前端通过角色和权限控制页面和按钮级别的访问权限。
- **状态管理**：使用 React Context 和自定义 Hook 管理全局状态。

## 开发指南

### 后端开发

- **开发语言**：C#
- **框架**：Asp.Net Core + Autofac + SqlSugar
- **数据库**：支持主流数据库（MySQL、SQL Server、PostgreSQL 等）
- **开发工具**：Visual Studio / Rider / VS Code

### 前端开发

- **开发语言**：TypeScript + React + Ant Design Pro
- **构建工具**：Webpack + Babel + TypeScript
- **开发工具**：VS Code / WebStorm

## 部署说明

- **后端部署**：支持部署到 IIS、Docker 容器或云服务器。
- **前端部署**：支持静态资源部署到 CDN 或 Nginx。
- **依赖服务**：MinIO、Redis、数据库、Quartz.NET（可选）

## 贡献指南

欢迎贡献代码和文档，提交 PR 前请确保：

- 遵循项目编码规范
- 提供清晰的提交说明
- 通过单元测试（如适用）

## 开源协议

本项目采用 [MIT License](https://opensource.org/licenses/MIT)，欢迎自由使用和修改。

## 联系方式

- **项目地址**：[Gitee](https://gitee.com/moper/Nasty)
- **问题反馈**：欢迎提交 Issue 或 PR
- **作者**：Moper

---

Nasty 致力于打造一个简洁、高效、可扩展的 Admin 框架，欢迎加入我们，共同完善这个项目！