audio_codebuddy/.plans/audiobook-v2-ux/backend-dev/progress.md

backend-dev - 工作日志

用于上下文恢复。压缩/重启后先读此文件。

---

2026-05-07

OPT-02: 轮询超时修复（WebSocket 推送）

完成以下修改：

1. 新建 server/src/services/websocket.service.ts

   • WebSocket 服务，基于 ws 库
   • 挂载于 /ws 路径
   • 提供 pushAudioGenerationComplete 和 pushVideoGenerationComplete 函数

2. 修改 server/src/app.ts

   • 导入 initWebSocket
   • 在 start() 函数中调用 initWebSocket(server)

3. 修改 server/src/modules/tts/tts.service.ts

   • 音频生成完成后推送 audio_generation_complete 事件
   • 音频生成失败后推送 audio_generation_complete 事件（status: 'failed'）

4. 修改 server/src/modules/video-generator/video-generator.service.ts

   • 视频生成完成后推送 video_generation_complete 事件
   • 视频生成失败后推送 video_generation_complete 事件（status: 'failed'）

待前端配合

• 移除 index.vue 和 chapter-detail.vue 中的 30s setTimeout 超时
• 改为监听 WebSocket 事件 audio_generation_complete 和 video_generation_complete

下一步

• OPT-08: batch-generate API (已完成)
• OPT-12: feedback API (已完成)
• OPT-17: 歌词时间轴

OPT-12: 意见反馈 API

完成以下修改：

1. 新建 server/src/modules/feedback/feedback.service.ts

   • 反馈服务，提供 submitFeedback 方法
   • 使用 uuid 生成反馈 ID
   • 保存到 MySQL 数据库

2. 新建 server/src/modules/feedback/feedback.controller.ts

   • 路由: POST /api/feedback
   • 参数验证: type 必填且为 suggestion/bug/other, title/content 必填
   • 调用 feedbackService.submitFeedback

3. 修改 server/prisma/schema.prisma

   • 新增 Feedback 模型

4. 修改 server/src/app.ts

   • 导入 feedbackRoutes
   • 注册 /api/feedback 路由

待执行

• 运行 npx prisma generate
• 运行 npx prisma db push