企业架构文档的标准化准则

以前团队小，架构师画图随口讲两句就通了。人一多，这套就散架。

PayBridge 从 20 人长到 200 人，跨三个大洲。图没人当面解释，红色一会儿表示“已完成”，一会儿表示“高风险”。箭头含义也各画各的。一张图硬塞部署、数据流、安全边界，最后字小到看不清，谁看了都猜。

所以架构图不能靠审美，得定一套企业通用语言。

箭头、颜色、粗细都得统一。 实心三角是同步调用，空心是异步消息。红色只标风险，绿色标正常。关键信息别只靠颜色传，还得加形状或文字——色盲同事也得看得懂。

一张图只讲一件事。 太挤就拆成多张。每张必须带图例、版本号、创建日期和适用范围。不然过几个月翻出来，没人知道这图当时在什么前提下画的。

视图也分四种：分层看结构，交互看关系，部署看环境，序列看一步步怎么流转。

标准落地前先收旧图找歧义，再让治理委员会批准，嵌进评审流程。以后新人看图不用找人翻译，评审时间也能全砸在设计本身上。

说白了，好标准不是管住画图的人，是让大家少猜。