整理前后端联调协作文档

This commit is contained in:
2026-04-01 19:05:28 +08:00
parent f7393907ec
commit 0490b8605c
3 changed files with 347 additions and 412 deletions

View File

@@ -60,6 +60,32 @@
---
## 2.3 当前固定模板
为了避免两份协作文档再次变成长讨论稿,当前约定两边都采用统一结构:
- `待确认`
- `已确认`
- `阻塞`
- `已完成`
- `下一步`
并且每条尽量固定包含:
- 时间
- 提出方
- 当前事实
- 需要对方确认什么
- 当前状态
这样做的目的不是增加格式负担,而是保证:
- 三条线程都能快速扫描
- 总控线程能快速识别优先级
- 已确认事项不会反复讨论
---
## 3. 总控线程的职责
总控线程不替代前后端线程,而是负责:
@@ -100,6 +126,21 @@
- 正式设计文档
- 阶段结论
### 3.3 当前总控线程的附加约束
总控线程需要持续做两件事:
- 读取并理解 [f2b.md](D:/dev/cmr-mini/f2b.md) 和 [b2f.md](D:/dev/cmr-mini/b2f.md) 的最新事实
- 把已经收敛的跨线程结论回写到 `doc/` 正式文档
也就是说,总控线程不是“第三份协作文档”,而是:
- 主线维护者
- 正式知识沉淀者
- 交叉影响判断者
---
---
## 4. 推荐协作顺序
@@ -142,6 +183,8 @@
- 以联调事实为主
- 可频繁修改
- 不要求体系化
- 采用统一固定结构
- 不承担正式设计说明职责
### 5.2 正式文档
@@ -255,3 +298,21 @@
- 让并行开发不串线
- 让重要结论沉淀下来
- 让总控线程始终知道项目全貌
---
## 9. 当前执行状态
截至当前阶段,这套方式已经进入实际执行状态:
- 前端线程维护 [f2b.md](D:/dev/cmr-mini/f2b.md)
- 后端线程维护 [b2f.md](D:/dev/cmr-mini/b2f.md)
- 两份文档都已经按统一结构整理
- 总控线程负责维护 [文档索引.md](D:/dev/cmr-mini/doc/文档索引.md) 和 `doc/` 下的正式文档
后续如果线程数量增加,或者联调链变复杂,优先仍然是:
- 先扩展协作文档约定
- 再决定是否引入更重的流程工具
而不是先把协作体系做复杂。