AI 辅助开发在线图书借阅平台设计与实现

一、需求分析与规划

一、功能需求

我们将需求分为两类：用户端功能和管理员端功能。

1. 用户端功能

在这里插入图片描述

用户注册与登录：支持邮箱/手机号注册，并实现安全的密码管理。
图书检索与浏览：
- 搜索：支持按书名、作者、ISBN、关键词进行模糊搜索。
- 筛选：支持按图书分类、出版社、出版年份等条件筛选。
- 排序：支持按上新时间、借阅量、评分等排序。
图书详情页：展示图书封面、书名、作者、出版社、简介、目录、库存状态、用户评分与评论。
个人中心：
- 借阅管理：查看当前借阅中、已归还、已超期的图书列表。可进行续借操作（有限制次数）。
- 个人信息管理：修改昵称、头像、密码、联系方式等。
消息通知：通过站内信或邮件接收借阅成功、到期提醒、超期警告、预约到书等通知。

2. 管理员端功能

管理员登录：独立的后台管理系统登录入口。
图书管理：
- CRUD 操作：对图书信息进行增删改查。
- 批量操作：支持通过 Excel 模板批量导入图书信息。
- 库存管理：管理图书的总数量、在馆数量。
用户管理：查看所有注册用户信息，禁用/启用用户账户，管理用户借阅权限。
借阅管理：
- 手动处理借阅、归还、续借操作（应对特殊情况）。
- 查看所有用户的借阅记录和历史。
数据统计与报表：
- 统计热门借阅图书、活跃用户、借阅趋势等。
- 生成借阅量、超期情况等报表。
系统设置：管理图书分类、出版社等基础数据。

（二）核心模块

根据以上功能，我们将系统划分为以下五个核心模块：

在这里插入图片描述

用户模块 (User Module)：负责用户注册、登录、认证、权限管理和个人信息管理。
图书模块 (Book Module)：负责图书信息的增删改查、分类管理、库存状态管理。
借阅模块 (Borrow/Lending Module)：核心业务模块，负责处理借书、还书、续借的完整流程和状态变更。
评论评分模块 (Review & Rating Module)：管理用户对图书的评论和评分。

（三）技术选型

后端：采用 Java 语言开发，结合 AI 辅助工具辅助代码生成与开发。使用 Spring Boot 框架搭建项目，利用 MyBatis 进行数据库操作，数据库选择 MySQL 存储数据。
前端：使用 Vue.js 框架构建用户界面，通过 Axios 与后端进行数据交互，配合 Element UI 组件库提升页面开发效率。

二、AI 辅助开发实录

经过上述的需求分析完毕之后，我们向高效辅助代码开发工具输入我们的需求提示词：

帮我实现如下内容项目名称：在线图书借阅平台核心要求采用前后端分离架构。后端必须使用 Java 语言，并主要使用 Spring Boot、MyBatis 框架。前端使用 Vue.js + Element Plus。数据库使用 MySQL 8.0。代码需具备良好的分层结构（Controller, Service, Mapper/DAO）、清晰的注释和规范的命名。

在这里插入图片描述

（一）需求理解阶段

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

在这里插入图片描述

从图片不难看出，AI 工具需求的理解完全满足了我们之前的需求分析的内容。

（二）接口设计阶段

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

在这里插入图片描述

接口设计完善，并且还考虑了用户体验等日常开发中最重要的潜在要求。

（三）表结构设计阶段

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

在这里插入图片描述

这里为了体现 AI 工具的强大之处，我们使用自动表结构生成。

在这里插入图片描述

在短短的一分钟之内，AI 工具就帮我们生成了 6 张表。

-- 用户信息表
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  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='通知消息表';

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

在这里插入图片描述

逻辑处理（接口）每个接口都给的非常详细，包括入参，处理逻辑，数据存储，返回结果等。

模块名称	功能名称	入参对象属性（必填项标★）	处理逻辑	返回 RestResult 结果
1. 用户管理	1.1 用户注册	username（用户名，★）、password（用户密码，★）、email（用户邮箱）、phone（用户手机号）、realName（真实姓名）	1. 校验用户名是否已存在；2. 若用户名不存在，将用户信息保存到数据库	1. 用户名已存在：`{"code":"000001","msg":"用户名已存在","data":...}`； 2. 保存成功：`{"code":"000000","msg":"调用成功","data":...}`
	1.2 用户登录	username（用户名，★）、password（用户密码，★）	1. 根据用户名查询用户信息；2. 验证查询到的用户密码是否正确；3. 密码正确则返回登录成功的用户信息	1. 用户不存在/密码错误：`{"code":"000001","msg":"用户不存在或密码错误","data":...}`； 2. 登录成功：`{"code":"000000","msg":"调用成功","data":...}`
	1.3 修改用户信息	userId（用户 id，★）、email（用户邮箱）、phone（用户手机号）、realName（真实姓名）、avatarUrl（头像地址）	1. 根据 userId 判断用户是否存在；2. 若用户存在，更新用户信息	1. 用户不存在：`{"code":"000001","msg":"用户不存在","data":...}`； 2. 更新成功：`{"code":"000000","msg":"调用成功","data":...}`
	1.4 获取用户详情	userId（用户 id，★）	1. 根据 userId 判断用户是否存在；2. 若用户存在，返回用户详细信息	1. 用户不存在：`{"code":"000001","msg":"用户不存在","data":...}`； 2. 查询成功：`{"code":"000000","msg":"调用成功","data":...}`
	1.5 禁用/启用用户	userId（用户 id，★）、status（用户状态，★）	1. 根据 userId 判断用户是否存在；2. 若用户存在，更新用户状态	1. 用户不存在：`{"code":"000001","msg":"用户不存在","data":...}`； 2. 状态更新成功：`{"code":"000000","msg":"调用成功","data":...}`
2. 图书管理	2.1 新增图书	isbn（ISBN 编号）、title（图书标题，★）、author（作者）、publisher（出版社）、publishDate（出版日期）、categoryId（分类 ID）、totalQuantity（总数量）、availableQuantity（可借数量）、status（图书状态）、description（图书描述）、coverImage（封面图片地址）	1. 校验图书 ISBN 是否已存在；2. 若 ISBN 不存在，将图书信息保存到数据库	1. ISBN 已存在：`{"code":"000001","msg":"该 ISBN 的图书已存在","data":...}`； 2. 保存成功：`{"code":"000000","msg":"调用成功","data":...}`
	2.2 删除图书	bookId（图书唯一标识，★）	1. 根据 bookId 判断图书是否存在；2. 若图书存在，删除指定图书信息	1. 图书不存在：`{"code":"000001","msg":"图书信息不存在","data":...}`； 2. 删除成功：`{"code":"000000","msg":"调用成功","data":...}`
	2.3 修改图书	bookId（图书唯一标识，★）、isbn（ISBN 编号）、title（图书标题）、author（作者）、publisher（出版社）、publishDate（出版日期）、categoryId（分类 ID）、totalQuantity（总数量）、availableQuantity（可借数量）、status（图书状态）、description（图书描述）、coverImage（封面图片地址）	1. 根据 bookId 判断图书是否存在；2. 若图书存在，更新图书信息

（五）源码生成阶段

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

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

在这里插入图片描述

共生成了 51 个文件，每个核心功能都有 Controller, DO, DTO, Service 等等，非常符合代码开发规范，之后我们点击打开项目。

结构如下

在这里插入图片描述

三、优化与调试心得

（一）生成代码调整问题

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

在这里插入图片描述

我们点击智能会话，让工具再次帮我们优化。重新生成的代码。同时登录时的判断也进行了修改，完美解决。

在这里插入图片描述

（二）SQL 优化问题

user_info 表:
- role_type 字段：使用 VARCHAR(20) 即可并定义明确的枚举值，如 USER, ADMIN，便于权限控制。
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(  UserDetailQueryDTO queryDTO) {
    log.info(, queryDTO.getUserId());
     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 {
         notificationService.deleteNotification(messageId);
    }
}

（三）AI 辅助工具使用体会

优势

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

不足

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

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

参考链接

后端开发
- Spring Boot 官方文档涵盖核心功能、配置管理和生产环境部署指南。
前端开发
- Vue.js 核心教程包含组件化开发、响应式设计和状态管理实践。
- Element Plus 组件库提供表单、表格、弹窗等常用组件的使用示例。
数据库设计
- MySQL 8.0 表结构优化指南详解字段类型选择、索引策略和存储引擎配置。
- InnoDB 存储引擎深度解析分析数据库物理结构与性能调优方法。
在线图书借阅平台开源项目
- Java+Spring Boot 实现的图书管理系统包含用户管理、图书 CRUD 和借阅流程的完整源码。

AI 辅助开发在线图书借阅平台设计与实现