94 lines
3.2 KiB
Markdown
94 lines
3.2 KiB
Markdown
|
# AI 克隆系统交付说明
|
|||
|
|
|
|||
|
|
## 1. 项目简介
|
|||
|
|
|
|||
|
|
本项目为“AI 克隆系统”，提供以下能力：
|
|||
|
|
|
|||
|
|
- 声音复刻（音色创建/管理）
|
|||
|
|
- 对话/通话类功能（依赖后端接口）
|
|||
|
|
- 照片复活/图片生成视频（后端任务 + 视频合成托管）
|
|||
|
|
- 用户体系（注册/登录/短信验证码/微信小程序登录）
|
|||
|
|
- 支付与计费（服务定价、下单、订单状态、按次/免费次数/补偿次数）
|
|||
|
|
- 管理端（Vue3 + Element Plus）用于运营/管理
|
|||
|
|
- 小程序/uni-app 前端（`frontend-ai/`）用于移动端交互
|
|||
|
|
|
|||
|
|
## 2. 交付物清单
|
|||
|
|
|
|||
|
|
- 后端服务（Spring Boot）
|
|||
|
|
- 目录：`ai-clone/`
|
|||
|
|
- 运行产物：`ai-clone/target/voice-cloning-1.0.0.jar`
|
|||
|
|
-
|
|||
|
|
- 管理端前端（静态站点）
|
|||
|
|
- 目录：`admin/`
|
|||
|
|
- 构建产物：`admin/dist/`
|
|||
|
|
|
|||
|
|
- 小程序/uni-app 前端
|
|||
|
|
- 目录：`frontend-ai/`
|
|||
|
|
- API 配置说明：`frontend-ai/config/README.md`
|
|||
|
|
|
|||
|
|
## 3. 运行环境与依赖
|
|||
|
|
|
|||
|
|
- 后端：
|
|||
|
|
- Java：**JDK 8**（后端 `ai-clone/pom.xml` 约束为 1.8）
|
|||
|
|
- Maven：3.6+
|
|||
|
|
- MySQL：8.x（或兼容版本）
|
|||
|
|
- 管理端：
|
|||
|
|
- Node.js：建议 18+
|
|||
|
|
- 小程序/uni-app：
|
|||
|
|
- HBuilderX（或 uni-app 对应构建链路）
|
|||
|
|
|
|||
|
|
## 4. 服务与端口约定
|
|||
|
|
|
|||
|
|
- 后端 API：默认 **20002**（以 `ai-clone/src/main/resources/application.properties` 的 `server.port` 为准）
|
|||
|
|
- 管理端前端：常见部署为静态站点端口 **20002** 或通过 Nginx 80/443 反代（由运维确定）
|
|||
|
|
|
|||
|
|
## 5. 核心接口（对接方常用）
|
|||
|
|
|
|||
|
|
说明：以下为“路由前缀级别”的对接索引，具体参数以代码/接口调试为准。
|
|||
|
|
|
|||
|
|
- 语音/音色
|
|||
|
|
- 前缀：`/api/voice`
|
|||
|
|
- 示例：创建音色、音色列表、删除音色
|
|||
|
|
- 照片复活/视频
|
|||
|
|
- 前缀：`/api/revival`（以 `PhotoRevivalController` 实际映射为准）
|
|||
|
|
- 用户体系
|
|||
|
|
- 前缀：`/api/user`
|
|||
|
|
- 示例：登录、微信登录、注册、找回密码等
|
|||
|
|
- 管理端账号
|
|||
|
|
- 前缀：`/api/admin`
|
|||
|
|
- 示例：管理员登录/注册、管理员列表等
|
|||
|
|
- 支付与计费
|
|||
|
|
- 前缀：`/api/pay`
|
|||
|
|
- 示例：服务价格列表、创建订单、查询订单状态、使用次数预览等
|
|||
|
|
|
|||
|
|
## 6. 配置项（交付时需要替换）
|
|||
|
|
|
|||
|
|
重要：**交付环境禁止使用仓库中硬编码的 Key/密码**。部署时请按下列项替换为客户方正式配置。
|
|||
|
|
|
|||
|
|
- 第三方 API：
|
|||
|
|
- 通义/百炼 DashScope：`dashscope.api.key`
|
|||
|
|
- 图片生成视频/第三方：`grsai.api.key`（如启用）
|
|||
|
|
- 数据库：
|
|||
|
|
- `spring.datasource.url`
|
|||
|
|
- `spring.datasource.username`
|
|||
|
|
- `spring.datasource.password`
|
|||
|
|
- 微信小程序登录：
|
|||
|
|
- `wechat.mini.appid`
|
|||
|
|
- `wechat.mini.secret`
|
|||
|
|
- 短信服务（如启用）：
|
|||
|
|
- `aliyun.sms.access-key-id`
|
|||
|
|
- `aliyun.sms.access-key-secret`
|
|||
|
|
- `aliyun.sms.sign-name`
|
|||
|
|
- `aliyun.sms.template-code`
|
|||
|
|
- 文件托管/静态资源：
|
|||
|
|
- `filehosting.local.path`
|
|||
|
|
- `filehosting.url.prefix`
|
|||
|
|
- `spring.web.resources.static-locations`
|
|||
|
|
|
|||
|
|
## 7. 验收方式（建议）
|
|||
|
|
|
|||
|
|
- 后端健康检查：访问 `GET /api/voice/health` 返回 `status=ok`
|
|||
|
|
- 管理端：可正常打开首页，且能成功调用后端 API（以实际部署域名/端口为准）
|
|||
|
|
- 小程序/uni-app：可正常登录、拉取列表、提交生成任务（以实际业务页面为准）
|
|||
|
|
|