> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akria.net/llms.txt
> Use this file to discover all available pages before exploring further.

# API 测试流程

> Core API 完整业务链路测试指南

## 🎯 测试目标

验证从信号创建到下游（Ghost / Rocket.Chat）接收的完整链路。

<Steps>
  <Step title="创建测试信号" icon="plus">
    使用 `dev-team-1` Key 提交模拟信号。
  </Step>

  <Step title="拉取 Outbox" icon="download">
    使用 `dev-team-4` Key 从指定渠道拉取任务。
  </Step>

  <Step title="执行推送" icon="paper-plane">
    将 Payload 发送到下游 Webhook 或 API。
  </Step>

  <Step title="发送 ACK" icon="check">
    确认投递成功，更新系统状态。
  </Step>
</Steps>

***

## 🚀 快速测试脚本

我们提供了一个全自动测试脚本，支持 Ubuntu 环境。

<Card title="Ubuntu 本地调试" icon="ubuntu" href="./DEBUG_UBUNTU">
  查看详细的 Ubuntu 本地环境配置与调试指南。
</Card>

### 运行步骤

```bash theme={null}
cd services/core-api-v1/tests
source venv/bin/activate

# 运行 1 个随机事件测试
python3 test_api.py --count 1 --push
```

***

## 🔍 核心验证点

<AccordionGroup>
  <Accordion title="1. 信号入库验证">
    检查 `signals` 表中是否生成了对应的 UUID 记录，状态应为 `dispatching`。
  </Accordion>

  <Accordion title="2. Outbox 生成验证">
    检查 `outbox` 表中是否针对 `ghost` 和 `rocketchat` 渠道生成了对应的 Payload。
  </Accordion>

  <Accordion title="3. 状态聚合验证">
    当所有渠道确认 ACK 后，`signals` 表中的状态应自动更新为 `sent`。
  </Accordion>
</AccordionGroup>

<Warning>
  **注意**：Ghost 推送需要生成 JWT Token，请确保本地已安装 `PyJWT`。
</Warning>