Files
cft0808--edict/docs/dashboard-upgrade-plan.md
2026-07-13 13:32:32 +08:00

4.4 KiB
Raw Permalink Blame History

军机处看板(Dashboard)升级计划

任务IDJJC-20260303-001
日期:2026-03-03
状态:门下省已准奏,尚书省派发执行中


一、背景

Phase 1 核心架构已全部完成(十二部制、实时看板、任务全生命周期、E2E测试等)。基于用户反馈和 ROADMAP Phase 2/3 规划,制定本升级计划,分三批推进。

二、升级批次总览

批次 周期 内容 负责部门
第一批 2-3周 御批模式、移动端适配、Docker一键体验 工部、刑部
第二批 2-3周 功过簿、急递铺、ClawHub上架 工部、礼部、户部
第三批 后续 国史馆、看板适配器、年度大考 工部、户部

三、第一批(高优先级,2-3周)

3.1 御批模式(人工审批节点)

目标:门下省审议完成后,任务进入「待御批」状态,用户在看板一键准奏/封驳。

  • 新增 AwaitingImperial 任务中间态
  • 看板新增「待御批」面板(待批列表 + 历史批示)
  • APIPOST /api/tasks/{id}/imperial-reviewbody: { action: "approve" | "reject", comment?: string }
  • 飞书/Telegram 推送审批通知
  • 超时机制:配置 imperial_review_timeout_hours(默认24h),超时策略可选:自动准奏 / 再次提醒 / 阻塞等待
  • 执行:工部开发前后端,刑部编写测试
  • 详细设计:见 docs/design-imperial-review.md

3.2 移动端响应式适配

目标:手机/平板可正常使用看板。

  • Tailwind 响应式断点:sm:640px / md:768px / lg:1024px
  • EdictBoard 移动端改为纵向卡片列表(< md)
  • TaskModal 移动端全屏显示
  • 顶部导航栏 < md 折叠为汉堡菜单
  • 执行:工部前端
  • 详细设计:见 docs/design-mobile-responsive.md

3.3 Docker 一键体验

目标docker compose up 即可体验完整看板(含预置数据)。

  • 基于现有 docker/demo_data/ 构建
  • Dockerfile:前端 build + 后端 serve 单容器
  • docker-compose.yml:看板服务 + 可选 Gateway
  • 预置 demo 数据(已有 tasks_source.json, officials_stats.json 等)
  • CIGitHub Actions)自动构建推送镜像
  • 执行:工部 DevOps
  • 详细设计:见 docs/design-docker.md

四、第二批(中优先级,2-3周)

4.1 功过簿(Agent 绩效评分)

  • 每个 Agent 完成率、返工率、耗时统计
  • 排行榜 + 趋势图面板
  • 自动标记"能臣" / "需训练"
  • 执行:工部开发 + 户部数据统计 + 礼部文档

4.2 急递铺(消息流可视化)

  • 看板实时连线动画:中书→门下→尚书→六部
  • 消息类型着色(派发/审议/回奏/封驳)
  • 时间线回放模式
  • 执行:工部前端

4.3 ClawHub 上架

  • 核心 Skills 提交 OpenClaw 官方市场
  • 一键安装三省六部 Skill Pack
  • 执行:礼部

五、第三批(后续规划)

功能 简述 负责
国史馆 历史旨意沉淀、相似检索、引用溯源 工部+户部
看板适配器 Notion/Linear/GitHub Issues 同步 工部
年度大考 Agent 年度绩效报告 + 可视化大屏 户部

六、性能基线要求(门下省修订)

升级前后须对比验证以下指标:

指标 测量方式 目标
首屏加载时间 Lighthouse / Performance API < 2s (LCP)
API 响应时间 /api/tasks P95 < 200ms
Bundle 大小 vite build 输出 记录基线,升级后不超过 +15%
内存占用 Chrome DevTools 记录基线

执行:户部测量,升级前后各出一份报告。

七、执行分工汇总

部门 第一批 第二批 第三批
工部 御批模式前后端、响应式适配、Docker 功过簿、急递铺 国史馆、看板适配器
刑部 御批模式测试、E2E补充
礼部 文档整理、ClawHub
户部 性能基线测量 功过簿数据统计 年度大考

八、里程碑

时间 里程碑
W1 性能基线测量完成;御批模式 API + 前端开发;Docker 镜像初版
W2 御批模式联调测试;移动端适配完成;Docker compose 可用
W3 第一批全部上线;刑部 E2E 测试通过;性能对比报告
W4-6 第二批开发 + 上线
W7+ 第三批按需推进