4R 系统建模框架

用 4R 梳理系统，为层级、角色、联系与规则分别绘制 Mermaid 图。

核心概念与定义

4R 是描述系统的本体论框架。在确定的观察层级，用角色、联系与规则构成系统结构与行为的显式规格。

维度	定义	图示参考
Rank，观察层级	模型的观察范围与粒度，决定哪些对象及细节属于当前层级。	层级与展开图
Role，角色	当前层级的组成部分，具有明确的职责与状态归属。	组成与职责图
Relation，联系	角色间的调用、依赖、信息传递或资源共享，包含方向与交换内容。	角色关系图
Rule，协作规则	角色协作的条件、顺序与约束，包括状态变化和异常处理。	时序、流程与状态图

Relation 描述静态联系，Rule 说明这些联系何时、按什么条件发挥作用。

业务、系统、应用、部署是观察视角，Rank 决定各视图的展开粒度。业务能力由系统或服务承担，应用视角描述内部模块与依赖，部署视角描述运行单元与基础设施的映射。

完整的 4R 架构说明分别为 Rank、Role、Relation、Rule 提供图示，一个 R 可以使用多张图。各图保持名称一致，并说明层级与对象映射。每个选定的观察视角都可以用 4R 分析。

所有图使用 Mermaid，视觉参数共用图示设计规范。图法、模板和检查项分别放在上表的参考文件中。

原则

• 角色与联系的含义取决于系统边界和观察层级。
• 同一对象在上层是角色，展开后可以成为包含其他角色的系统。
• 各视图描述同一系统，对象名称与对应关系保持一致。
• 关键场景检验结构与协作规则是否一致。

避免误用

• 观察视角不等于观察层级，四类架构视图不固定对应 L1 至 L4。
• Relation 不能替代 Rule，成功路径不能替代条件、约束和异常规则。
• 技术名称与目录结构不能代替职责边界，运行调用与代码依赖分别表述。
• 状态变化与异常处理有明确的负责角色。
• 区分现状、目标与推断，缺少依据的结构和规则保持待确认。