精品书单与更多推荐说明.md 2.0 KB

精品书单与更多推荐功能说明

功能概述

  • 精品书单:展示点赞数 + 浏览量较高的精品书籍,默认显示 4 本。
  • 更多推荐:展示热度较高的推荐书籍,默认显示 6 本。
  • 数据来源:MySQL books 表,status = 1(上架)的书籍。

后端接口

接口 方法 说明 参数 默认值
/api/book/featured-list GET 获取精品书单 limit 可选 4
/api/book/more-recommend GET 获取更多推荐 limit 可选 6

排序规则

  • 精品书单:like_count DESC, view_count DESC, created_at DESC
  • 更多推荐:view_count DESC, like_count DESC, created_at DESC

返回值结构:Result<List<BookVO>>

前端改动

文件:books/pages/index/index.vue

  • 新增 loadFeaturedListloadMoreRecommend 方法,页面加载/显示时自动调用。
  • 增加加载中、空状态提示。
  • 图片加载失败时使用备用图片。

测试步骤

  1. 启动后端服务

    cd book
    mvn spring-boot:run
    
  2. 验证接口

    • 浏览器访问 http://localhost:8081/api/book/featured-list
    • 浏览器访问 http://localhost:8081/api/book/more-recommend
    • 确认返回 code: 200data 列表非空。
  3. 检查数据库数据

    USE books_db;
    SELECT COUNT(*) FROM books WHERE status = 1;
    
    • 若返回 0,请执行 book/src/main/resources/db/quick_insert_books.sql
  4. 前端验证

    • 打开微信开发者工具,重新编译/刷新小程序。
    • 首页“精品书单”、“更多推荐”显示来自后端的动态数据。
    • Network 面板可看到对应接口请求成功。

注意事项

  • 确保数据库书籍的 status 为 1(上架)。
  • 若需要调整数量,可在前端调用时传入 limit,或后端默认值中修改。
  • 若需定制筛选条件,可在 BookMapper.xml 中调整 SQL 排序/筛选逻辑。