# API OpenMagic Testing And QA

## 1. 核心原则

所有功能必须由开发侧自行验证通过后，才可视为可交付。

禁止以下做法：

- 只写代码不自测
- 把明显应由开发完成的验证工作转嫁给用户
- 未验证后台功能就宣称完成

---

## 2. 当前项目的测试策略

在项目初期未公开前：

- 测试优先
- 登录认证次之
- 先把功能跑通，再加权限

因此建议：

- 初期可临时关闭不必要的登录门槛
- 先验证页面、支付、咨询、控制台、转发链路
- 等所有主要流程稳定后，再补登录和权限控制

---

## 3. 必测模块

### 3.1 前台页面

- 首页
- 定价页
- 文档页
- 企业页
- 免费聊天入口
- 咨询入口

### 3.2 控制台

- 登录/注册
- API Key 创建/删除
- 用量页
- 余额/充值页
- 订单页
- 邀请页

### 3.3 支付

- 创建订单
- 发起支付
- 支付回调
- 余额/额度发放
- 月卡开通
- 异常回调处理

### 3.4 咨询

- 咨询组件显示
- 消息发送
- 新消息提醒
- 附件上传
- 品牌路由正确

### 3.5 API 网关

- 鉴权
- 余额校验
- 请求转发
- 流式返回
- 错误返回
- 模型映射

### 3.6 主站导流

- 主站首页 CTA
- 文章页 CTA
- 跳转路径
- 活动链接

---

## 4. 验收顺序

建议顺序：

1. 静态页面与前端交互
2. 咨询入口
3. 注册与控制台基础
4. 支付与订单
5. API 转发
6. 邀请与活动
7. 登录与权限收口

---

## 5. 测试方法

### 页面验证

- 浏览器手动点测
- 多页面路径检查
- 移动端与桌面端检查

### API 验证

- `curl`
- SDK 示例
- 流式响应测试

### 支付验证

- 沙箱/测试订单
- 重复回调
- 失败回调

### 控制台验证

- 用户路径全流程走通
- 异常输入测试

---

## 6. 交付门槛

一个模块只有在以下条件满足后，才能视为“完成”：

- 功能已实现
- 自测已完成
- 关键异常路径已验证
- 前后台链路已贯通
- 结果可复现

---

## 7. 对后续开发的约束

- 每做完一个核心模块，都必须补测试记录
- 能通过浏览器、命令行、接口调用自行验证的，都必须先自行验证
- 重要后台操作必须自己实际点过，而不是只看代码逻辑