本项目
? 上面每一格 tab 是一个需求目标;这一块画的是当前那格的目标。跟着 tab 走的还有:协作架构、需求台账、会话明细 —— 因为它们都按"任务类别"归属到某个目标。
上面那一排「前置 / 队列通知 / 最近上报」是整个工作区的,⛔ 不随 tab 变。
怎么多一格:在收件箱的
goals/ 目录里放一份与 goal.json 同字段的
<目标id>.json,刷新即多一格。只有一格时,就是本工作区只登记了一个目标。看板只读:后台隔一会儿生成一份快照,页面直接读缓存(间隔见「协作架构」那块的问题说明)。
协作架构用户 · 会话 · 协作会话 · 程序 · WorkBuddy
? 主会话左边那格是唤醒会话(名字由使用方给)—— 画成圆角矩形 + 外圈虚线, 它本身就是一条会话,而且是独立会话(自己一条,⛔ 不在主会话上处理), 随需求确定时才创建;位置贴在主会话左边,⛔ 不进下方那一排。它框色/徽章=实时状态:绿 ● 在跑 · 黄 ‖ 停着 · 灰 ○ 还没建。
图上每条线旁边都写了它是什么(① 派活 · ②③ 上报 · ④ 收结果 · 队列),看线就行。
🔴 ① 派活的特别之处:它是主会话建一条自动化排期、宿主到点开新会话 —— 这是唯一能开新会话的通道(钩子开不了会话)⇒ 所以"叫醒"只能喊、⛔ 不能自己开棒。
主会话框里写着它负责哪几个任务类别;主会话下方那一排是协作会话 —— 一格一条,横着排、有几条画几条,一条都没有时画个空框写明「暂无协作会话」。
任务类别是同一个工作区里用会话名称前缀区分的(每个类别各有自己的主会话)。
状态都是实读的,会话读 WorkBuddy 的库,程序读它自己留下的时间记录。哪一格停着不动,看框的颜色就知道。
看板只读。后台每 — 秒生成一份快照,页面直接读缓存。
有会话在跑
有件没人在跑
空闲 / 件已全完
已停
WorkBuddy
前置
? 看什么、叫什么名字,由**使用方**的看板扩展(`board_ext.py`)决定。组件名一律写成「系统 · 模块 · 功能名」,不用自造简称。
状态只做探测:读组件自己留下的时间记录和日志,不发请求、不改任何东西。