看板分组配置说明 (v0.6)

版本: v0.6 · 2026-06-16 · 新增 用途: 在飞书 Bitable UI 配 "5角色×4阶段 看板" 分组规则 配合: T3 §1+§2 飞书 RGDK 增强 (view_id vewg17WNOq)

0. 前置

• 飞书账号: 王春晓 (chunx, open_id 在 .env)
• 飞书 Bitable: v06_生产进度 (table_id tblMdbD3IgZpRQEh, app_token RGDKbrtZ1aMcEOsZ2GcczeFknNg)
• 已建视图: "5角色×4阶段 看板" (view_id vewg17WNOq, view_type kanban)
• 已加字段: 角色 (5 选) / 阶段 (4 选)
• 预计耗时: 5 min

1. 进入看板视图

1. 打开飞书 → 找到 v06_生产进度 表
2. 左下角"视图"下拉 → 选 "5角色×4阶段 看板"
3. 当前应是空白看板 (因为未配分组)

2. 配置分组规则

1. 右上角 ⋯ (三点菜单) → "配置看板" (或"看板设置")
2. 主分组 (Group by): 选 "角色" 字段
3. 自动出 5 列: 出题人 / 教案人 / 评测人 / 审核员 / PM
4. 子分组 (Sub-group by): 选 "阶段" 字段
5. 每列内再分 4 行: 启动 / 执行 / 审核 / 交付
6. 每列卡片数: 拉满 50 张 (默认就行)

3. 配置卡片字段 (可选)

1. 卡片显示字段: 选 Task ID + 脚本名 + 退出码
2. 隐藏字段: 多行文本 / 跑通日期 (避免卡片太长)
3. 卡片高度: 紧凑

4. 保存 + 验证

1. 右上角 "保存" (或自动保存)
2. 验证:
   • 看板应显示 5 大列 (角色)
   • 每列内 4 子行 (阶段)
   • 现有数据 (如果 v06_生产进度 已有行) 应自动按角色+阶段归位
   • 拖拽: 把一行的"启动"拖到"执行" → 自动改 阶段 字段值
3. 截图存档到 docs/_internal/screenshots/kanban_2026-06-16.png

5. 权限分享

1. 看板视图默认仅你可见
2. 分享给 PM 团队: 右上角"分享" → 加 chunx-config.yaml 里的 team_open_ids
3. 权限: 可编辑 (能拖卡改状态)

6. 故障排查

问题	原因	解决
没看到"配置看板"	view_type 不是 kanban	重设视图类型为 kanban
拖卡不生效	字段权限 read-only	飞书表 → 字段 → 阶段 → 改"所有成员可编辑"
子分组不显示	飞书 Bitable 版本 < 7.x	升级飞书 app 到最新版
列太窄	浏览器 zoom	Ctrl+= 放大 / 拖列宽

7. 后续

• v0.7: 加"按角色"自动计算工时总和 (飞书 BI)
• v0.8: 拖卡触发 webhook 通知 PM
• v0.9: 加 5P0 红线标记 (卡角红点)

8. 关联

• view_id vewg17WNOq (T3 已建)
• table_id tblMdbD3IgZpRQEh (v06_生产进度)
• 字段 角色/阶段 已加 (T3 §1+§2)
• 配错回滚: 视图右上角 ⋯ → 删除视图 → 重建