mirror of
https://github.com/hpd840321/craftlabs-authorization-sdk.git
synced 2026-06-09 10:00:30 +08:00
huangping
650c1caffa
Add I8/I9 design and implementation review markdown, update parallel iteration index and I7 review cross-links, and add FRONTEND_UI_SPECIFICATION for design handoff (Figma Make). Made-with: Cursor
41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# I8 实现审核 — 对照 [I8_WEBHOOK_DELIVERY_REPLAY_DESIGN.md](./I8_WEBHOOK_DELIVERY_REPLAY_DESIGN.md)
|
||
|
||
> **日期**：2026-04-06。
|
||
|
||
---
|
||
|
||
## 1. 总评
|
||
|
||
| 设计条款 | 结论 |
|
||
|----------|------|
|
||
| 浏览器只调平台、平台代调 Webhook | **已落地**：`POST /api/v1/callback-inbox/{id}/replay-webhook-delivery` + `WebhookDeliveryReplayClient`。 |
|
||
| Webhook `/internal/**` 独立 Ops Token | **已落地**：`WebhookOpsTokenFilter`、`X-Webhook-Ops-Token`；空配置 **503**。 |
|
||
| 仅 `DEAD` 可重放 | **已落地**：`PlatformDeliveryService.replayDeadDeliveryByReceiptId`。 |
|
||
| 关联 `webhookReceiptId` | **已落地**：平台从 `PlatformCallbackInbox` 解析 `Long` 调 Webhook。 |
|
||
| OpenAPI / Runbook | **已更新**：`CallbackWebhookReplayResponse`、RUNBOOK §10.5 I8 段。 |
|
||
|
||
---
|
||
|
||
## 2. 偏差与后续
|
||
|
||
| 项 | 说明 |
|
||
|----|------|
|
||
| **UI 不展示出库状态** | 仍为「成功调用平台接口」提示；是否在详情旁拉取 Webhook 库属 **Mid**（需只读 API 或观测面）。 |
|
||
| **Playwright** | 未进 CI；与 I6/I7 一致可后续补一条 OPS 点击重放（需 mock Webhook 或 test 栈）。 |
|
||
|
||
---
|
||
|
||
## 3. 验证命令（提交前）
|
||
|
||
- `mvn -f services/pom.xml verify`
|
||
- `npm run build`（`web/delivery-platform-ui`）
|
||
- `UPDATE_OPENAPI=0 mvn -f services/pom.xml test -Dtest=OpenApiContractSnapshotTest`（契约已与 `contracts/openapi/delivery-platform-api.json` 手工对齐时亦应通过）
|
||
|
||
---
|
||
|
||
## 4. 修订记录
|
||
|
||
| 日期 | 说明 |
|
||
|------|------|
|
||
| 2026-04-06 | 初版：I8 实现对照设计审核。 |
|