同步前后端联调与文档更新
This commit is contained in:
92
f2b.md
92
f2b.md
@@ -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 @@
|
||||
- 后续是否提供用户身体数据接口
|
||||
- 状态:后续事项
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user