基于 AI 辅助开发的在线图书借阅系统实现

2.2.2 实体类设计

图书实体对象示例：

package com.library.entity;

import jakarta.persistence.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@NoArgsConstructor
@AllArgsConstructor
@Entity
@Table(name = "books")
public class BookDO {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(name = "name", nullable = false)
    private String name;
    
    @Column(name = "status", nullable = false)
    private String status;
    
    @Column(name = "stock_count", nullable = false)
    private Integer stockCount;
}

图书详情实体类：

package com.library.entity;

import com.library.entity.CategoryDO;
import jakarta.persistence.*;
import java.util.List;
import lombok.*;

@Data
@NoArgsConstructor
@AllArgsConstructor
@Entity
@Table(name = "books")
public class BookDetailDO {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(name = "title", nullable = false)
    private String title;
    
    @Column(name = "author", nullable = false)
    private String author;
    
    @Column(name = "category_id", nullable = false)
    private Long categoryId;
    
    @Column(name = "description", nullable = true)
    private String description;
    
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "category_id", referencedColumnName = "id", insertable = false, updatable = false)
    private CategoryDO category;
}

2.2.3 数据统计控制器

package com.library.controller;

import com.library.dto.*;
import com.library.service.StatisticsService;
import jakarta.validation.Valid;
import java.util.Map;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@Slf4j
@RestController
@RequestMapping("/statistics")
public class StatisticsController {
    @Autowired
    private StatisticsService statisticsService;

    @PostMapping("/borrow-rank")
    public Map<String, Object> getBorrowRank(@RequestBody @Valid BorrowRankQuery query) {
        return statisticsService.getBorrowRank(query);
    }

    @PostMapping("/hot-books")
    public Map<String, Object> getHotBooks(@RequestBody @Valid HotBookQuery query) {
        return statisticsService.getHotBooks(query);
    }

    @PostMapping("/user-borrow-stats")
    public Map<String, Object> getUserBorrowStats(@RequestBody @Valid UserBorrowStatQuery query) {
        return statisticsService.getUserBorrowStats(query);
    }

    @PostMapping("/generate-report")
    public Map<String, Object> generateReport(@RequestBody @Valid ReportQuery query) {
        return statisticsService.generateReport(query);
    }
}

三、优化与调试心得

3.1 遇到的典型问题

1. 字段映射错误：AI 生成的 BorrowRecord 实体类中 dueDate 字段类型误设为 LocalDate（实际应为 LocalDateTime，与业务中精确到时分秒的借阅归还时间逻辑匹配）。
2. 业务逻辑缺陷：自动生成的借阅方法未检查用户最大借阅数量限制（如系统规定每人最多借 5 本），导致可能出现超量借阅的情况。
3. 权限校验遗漏：初始生成的 Controller 未集成 Spring Security，所有用户均可访问敏感的借阅管理接口，如借阅、归还和续借操作。

3.2 解决方案与 AI 辅助

• 问题 1：手动修改实体类字段类型为 @TableField("due_date") private LocalDateTime dueDate，并通过 AI 询问'如何修正 MyBatis 实体类中日期字段类型不匹配'，获得注解配置建议。
• 问题 2：在借阅 Service 层添加借阅数量检查逻辑（见上文 2.2.1）。
• 问题 3：通过 AI 生成 Spring Security 配置类，定义角色权限规则：

// AI 辅助生成的 SecurityConfig.java 片段
http.authorizeHttpRequests()
    .antMatchers("/borrow/**").hasAnyRole("USER", "ADMIN")
    .antMatchers("/return/**").hasAnyRole("USER", "ADMIN")
    .antMatchers("/renew/**").hasAnyRole("USER", "ADMIN")
    .anyRequest().authenticated();

3.3 并发处理

并发借阅冲突：多个用户同时借同一本书时，库存可能超卖。 解决方案：在 Book 表添加乐观锁版本号字段，更新时校验版本一致性：

@Update("UPDATE book SET stock = stock - 1, version = version + 1 WHERE id = #{id} AND version = #{version}")
int reduceStockWithVersion(@Param("id") Integer id, @Param("version") Integer version);

四、成果展示与总结

4.1 部署测试

系统界面展示了图书列表页面，包含 ID、封面、名称、所属分类、状态、数量等信息，支持添加、修改、删除、借阅等操作及搜索功能。用户管理界面显示用户列表，支持添加、修改、删除等操作。图书分类列表展示不同分类的记录。

4.2 核心功能验证

• 借阅流程：读者登录后搜索图书，点击借阅→系统验证库存与借阅资格→生成借阅记录（应还日期自动计算）。
• 逾期提醒：超过 30 天未还的书目，在用户首页显示逾期天数及罚款金额。

4.3 价值评估

• 效率提升：基础 CRUD 代码生成节省约 60% 编码时间，适合需求明确的标准化模块。
• 规范性保障：生成的代码符合 Spring Boot 最佳实践（如分层架构、注解驱动）。
• 局限性：复杂业务逻辑（如并发借阅冲突处理）需手动补充优化，AI 对非标准需求的适配能力待加强。

五、总结

本文通过系统开发实践验证了 AI 辅助开发在教育/文化数字化场景中的应用价值：

1. 效率提升：基础功能代码生成节省 50%-70% 开发时间，尤其适合需求明确的标准化模块（如用户管理、CRUD 操作）。
2. 学习曲线平缓：对新手开发者友好，通过 AI 生成的代码反向学习 Spring Boot 最佳实践（如分层架构、注解配置）。

未来可进一步探索 AI 大模型与代码生成的深度融合，推动软件开发向自动实现演进。