audio_codebuddy/feature_list.json

{
  "project_name": "AI有声书生成工具 - 第二期",
  "base_config": {
    "backend_port": 3000,
    "frontend_port": 5173,
    "db_host": "localhost",
    "db_port": 3306,
    "auth_enabled": false
  },
  "features": [
    {
      "id": 1,
      "description": "播放记录 - 数据库表设计",
      "status": "done",
      "passes": true,
      "backend_test_steps": [
        "1. curl -X POST http://localhost:3000/api/player/progress -H 'Content-Type: application/json' -d '{\"userId\":\"test-user\",\"audioId\":\"audio-001\",\"progress\":30.5,\"duration\":180}' - 验证创建播放记录",
        "2. curl http://localhost:3000/api/player/progress?userId=test-user - 验证查询播放记录列表",
        "3. curl -X PUT http://localhost:3000/api/player/progress/audio-001 -H 'Content-Type: application/json' -d '{\"progress\":60.0}' - 验证更新播放进度",
        "4. curl -X DELETE http://localhost:3000/api/player/progress/audio-001 - 验证删除播放记录"
      ],
      "frontend_test_steps": [
        "1. 打开播放器页面",
        "2. 点击播放音频",
        "3. 等待5秒后查看播放进度是否自动保存",
        "4. 刷新页面验证续播位置是否正确"
      ]
    },
    {
      "id": 2,
      "description": "播放记录 - 前端播放器集成",
      "backend_test_steps": [
        "1. curl http://localhost:3000/api/player/progress?userId=test-user - 验证获取播放进度接口正常"
      ],
      "frontend_test_steps": [
        "1. 打开player页面",
        "2. 选择一个有播放进度的音频",
        "3. 验证是否从上次进度位置开始播放",
        "4. 验证播放进度每5秒自动保存"
      ],
      "status": "done",
      "passes": true
    },
    {
      "id": 3,
      "description": "收藏功能 - 数据库表设计",
      "backend_test_steps": [
        "1. curl -X POST http://localhost:3000/api/favorites -H 'Content-Type: application/json' -d '{\"userId\":\"test-user\",\"audioId\":\"audio-002\"}' - 验证添加收藏",
        "2. curl http://localhost:3000/api/favorites?userId=test-user - 验证查询收藏列表",
        "3. curl -X DELETE http://localhost:3000/api/favorites/audio-002 - 验证取消收藏",
        "4. curl -X POST http://localhost:3000/api/favorites -H 'Content-Type: application/json' -d '{\"userId\":\"test-user\",\"audioId\":\"audio-003\"}' - 重新添加收藏用于后续测试"
      ],
      "frontend_test_steps": [
        "1. 打开player页面",
        "2. 点击收藏按钮",
        "3. 验证收藏状态变为已收藏",
        "4. 进入favorites页面",
        "5. 验证收藏的音频显示在列表中",
        "6. 点击取消收藏按钮",
        "7. 验证列表中该音频已移除"
      ],
      "status": "done",
      "passes": true
    },
    {
      "id": 4,
      "description": "收藏功能 - favorites页面开发",
      "backend_test_steps": [
        "1. curl http://localhost:3000/api/favorites?userId=test-user - 验证收藏列表查询"
      ],
      "frontend_test_steps": [
        "1. 进入favorites收藏页面",
        "2. 验证页面正常加载，显示收藏列表",
        "3. 点击某个音频进入播放器",
        "4. 返回favorites页面验证列表刷新正常"
      ],
      "status": "done",
      "passes": true
    },
    {
      "id": 5,
      "description": "定时关闭 - 前端定时器实现",
      "backend_test_steps": [],
      "frontend_test_steps": [
        "1. 打开player页面并开始播放",
        "2. 点击定时关闭按钮",
        "3. 选择15分钟定时",
        "4. 验证倒计时显示正确",
        "5. 等待或快进到定时时间",
        "6. 验证播放自动暂停"
      ],
      "status": "done",
      "passes": true
    },
    {
      "id": 6,
      "description": "播放速度记忆 - 用户偏好API",
      "backend_test_steps": [
        "1. curl -X POST http://localhost:3000/api/user/preferences -H 'Content-Type: application/json' -d '{\"userId\":\"test-user\",\"playSpeed\":1.5}' - 验证创建用户偏好",
        "2. curl http://localhost:3000/api/user/preferences?userId=test-user - 验证查询用户偏好",
        "3. curl -X PUT http://localhost:3000/api/user/preferences -H 'Content-Type: application/json' -d '{\"userId\":\"test-user\",\"playSpeed\":2.0}' - 验证更新播放速度",
        "4. curl -X PUT http://localhost:3000/api/user/preferences -H 'Content-Type: application/json' -d '{\"userId\":\"test-user\",\"playSpeed\":1.0}' - 恢复默认速度"
      ],
      "frontend_test_steps": [
        "1. 打开player页面",
        "2. 调整播放速度为1.5x",
        "3. 刷新页面",
        "4. 验证播放速度仍为1.5x"
      ],
      "status": "done",
      "passes": true
    },
    {
      "id": 7,
      "description": "分享功能 - 微信JSSDK集成",
      "backend_test_steps": [
        "1. curl http://localhost:3000/api/share?audioId=audio-001 - 验证生成分享链接接口"
      ],
      "frontend_test_steps": [
        "1. 打开player页面",
        "2. 点击分享按钮",
        "3. 验证分享面板正常弹出",
        "4. 验证分享卡片显示标题、封面、简介"
      ],
      "status": "done",
      "passes": true
    },
    {
      "id": 8,
      "description": "分享功能 - 分享卡片生成",
      "backend_test_steps": [
        "1. curl http://localhost:3000/api/share?audioId=7 - 验证分享信息接口返回正确数据"
      ],
      "frontend_test_steps": [
        "1. 打开player页面",
        "2. 点击分享到微信好友",
        "3. 验证分享内容包含音频标题",
        "4. 点击分享到朋友圈",
        "5. 验证朋友圈分享内容正确"
      ],
      "status": "done",
      "passes": true
    },
    {
      "id": 9,
      "description": "加载优化 - 骨架屏组件",
      "backend_test_steps": [],
      "frontend_test_steps": [
        "1. 刷新首页",
        "2. 验证骨架屏正常显示",
        "3. 验证数据加载完成后骨架屏消失",
        "4. 验证内容正常渲染"
      ],
      "status": "init",
      "passes": false
    },
    {
      "id": 10,
      "description": "加载优化 - 图片懒加载",
      "backend_test_steps": [],
      "frontend_test_steps": [
        "1. 进入包含多张图片的列表页面",
        "2. 验证首屏图片正常加载",
        "3. 滚动页面",
        "4. 验证下方图片进入可视区时加载",
        "5. 滚动回顶部",
        "6. 验证图片已缓存不会重复加载"
      ],
      "status": "init",
      "passes": false
    },
    {
      "id": 11,
      "description": "全局搜索 - 搜索API",
      "backend_test_steps": [
        "1. curl http://localhost:3000/api/search?q=test - 验证搜索接口",
        "2. curl http://localhost:3000/api/search?q=故事 - 验证中文搜索",
        "3. curl http://localhost:3000/api/search?q= - 验证空关键词处理"
      ],
      "frontend_test_steps": [
        "1. 进入search搜索页面",
        "2. 输入搜索关键词",
        "3. 验证搜索结果列表正常显示",
        "4. 验证搜索结果相关性"
      ],
      "status": "init",
      "passes": false
    },
    {
      "id": 12,
      "description": "全局搜索 - search页面开发",
      "backend_test_steps": [
        "1. curl http://localhost:3000/api/search?q=小说 - 验证搜索结果正确返回"
      ],
      "frontend_test_steps": [
        "1. 进入search搜索页面",
        "2. 验证搜索历史记录显示",
        "3. 验证热门推荐显示",
        "4. 输入关键词进行搜索",
        "5. 点击搜索结果进入player页面"
      ],
      "status": "init",
      "passes": false
    },
    {
      "id": 13,
      "description": "内容分类 - 分类管理API",
      "backend_test_steps": [
        "1. curl http://localhost:3000/api/categories - 验证获取分类列表",
        "2. curl http://localhost:3000/api/categories/1 - 验证获取分类下音频",
        "3. curl http://localhost:3000/api/categories/999 - 验证无效分类ID处理"
      ],
      "frontend_test_steps": [
        "1. 进入index首页",
        "2. 验证分类标签显示正确",
        "3. 点击某个分类",
        "4. 验证只显示该分类下的音频"
      ],
      "status": "init",
      "passes": false
    },
    {
      "id": 14,
      "description": "内容分类 - 分类筛选",
      "backend_test_steps": [
        "1. curl http://localhost:3000/api/categories/2 - 验证分类2音频列表"
      ],
      "frontend_test_steps": [
        "1. 在index页面切换不同分类标签",
        "2. 验证列表内容随分类变化",
        "3. 验证分类筛选准确性"
      ],
      "status": "init",
      "passes": false
    },
    {
      "id": 15,
      "description": "音质选择 - 音质切换逻辑",
      "backend_test_steps": [
        "1. curl -X PUT http://localhost:3000/api/user/preferences -H 'Content-Type: application/json' -d '{\"userId\":\"test-user\",\"quality\":\"high\"}' - 验证设置高品质",
        "2. curl http://localhost:3000/api/user/preferences?userId=test-user - 验证获取偏好确认"
      ],
      "frontend_test_steps": [
        "1. 打开player页面",
        "2. 点击音质选择按钮",
        "3. 切换到高音质",
        "4. 验证音质切换生效",
        "5. 刷新页面验证音质设置已保存"
      ],
      "status": "init",
      "passes": false
    },
    {
      "id": 16,
      "description": "离线缓存 - 下载管理",
      "backend_test_steps": [
        "1. curl http://localhost:3000/api/downloads - 验证获取下载列表",
        "2. curl http://localhost:3000/api/downloads/check - 验证检查下载状态"
      ],
      "frontend_test_steps": [
        "1. 进入favorites页面",
        "2. 选择一个音频点击下载",
        "3. 验证下载进度显示",
        "4. 验证下载完成后状态更新"
      ],
      "status": "init",
      "passes": false
    },
    {
      "id": 17,
      "description": "离线缓存 - 离线播放",
      "backend_test_steps": [
        "1. curl http://localhost:3000/api/downloads - 验证下载列表接口"
      ],
      "frontend_test_steps": [
        "1. 进入favorites页面",
        "2. 验证已下载音频显示下载状态",
        "3. 关闭网络连接",
        "4. 点击已下载音频进行播放",
        "5. 验证离线播放正常"
      ],
      "status": "init",
      "passes": false
    },
    {
      "id": 18,
      "description": "评论打分 - 评论API",
      "backend_test_steps": [
        "1. curl -X POST http://localhost:3000/api/comments -H 'Content-Type: application/json' -d '{\"userId\":\"test-user\",\"audioId\":\"audio-004\",\"content\":\"很好听\",\"rating\":5}' - 验证发表评论",
        "2. curl http://localhost:3000/api/comments/audio-004 - 验证获取评论列表",
        "3. curl -X POST http://localhost:3000/api/comments -H 'Content-Type: application/json' -d '{\"userId\":\"test-user2\",\"audioId\":\"audio-004\",\"content\":\"不错\",\"rating\":4}' - 添加更多评论"
      ],
      "frontend_test_steps": [
        "1. 打开player页面",
        "2. 滑动到评论区",
        "3. 验证评论列表显示",
        "4. 输入评论内容并打分",
        "5. 点击提交",
        "6. 验证新评论显示在列表中"
      ],
      "status": "init",
      "passes": false
    },
    {
      "id": 19,
      "description": "消息通知 - 通知API",
      "backend_test_steps": [
        "1. curl http://localhost:3000/api/notifications - 验证获取通知列表",
        "2. curl -X POST http://localhost:3000/api/notifications/read -H 'Content-Type: application/json' -d '{\"id\":\"notif-001\"}' - 验证标记已读"
      ],
      "frontend_test_steps": [
        "1. 进入任意页面",
        "2. 验证通知图标显示",
        "3. 点击通知图标",
        "4. 验证通知列表正常显示",
        "5. 点击某条通知",
        "6. 验证已读状态更新"
      ],
      "status": "init",
      "passes": false
    }
  ]
}