fusion-ai-studio案例深度拆解(二):金融期末结账洞察应用Ledger Insights的五面板设计逻辑

原创2026-10-31 14:16:02717 阅读

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:

  1. getAccountingExceptions 按异常类别聚合(数量 + 金额),先展示 Top 5 类别(L715-L751);
  2. 点击某行 → drillDownToTransactions 下钻到受影响交易,并按交易类别动态生成一组修正动作(提供备用科目、重建子账簿核算、导入/过账日记账、挂过渡科目、建汇率等,L394-L412);
  3. 动作先走 validateFields 二次确认,确认后通过 submitEssJob 真正提交 ESS 作业(L189-L226);
  4. 附带 Send Email 能力,把代表性异常打包成邮件草稿发给团队。

它还负责渲染副标题:用期间结束日减当天得出"N days to close"(L672-L695),把"时间压力"直接挂在页面顶部。

2️⃣ Period Status:最轻量的面板

只有展示职责:并行查询 GL 与应付/应收子账簿的期间状态(L168-L218),用徽章(badge)形式呈现 Open/Closed。它不进摘要、不做下钻——"期间是否还开着"是结账第一道闸,用户扫一眼即可。

3️⃣ 4️⃣ 5️⃣ 三个"洞察类"面板:同一套传感器,三套过滤器

控制合规、过渡户余额、差异分析这三个面板表面不同,底层完全同构:

  • 数据都来自同一个传感器洞察库(sensorCode=LedgerInsights,状态 ORA_OPEN,按规则优先级排序);
  • 区别只在类别过滤器:
    • 控制合规:ORA_ACCOUNTING_CONTROLS + ORA_PERIOD_END_CONTROLS(L244-L260)
    • 过渡户余额:ORA_RECONCILIATION + ORA_CLEARING_AND_ACCRUAL(L220-L239)
    • 差异分析:ORA_VARIANCE(L220-L239)
  • 展示前都经过同一个 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 个要点

  1. 页面 = 泳道容器 + 每格一个 agent 工作流,布局用 firstLane/secondLane 显式排布;
  2. 用 includeIn* 三开关控制每个 agent 参与摘要/动作/通信的粒度,别让所有面板抢顶部摘要;
  3. 同类面板共享数据底座、只换过滤器,生命周期动作(审阅/驳回)统一封装成业务对象函数;
  4. 上下文独立成工作流(解析、校验、切换、刷新),页面切换账簿时才能整页联动。

📁 关键文件索引

登录后查看全文
fusion-ai-studio