系统架构总装图 · 结算审核AI工具箱

六图汇合点:每个框 = 已完成分析的落位 | 目录树点击文件查看对应函数族/状态/依据 | 状态:绿=契约已定稿可开工 · 橙=待定稿(含外部依赖)

UI 层 引擎层-确定性 引擎层-LLM系 存储层-案件目录 质量设施

① 架构总装图 —— 每个框都站着已完成的分析

点击各框显示:包含文件 · 对应函数族 · 数据依据(哪张图/哪份文档) | 依赖方向自上而下

UI 层 依据:07§4.2 双调用 · 交互设计(问答台) Streamlit 工作台 对齐确认·差异报告·问答台 问答 Agent(只读) v0.2 · tool_registry pipeline.py 显式编排 12号图六阶段写死 事件提交 ↓ · 状态/证据 ↑ 引擎层(纯 Python · 无界面依赖 · 可命令行独立跑) ingest / excel_io dtype=str·Decimal·sha256 G1列名映射·14图E1 F1 align/compare 四级置信·组ID·依据 契约已定稿·E5/E6/E7 F2 recalc 04图①~⑦→yaml规则 E11/E18 · 挂起S1~S7 F6 group_summary G6映射表·G7词典 E9/E10 独立函数×5 gen_report·lookup_price·calc_fee… G11模板·G16映射 F3 llm_extract 要点卡·材料归一(G6) E3/E7/E13/E20 F4 llm_classify 四类归因·G5快照强制 E8/E16 F5 crosscheck F3+F1组合链 E13/E14 F7 retrieve 案内+知识库·G9组 E15 F8 OCR / F9 印章 / F10 转写 G12低置信转人工·不鉴真伪 E4 · P1阶段解锁 workflow 状态机 确认队列·S1~S7·事件溯源 decisions.jsonl · 12号裁决带 validator(不可跳过) 引用回验·数值正则复核 F3/F4/F7 输出的闸 llm_gateway 温度0·缓存·token日志 NFR-2 可复现 manifest 产物登记 G14命名规范·代码/规则/prompt哈希 E17/E18 · 可复现的实现载体 全部读写收口在函数族契约后 ↓ 存储层(案件目录 = 证据流本身 · 无数据库服务) cases/<案件ID>/ input/(只读+sha256)· artifacts/ decisions.jsonl(=日志型数据库) vectors/(案内检索) Chroma 嵌入式文件夹 随案件存亡 · F7 模式A knowledge/(跨案知识库) 标准清单·指标·脱敏案例 历史合同原文默认不入 G11 人工模板×N 分包造价/信息价/台账… 24项条件可达的钥匙 质量设施(三硬需求的工程兑现) tests/golden 金标准评测 模拟数据10类缺陷注入 prompts/ 版本化 semver · 版本入缓存key rules/*.yaml(带source) 口径登记 · ASSUMED脚注 scripts/replay.py 任意历史状态回放

② 代码目录树 —— 每个文件 = 哪个函数族 = 什么状态

点击文件名查看详情(对应函数族/输入输出契约锚点/开发序) | 开发序来自 14 号图拓扑排序

settlement-audit/
├─ app/
│ └─streamlit_app.py ← UI薄壳:渲染+事件提交,零业务逻辑W6
├─ engine/
│ ├─manifest.py ← 产物登记·版本指纹(14图E17)步骤0·最先
│ ├─ingest.py + excel_io ← 标准化+sha256(E1/E2)步骤1
│ ├─align.py + compare ← F1 对齐比对·契约已定稿(E5/E6/E7)契约✓步骤2-3
│ ├─workflow.py ← 确认状态机·事件溯源(E5/E6闸门)步骤2
│ ├─llm_extract.py ← F3 抽取+材料归一(E3/E7/E13/E20)步骤4
│ ├─llm_classify.py ← F4 归类(E8/E16)步骤6
│ ├─recalc.py ← F2 重算·04图①~⑦→yaml(E11/E18)步骤5
│ ├─group_summary.py ← F6 汇总(E9/E10)步骤6
│ ├─crosscheck.py ← F5 交叉核对(E13/E14)步骤7
│ ├─retrieve.py ← F7 向量检索(E15)步骤7
│ ├─ocr/stamp/transcribe ← F8/F9/F10(P1解锁)步骤7+
│ ├─validator.py ← LLM输出回验·不可跳过步骤4
│ ├─llm_gateway.py ← 温度0·缓存·日志步骤4
│ └─report.py + gen_* ← 独立函数×5(G16映射)步骤7
├─ prompts/v1/ ← 版本化 prompt(缓存key含版本)
├─ rules/
│ ├─thresholds.yaml ← 口径登记·source字段·ASSUMED脚注步骤1起
│ └─列名映射×资料类型.yaml ← G1 缺口落地
├─ cases/ ← 运行时数据(不入git)· 存储层详图见上
├─ tests/
│ ├─golden/answers.csv ← 金标准(71项需求的正确答案)D1
│ └─test_report_schema.py ← 报告列结构断言
├─ scripts/ ← make_sim_data(已有) · replay.py
└─pipeline.py ← 显式编排·12号图六阶段写死W4

③ 本图与六张姊妹图的关系(每个架构框的依据链)

架构部件依据文档依据内容
函数族划分(10+5)07 归类 · 10 映射图73 项需求按技术动作归类,零悬空核对
模块间 20 条数据边13 接力契约 · 14 拓扑8 大场景逐场走链,30 交接物去重
pipeline 六阶段12 Workflow业务制度时序 · 28 节点 · 2 道裁决带
F2 的 yaml 规则体系04 条件逻辑7 组嵌套决策树 → 每菱形=一个yaml字段
workflow 状态机05 需求产出物三硬需求(不静默/可追溯/可复现)
需求明细与路径标记09 清单71 项逐行 · 输入/输出/动作

架构依据链闭环:任何框被质疑,沿③表回溯到具体场景和需求行。本图冻结后进入开发:按②目录树的步骤序(manifest → ingest → F1…)写代码,每个文件开工前其接口文档(沿14图边)必须已定稿。