Codebase Architecture Atlas

代码库 → 本体(实体 / 关系 / 数据流 / 设计原则)→ 可下钻的交互式架构网页。

交付物

designs/<slug>-architecture-atlas/:

• 多文件工程:<Name> Atlas.html + data.js(本体数据)+ app.js(渲染引擎)
• 单文件离线版 HTML:可双击打开、可直接分发
• 四层纵深:L1 全景总览 → L2 模块级拓扑 → L3 模块内部 ×N → L4 数据流时序图;附设计原则页
• 交互:单击组件看详情抽屉(职责/关系/关键文件/部署/备注)、双击下钻、⌘K 全局搜索、平移缩放、URL hash 定位、顶栏主题切换(浅色/深色/纸面/暖黄)

三个关键认知

1. 渲染引擎已就绪,不要重写前端。assets/template/ 的引擎读取全局 ATLAS 对象,你的全部创作是 data.js(本体)+ 视图坐标。引擎只绑定「形态原语」(黑底/虚线框/等宽字体等 11 种 form 与 4 种线型),不绑定任何具体种类。
2. 本体靠勘探,不靠想象——包括词表本身。每个实体/关系必须有代码证据(文件路径、类名、协议名);不确定的写进实体 notes,禁止虚构。kinds/relKinds 词表同样要从勘探报告推导:不是每个 codebase 都有守护进程或用户进程,图例按实际用到的种类自动生成。坑与债是最有信息量的本体,如实建模。
3. 布局是设计,不是算法。手工排布坐标;流水线只走一个方向(左→右或上→下);出现长对角线 = 重排信号。