# verify-delivery-service

KTV产线交付质检HTTP服务 — 4项QA检查

## 服务说明

将KTV产线的交付质检流程封装为HTTP服务，提供统一的质检入口。

### 4项QA检查

1. **QA1 字幕时间精准性** — 时间单调递增、无重叠、无gap>2s
2. **QA2 字幕歌词正确性** — ASS中歌词与原始歌词逐行比对
3. **QA3 MTV使用原音频** — 单轨、duration匹配原曲
4. **QA4 KTV双轨音序** — Track1=伴奏(Accompaniment), Track2=原唱(Original)

## 部署

```bash
git clone git@git.opencomputing.cn:yumoqing/verify_delivery.git
cd verify_delivery
chmod +x start.sh stop.sh
./start.sh
```

服务运行在 `http://0.0.0.0:9085`

## API端点

### GET /api/status
服务状态检查

### POST /api/submit
提交质检任务

参数：
- `mtv_path`: MTV视频路径（可选）
- `ktv_path`: KTV视频路径（可选）
- `ass_path`: ASS字幕路径（可选）
- `lyrics_path`: 原始歌词路径（可选）
- `calibrated_path`: calibrated.json路径（可选，用于QA1）
- `original_duration`: 原曲时长（秒，可选）

返回：
```json
{
  "status": "submitted",
  "task_id": "xxx",
  "message": "质检任务已提交"
}
```

### GET /api/task?task_id=xxx
查询质检任务结果

返回：
```json
{
  "task_id": "xxx",
  "status": "completed",
  "result": {
    "status": "PASSED",
    "qa_results": {
      "QA1_timeline": {"passed": true, "errors": []},
      "QA2_lyrics": {"passed": true, "errors": []},
      "QA3_mtv": {"passed": true, "errors": []},
      "QA4_ktv": {"passed": true, "errors": []}
    },
    "total_errors": 0,
    "errors": []
  }
}
```

## 技术栈

- ahserver (ahserver.webapp)
- longtasks (异步任务队列)
- ffprobe (视频/音频元数据提取)
- Python 3.10

## Git仓库

- 远端：`git@git.opencomputing.cn:yumoqing/verify_delivery.git`
- 本地：`~/test/verify-delivery-service/`