基于 AI 辅助的在线图书借阅平台设计与实现

（一）需求理解阶段

AI 工具解析后的需求点包括：

1. 需要用户管理功能，包括用户注册、登录、个人信息维护和权限控制。
2. 需要图书管理功能，支持图书信息的增删改查以及分类和状态管理。
3. 需要借阅管理功能，支持用户借书、还书、续借操作及借阅记录查询。
4. 需要系统配置管理功能，支持基础数据配置和全局参数设置。
5. 需要通知消息功能，支持向用户推送借阅相关的提醒和公告信息。
6. 需要统计报表功能，支持生成各类业务统计数据和分析报告。

（二）接口设计阶段

1. 用户管理：实现用户的注册、登录、个人信息维护及权限控制功能。支持用户角色分配与访问控制，确保系统安全性与数据隔离性。
2. 图书管理：提供图书信息的增删改查操作，支持图书分类管理和状态更新，如在馆、借出等状态变更，满足图书资源的有效管理。
3. 借阅管理：处理用户的借书、还书和续借请求，记录每次借阅行为并提供借阅历史查询服务，保障图书流通顺畅与可追溯性。
4. 系统配置管理：管理系统基础数据配置项和全局参数设置，包括但不限于系统运行参数、业务规则配置等内容，提升系统的灵活性和适应能力。
5. 通知消息管理：支持向用户推送借阅相关的提醒通知与公告信息，包括逾期提醒、归还提示等，增强用户体验和系统交互性。
6. 统计报表管理：生成各类业务统计数据和分析报告，涵盖借阅情况、图书利用率、用户活跃度等维度，辅助决策制定与运营优化。

（三）表结构设计阶段

AI 工具支持自动表结构生成或使用现有表结构两种情况。

-- 用户信息表
CREATE TABLE user_info (
  user_id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '用户唯一标识',
  username VARCHAR(50) NOT NULL UNIQUE COMMENT '用户名',
  password VARCHAR(100) NOT NULL COMMENT '用户密码（加密后）',
  email VARCHAR(100) COMMENT '用户邮箱',
  phone VARCHAR(20) COMMENT '用户手机号',
  real_name VARCHAR(50) COMMENT '真实姓名',
  avatar_url VARCHAR(255) COMMENT '头像地址',
  status TINYINT DEFAULT 1 COMMENT '用户状态：1-正常，0-禁用',
  role_type VARCHAR(50) COMMENT '用户角色类型',
  create_by VARCHAR(50) COMMENT '创建人',
  create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  update_by VARCHAR(50) COMMENT '修改人',
  update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间'
) COMMENT='用户信息表';

-- 图书信息表
CREATE TABLE book_info (
  book_id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '图书唯一标识',
  isbn VARCHAR(20) UNIQUE COMMENT 'ISBN 编号',
  title VARCHAR(200) NOT NULL COMMENT '图书标题',
  author VARCHAR(100) COMMENT '作者',
  publisher VARCHAR(100) COMMENT '出版社',
  publish_date DATE COMMENT '出版日期',
  category_id INT COMMENT '分类 ID',
  total_quantity INT DEFAULT 0 COMMENT '总数量',
  available_quantity INT DEFAULT 0 COMMENT '可借数量',
  status TINYINT DEFAULT 1 COMMENT '图书状态：1-在馆，0-借出',
  description TEXT COMMENT '图书描述',
  cover_image VARCHAR(255) COMMENT '封面图片地址',
  create_by VARCHAR(50) COMMENT '创建人',
  create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  update_by VARCHAR(50) COMMENT '修改人',
  update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间'
) COMMENT='图书信息表';

-- 借阅记录表
CREATE TABLE borrow_record (
  record_id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '借阅记录唯一标识',
  user_id BIGINT NOT NULL COMMENT '借阅用户 ID',
  book_id BIGINT NOT NULL COMMENT '图书 ID',
  borrow_date DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '借书时间',
  due_date DATETIME COMMENT '应还时间',
  return_date DATETIME COMMENT '实际归还时间',
  renewal_count INT DEFAULT 0 COMMENT '续借次数',
  status TINYINT DEFAULT 1 COMMENT '借阅状态：1-已借出，2-已归还，3-逾期',
  create_by VARCHAR(50) COMMENT '创建人',
  create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  update_by VARCHAR(50) COMMENT '修改人',
  update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间'
) COMMENT='借阅记录表';

-- 系统配置表
CREATE TABLE system_config (
  config_id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '配置项唯一标识',
  config_key VARCHAR(100) NOT NULL UNIQUE COMMENT '配置键名',
  config_value TEXT COMMENT '配置值',
  config_desc VARCHAR(255) COMMENT '配置说明',
  group_name VARCHAR(50) COMMENT '所属组别',
  is_enabled TINYINT DEFAULT 1 COMMENT '是否启用：1-是，0-否',
  create_by VARCHAR(50) COMMENT '创建人',
  create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  update_by VARCHAR(50) COMMENT '修改人',
  update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间'
) COMMENT='系统配置表';

-- 通知消息表
CREATE TABLE notification_message (
  message_id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '消息唯一标识',
  user_id BIGINT COMMENT '接收用户 ID',
  title VARCHAR(200) NOT NULL COMMENT '消息标题',
  content TEXT NOT NULL COMMENT '消息内容',
  message_type VARCHAR(50) COMMENT '消息类型：如逾期提醒、归还提示等',
  is_read TINYINT DEFAULT 0 COMMENT '是否已读：0-未读，1-已读',
  send_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '发送时间',
  expire_time DATETIME COMMENT '过期时间',
  create_by VARCHAR(50) COMMENT '创建人',
  create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  update_by VARCHAR(50) COMMENT '修改人',
  update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间'
) COMMENT='通知消息表';

（四）逻辑处理（接口）阶段

每个接口都给出了详细的入参、处理逻辑、数据存储及返回结果。

（五）源码生成阶段

点击开始生成，等待即可。

每个核心功能差不多都是两分钟生成完毕，因此该项目 6 个核心功能共耗时 12 分钟就生成完毕了。

共生成了 51 个文件，每个核心功能都有 Controller, DO, DTO, Service 等等，非常符合代码开发规范。

三、优化与调试心得

（一）生成代码调整问题

在生成用户登录功能代码后，发现密码加密逻辑缺失。AI 生成的 UserServiceImpl 中，用户注册时密码是明文存储，登录验证也直接比较明文密码。这存在严重安全隐患，于是通过智能会话进行优化，建议引入 Spring Security 的密码加密工具 BCryptPasswordEncoder，在用户注册时对密码进行加密，登录验证时也用该工具对输入密码加密后再与数据库中密码比较。

重新生成的代码同时登录时的判断也进行了修改，完美解决。

（二）SQL 优化问题

1. user_info 表:
   • role_type 字段：使用 VARCHAR(20) 即可并定义明确的枚举值，如 USER, ADMIN，便于权限控制。
2. book_info 表:
   • status 字段：目前的 1-在馆，0-借出 定义是多余的。因为图书的在馆状态完全可以通过 (available_quantity > 0) 来逻辑判断。这个状态可以移除，或者改为更丰富的状态（如：在馆、借出、整理中、已下架）。
   • 由于借阅是这个平台最重要的功能，因此我们可以考虑增加一个索引来优化查询性能。特别是用户端需要频繁查询某个用户的借阅记录。

borrow_record 表:

ALTER TABLE borrow_record ADD INDEX idx_user_status (user_id, status);

四、成果展示与总结

（一）工程结构图

项目最终的工程结构清晰，分为用户、图书、借阅、分类等模块，每个模块下包含实体类、Repository、Service、Controller 等组件。

（二）核心代码片段

以下是用户登录接口的核心代码片段（UserController 类中）：

/**
 * 用户注册接口
 *
 * @param registerDTO 注册信息
 * @return RestResult
 */
@PostMapping("/register")
public RestResult<?> register(@Valid @RequestBody UserRegisterDTO registerDTO) {
    log.info("接收到用户注册请求，用户名为：{}", registerDTO.getUsername());
    return userService.register(registerDTO);
}

/**
 * 用户登录接口
 *
 * @param loginDTO 登录信息
 * @return RestResult
 */
@PostMapping("/login")
public RestResult<?> login(@Valid @RequestBody UserLoginDTO loginDTO) {
    log.info("接收到用户登录请求，用户名为：{}", loginDTO.getUsername());
    return userService.login(loginDTO);
}

/**
 * 修改用户信息接口
 *
 * @param updateDTO 更新信息
 * @return RestResult
 */
@PostMapping("/update")
public RestResult<?> updateUser(@Valid @RequestBody UserUpdateDTO updateDTO) {
    log.info("接收到修改用户信息请求，用户 ID 为：{}", updateDTO.getUserId());
    return userService.updateUser(updateDTO);
}

/**
 * 更新用户状态接口
 *
 * @param statusUpdateDTO 状态更新信息
 * @return RestResult
 */
@PostMapping("/update-status")
public RestResult<?> updateUserStatus(@Valid @RequestBody UserStatusUpdateDTO statusUpdateDTO) {
    log.info("接收到更新用户状态请求，用户 ID 为：{}", statusUpdateDTO.getUserId());
    return userService.updateUserStatus(statusUpdateDTO);
}

/**
 * 查询用户详情接口
 *
 * @param queryDTO 查询条件
 * @return RestResult
 */
@PostMapping("/detail")
public RestResult<?> getUserDetail(@Valid @RequestBody UserDetailQueryDTO queryDTO) {
    log.info("接收到查询用户详情请求，用户 ID 为：{}", queryDTO.getUserId());
    return userService.getUserDetail(queryDTO);
}

以下是用户借阅接口的核心代码片段（BorrowController 类中）：

@RestController
@RequestMapping("/borrow")
@RequiredArgsConstructor
public class BorrowController {
    private final BorrowService borrowService;

    /**
     * 用户借书接口
     *
     * @param borrowBookDTO 借书参数对象
     * @return 统一响应结果
     */
    @PostMapping("/borrowBook")
    public RestResult<?> borrowBook(@RequestBody @Valid BorrowBookDTO borrowBookDTO) {
        return borrowService.borrowBook(borrowBookDTO);
    }

    /**
     * 用户还书接口
     *
     * @param returnBookDTO 还书参数对象
     * @return 统一响应结果
     */
    @PostMapping("/returnBook")
    public RestResult<?> returnBook(@RequestBody @Valid ReturnBookDTO returnBookDTO) {
        return borrowService.returnBook(returnBookDTO);
    }

    /**
     * 用户续借接口
     *
     * @param renewalBookDTO 续借参数对象
     * @return 统一响应结果
     */
    @PostMapping("/renewalBook")
    public RestResult<?> renewalBook(@RequestBody @Valid RenewalBookDTO renewalBookDTO) {
        return borrowService.renewalBook(renewalBookDTO);
    }

    /**
     * 查询借阅历史接口
     *
     * @param queryHistoryDTO 查询参数对象
     * @return 统一响应结果
     */
    @GetMapping("/queryHistory")
    public RestResult<?> queryHistory(QueryHistoryDTO queryHistoryDTO) {
        return borrowService.queryHistory(queryHistoryDTO);
    }
}

以下是消息接口的核心代码片段（NotificationController 类中）：

/**
 * <p>
 * 通知消息控制器
 * </p>
 * @author Administrator
 */
@RestController
@RequestMapping("/notification")
@RequiredArgsConstructor
public class NotificationController {
    private final NotificationService notificationService;

    /**
     * 发送通知消息
     *
     * @param request 发送通知请求参数
     * @return 统一响应结果
     */
    @PostMapping("/send")
    public RestResult<Void> sendNotification(@Valid @RequestBody SendNotificationRequest request) {
        return notificationService.sendNotification(request);
    }

    /**
     * 获取用户未读通知列表
     *
     * @param query 查询参数
     * @return 统一响应结果
     */
    @GetMapping("/unread-list")
    public RestResult<Object> getUnreadNotifications(NotificationQuery query) {
        return notificationService.getUnreadNotifications(query.getUserId());
    }

    /**
     * 标记通知为已读
     *
     * @param messageId 消息 ID
     * @return 统一响应结果
     */
    @PutMapping("/mark-read/{messageId}")
    public RestResult<Void> markAsRead(@PathVariable Long messageId) {
        return notificationService.markAsRead(messageId);
    }

    /**
     * 删除通知消息
     *
     * @param messageId 消息 ID
     * @return 统一响应结果
     */
    @DeleteMapping("/{messageId}")
    public RestResult<Void> deleteNotification(@PathVariable Long messageId) {
        return notificationService.deleteNotification(messageId);
    }
}

（三）AI 辅助开发体会

优势

• 开发效率高：能够快速生成各模块的基础代码，省去了大量重复的编码工作，极大地加快了项目的开发进度，让开发者可以将更多精力放在业务逻辑的优化和复杂功能的实现上。
• 代码规范性好：生成的代码遵循一定的规范，如包结构划分、类和方法的命名等，有利于项目的统一管理和团队协作。
• 学习成本低：对于一些常见的功能模块，AI 的智能引导可以辅助开发者快速上手，即使是对某些技术不太熟悉的开发者，也能借助它开展开发工作。

不足

• 复杂业务支持有限：对于一些业务逻辑复杂、存在特殊业务规则的功能，AI 生成的代码往往不能完全满足需求，例如密码不能明文存储等这种特殊逻辑，可能需要进一步通过智能会话去优化或者甚至大量的手动调整和优化，在业务深度适配方面还有提升空间。

总体而言，AI 辅助工具在在线图书借阅平台的开发过程中起到了很好的辅助作用，尤其是在基础代码生成方面表现出色，虽然存在一些不足，但仍为项目开发带来了诸多便利。

参考链接

1. Spring Boot 官方文档
   • Spring Boot Reference
2. 前端开发
   • Vue.js Core Tutorial
   • Element Plus Component Library
3. 数据库设计
   • MySQL 8.0 Table Structure Optimization Guide
   • InnoDB Storage Engine Deep Dive
4. 开源项目
   • Java+Spring Boot Book Management System