同步前后端联调与文档更新

This commit is contained in:
2026-04-02 09:25:05 +08:00
parent af43beadb0
commit 6964e26ec9
113 changed files with 4317 additions and 293 deletions

92
f2b.md
View File

@@ -1,6 +1,6 @@
# F2B 协作清单
> 文档版本v1.0
> 最后更新2026-04-02
> 最后更新2026-04-02 08:28:05
说明:
@@ -14,44 +14,6 @@
## 待确认
### F2B-001
- 时间2026-04-01
- 提出方:前端
- 当前事实:
- 小程序当前按以下语义上报 session 结束状态:
- 正常打终点完成 -> `finished`
- 超时结束 -> `failed`
- 主动退出 / 放弃恢复 -> `cancelled`
- 需要对方确认什么:
- backend 是否确认以上三态为正式语义
- 状态:待确认
### F2B-002
- 时间2026-04-01
- 提出方:前端
- 当前事实:
- 小程序已启用“放弃恢复 -> `finish(cancelled)`
- 调用时使用的是恢复快照里的旧 `sessionId/sessionToken`
- 若上报失败,前端仍会放弃本地恢复,不阻塞用户
- 需要对方确认什么:
- backend 是否确认“放弃恢复”应记为 `cancelled`
-`sessionToken` 在该场景下是否允许调用 `finish(cancelled)`
- 状态:待确认
### F2B-003
- 时间2026-04-01
- 提出方:前端
- 当前事实:
- 联调和故障恢复场景下,`start` / `finish` 存在重复调用可能
- 当前前端已经尽量去重,但无法完全避免网络重试和页面重进
- 需要对方确认什么:
- backend 是否按幂等方式处理 `start`
- backend 是否按幂等方式处理 `finish`
- 状态:待确认
### F2B-004
- 时间2026-04-01
@@ -109,6 +71,43 @@
-
- 状态:已确认
### F2B-C003
- 时间2026-04-02
- 提出方:前端
- 当前事实:
- backend 已确认 session 三态正式语义:
- 正常完成 -> `finished`
- 超时或规则失败 -> `failed`
- 主动退出 / 放弃恢复 -> `cancelled`
- 前端已按这套语义继续联调
- 需要对方确认什么:
-
- 状态:已确认
### F2B-C004
- 时间2026-04-02
- 提出方:前端
- 当前事实:
- backend 已确认“放弃恢复”官方语义为 `finish(cancelled)`
-`sessionToken` 在该场景下允许继续调用
- 前端当前已正式启用该链路
- 需要对方确认什么:
-
- 状态:已确认
### F2B-C005
- 时间2026-04-02
- 提出方:前端
- 当前事实:
- backend 已确认 `start / finish` 按幂等处理
- 前端可继续按当前补报 / 重试逻辑联调
- 需要对方确认什么:
-
- 状态:已确认
---
## 阻塞
@@ -176,20 +175,18 @@
### F2B-N001
- 时间2026-04-01
- 时间2026-04-02
- 提出方:前端
- 当前事实:
- 当前最需要 backend 反馈的,是 session 生命周期相关语义
- session 生命周期关键语义已由 backend 确认
- 当前前端下一轮重点应转向主链回归与结果展示对齐
- 需要对方确认什么:
- 优先回复:
- F2B-001
- F2B-002
- F2B-003
- 状态:等待后端回复
-
- 状态:前端执行中
### F2B-N002
- 时间2026-04-01
- 时间2026-04-02
- 提出方:前端
- 当前事实:
- 心率 / 卡路里个体化能力已在前端预留
@@ -197,3 +194,4 @@
- 后续是否提供用户身体数据接口
- 状态:后续事项