# huanxisha

**Repository Path**: su-just/huanxisha

## Basic Information

- **Project Name**: huanxisha
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-30
- **Last Updated**: 2025-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MySharpProject

一个基于 .NET 的文件管理系统，提供用户认证、文件上传下载、用户管理等功能。

## 功能特性

- **用户认证**：支持用户登录和注册功能，使用 JWT 进行身份验证。
- **文件管理**：支持文件和文件夹的上传、下载、删除和列表展示。
- **用户管理**：支持用户信息的查看、更新和删除，以及密码修改。
- **异常处理**：全局异常处理中间件，统一处理系统异常。
- **API 文档**：集成 Swagger UI 提供 API 文档和测试功能。

## 技术栈

- **.NET 9.0**
- **ASP.NET Core**
- **JWT 身份验证**
- **Dapper ORM**
- **MySQL 数据库**
- **Swagger UI**

## 安装与运行

1. **克隆项目**
   ```bash
   git clone https://gitee.com/su-just/huanxisha.git
   cd MySharpProject
   ```

2. **还原依赖**
   ```bash
   dotnet restore
   ```

3. **配置数据库**
   - 修改 `appsettings.json` 文件中的数据库连接字符串。

4. **运行项目**
   ```bash
   dotnet run
   ```

5. **访问 API 文档**
   - 打开浏览器访问 `http://localhost:5000/swagger` 查看和测试 API 接口。

## API 接口

### 认证接口
- **POST /api/Auth/Login**：用户登录，返回 JWT 令牌。
- **POST /api/Auth/Register**：用户注册。

### 文件接口
- **POST /api/File/Upload**：上传文件或文件夹。
- **GET /api/File/List**：获取文件列表。
- **GET /api/File/Download/{fileId}**：下载文件。
- **GET /api/File/Delete/{id}**：删除文件或文件夹。

### 用户接口
- **GET /api/User/Users**：获取用户列表（分页）。
- **GET /api/User/{id}**：获取用户详情。
- **PUT /api/User/Password**：修改用户密码。
- **DELETE /api/User/{id}**：删除用户。

## 贡献指南

欢迎贡献代码和提出建议！请遵循以下步骤：
1. Fork 项目。
2. 创建新分支。
3. 提交代码更改。
4. 发起 Pull Request。

## 许可证

本项目使用 MIT 许可证。详情请查看 [LICENSE](LICENSE) 文件。