audio_codebuddy/.plans/audiobook-v2-ux/docs/architecture.md

AI有声书 v2 - 架构

系统架构和关键设计决策。 维护者：team-lead, devs（架构变更后更新）

系统概览

AI 有声书生成平台，包含：

• 前端：uni-app (Vue 3)，多端支持（H5/小程序）
• 后端：Node.js + Express，Prisma ORM
• 数据库：PostgreSQL
• 实时通信：WebSocket（生成进度推送）

组件图

┌─────────────────┐     ┌─────────────────┐
│   微信小程序      │     │   H5 / Web      │
│   (uni-app)     │     │   (uni-app)     │
└────────┬────────┘     └────────┬────────┘
         │                       │
         └───────────┬───────────┘
                     │ HTTP/WebSocket
         ┌───────────▼───────────┐
         │     Node.js API       │
         │   (Express + Prisma)  │
         └───────────┬───────────┘
                     │
    ┌─────────────────┼─────────────────┐
    │                 │                 │
┌───▼───┐      ┌─────▼─────┐    ┌─────▼─────┐
│PostgreSQL│    │  文件存储   │    │  AI 服务   │
│         │    │(本地/NFS) │    │ (TTS API) │
└─────────┘    └───────────┘    └───────────┘

目录结构

audio_codebuddy/
├── my-uniapp-vue3/          # 前端 uniapp 项目
│   └── src/
│       ├── pages/           # 页面
│       ├── components/      # 组件
│       ├── stores/          # Pinia 状态
│       └── utils/            # 工具函数
├── server/                  # 后端 Node.js
│   └── src/
│       ├── modules/          # 业务模块
│       │   └── book-generator/
│       ├── services/         # 服务层
│       └── app.ts            # Express 入口
└── 优化开发计划.md           # 优化文档

技术栈

• 前端：Vue 3 + TypeScript + uni-app + Pinia
• 后端：Node.js + Express + TypeScript + Prisma
• 数据库：PostgreSQL + Prisma ORM
• 实时：WebSocket（ws 库）
• AI：TTS API（外部服务）

关键设计

有声书生成流程

1. 创建书籍 → AI 生成章节内容
2. 生成音频 → TTS 文字转语音
3. 生成视频 → 音频 + 封面图合成
4. 发布分享

状态管理

• 前端：Pinia stores（bookStore, playerStore, userStore）
• 后端：Prisma + 内存状态（book-generator.store.ts）

API 设计

• RESTful API
• WebSocket 推送生成进度
• 前后端接口见 api-contracts.md