# BookManagementSystem

**Repository Path**: flyingharry/book-management-system

## Basic Information

- **Project Name**: BookManagementSystem
- **Description**: .net core api 开发的图书管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-18
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BookManagementSystem

图书管理系统 API，基于 .NET 8 构建的现代化 Web API 应用程序。

## 技术栈

- **框架**: .NET 8
- **开发语言**: C#
- **Web API**: ASP.NET Core Web API
- **数据库**: 支持多种关系型数据库（需根据配置选择）
- **认证**: JWT 令牌认证
- **授权**: 基于角色的访问控制 (RBAC)

## 主要功能

### 用户管理
- 用户注册和登录
- 获取当前用户信息
- 用户角色管理（管理员、图书管理员、普通用户）

### 图书管理
- 图书信息的增删改查
- 图书分类管理
- 图书搜索和筛选

### 借阅管理
- 图书借阅和归还
- 借阅记录查询
- 逾期提醒

## 项目结构

```
BookManagementSystem/
├── Controllers/          # API 控制器
├── Models/               # 数据模型和请求/响应模型
├── Services/             # 业务逻辑服务
├── Helpers/              # 工具类和辅助函数
├── Middleware/           # 自定义中间件
├── Migrations/           # 数据库迁移文件
├── AppSettings.json      # 应用程序配置
└── Program.cs            # 应用程序入口
```

## 快速开始

1. **克隆仓库**
   ```bash
   git clone https://gitee.com/your-username/BookManagementSystem.git
   ```

2. **安装依赖**
   ```bash
   dotnet restore
   ```

3. **配置数据库连接**
   在 `AppSettings.json` 中配置数据库连接字符串。

4. **运行数据库迁移**
   ```bash
   dotnet ef database update
   ```

5. **启动应用**
   ```bash
   dotnet run
   ```

6. **访问 API**
   API 将在 `http://localhost:5000/api` 上运行。

## API 文档

项目使用 Swagger/OpenAPI 生成 API 文档，启动应用后可通过 `http://localhost:5000/swagger` 访问。

## 认证和授权

- 使用 JWT 令牌进行认证
- 支持以下角色：
  - `admin`: 管理员，拥有所有权限
  - `librarian`: 图书管理员，可管理图书和借阅
  - `user`: 普通用户，可查询图书和管理个人借阅

## 开发规范

- 采用 RESTful API 设计风格
- 遵循 C# 编码规范
- 使用依赖注入 (DI) 模式
- 实现仓储模式和服务层模式

## 许可证

MIT License