# 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：可正常登录、拉取列表、提交生成任务（以实际业务页面为准）