# 泷川图书馆管理系统

**Repository Path**: honlnk/takiawa-library

## Basic Information

- **Project Name**: 泷川图书馆管理系统
- **Description**: 这是一个简单的图书管理系统
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-13
- **Last Updated**: 2026-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Takiawa Library Management System

## 项目简介

Takiawa Library 是一个基于 Spring Boot 的图书馆管理系统，提供了完整的图书管理、借阅归还、用户管理等功能。系统采用经典的前后端不分离架构，使用 Thymeleaf 模板引擎进行页面渲染，界面简洁直观。

## 技术栈

- **后端框架**: Spring Boot 2.x
- **持久层框架**: MyBatis
- **模板引擎**: Thymeleaf
- **数据库**: MySQL（可通过 `docs/data.sql` 初始化数据）
- **前端技术**: HTML5、CSS3

## 主要功能

### 1. 图书管理
- 查看全部图书列表
- 按关键词搜索图书（支持书名、作者、ISBN 等字段模糊查询）
- 实时显示图书库存状态

### 2. 借阅管理
- 借阅图书（自动更新库存）
- 归还图书（记录借阅时长）
- 查看个人借阅记录
- 查看全部借阅记录

### 3. 用户系统
- 用户登录认证
- 权限管理（普通用户/管理员）

## 项目结构

```
src/main/java/com/ttk/takiawalib/
├── TakiawalibApplication.java    # 启动类
├── ServletInitializer.java       # Web部署配置
├── controller/                   # 控制器层
│   └── BookController.java       # 图书相关接口
├── dao/                          # 数据访问层（MyBatis Mapper）
│   ├── BookDao.java
│   ├── BorrowRecordDao.java
│   └── UserDao.java
├── entity/                       # 实体类
│   ├── Books.java
│   ├── Users.java
│   ├── BorrowRecord.java
│   └── BorrowRecordVO.java
└── service/                      # 业务逻辑层
    ├── BookService.java
    ├── BorrowService.java
    └── UserService.java

src/main/resources/
├── application.properties        # 应用配置
├── static/style/style.css       # 样式文件
└── templates/                    # HTML页面
    ├── index.html               # 首页/图书列表
    └── records.html             # 借阅记录
```

## 快速开始

### 环境要求
- JDK 8+
- Maven 3.x
- MySQL 5.7+

### 配置步骤

1. **创建数据库**
   ```sql
   CREATE DATABASE takiawalib DEFAULT CHARACTER SET utf8mb4;
   
   -- 导入初始数据
   USE takiawalib;
   SOURCE docs/data.sql;
   ```

2. **修改数据库配置**
   
   编辑 `src/main/resources/application.properties`，配置您的数据库连接信息：
   ```properties
   spring.datasource.url=jdbc:mysql://localhost:3306/takiawalib
   spring.datasource.username=your_username
   spring.datasource.password=your_password
   ```

3. **构建运行**
   ```bash
   # 使用Maven打包
   mvn clean package
   
   # 运行项目
   java -jar target/takiawalib-0.0.1-SNAPSHOT.jar
   ```

4. **访问系统**
   
   打开浏览器访问 `http://localhost:8080`

## 核心接口

| 请求路径 | 方法 | 功能说明 |
|---------|------|----------|
| `/` | GET | 图书列表/搜索 |
| `/borrow?bookId={id}` | GET | 借阅图书 |
| `/return?recordId={id}` | GET | 归还图书 |
| `/records` | GET | 查看借阅记录 |

## License

本项目基于 [MIT License](LICENSE) 开源。