第四部分 — 建造工厂：架构与案例

目录即前门

开源临床世界中最被低估的产品决策，不是一个包，而是一份目录： 一个公开的、可浏览的合集，收录每一份标准表格、清单与图形，每一 项都以渲染好的示例连同产出它的代码一并展示，可在合成数据上运行。 背后的团队对这份目录的投入，与对包本身的投入同样认真——而生态 的采纳曲线也随之向上弯折。

这个教益可以推广。对一个信任产品而言，目录不是文档的装饰。它是 前门、销售引擎和质量仪器，三者合一。

目录承担的三份工作

它是永不打烊的演示。 另一个时区的潜在客户可以在他们当地的 凌晨两点，浏览你的系统产出的精确输出——不是截图，不是承诺，而 是渲染好的工件，清单历历在目：用了哪份规格、哪份数据、哪个比较 判定。对一个以"每个数字都携带证据"为卖点的产品，没有比一座携 带着证据的数字库更有说服力的工件了。演示需要一名销售；目录只需 要一个 URL。

它是诚实的边界。 目录在存在的东西与不存在的东西之间划出一 条物理的线。目录中没有的能力，官方即未声明；目录中存在的能力， 是由真实系统在访客可以检视的数据上渲染出来的。营销跑不过这样一 份目录——而这，按原则六，正是意义所在。团队会发现，目录悄悄地 也成了内部的真相之源：工程师在声称某个功能可用之前会先查它，因 为其他人都会查。

它是回归仪器。 那套在合成数据上渲染目录的机器，可以在每次 发布时重新渲染，并与锁定的参照比较。目录变成一份活着的 OQ：引 擎行为的任何变化，都会在客户看到之前，以可视化加单元格级差异的 形式，横跨整个产品表面显现出来。很少有团队把自己的公开画廊当作 质量门；做到的那些，交付时带着一种不寻常的从容。

好的目录条目携带什么

一致性比数量更重要。每个条目都应展示同样的解剖结构，因为目录教 授的是产品的心智模型，而不仅仅是它的库存：

• 渲染好的输出本身——表格、清单或图形，与交付时一模一样。
• 它所依据的规格，以可读的形式呈现。
• 它运行时所用的合成数据集，来源清晰可见。
• 比较判定结论——独立核验了什么，以及如何核验。
• 一条命令的可复现方式——在本地重新生成该条目的确切调用。

最后一项把读者变成用户：从"看着一个示例"到"在我自己的机器上 运行这个示例"的距离，应当是一次复制粘贴。生态以这段距离的速度 生长。

合成数据基座

这一切都无法用真实的研究数据来实现——治理禁止，而且禁得对。 目录立于对自身合成属性坦诚的合成数据之上：在结构上忠于标 准(域、变量、受控术语)，丰富到足以走遍每一条代码路径，并在每 一个工件中清晰标注。构建和维护这样一份数据集不是开销。它是前门 的燃料、演示的燃料、公共 CI 的燃料和练兵场的燃料——一笔投入， 四份回报。

检验。 把你产品的 URL 发给一个陌生人，然后离开房间。没 有你，他们能核验什么？ 如果答案是"营销说辞"，那这扇前门是 一本宣传册。如果他们能浏览渲染好的输出、检视规格与判定结论， 并在五分钟内于本地重跑其中一条，那这扇前门就是产品本身。