SOA Senior — 模式编辑器

账户是一个图表。
您是其设计师。

作为SOA Senior,您设计再保险技术账户模板(模式)。每个模式定义账户的结构:会计行、连接类型,以及引用经理产生的量化输出的FORMULA节点。

📐 DAG模式编辑器
🏷 SOA连接类型
🔗 FORMULA布线
🧩 文档维度

您在链条中的角色

六个角色——一个方向。SOA模块位于链条末端,将精算工作转化为财务账户。

Junior
条款创建
将文本结构化为有类型的条款
Senior
审批
批准条款、维度、条约类型
Actuary
DAG形式化
将条款编码为计算图表
Manager
实例化
在合同上实例化图表,输入值
SOA Senior — 您
模式设计
设计账户DAG,将FORMULA节点与经理输出布线
SOA Junior
账户生成
在合同上实例化您的模式
💡
您不输入财务值。您构建展示结构。SOA Junior填写对经理数据的引用。实际数字来自经理的图表实例。

模式侧边栏

左侧边栏列出您所有的SOA模式。每个模式是账户报表的可复用模板。

使用搜索框按名称或标识符筛选模式。点击+ New pattern创建——为其指定描述性标签(例如XL Treaty Statement v1Quota Share — Annual)。

模式名称旁的徽章表示检测到循环——在循环修复之前该模式无法被Junior实例化。小型实例计数器(例如)显示引用该模式的活跃SOA实例数量。

🔒
已实例化的模式被冻结。一旦Junior从您的模式创建实例,您就无法更改模式的节点/连接结构。创建新版本(新标签)以更改未来实例的结构。

构建SOA模式

模式是会计行项目的有向无环图。每个节点代表报表中的一行。连接编码层次结构(明细→小计→合计)。

1
选择模式
点击侧边栏中的模式将其加载到画布。如果画布为空,模式尚无节点。
2
添加节点
点击工具栏中的+ Node(或双击画布)。填写标签、会计连接类型和值类型。点击Add node
3
连接节点
将鼠标悬停在节点上直到下边缘出现输出端口,然后拖动到目标节点。出现连接类型提示(DETAIL、SUBTOTAL等)。
4
附加维度(可选)
选择节点→在检查器中打开Dimensions选项卡→添加SOA Junior应为此行项目记录的维度。
5
保存
点击💾 Save。整个模式以原子方式写入。循环检测在每次保存时运行。
⚠️
未保存的更改仅存在于浏览器中。不保存就导航或刷新会丢失工作。标题始终显示●未保存/✓已保存

键盘快捷键

操作
Ctrl/Cmd + S保存当前模式
Del / Backspace删除选中的节点或连接
滚轮放大/缩小
画布拖动移动视图
画布双击在光标处添加节点

SOA连接类型

SOA模式中的每个节点和连接都具有连接类型——其在账户中的会计角色。这取代了精算师使用的计算操作数。

HEADER
章节标题或主标题——无值,纯结构性。
DETAIL
单行项目。为SUBTOTAL或TOTAL提供数据。
SUBTOTAL
章节内DETAIL行的中间合计。
TOTAL
最终余额——账户或主要章节的最后一行。
OFFSET
抵消项——减少或调整相邻行(例如存款抵消)。
NOTE
信息注释——在账户中可见但不是计算的一部分。

您可以从侧边栏的🏷 SOA Link Types扩展列表。新代码在节点编辑器中立即可用。如果节点或连接仍在使用某代码,则删除会被阻止。

💡
节点颜色=连接类型。画布以连接类型的颜色渲染每个节点——HEADER海军蓝、DETAIL蓝色、SUBTOTAL绿色、TOTAL深绿、OFFSET橙色、NOTE灰色。账户结构一目了然。

检查器面板

点击节点在右侧打开检查器——所选节点有两个选项卡。

选项卡在此执行的操作
Properties编辑节点的标签、连接类型和值类型。点击Apply更新内存状态——点击工具栏Save以持久化。
Dimensions添加或删除文档维度附件。每个附加的维度成为SOA Junior必须为此行项目完成的填写表单。

点击连接会打开带有连接类型选择器的检查器——更改类型并点击Apply

点击模式背景(未选中节点)显示模式检查器:关联条款、条约类型限制、实例数量和快速操作按钮(重命名、编辑条款、编辑条约类型、删除)。

FORMULA节点——通往经理数据的桥梁

FORMULA节点是特殊的账户行项目,其值不由SOA Junior直接输入——Junior引用经理图表实例中的特定节点。

🔗 对账信号
FORMULA布线是精算领域与会计现实之间的对账行为。如果账户中的某行找不到经理图表中的目标节点,工具就会揭示不一致——精算师建模的内容与账户要求的内容不同步。RI-TOOL使这种差距可见。

如何创建FORMULA节点

1
添加节点
点击+ Node。设置标签(例如净自留损失),选择合适的连接类型(通常为DETAIL),将值类型设置为FORMULA
2
保存
保存模式。FORMULA维度自动附加——无需手动步骤。节点在画布上以虚线边框和🔗图标显示。
💡
每个经理数量一个FORMULA节点。如果账户有两个独立的复原保险费,创建两个FORMULA节点——每个由Junior独立引用。

SOA Junior如何使用FORMULA节点

当Junior打开FORMULA节点时,出现三组选择器:同一合同、同一条约类型、同一条款。Junior选择相关经理图表和其输出为该账户行提供数据的特定节点。引用存储为JSON引用——不复制任何值,只有指针。

📊
每个新账户均附带两个现成模板
PC Standard和PC Sliding Scale — 21个节点,14个FORMULA链接与Profit Commission精算师图连接。第一天即可实例化。

IF / THEN / ELSE 链接操作数

当SOA模式节点连接到类型为CONDITION的Actuary图节点时,三个专用链接操作数明确构建条件关系。

在补丁035之前,CONDITION节点对所有父节点使用通用ARGUMENT操作数,使图形意图模糊。以下三个专用操作数替换CONDITION链接上的ARGUMENT,使谓词逻辑在画布上立即可读。

IF
被评估的谓词。每个CONDITION节点恰好有一个IF父节点。以紫色显示。
THEN
谓词为真时返回的值。以绿色显示。
ELSE
谓词为假时返回的值。可以是CONSTANT(0)作为零底线。以红色显示。

这些操作数何时与SOA Senior相关?

作为SOA Senior,您不构建Actuary图,但您将FORMULA节点连接到其Manager对应项,这些对应项本身引用Actuary图的输出。了解CONDITION节点产生什么有助于您在statement中准确标记相应的FORMULA行项目。

典型示例:Profit Commission Payable after Loss Corridor FORMULA节点应引用Actuary图中CONDITION节点的输出。该CONDITION评估loss corridor阈值 — IF父节点是测试,THEN父节点是corridor满足时的佣金,ELSE父节点是零。您的FORMULA行捕获该分支的结果。

💡
一个CONDITION = 一个二元结果。 如果账户需要"corridor以上"和"corridor以下"场景的两个独立行,请将它们建模为两个独立的FORMULA节点 — 每个引用Actuary图的不同分支,而不是CONDITION节点本身。

THRESHOLD节点

THRESHOLD节点(橙色,在补丁035中引入)是表示单个边界(底线、上限、附着点或触发器)的叶节点。它始终是CONDITION或LOOKUP节点的父节点。THRESHOLD节点不直接作为SOA模式中的FORMULA目标出现:它们是Actuary图中的中间输入,不是输出量。不要创建引用THRESHOLD节点的FORMULA行。

维度

维度是附加到模式节点的可选填写表单——文档轴。SOA Senior可以将租户目录中的任何维度附加到任何节点。

维度目录归高级承保人所有,在所有配置文件间共享。租户创建时提供专用SOA维度类别,包含三个基本轴:周期性份额交易对手——账户行最常见的文档上下文。

💡
FORMULA节点在Dimensions选项卡中有专用消息。当节点设置为FORMULA时,检查器中的Dimensions选项卡显示说明通知而非维度列表——FORMULA维度自动管理,无法手动添加或删除。
基本维度SOA节点上的典型用途
PERIODICITY季度/年度/调整/补充——该行的会计周期
SHARE100%/再保险人份额/分出人份额——适用比例
COUNTERPART再保险人/经纪人——付款或收款方
💡
维度是可选的,但功能强大。TOTAL节点几乎不需要文档;为保险费行提供数据的DETAIL节点几乎总能从PERIODICITY和SHARE中受益。请运用判断——精心选择的少量维度优于表单过载。

模式限制

两个可选限制有助于SOA Junior为每份合同找到正确的模式。

关联条款

模式可以锚定到一个或多个已批准的条款(例如XL复原条款)。这是信息性的——表明该模式是为哪个条款系列设计的。在实例化时不强制执行限制。

管理:点击工具栏中的🔗 Clauses,或使用模式检查器中的Edit linked clauses按钮。

条约类型限制

如果将模式限制为一种或多种条约类型(例如TREATY_XL),Junior的实例创建界面会显示兼容性徽章:✓ Compatible⚠ Mismatch。不匹配是警告,不是阻止。

取消选中所有条约类型可使模式变为通用——适用于任何合同。

管理:点击工具栏中的📋 Treaty types,或使用模式检查器。

循环检测

DAG必须是无环的——任何行项目都不能是自己的祖先。RI-TOOL在每次保存时自动检测循环。

如果发现循环,编辑器顶部出现橙色横幅,侧边栏中的模式行显示♻ cycle徽章。模式仍然保存,但被标记为不可实例化。

⚠️
检测不会阻止保存。找到返回到自身某个祖先的节点,删除有问题的连接,然后重新保存。循环标志自动清除。

模式浏览器

所有模式的生产视图——可按实例状态和循环标志筛选。

点击侧边栏中的🔭 Pattern Explorer打开全屏视图。每张卡片显示模式标识符、标签、节点数量、维度覆盖率百分比和实例数量。点击卡片直接跳转到编辑器中的该模式。

维度覆盖率

覆盖率是至少附加一个维度的节点百分比。🧩 80%表示80%的节点有文档要求。0%覆盖率的模式是有效的,但不会为Junior生成填写表单。

Data Checks

对租户数据的实时SQL查询——通过侧边栏的📊 Data Checks访问。

视图显示内容
SOA Templates — overview所有模式,包含节点数量、FORMULA节点、实例数量、条约类型和关联条款
FORMULA nodes — missing dimension未附加FORMULA维度的FORMULA节点——需要修复的配置异常
Dimension coverage by node所有节点及其附加维度和指示数量——有助于覆盖率审计

每个视图都有▶ Run按钮。结果内联显示,带有用于完整导出的⬇ Download CSV链接。

维护

从侧边栏访问的四项清理检查。始终在执行前进行诊断 — 执行不可逆。

代码清理内容风险
S1没有节点的模式 — 创建中止留下的空壳
S2检测到循环的模式 — 仅诊断,不删除。在编辑器中手动修复。
S3父模式在正常流程外被删除的孤立节点
S4节点或维度被删除的孤立维度附件

推荐顺序:S1 → S3 → S4。S2是只读诊断 — 它突出显示需要手动修复的循环,不删除任何内容。