weichenandCursor
14f75df1ac
Progress tracking now lives in a separate project. Drop the server, docs, and module-boundary entries without restoring engineering-dashboard. Co-authored-by: Cursor <cursoragent@cursor.com>
2.5 KiB
2.5 KiB
title, status, created, updated, owner, branch, worktree, mutex
| title | status | created | updated | owner | branch | worktree | mutex |
|---|---|---|---|---|---|---|---|
| 个人工程中控台：实时项目看板与离线 HTML 快照 | done | 2026-09-17 | 2026-09-17 | Cursor-Auto | feature/engineering-dashboard | .worktrees/feature-engineering-dashboard | engineering-dashboard |
个人工程中控台：实时项目看板与离线 HTML 快照
目标
实现一个独立于产品后台的本地只读中控台，以同一不可变快照驱动实时页面、机器可读 JSON 与单文件 HTML 导出。
范围
- 聚合
.doc、Git/worktree、Docker/Compose、/ready和晋升凭证。 - 展示架构、模块、功能、任务、分支、验证和环境实装证据。
- 提供 Markdown 搜索、阅读、正反向链接和证据链导航。
- 显示来源、新鲜度、degraded 与 drift，不把声明状态当作观测状态。
非目标
- 不接入产品后台、产品数据库或产品权限体系。
- 不写文档，不操作 Git、Docker、部署或 Herdr。
- 不隐式联网或执行
git fetch。
步骤
- U1：冻结快照、事实与四轴状态契约。
- U2：实现文档图谱与领域解析器。
- U3：实现 Git 与 worktree 采集。
- U4：实现运行态与部署证据采集。
- U5：实现对账、派生视图与新鲜度。
- U6：实现本地服务、总览与文档导航。
- U7：实现离线导出、脚本、浏览器验收和治理文档同步。
验收标准
- 实时 HTML、离线 HTML 和 JSON 引用同一
generation_id与revision_id。 - 计划、实施、验证、实装四轴独立展示。
- rdev、dev ahead、main events 分叉三个真实样本按方案输出。
- 单源失败时页面仍可用，且显示 stale/error/last-success。
- 默认仅监听 loopback，无写操作、凭证暴露、路径越界和远程资源执行。
- 导出 HTML 离开仓库后仍可阅读 Markdown，且不嵌入 assets。
相关链接
- 设计与实施方案：../../archive/design/2026-09-17-personal-engineering-control-center-plan.md
- Test report: ../../test-reports/2026-09-17-engineering-dashboard-test-report.md
证据 / 备注
- 实现提交序列见
feature/engineering-dashboard（U1→U7）。 - 启动：
./scripts/engineering-dashboard.sh serve --repo . --addr 127.0.0.1:8787 - 导出：
./scripts/engineering-dashboard.sh export --repo . --output /tmp/engdash.html