zhangyan/cmr-mini
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

完善活动运营域与联调标准化

Browse Source
This commit is contained in:
zhangyan
2026-04-03 13:11:41 +08:00
parent 0e28f70bad
commit 129ea935db
56 changed files with 11004 additions and 196 deletions
Download Patch File Download Diff File Expand all files Collapse all files

100
doc/gameplay/多线程联调协作方式.md
View File

@@ -1,6 +1,6 @@
# 多线程联调协作方式
> 文档版本：v1.0
> 最后更新：2026-04-02 08:28:05
> 文档版本：v1.1
> 最后更新：2026-04-03 11:15:00
## 目标
@@ -21,7 +21,7 @@
- 一个代码仓库
- 多条并行线程
- 两份根目录协作文档
- 四份根目录协作文档
- 一名全局维护者负责总览和收口
对应关系：
@@ -32,38 +32,57 @@
---
## 2. 两份协作文档的职责
## 2. 当前协作文档的职责
当前跨线程沟通只走两份文件：
当前跨线程沟通主线改为 4 份文件：
- [t2b.md](D:/dev/cmr-mini/t2b.md)
- [b2t.md](D:/dev/cmr-mini/b2t.md)
- [t2f.md](D:/dev/cmr-mini/t2f.md)
- [f2t.md](D:/dev/cmr-mini/f2t.md)
旧的：
- [f2b.md](D:/dev/cmr-mini/f2b.md)
- [b2f.md](D:/dev/cmr-mini/b2f.md)
### 2.1 `f2b.md`
默认不再作为主线协作文档继续扩写，只保留历史参考价值。
由前端线程维护，用于记录：
### 2.1 `t2b.md`
- 前端当前联调状态
- 前端已经按什么契约实现
- 需要后端确认什么
- 当前前端阻塞点是什么
由总控线程维护，写给后端线程，用于记录：
它不是后端说明文档，也不是讨论区。
- 当前阶段后端应推进什么
- 本刀范围是什么
- 哪些对象和接口先做
### 2.2 `b2f.md`
### 2.2 `b2t.md`
由后端线程维护，用于记录：
由后端线程维护，写给总控线程，用于记录：
- 后端已经具备什么能力
- 前端应如何接入
- 哪些地方不允许前端自行假设
- 哪些接口和字段已经定版
- 后端当前已完成什么
- 后端希望确认什么
- 下一步建议是什么
它不是前端反馈文档，也不是需求池。
### 2.3 `t2f.md`
由总控线程维护，写给前端线程，用于记录：
- 当前阶段前端应推进什么
- 当前推荐接线顺序是什么
- 哪些字段和页面优先接入
### 2.4 `f2t.md`
由前端线程维护，写给总控线程，用于记录：
- 前端当前已完成什么
- 前端在哪些地方受阻
- 需要总控或后端确认什么
---
## 2.3 当前固定模板
## 2.5 当前固定模板
为了避免两份协作文档再次变成长讨论稿，当前约定两边都采用统一结构：
@@ -105,8 +124,10 @@
- [readme-develop.md](D:/dev/cmr-mini/readme-develop.md)
- [文档索引.md](D:/dev/cmr-mini/doc/文档索引.md)
- [f2b.md](D:/dev/cmr-mini/f2b.md)
- [b2f.md](D:/dev/cmr-mini/b2f.md)
- [t2b.md](D:/dev/cmr-mini/t2b.md)
- [b2t.md](D:/dev/cmr-mini/b2t.md)
- [t2f.md](D:/dev/cmr-mini/t2f.md)
- [f2t.md](D:/dev/cmr-mini/f2t.md)
以及当前代码事实：
@@ -118,8 +139,8 @@
总控线程不应该：
- 抢写前端线程的 `f2b.md`
- 抢写后端线程的 `b2f.md`
- 抢写前端线程的 [f2t.md](D:/dev/cmr-mini/f2t.md)
- 抢写后端线程的 [b2t.md](D:/dev/cmr-mini/b2t.md)
- 把临时讨论直接当作正式契约
- 在两边尚未确认时擅自“替双方拍板”
@@ -133,7 +154,7 @@
总控线程需要持续做两件事：
- 读取并理解 [f2b.md](D:/dev/cmr-mini/f2b.md) 和 [b2f.md](D:/dev/cmr-mini/b2f.md) 的最新事实
- 读取并理解 [b2t.md](D:/dev/cmr-mini/b2t.md) 和 [f2t.md](D:/dev/cmr-mini/f2t.md) 的最新事实
- 把已经收敛的跨线程结论回写到 `doc/` 正式文档
也就是说，总控线程不是“第三份协作文档”，而是：
@@ -152,8 +173,9 @@
```text
前端/后端各自推进
-> 遇到跨边界事项时写入 f2b / b2f
-> 总控线程读取两份协作文档
-> 总控通过 t2b / t2f 下发阶段性要求
-> 前后端通过 b2t / f2t 回写事实与阻塞
-> 总控线程读取四份协作文档
-> 判断是否需要：
- 调整主线优先级
- 更新正式方案文档
@@ -163,7 +185,7 @@
也就是说：
- `f2b / b2f` 是协作事实层
- `t2b / b2t / t2f / f2t` 是协作事实层
- `doc/` 是正式知识层
- 代码是最终实现层
@@ -177,8 +199,10 @@
位于仓库根目录：
- [f2b.md](D:/dev/cmr-mini/f2b.md)
- [b2f.md](D:/dev/cmr-mini/b2f.md)
- [t2b.md](D:/dev/cmr-mini/t2b.md)
- [b2t.md](D:/dev/cmr-mini/b2t.md)
- [t2f.md](D:/dev/cmr-mini/t2f.md)
- [f2t.md](D:/dev/cmr-mini/f2t.md)
特点：
@@ -265,7 +289,7 @@
- 模拟器接入
- 交互和体验
并把需要后端确认的事项写入 [f2b.md](D:/dev/cmr-mini/f2b.md)。
并把当前事实、阻塞和待确认事项回写到 [f2t.md](D:/dev/cmr-mini/f2t.md)。
### 7.2 后端线程
@@ -276,7 +300,7 @@
- release / manifest / config 发布链
- workbench / dev tools
并把前端需要知道的契约写入 [b2f.md](D:/dev/cmr-mini/b2f.md)。
并把当前事实、完成项和待确认事项回写到 [b2t.md](D:/dev/cmr-mini/b2t.md)。
### 7.3 总控线程
@@ -294,7 +318,7 @@
当前项目的协作方式正式定为：
> 前后端线程分别维护自己的协作文档， 总控线程负责读取两份协作文档并维护全局主线、正式文档和阶段结论。
> 总控线程通过 [t2b.md](D:/dev/cmr-mini/t2b.md) / [t2f.md](D:/dev/cmr-mini/t2f.md) 下发阶段要求，前后端线程通过 [b2t.md](D:/dev/cmr-mini/b2t.md) / [f2t.md](D:/dev/cmr-mini/f2t.md) 回写事实，总控线程再维护全局主线、正式文档和阶段结论。
这样做的目标不是增加文书工作，而是：
@@ -308,9 +332,13 @@
截至当前阶段，这套方式已经进入实际执行状态：
- 前端线程维护 [f2b.md](D:/dev/cmr-mini/f2b.md)
- 后端线程维护 [b2f.md](D:/dev/cmr-mini/b2f.md)
- 两份文档都已经按统一结构整理
- 总控线程维护：
- [t2b.md](D:/dev/cmr-mini/t2b.md)
- [t2f.md](D:/dev/cmr-mini/t2f.md)
- 执行线程回写：
- [b2t.md](D:/dev/cmr-mini/b2t.md)
- [f2t.md](D:/dev/cmr-mini/f2t.md)
- 旧的 [f2b.md](D:/dev/cmr-mini/f2b.md) / [b2f.md](D:/dev/cmr-mini/b2f.md) 仅保留历史参考
- 总控线程负责维护 [文档索引.md](D:/dev/cmr-mini/doc/文档索引.md) 和 `doc/` 下的正式文档
后续如果线程数量增加，或者联调链变复杂，优先仍然是：