zhibo/用户活动记录功能说明.md

用户活动记录功能说明

功能概述

实现了管理端与移动端的"历史记录"功能互通，包括：

• 观看历史（直播间、作品、用户主页）
• 点赞记录（直播间、作品、心愿）
• 关注记录
• 收藏记录

后端实现

1. 服务层

• UserActivityRecordService.java - 服务接口
• UserActivityRecordServiceImpl.java - 服务实现

2. API 控制器

• 前端 API: UserActivityRecordController.java

  • 路径前缀: /api/front/activity/
  • 接口列表:
    • POST /view/record - 记录观看历史
    • GET /view/history - 获取观看历史
    • DELETE /view/history/{historyId} - 删除单条观看历史
    • DELETE /view/history - 清空观看历史
    • GET /like/records - 获取点赞记录
    • GET /like/rooms - 获取点赞的直播间
    • GET /like/works - 获取点赞的作品
    • GET /like/wishes - 获取点赞的心愿
    • GET /follow/records - 获取关注记录
    • GET /collect/works - 获取收藏的作品
    • GET /stats - 获取用户活动统计

• 管理端 API: UserActivityController.java

  • 路径前缀: /api/admin/user/
  • 接口列表:
    • GET /follow/records - 获取用户关注记录
    • GET /like/records - 获取用户点赞记录
    • GET /view/history - 获取用户查看历史
    • GET /collect/works - 获取用户收藏的作品
    • GET /activity/stats - 获取用户活动统计

3. 数据库表

执行 sql/user_activity_records_update.sql 创建以下表：

• eb_view_history - 查看历史记录表
• eb_live_room_like - 直播间点赞记录表
• eb_wish_like - 心愿点赞记录表
• eb_search_history - 搜索历史表
• eb_hot_search - 热门搜索表
• eb_works_relation - 作品关系表（点赞、收藏）

Android 端实现

1. API 接口

在 ApiService.java 中添加了以下接口：

• 观看历史相关接口
• 点赞记录相关接口
• 关注记录接口
• 收藏记录接口
• 用户活动统计接口

2. 页面

• MyRecordsActivity.java - 我的记录页面（整合所有记录类型）
• WatchHistoryActivity.java - 观看历史页面（已更新使用新 API）

3. 布局文件

• activity_my_records.xml - 我的记录页面布局
• fragment_record_list.xml - 记录列表 Fragment 布局
• item_record.xml - 记录列表项布局
• activity_watch_history.xml - 观看历史页面布局

4. 入口

在 ProfileActivity 中添加了"我的记录"快捷入口（action4）

管理端前端实现

1. API 文件

• src/api/userActivity.js - 用户活动记录 API

2. 页面更新

• src/views/user/list/userDetails.vue - 用户详情页面
  • 添加了"关注记录"标签页
  • 添加了"点赞记录"标签页
  • 添加了"查看历史"标签页
  • 添加了"收藏记录"标签页

部署步骤

1. 数据库更新

   -- 执行 SQL 脚本
   source sql/user_activity_records_update.sql
   

2. 后端部署

   • 重新编译并部署 Java 后端服务

3. 管理端前端部署

   • 重新构建并部署管理端前端

4. Android 端

   • 重新编译 APK 并安装

注意事项

1. 后端使用 JdbcTemplate 直接操作数据库，确保数据库表已创建
2. Android 端需要登录后才能使用记录功能
3. 管理端可以查看任意用户的活动记录