Add video download failure reporting feature

- Introduced a new API endpoint `POST /api/v1/video/remove_watermark/report_failure` for reporting download failures.
- Added a new database table `video_download_failures` to store details about failed downloads, including domain, URL, error message, and reporting metadata.
- Updated the video handler to process failure reports and save them to the database.
- Enhanced documentation to include details about the new reporting feature and its usage.

docs/remove_watermark/API.md

@@ -99,3 +99,25 @@ curl -X POST 'http://127.0.0.1:8080/api/v1/video/remove_watermark/unlock' \
 - 每次解析调用都会写入 `video_parse_logs`，其中包含 `request_content`、`parsed_url`、第三方响应、调用耗时等字段，便于审计和配额统计。
 - 第三方返回的 JSON 直接保存在 `video_parse_logs.third_party_payload` 字段，可通过 SQL 查询和脱敏。
 - SQL DDL 位于 `docs/sql/remove_watermark.sql`，部署数据库时执行即可。
+
+## 5. 下载失败上报
+
+`POST /api/v1/video/remove_watermark/report_failure`
+
+| 项目 | 说明 |
+| --- | --- |
+| Header | 可为空（供内部服务调用），也可附加 `Content-Type: application/json` |
+| 请求体 | `{ "domain": "example.com", "failedUrl": "https://example.com/video.mp4", "errorMessage": "403 from CDN", "timestamp": 1728034710000, "userAgent": "miniprogram" }` |
+| 响应 | `{"code":200,"message":"success","data":{"reported":true}}` |
+
+字段说明：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `domain` | string，可选 | 失败 URL 所属域名，若缺失会自动从 `failedUrl` 解析 |
+| `failedUrl` | string，必填 | 下载失败的完整地址 |
+| `errorMessage` | string，可选 | 失败原因描述，建议包含第三方响应 |
+| `timestamp` | number，可选 | 失败发生时间，毫秒级 Unix 时间戳。默认使用服务端接收时间。 |
+| `userAgent` | string，可选 | 报告端的 UA，默认取 HTTP 头 |
+
+服务端会额外记录请求来源 IP（`client_ip`），并存入 `video_download_failures` 表，便于后续排查白名单或 CDN 问题。