基于飞算 JavaAI 的在线图书借阅平台设计与实现

2. 核心代码展示

AI 生成的代码不仅结构规范，还自带参数校验、事务控制和详细注释，仅需根据课程设计需求补充少量业务逻辑（比如超期提醒的时间计算），以下是关键模块的代码示例：

（1）entity 包：核心实体类

User.java（用户实体，区分学生/管理员角色）

package com.student.library.entity;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.time.LocalDateTime;

/**
 * <p>
 * 用户实体类：映射 user 表，区分学生（role=0）和管理员（role=1）角色
 * </p>
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
@TableName("user")// 关联数据库表名
public class User {
    /**
     * 用户 ID：主键，自增
     */
    @TableId(type = IdType.AUTO)
    private Long id;

    /**
     * 账号：学生填学号，管理员填工号，唯一非空
     */
    private String account;

    /**
     * 密码：存储 BCrypt 加密后的字符串（提示：避免明文存储）
     */
    private String password;

    /**
     * 姓名：用户真实姓名
     */
    private String name;

    /**
     * 角色：0=学生，1=管理员（控制权限，学生不能添加图书）
     */
    private Integer role;

    /**
     * 班级：仅学生有值，格式如'2024-计算机 1 班'
     */
    private String className;

    /**
     * 邮箱：用于接收超期提醒、密码找回
     */
    private String email;

    /**
     * 创建时间：用户注册时间，自动填充
     */
    private LocalDateTime createTime;
}

Book.java（图书实体，含馆藏与可借数量）

package com.student.library.entity;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.time.LocalDateTime;

/**
 * <p>
 * 图书实体类：映射 book 表，记录图书基本信息与库存状态
 * </p>
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
@TableName("book")
public class Book {
    /**
     * 图书编号：主键，自增（也可手动录入 ISBN）
     */
    @TableId(type = IdType.AUTO)
    private Long bookNo;

    /**
     * 书名：非空，如《Java 编程思想》
     */
    private String bookName;

    /**
     * 作者：非空，多个作者用逗号分隔
     */
    private String author;

    /**
     * 图书分类：关联 category 表，如'计算机类''文学类'
     */
    private Long categoryId;

    /**
     * 出版社：图书出版机构
     */
    private String publisher;

    /**
     * 出版日期：图书出版时间
     */
    private LocalDateTime publishDate;

    /**
     * 馆藏总数：图书馆拥有的该图书总数量
     */
    private Integer totalCount;

    /**
     * 剩余可借数量：totalCount - 已借出数量
     */
    private Integer availableCount;

    /**
     * 图书简介：描述图书内容，帮助学生判断是否需要借阅
     */
    private String description;
}

（2）dto 包：数据传输对象（带参数校验）

BorrowBookDTO.java（学生借阅图书的请求 DTO）

package com.student.library.dto;

import jakarta.validation.constraints.NotNull;
import lombok.Data;

/**
 * <p>
 * 图书借阅请求 DTO：接收学生借阅时的参数，含参数校验
 * </p>
 */
@Data
public class BorrowBookDTO {
    /**
     * 学生 ID：必填，从登录态获取，避免手动输入
     */
    @NotNull(message = "学生 ID 不能为空")
    private Long studentId;

    /**
     * 图书编号：必填，从图书详情页获取
     */
    @NotNull(message = "图书编号不能为空")
    private Long bookNo;

    /**
     * 借阅天数：必填，默认 30 天，最多 60 天（图书馆规则）
     */
    @NotNull(message = "借阅天数不能为空")
    private Integer borrowDays = 30;
}

BookAddDTO.java（管理员添加图书的请求 DTO）

package com.student.library.dto;

import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Positive;
import lombok.Data;
import java.time.LocalDateTime;

/**
 * <p>
 * 图书添加请求 DTO：接收管理员添加图书的参数，含参数校验
 * </p>
 */
@Data
public class BookAddDTO {
    /**
     * 书名：必填，长度不超过 100 字
     */
    @NotBlank(message = "书名不能为空")
    private String bookName;

    /**
     * 作者：必填，多个作者用逗号分隔
     */
    @NotBlank(message = "作者不能为空")
    private String author;

    /**
     * 分类 ID：必填，关联已有的图书分类
     */
    @NotNull(message = "图书分类不能为空")
    private Long categoryId;

    /**
     * 出版社：必填
     */
    @NotBlank(message = "出版社不能为空")
    private String publisher;

    /**
     * 出版日期：必填
     */
    @NotNull(message = "出版日期不能为空")
    private LocalDateTime publishDate;

    /**
     * 馆藏总数：必填，且必须为正整数
     */
    @NotNull(message = "馆藏总数不能为空")
    @Positive(message = "馆藏总数必须大于 0")
    private Integer totalCount;

    /**
     * 图书简介：非必填，为空时默认填充'暂无简介'
     */
    private String description;
}

（3）vo 包：视图对象（向前端隐藏敏感字段）

BookDetailVO.java（图书详情 VO，给学生展示）

package com.student.library.vo;

import lombok.Data;
import java.time.LocalDateTime;

/**
 * <p>
 * 图书详情 VO：封装学生查看图书时需要的信息，隐藏敏感字段（如分类 ID）
 * </p>
 */
@Data
public class BookDetailVO {
    /**
     * 图书编号
     */
    private Long bookNo;

    /**
     * 书名
     */
    private String bookName;

    /**
     * 作者
     */
    private String author;

    /**
     * 图书分类名称：展示'计算机类'，而非分类 ID
     */
    private String categoryName;

    /**
     * 出版社
     */
    private String publisher;

    /**
     * 出版日期
     */
    private LocalDateTime publishDate;

    /**
     * 剩余可借数量：学生最关心的字段，优先展示
     */
    private Integer availableCount;

    /**
     * 图书简介
     */
    private String description;

    /**
     * 是否可借：true=可借（availableCount>0），false=不可借（需预约）
     */
    private Boolean canBorrow;
}

（4）service 包：业务逻辑实现（含核心校验）

BorrowServiceImpl.java（借阅服务实现类，含借阅/续借逻辑）

package com.student.library.service.impl;

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.student.library.dto.BorrowBookDTO;
import com.student.library.entity.Book;
import com.student.library.entity.BorrowRecord;
import com.student.library.entity.User;
import com.student.library.mapper.BookMapper;
import com.student.library.mapper.BorrowRecordMapper;
import com.student.library.mapper.UserMapper;
import com.student.library.service.BorrowService;
import com.student.library.vo.BorrowRecordVO;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.BeanUtils;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.time.LocalDate;
import java.time.temporal.ChronoUnit;
import java.util.List;
import java.util.stream.Collectors;

/**
 * <p>
 * 借阅服务实现类：处理图书借阅、续借、归还等核心业务
 * </p>
 */
@Slf4j
@Service
@RequiredArgsConstructor
public class BorrowServiceImpl extends ServiceImpl<BorrowRecordMapper, BorrowRecord> implements BorrowService {
    private final BorrowRecordMapper borrowRecordMapper;
    private final BookMapper bookMapper;
    private final UserMapper userMapper;

    /**
     * 学生借阅图书（核心逻辑：校验库存、计算到期时间）
     */
    @Override
    @Transactional// 事务控制：确保借阅失败时回滚，避免库存异常
    public BorrowRecord borrowBook(BorrowBookDTO borrowBookDTO) {
        log.info("学生借阅图书：学生 ID={}，图书编号={}，借阅天数={}", borrowBookDTO.getStudentId(), borrowBookDTO.getBookNo(), borrowBookDTO.getBorrowDays());

        // 1. 校验学生身份（必须是 role=0 的用户）
        User student = userMapper.selectById(borrowBookDTO.getStudentId());
        if (student == null || student.getRole() != 0) {
            throw new RuntimeException("无效的学生账号，无法借阅图书");
        }

        // 2. 校验图书状态（是否存在、是否可借）
        Book book = bookMapper.selectById(borrowBookDTO.getBookNo());
        if (book == null) {
            throw new RuntimeException("该图书不存在");
        }
        if (book.getAvailableCount() <= 0) {
            throw new RuntimeException("该图书已无库存，可尝试预约");
        }

        // 3. 校验借阅天数（最多 60 天，符合图书馆规则）
        if (borrowBookDTO.getBorrowDays() > 60) {
            throw new RuntimeException("单次借阅最多 60 天，请调整借阅天数");
        }

        // 4. 生成借阅记录
        BorrowRecord borrowRecord = new BorrowRecord();
        borrowRecord.setStudentId(borrowBookDTO.getStudentId());
        borrowRecord.setBookNo(borrowBookDTO.getBookNo());
        borrowRecord.setBorrowDate(LocalDate.now());
        // 计算到期时间：借阅日期 + 借阅天数
        borrowRecord.setDueDate(LocalDate.now().plusDays(borrowBookDTO.getBorrowDays()));
        borrowRecord.setReturnStatus(0);// 0=未归还，1=已归还

        // 5. 更新图书剩余可借数量
        book.setAvailableCount(book.getAvailableCount() - 1);
        bookMapper.updateById(book);

        // 6. 保存借阅记录
        save(borrowRecord);
        log.info("图书借阅成功：借阅记录 ID={}，到期时间={}", borrowRecord.getId(), borrowRecord.getDueDate());
        return borrowRecord;
    }

    /**
     * 学生续借图书（核心逻辑：校验是否超期、限制续借次数）
     */
    @Override
    @Transactional
    public BorrowRecord renewBook(Long recordId) {
        log.info("学生续借图书：借阅记录 ID={}", recordId);

        // 1. 查询借阅记录（必须存在且未归还）
        BorrowRecord record = getById(recordId);
        if (record == null) {
            throw new RuntimeException("借阅记录不存在");
        }
        if (record.getReturnStatus() == 1) {
            throw new RuntimeException("该图书已归还，无需续借");
        }

        // 2. 校验是否超期（超期后不能续借，需先归还并缴纳罚款）
        if (LocalDate.now().isAfter(record.getDueDate())) {
            throw new RuntimeException("图书已超期，请先归还并处理罚款");
        }

        // 3. 校验续借次数（最多续借 1 次，避免长期占用图书）
        if (record.getRenewCount() >= 1) {
            throw new RuntimeException("该图书已续借 1 次，无法再次续借");
        }

        // 4. 更新到期时间（续借 30 天）和续借次数
        record.setDueDate(record.getDueDate().plusDays(30));
        record.setRenewCount(record.getRenewCount() + 1);
        updateById(record);
        log.info("图书续借成功：借阅记录 ID={}，新到期时间={}", recordId, record.getDueDate());
        return record;
    }

    /**
     * 查询学生的借阅记录（含超期提醒）
     */
    @Override
    public List<BorrowRecordVO> getStudentBorrowRecords(Long studentId) {
        // 1. 查询该学生的所有未归还借阅记录
        List<BorrowRecord> recordList = lambdaQuery()
                .eq(BorrowRecord::getStudentId, studentId)
                .eq(BorrowRecord::getReturnStatus, 0)
                .list();

        // 2. 转换为 VO，补充图书名称、作者，添加超期提醒
        return recordList.stream().map(record -> {
            BorrowRecordVO vo = new BorrowRecordVO();
            BeanUtils.copyProperties(record, vo);
            // 补充图书信息
            Book book = bookMapper.selectById(record.getBookNo());
            vo.setBookName(book.getBookName());
            vo.setAuthor(book.getAuthor());

            // 计算剩余天数，添加超期提醒
            long daysLeft = ChronoUnit.DAYS.between(LocalDate.now(), record.getDueDate());
            vo.setDaysLeft((int) daysLeft);
            if (daysLeft < 0) {
                vo.setOverdueReminder("已超期" + (-daysLeft) + "天，请尽快归还");
            } else if (daysLeft <= 3) {
                vo.setOverdueReminder("即将超期，剩余" + daysLeft + "天");
            } else {
                vo.setOverdueReminder("正常借阅中");
            }
            return vo;
        }).collect(Collectors.toList());
    }
}

四、网页展示

为了贴合学生在图书馆使用电脑的场景，前端采用 Bootstrap 实现响应式布局，界面简洁清晰，避免冗余功能。以下是核心页面的功能与设计：

1. 图书查询页

• 布局：顶部是搜索栏（支持按书名、作者搜索），左侧是分类筛选栏（计算机类、文学类、经管类等），中间是图书列表（卡片式展示）；
• 核心功能：点击分类筛选栏的'计算机类'，会自动筛选出该分类下的所有图书；图书卡片显示书名、作者、剩余可借数量，点击'查看详情'可进入图书详情页；
• 细节设计：剩余可借数量为 0 时，卡片右上角显示'无库存'红色标签，避免学生白跑一趟；支持分页（每页 12 本图书），符合学生浏览习惯。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>图书查询 - 校园图书馆系统</title>
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/css/font-awesome.min.css" rel="stylesheet">
    <style>
        .category-item { transition: all 0.2s; }
        .category-item:hover, .category-item.active { background-color: #0d6efd; color: white !important; }
        .book-card { transition: transform 0.3s, box-shadow 0.3s; }
        .book-card:hover { transform: translateY(-5px); box-shadow: 0 10px 20px rgba(0,0,0,0.1); }
        .no-stock { position: absolute; top: 10px; right: 10px; }
    </style>
</head>
<body>
<!-- 导航栏 -->
<nav class="navbar navbar-expand-lg navbar-dark bg-primary mb-4">
    <div class="container">
        <a class="navbar-brand" href="#"><i class="fa fa-book mr-2"></i>校园图书馆</a>
        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
            <span class="navbar-toggler-icon"></span>
        </button>
        <div class="collapse navbar-collapse" id="navbarNav">
            <ul class="navbar-nav ms-auto">
                <li class="nav-item"><a class="nav-link active" href="book-search.html">图书查询</a></li>
                <li class="nav-item"><a class="nav-link" href="borrowing-record.html">借阅记录</a></li>
                <li class="nav-item"><a class="nav-link" href="#">个人中心</a></li>
                <li class="nav-item dropdown">
                    <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown"><i class="fa fa-user-circle"></i> 张同学</a>
                    <ul class="dropdown-menu dropdown-menu-end">
                        <li><a class="dropdown-item" href="#">个人信息</a></li>
                        <li><a class="dropdown-item" href="#">修改密码</a></li>
                        <li><hr class="dropdown-divider"></li>
                        <li><a class="dropdown-item" href="#">退出登录</a></li>
                    </ul>
                </li>
            </ul>
        </div>
    </div>
</nav>
<div class="container">
    <h3 class="mb-4">图书查询</h3>
    <!-- 搜索栏 -->
    <div class="row mb-4">
        <div class="col-md-8 offset-md-2">
            <div class="input-group">
                <input type="text" class="form-control" placeholder="请输入书名或作者进行搜索..." id="searchInput">
                <button class="btn btn-primary" type="button" id="searchBtn"><i class="fa fa-search mr-1"></i>搜索</button>
            </div>
        </div>
    </div>
    <div class="row">
        <!-- 分类筛选栏 -->
        <div class="col-md-3 mb-4">
            <div class="card">
                <div class="card-header bg-light"><h5 class="mb-0">图书分类</h5></div>
                <div class="list-group list-group-flush">
                    <a href="#" class="list-group-item list-group-item-action category-item active">全部图书</a>
                    <a href="#" class="list-group-item list-group-item-action category-item">计算机类</a>
                    <a href="#" class="list-group-item list-group-item-action category-item">文学类</a>
                    <a href="#" class="list-group-item list-group-item-action category-item">经管类</a>
                    <a href="#" class="list-group-item list-group-item-action category-item">理工类</a>
                    <a href="#" class="list-group-item list-group-item-action category-item">医学类</a>
                    <a href="#" class="list-group-item list-group-item-action category-item">历史类</a>
                    <a href="#" class="list-group-item list-group-item-action category-item">艺术类</a>
                </div>
            </div>
        </div>
        <!-- 图书列表 -->
        <div class="col-md-9">
            <div class="row">
                <!-- 图书卡片示例 -->
                <div class="col-md-4 mb-4">
                    <div class="card book-card h-100 position-relative">
                        <img src="https://picsum.photos/id/24/300/400" class="card-img-top" alt="Java 编程思想">
                        <div class="card-body">
                            <h5 class="card-title">Java 编程思想</h5>
                            <p class="card-text text-muted">作者：Bruce Eckel</p>
                            <p class="card-text"><small>剩余可借：<span class="text-success">5</span>/10</small></p>
                            <a href="#" class="btn btn-primary btn-sm w-100">查看详情</a>
                        </div>
                    </div>
                </div>
                <!-- 更多卡片省略 -->
            </div>
            <!-- 分页 -->
            <nav aria-label="Page navigation">
                <ul class="pagination justify-content-center">
                    <li class="page-item disabled"><a class="page-link" href="#" tabindex="-1">上一页</a></li>
                    <li class="page-item active"><a class="page-link" href="#">1</a></li>
                    <li class="page-item"><a class="page-link" href="#">2</a></li>
                    <li class="page-item"><a class="page-link" href="#">3</a></li>
                    <li class="page-item"><a class="page-link" href="#">下一页</a></li>
                </ul>
            </nav>
        </div>
    </div>
</div>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js"></script>
<script>
    // 分类筛选功能
    document.querySelectorAll('.category-item').forEach(item => {
        item.addEventListener('click', function(e) {
            e.preventDefault();
            document.querySelectorAll('.category-item').forEach(i => i.classList.remove('active'));
            this.classList.add('active');
        });
    });
    // 搜索功能
    document.getElementById('searchBtn').addEventListener('click', function() {
        const searchText = document.getElementById('searchInput').value.trim();
        if (searchText) {
            alert(`搜索内容：${searchText}`);
        } else {
            alert('请输入搜索内容');
        }
    });
</script>
</body>
</html>

2. 借阅记录页

• 布局：表格形式展示所有未归还的借阅记录，列包含'图书名称''作者''借阅时间''到期时间''剩余天数''操作'；
• 核心功能：剩余天数小于 3 天时，'剩余天数'列显示红色字体并标注'即将超期'；点击'续借'按钮可完成续借，点击'归还'按钮可预约归还（管理员确认后完成归还）；
• 细节设计：表格上方有'超期提醒'模块，显示该学生所有超期未还的图书，避免学生遗漏。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>借阅记录 - 校园图书馆系统</title>
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/css/font-awesome.min.css" rel="stylesheet">
    <style>
        .overdue-alert { border-left: 4px solid #dc3545; }
        .soon-expire { color: #dc3545; font-weight: bold; }
        .table-hover tbody tr:hover { background-color: rgba(0,0,0,0.05); }
    </style>
</head>
<body>
<!-- 导航栏 -->
<nav class="navbar navbar-expand-lg navbar-dark bg-primary mb-4">
    <div class="container">
        <a class="navbar-brand" href="#"><i class="fa fa-book mr-2"></i>校园图书馆</a>
        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
            <span class="navbar-toggler-icon"></span>
        </button>
        <div class="collapse navbar-collapse" id="navbarNav">
            <ul class="navbar-nav ms-auto">
                <li class="nav-item"><a class="nav-link" href="book-search.html">图书查询</a></li>
                <li class="nav-item"><a class="nav-link active" href="borrowing-record.html">借阅记录</a></li>
                <li class="nav-item"><a class="nav-link" href="#">个人中心</a></li>
                <li class="nav-item dropdown">
                    <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown"><i class="fa fa-user-circle"></i> 张同学</a>
                    <ul class="dropdown-menu dropdown-menu-end">
                        <li><a class="dropdown-item" href="#">个人信息</a></li>
                        <li><a class="dropdown-item" href="#">修改密码</a></li>
                        <li><hr class="dropdown-divider"></li>
                        <li><a class="dropdown-item" href="#">退出登录</a></li>
                    </ul>
                </li>
            </ul>
        </div>
    </div>
</nav>
<div class="container">
    <h3 class="mb-4">借阅记录</h3>
    <!-- 超期提醒 -->
    <div class="alert alert-danger overdue-alert mb-4">
        <h5 class="alert-heading"><i class="fa fa-exclamation-circle mr-2"></i>超期提醒</h5>
        <p>您有 1 本图书已超期未还，请尽快归还，以免影响您的借阅权限。</p>
        <ul>
            <li>《C 程序设计》 - 已超期 3 天</li>
        </ul>
    </div>
    <!-- 借阅记录表格 -->
    <div class="card">
        <div class="card-body">
            <div class="table-responsive">
                <table class="table table-hover">
                    <thead class="table-light">
                        <tr>
                            <th>图书名称</th>
                            <th>作者</th>
                            <th>借阅时间</th>
                            <th>到期时间</th>
                            <th>剩余天数</th>
                            <th>操作</th>
                        </tr>
                    </thead>
                    <tbody>
                        <tr>
                            <td>Java 编程思想</td>
                            <td>Bruce Eckel</td>
                            <td>2023-05-10</td>
                            <td>2023-06-10</td>
                            <td class="soon-expire">2 天 <span class="badge bg-danger">即将超期</span></td>
                            <td>
                                <button class="btn btn-sm btn-primary" onclick="renewBook(1)">续借</button>
                                <button class="btn btn-sm btn-secondary ms-1" onclick="reserveReturn(1)">归还预约</button>
                            </td>
                        </tr>
                        <!-- 更多行省略 -->
                    </tbody>
                </table>
            </div>
        </div>
    </div>
</div>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js"></script>
<script>
    // 续借功能
    function renewBook(bookId) {
        if (confirm('确定要续借这本书吗？续借将延长 30 天借阅期。')) {
            alert('续借成功！新的到期时间将延长 30 天。');
        }
    }
    // 归还预约功能
    function reserveReturn(bookId) {
        if (confirm('确定要预约归还这本书吗？管理员确认后，请在 3 天内到图书馆归还。')) {
            alert('归还预约已提交，请留意系统通知。');
        }
    }
</script>
</body>
</html>

3. 图书管理页

• 布局：顶部有'添加图书'按钮，下方是图书管理表格，列包含'图书编号''书名''作者''馆藏总数''剩余可借数量''操作'；
• 核心功能：点击'添加图书'跳转至添加页面（带参数校验，比如馆藏数量必须为正整数）；点击'编辑'可修改图书信息（如更新简介），点击'下架'可将图书设为'不可借'（用于图书维护）；
• 细节设计：剩余可借数量小于总数的 1/3 时，'剩余可借数量'列显示黄色字体，提醒管理员补充馆藏。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>图书管理 - 校园图书馆系统</title>
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/css/font-awesome.min.css" rel="stylesheet">
    <style>
        .low-stock { color: #fd7e14; font-weight: bold; }
        .sidebar { min-height: calc(100vh - 56px); background-color: #f8f9fa; border-right: 1px solid #dee2e6; }
        .sidebar .nav-link { color: #333; transition: all 0.2s; }
        .sidebar .nav-link.active { background-color: #0d6efd; color: white; }
        .sidebar .nav-link:hover:not(.active) { background-color: #e9ecef; }
    </style>
</head>
<body>
<!-- 顶部导航栏 -->
<nav class="navbar navbar-expand-lg navbar-dark bg-primary">
    <div class="container-fluid">
        <a class="navbar-brand" href="#"><i class="fa fa-book mr-2"></i>图书馆管理系统</a>
        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
            <span class="navbar-toggler-icon"></span>
        </button>
        <div class="collapse navbar-collapse" id="navbarNav">
            <ul class="navbar-nav ms-auto">
                <li class="nav-item dropdown">
                    <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown"><i class="fa fa-user-circle"></i> 管理员</a>
                    <ul class="dropdown-menu dropdown-menu-end">
                        <li><a class="dropdown-item" href="#">个人信息</a></li>
                        <li><a class="dropdown-item" href="#">修改密码</a></li>
                        <li><hr class="dropdown-divider"></li>
                        <li><a class="dropdown-item" href="#">退出登录</a></li>
                    </ul>
                </li>
            </ul>
        </div>
    </div>
</nav>
<div class="container-fluid">
    <div class="row">
        <!-- 侧边栏 -->
        <div class="col-md-2 d-none d-md-block sidebar p-3">
            <ul class="nav flex-column">
                <li class="nav-item mb-1"><a class="nav-link active" href="admin-book-management.html"><i class="fa fa-book mr-2"></i>图书管理</a></li>
                <li class="nav-item mb-1"><a class="nav-link" href="#"><i class="fa fa-users mr-2"></i>读者管理</a></li>
                <li class="nav-item mb-1"><a class="nav-link" href="#"><i class="fa fa-exchange mr-2"></i>借阅管理</a></li>
                <li class="nav-item mb-1"><a class="nav-link" href="#"><i class="fa fa-bar-chart mr-2"></i>统计分析</a></li>
                <li class="nav-item mb-1"><a class="nav-link" href="#"><i class="fa fa-cog mr-2"></i>系统设置</a></li>
            </ul>
        </div>
        <!-- 主内容区 -->
        <main class="col-md-10 ms-sm-auto px-md-4 py-4">
            <div class="d-flex justify-content-between align-items-center mb-4">
                <h3>图书管理</h3>
                <button class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#addBookModal"><i class="fa fa-plus mr-1"></i>添加图书</button>
            </div>
            <!-- 图书管理表格 -->
            <div class="card">
                <div class="card-body">
                    <div class="table-responsive">
                        <table class="table table-hover">
                            <thead class="table-light">
                                <tr>
                                    <th>图书编号</th>
                                    <th>书名</th>
                                    <th>作者</th>
                                    <th>分类</th>
                                    <th>馆藏总数</th>
                                    <th>剩余可借</th>
                                    <th>状态</th>
                                    <th>操作</th>
                                </tr>
                            </thead>
                            <tbody>
                                <tr>
                                    <td>BOOK001</td>
                                    <td>Java 编程思想</td>
                                    <td>Bruce Eckel</td>
                                    <td>计算机类</td>
                                    <td>10</td>
                                    <td class="low-stock">3</td>
                                    <td><span class="badge bg-success">可借</span></td>
                                    <td>
                                        <button class="btn btn-sm btn-primary" onclick="editBook('BOOK001')">编辑</button>
                                        <button class="btn btn-sm btn-warning ms-1" onclick="下架图书('BOOK001')">下架</button>
                                    </td>
                                </tr>
                                <!-- 更多行省略 -->
                            </tbody>
                        </table>
                    </div>
                    <!-- 分页 -->
                    <nav aria-label="Page navigation" class="mt-4">
                        <ul class="pagination justify-content-center">
                            <li class="page-item disabled"><a class="page-link" href="#" tabindex="-1">上一页</a></li>
                            <li class="page-item active"><a class="page-link" href="#">1</a></li>
                            <li class="page-item"><a class="page-link" href="#">2</a></li>
                            <li class="page-item"><a class="page-link" href="#">3</a></li>
                            <li class="page-item"><a class="page-link" href="#">下一页</a></li>
                        </ul>
                    </nav>
                </div>
            </div>
        </main>
    </div>
</div>
<!-- 添加图书模态框 -->
<div class="modal fade" id="addBookModal" tabindex="-1" aria-labelledby="addBookModalLabel" aria-hidden="true">
    <div class="modal-dialog modal-lg">
        <div class="modal-content">
            <div class="modal-header">
                <h5 class="modal-title" id="addBookModalLabel">添加图书</h5>
                <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
            </div>
            <div class="modal-body">
                <form id="addBookForm">
                    <div class="row mb-3">
                        <div class="col-md-6">
                            <label for="bookName" class="form-label">书名 <span class="text-danger">*</span></label>
                            <input type="text" class="form-control" id="bookName" required>
                        </div>
                        <div class="col-md-6">
                            <label for="author" class="form-label">作者 <span class="text-danger">*</span></label>
                            <input type="text" class="form-control" id="author" required>
                        </div>
                    </div>
                    <div class="row mb-3">
                        <div class="col-md-6">
                            <label for="category" class="form-label">分类 <span class="text-danger">*</span></label>
                            <select class="form-select" id="category" required>
                                <option value="">请选择分类</option>
                                <option value="计算机类">计算机类</option>
                                <option value="文学类">文学类</option>
                                <option value="经管类">经管类</option>
                                <option value="理工类">理工类</option>
                                <option value="医学类">医学类</option>
                                <option value="历史类">历史类</option>
                                <option value="艺术类">艺术类</option>
                            </select>
                        </div>
                        <div class="col-md-6">
                            <label for="publisher" class="form-label">出版社</label>
                            <input type="text" class="form-control" id="publisher">
                        </div>
                    </div>
                    <div class="row mb-3">
                        <div class="col-md-6">
                            <label for="totalCopies" class="form-label">馆藏总数 <span class="text-danger">*</span></label>
                            <input type="number" class="form-control" id="totalCopies" min="1" required>
                            <div class="form-text">请输入正整数</div>
                        </div>
                        <div class="col-md-6">
                            <label for="publicationDate" class="form-label">出版日期</label>
                            <input type="date" class="form-control" id="publicationDate">
                        </div>
                    </div>
                    <div class="mb-3">
                        <label for="description" class="form-label">图书简介</label>
                        <textarea class="form-control" id="description" rows="3"></textarea>
                    </div>
                </form>
            </div>
            <div class="modal-footer">
                <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">取消</button>
                <button type="button" class="btn btn-primary" onclick="saveBook()">保存</button>
            </div>
        </div>
    </div>
</div>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js"></script>
<script>
    // 编辑图书
    function editBook(bookId) {
        alert(`编辑图书：${bookId}`);
    }
    // 下架图书
    function 下架图书 (bookId) {
        if (confirm(`确定要将图书 ${bookId} 下架吗？下架后读者将无法借阅。`)) {
            alert(`图书 ${bookId} 已成功下架`);
        }
    }
    // 上架图书
    function 上架图书 (bookId) {
        if (confirm(`确定要将图书 ${bookId} 上架吗？上架后读者可以正常借阅。`)) {
            alert(`图书 ${bookId} 已成功上架`);
        }
    }
    // 保存图书
    function saveBook() {
        const bookName = document.getElementById('bookName').value;
        const author = document.getElementById('author').value;
        const category = document.getElementById('category').value;
        const totalCopies = document.getElementById('totalCopies').value;
        if (!bookName || !author || !category || !totalCopies) {
            alert();
            ;
        }
         ((totalCopies) <= ) {
            ();
            ;
        }
        ();
         modal = bootstrap..(.());
        modal.();
        .().();
    }
</script>
</body>
</html>

五、优化与调试

生成源码后，根据课程设计要求做了 3 处关键优化，并解决了 2 个常见问题：

1. 核心优化点

• 密码加密：代码注释中提醒'密码需加密存储'，集成了 Spring Security 的 BCrypt 加密，在 UserServiceImpl 的 register 方法中，将 user.setPassword(request.getPassword()) 改为 user.setPassword(bCryptPasswordEncoder.encode(request.getPassword()))，登录时用 bCryptPasswordEncoder.matches() 校验，避免明文存储密码。
• 超期提醒：在 BorrowServiceImpl 的 getStudentBorrowRecords 方法中，添加'剩余天数计算'逻辑，当剩余天数≤3 天时，在前端显示红色提醒；超期后，禁止续借并提示'需先归还'，符合图书馆实际规则。
• 图书分类管理：基础模块中没有'图书分类添加'功能，在管理员端补充了 CategoryController 和 CategoryService，支持管理员添加/编辑图书分类（如'考研类''小说类'），让图书分类更灵活。

2. 调试中遇到的问题及解决

• 问题 1：启动项目时提示'数据库连接失败'——原因是 application.yml 中 MySQL 的 password 是默认值，改成自己本地数据库的密码后，重启项目恢复正常。
• 问题 2：学生借阅图书后，图书的'剩余可借数量'未减少——检查代码发现，BorrowServiceImpl 的 borrowBook 方法中，忘记调用 bookMapper.updateById(book) 更新图书信息，补充该代码后问题解决。

六、自我感想

这次使用 AI 工具开发在线图书借阅平台，收获远超'完成课程设计'的目标：

1. 需求梳理不再'迷茫'：以前做项目总把'想要一个借阅平台'停留在模糊想法阶段，不知道怎么拆分成'学生能查书''管理员能加书'等具体功能。AI 的'需求拆解'环节帮助把口语化描述转化为可执行关键点，还补充了'续借次数限制''超期校验'等没考虑到的细节，明白'好的需求是能落地的小功能集合'。
2. 基础代码不再'重复写'：实体类的 get/set 方法、Mapper 的 CRUD 接口、DTO 的参数校验——这些以前要写 1 天的基础代码，AI 很快生成，而且代码带完整注释。不需要再纠结'表结构字段怎么设计'，而是能专注于'超期提醒''续借逻辑'等核心业务，开发效率提升明显。
3. 解决问题更'有思路'：调试时遇到'借阅后库存不更新'，顺着生成的代码注释'需更新图书的 availableCount'，很快定位到'忘记调用 update 方法'的问题；以前遇到 bug 会慌，现在知道从'业务逻辑流程'和'代码注释提示'中找解决方向，这种思维对后续学习很有帮助。

七、总结

这次开发让我明白，对学生而言，AI 工具不是'代替编程'，而是'降低开发门槛'——帮我们解决了'基础代码繁琐''需求梳理混乱'的痛点，能在有限的课程设计时间内，开发出功能完整、逻辑规范的系统。

当然，这个平台还有很多可优化的地方：比如添加'图书预约'功能（热门图书无库存时学生可预约）、对接图书馆的罚款系统（超期后自动计算罚款金额）。后续会继续迭代，比如在'需求编辑器'中输入'添加图书预约功能，支持学生预约无库存图书，有库存时自动提醒'，进一步完善平台功能。

最后，给其他做课程设计的同学一个建议：如果遇到'不知道怎么开始''代码写不下去'的问题，不妨试试 AI 辅助工具——它能帮你生成代码，更能引导养成'先梳理需求、再设计、最后编码'的规范开发习惯，这对未来的学习和工作都至关重要。