docs: 幂等键检修报告;勘误 API_INVENTORY 与 HTTP 报告;同步 STATUS/JIRA

新增 docs/幂等键检修报告-2026-09-18.md:记录双向断裂(后端零处读取该头、
前端 Date.now 每次生成新键)、五处审计发现、机制设计与五个取舍
(先占位后执行 / 重放 / 失败释放占位 / 孤儿占位接管 / 作用域含 actor_id)、
列类型不变量扫描、E2E 与守门证据、三处同形状问题的连带修复。

同轮勘误:

- docs/HTTP语义检修报告-2026-09-18.md:其中「Idempotency-Key 已支持」一句
  在写下时不成立(后端当时零处读取),已显式标注勘误并保留原文,
  以免「结论先于核实」被当作既成事实继续引用。
- docs/api/API_INVENTORY.md:原记载 POST /activities/{id}/interests
  「提交活动互选」,后端从未实现(Phase 16 已并入 /feedback 的
  interestTargetUserIds),按真实端点重列并附勘误说明。

docs/STATUS.md:迁移范围更新为 V001~V046;回归行更新为 669 / 0 / 0 / 3;
新增「幂等键检修」章节;补登 HTTP 语义检修章节在两份文档中的缺失条目。
docs/JIRA_BACKLOG.md:补登 HTTP 语义检修与幂等键检修两行
(此前均未登记)。
This commit is contained in:
WorkBuddy
2026-09-18 16:37:47 +08:00
parent af5412646b
commit 2766e53fe2
5 changed files with 453 additions and 5 deletions
+6 -1
View File
@@ -180,7 +180,12 @@ Tests run: 664, Failures: 0, Errors: 0, Skipped: 3 BUILD SUCCESS
但限流本身是否启用、阈值多少,本轮未验证。
3. **OpenAPI 文档对外发布**:已有 `OpenApiConfig`,是否开放、开放哪些端点需决策。
4. **审计与可观测**:第三方调用需要独立的调用审计与配额计量。
5. **分页稳定性与幂等**:`Idempotency-Key` 已支持,但需确认第三方可见端点的覆盖范围。
5. **分页稳定性与幂等**:~~`Idempotency-Key` 已支持~~,但需确认第三方可见端点的覆盖范围。
> **勘误(同日续做)**:此处"已支持"在写下时不成立——后端当时**零处**读取 `Idempotency-Key` 头,
> 前端 26 处发送全部石沉大海。该断言已由 `docs/幂等键检修报告-2026-09-18.md` 修复并推翻:
> 幂等机制现已真正落地(29+1 处端点声明 + 拦截器 + 唯一索引),此处描述**至此才成立**。
> 保留原文以记录这处"结论先于核实"的失误。
6. **敏感字段脱敏边界**:现有 INV-011 等约束面向内部角色,第三方场景需重新界定。
---