fusion-ai-studio案例深度拆解(二):金融期末结账洞察应用Ledger Insights的五面板设计逻辑
fusion-ai-studio案例深度拆解(二):金融期末结账洞察应用Ledger Insights的五面板设计逻辑
fusion-ai-studio 开源项目中的 Ledger Insights 是一个面向总账(General Ledger)期末结账的洞察应用:它用五个面板把期间状态、会计异常、过渡户余额、差异分析和控制合规汇聚到同一个工作区。这篇文章拆解这五个面板的设计逻辑——每个面板负责什么、数据如何串联、以及背后的复用套路。
🧭 应用全景:一个统一结账监控工作区
应用定义在 xx_fin_gl_ledger_insights_workspace.app,代码 XX_FIN_GL_LEDGER_INSIGHTS_WORKSPACE。官方描述是 "a unified workspace for monitoring General Ledger period close health",即帮助用户识别结账风险、下钻到底层余额与日记账,并支持切换账簿上下文。
几个决定"骨架"的配置项:
| 配置 | 位置 | 作用 |
|---|---|---|
pagePattern: swimlanesPattern |
L13 | 泳道式页面布局 |
layout: "2" + firstLane/secondLane |
L59-L68 | 左泳道 3 个面板、右泳道 2 个面板 |
summary.agentCode → XX_FIN_GL_LEDGER_CLOSURE_WORKFLOW |
L481-L483 | 顶部"结账摘要"由专门的汇总工作流生成 |
subtitleAgentCode → 会计异常工作流 |
L120 | 副标题显示"期间 + 距结账 N 天" |
appContextView / queryAgent → 账簿切换工作流 |
L485-L488 | 上下文区 + 自然语言查询入口 |
🗂️ 五面板:一个面板 = 一个工作流
五个 agentContainers(L15-L58)各自绑定一个工作流,工作流清单见 workflows/README.md:
| 面板 | 绑定工作流 | 数据底座 | 进摘要 | 动作 | 通信 |
|---|---|---|---|---|---|
| Accounting Exceptions | XX_FIN_GL_ACCOUNTING_EXCEPTIONS_WORKFLOW |
Accounting Exceptions Lookup BO | ✅ | ✅ | ✅ |
| Period Status | XX_FIN_GL_PERIOD_STATUS_WORKFLOW |
Period Status BO | ❌ | ✅ | ❌ |
| Controls & Compliance | XX_FIN_GL_CONTROLS_COMPLIANCE_WORKFLOW |
Insights List(控制类) | ✅ | ✅ | ❌ |
| Clearing Account Balances | XX_FIN_GL_CLEARING_ACCOUNT_WORKFLOW |
Insights List(对账类) | ❌ | ✅ | ❌ |
| Variance Analysis | XX_FIN_GL_VARIANCE_ANALYSIS_WORKFLOW |
Insights List(差异类) | ❌ | ✅ | ❌ |
这里的三列开关来自 L70-L118 的 includeInSummary / includeInActions / includeInCommunications。设计意图很清晰:只有会计异常和控制合规参与顶部摘要——因为它们直接回答"结账会被什么卡住";其余面板负责展示层,避免摘要信息互相打架。
1️⃣ Accounting Exceptions:最"能动手"的面板
这是五个面板里唯一支持邮件通信和 ESS 作业提交的。流程见 xx_fin_gl_accounting_exceptions_workflow.wf:
getAccountingExceptions按异常类别聚合(数量 + 金额),先展示 Top 5 类别(L715-L751);- 点击某行 →
drillDownToTransactions下钻到受影响交易,并按交易类别动态生成一组修正动作(提供备用科目、重建子账簿核算、导入/过账日记账、挂过渡科目、建汇率等,L394-L412); - 动作先走
validateFields二次确认,确认后通过submitEssJob真正提交 ESS 作业(L189-L226); - 附带
Send Email能力,把代表性异常打包成邮件草稿发给团队。
它还负责渲染副标题:用期间结束日减当天得出"N days to close"(L672-L695),把"时间压力"直接挂在页面顶部。
2️⃣ Period Status:最轻量的面板
只有展示职责:并行查询 GL 与应付/应收子账簿的期间状态(L168-L218),用徽章(badge)形式呈现 Open/Closed。它不进摘要、不做下钻——"期间是否还开着"是结账第一道闸,用户扫一眼即可。
3️⃣ 4️⃣ 5️⃣ 三个"洞察类"面板:同一套传感器,三套过滤器
控制合规、过渡户余额、差异分析这三个面板表面不同,底层完全同构:
- 数据都来自同一个传感器洞察库(
sensorCode=LedgerInsights,状态ORA_OPEN,按规则优先级排序); - 区别只在类别过滤器:
- 展示前都经过同一个 LLM 节点
FIND_TOP_INSIGHTS:把技术性规则名改写成业务语言,按业务影响(金额、百分比、严重度措辞)排序取 Top 5(L373-L398); - 生命周期动作完全一致:
markAsReviewed(带评论的审阅表单)和dismiss(驳回),都调用 Insight Review Actions 业务对象。
这是最值得学习的点:一个洞察平台 + 多个类别切片 = 多个面板。 新增第六、第七个面板,只需复制工作流换过滤器,不用动应用框架。
🔍 贯穿五个面板的三条主线
主线一:统一的"账簿 + 期间"上下文。 所有面板共享 XX_FIN_GL_LEDGER_INSIGHTS_CONTEXT_WORKFLOW(xx_fin_gl_ledger_insights_context_workflow.wf)。它按优先级确定默认账簿——用户偏好(ORA_GL_LA_CURRENT_LEDGER_ID,L537)> 权限范围内首个账簿——再拉取会计期间、元数据和标准值列表,组装成 appContext(L453-L471)。
主线二:自然语言切换账簿,全页联动刷新。 用户在搜索框输入 "Switch ledger to Vision Operations (USA)" 这类语句,账簿切换工作流会解析意图、匹配可用账簿、校验开放期间,然后更新应用上下文并触发整页刷新(xx_fin_gl_ledger_switch_workflow.wf#L209-L238)。匹配到多个时,返回可点选的账簿列表让用户二选一(L248-L271)。
主线三:五面板一次并行汇总。 顶部摘要不是"五个面板摘要的拼接",而是 XX_FIN_GL_LEDGER_CLOSURE_WORKFLOW 用一个 PARALLEL 节点并行调起五个面板工作流,再由 LLM 综合输出一条 CFO 视角的 2~3 条要点(xx_fin_gl_ledger_closure_workflow.wf#L130-L176)。
下钻机制也值得一提: 洞察记录里自带 base64 编码的 bossFilter,点击后先经 resolvePeriodExpression 把相对期间表达式解析成具体期间(L789-L814),再按数据类型分发到余额表或日记账明细表查询(extractAV / bossExtract),最后渲染成可"Mark as Reviewed / Dismiss"的动态表格。日记账行级下钻的查询载荷由独立的 Query Helper 工作流构建(xx_fin_gl_ledger_insights_query_helper.wf)。
✨ 复现这个模式的 4 个要点
- 页面 = 泳道容器 + 每格一个 agent 工作流,布局用
firstLane/secondLane显式排布; - 用
includeIn*三开关控制每个 agent 参与摘要/动作/通信的粒度,别让所有面板抢顶部摘要; - 同类面板共享数据底座、只换过滤器,生命周期动作(审阅/驳回)统一封装成业务对象函数;
- 上下文独立成工作流(解析、校验、切换、刷新),页面切换账簿时才能整页联动。
📁 关键文件索引
- 应用定义:xx_fin_gl_ledger_insights_workspace.app
- 工作流说明:workflows/README.md
- 业务对象说明(异常查询、洞察列表、洞察审阅动作、账簿查询、期间表达式解析等 11 个 BO):businessObjects/README.md
- 五个面板工作流 + 上下文/切换/汇总/查询辅助共 9 个
.wf文件:release-26C/aiapps/fin/ledger-insights/workflows/