31 lines
1.6 KiB
Markdown
31 lines
1.6 KiB
Markdown
# Gitea Webhook Agent 文档与回归计划
|
||
|
||
## 目标
|
||
|
||
补齐 Gitea Workflow 的部署运维和测试设计文档，并新增不依赖业务实现的
|
||
Webhook 协议回归脚本与 fixtures，覆盖验签、事件过滤、队列恢复、回执重试
|
||
兜底、MCP 线程配置和安全边界；不修改 `server.js` 主逻辑，也不覆盖其他代理
|
||
正在进行的 Gitea 文档或实现改动。
|
||
|
||
## 步骤
|
||
|
||
1. 盘点并复核 `docs/gitea-workflow/PRD.md`、`ARCHITECTURE.md`，确认需求覆盖和
|
||
与其他代理的修改边界
|
||
2. 补齐/校验 PRD 与架构交付基线，并设计部署运维文档固定安全与恢复契约
|
||
3. 设计测试文档并建立需求到回归场景覆盖矩阵
|
||
4. 新增独立 webhook 回归脚本与 JSON fixtures，固定直接验收入口
|
||
5. 运行定向回归、脚本语法检查和差异范围审查
|
||
6. 完成文档一致性复核并清理临时清单
|
||
|
||
## 约束
|
||
|
||
- 现有 `PRD.md`、`ARCHITECTURE.md` 属于其他代理的工作区：先做只读一致性复核；
|
||
只有发现本需求明确缺口且确认不覆盖其改动时才做最小追加，否则在新增文档中
|
||
记录已覆盖项和缺口。
|
||
- 本轮新增/修改目标为 `docs/gitea-workflow/DEPLOYMENT.md`、`TESTING.md`、
|
||
`scripts/gitea-webhook-regression.js` 及 `fixtures/gitea-workflow/*.json`，
|
||
并在新增文档中明确引用 PRD/架构路径。
|
||
- 独立验收入口固定为：`timeout 60s node scripts/gitea-webhook-regression.js`；
|
||
脚本输出每个场景的 PASS/FAIL 与最终汇总，不依赖服务启动或网络。
|
||
- 不修改 `server.js` 主逻辑、`lib/`、`public/`、依赖和其他代理的目标文档。
|