feat: 新增风险图谱算法与系统仪表盘及操作反馈体系
后端新增风险图谱算法模块、风险观察与反馈服务、规则 DSL 校验器和可解释性引擎，完善系统仪表盘和财务仪表盘统计， 优化 agent 运行和编排执行链路，清理旧开发文档，前端新增 系统趋势、负载热力图等多种仪表盘图表组件，完善操作反馈 对话框和工作台日期选择器，优化报销创建和审批详情交互， 补充单元测试覆盖。
This commit is contained in:
caoxiaozhu
@@ -0,0 +1,112 @@
|
||||
# 风险图谱数据来源与壁垒资产清单
|
||||
|
||||
更新日期：2026-05-30
|
||||
|
||||
## 风险相关数据来源
|
||||
|
||||
1. 报销单主表：`ExpenseClaim`
|
||||
- 关键字段：`id`、`claim_no`、`employee_id`、`employee_name`、`department_id`、`department_name`、`expense_type`、`amount`、`currency`、`invoice_count`、`occurred_at`、`submitted_at`、`status`、`approval_stage`、`risk_flags_json`。
|
||||
- 用途：风险主体、金额基线、流程阶段、规则命中、图谱 claim 节点。
|
||||
|
||||
2. 报销明细：`ExpenseClaimItem`
|
||||
- 关键字段：`item_id`、`item_type`、`item_amount`、`item_location`、`item_date`、`invoice_id`。
|
||||
- 用途：多凭证一致性、时空一致性、票据关系、图谱 item / invoice 节点。
|
||||
|
||||
3. 风险规则命中：`risk_flags_json` 与规则中心结果
|
||||
- 来源：报销单已有风险标记、`RiskObservationService.upsert_platform_risk_flags()`。
|
||||
- 用途：`S_rule`、规则版本追溯、候选规则闭环。
|
||||
|
||||
4. 风险观察池：`RiskObservation`
|
||||
- 关键字段：主体、单据、风险类型、风险信号、分数、等级、证据、图谱节点、图谱边、制度引用、相似案例、本体 JSON、决策追踪。
|
||||
- 用途：统一风险结论、看板、详情、反馈、回放。
|
||||
|
||||
5. 风险观察反馈：`RiskObservationFeedback`
|
||||
- 关键字段：反馈类型、动作、处理人、备注、扩展 payload。
|
||||
- 用途：人工采纳、误报、忽略、处理完成、候选规则来源、回放标签。
|
||||
|
||||
6. 数字员工任务记录：`HermesTaskExecutionLog`
|
||||
- 关键字段：任务配置、状态、开始结束时间、错误信息、执行摘要。
|
||||
- 用途：风险扫描任务追溯、数字员工工作记录详情、失败原因。
|
||||
|
||||
7. Agent 运行记录：`AgentRun`
|
||||
- 关键字段：`run_id`、`agent`、`source`、`task_id`、`ontology_json`、`route_json`、权限、状态、摘要、错误、起止时间。
|
||||
- 用途：数字员工运行上下文、数据血缘、回放输入。
|
||||
|
||||
8. 工具调用记录：`AgentToolCall`
|
||||
- 关键字段：工具类型、工具名称、请求、响应、状态、耗时、错误。
|
||||
- 用途：OCR、知识检索、规则执行、外部工具证据链。
|
||||
|
||||
9. 语义解析日志：`SemanticParseLog`
|
||||
- 关键字段：原始查询、场景、意图、实体、时间范围、指标、约束、风险信号、权限、置信度。
|
||||
- 用途：本体到风险图谱桥接、低置信度降级、语义血缘。
|
||||
|
||||
10. 财务制度知识库
|
||||
- 来源：知识库文档、制度归集任务、知识检索证据。
|
||||
- 用途：制度条款引用、`S_policy`、风险解释、制度缺口识别。
|
||||
|
||||
## `/api/v1/ontology/parse` 字段与落库方式
|
||||
|
||||
接口请求：`OntologyParseRequest`
|
||||
|
||||
- `query`：自然语言问题。
|
||||
- `user_id`：当前用户。
|
||||
- `context_json`：角色、部门、权限上下文。
|
||||
|
||||
接口响应：`OntologyParseResult`
|
||||
|
||||
- `scenario`：业务场景。
|
||||
- `intent`：用户意图。
|
||||
- `entities`：实体列表，包含类型、原值、标准值、角色、置信度。
|
||||
- `time_range`：时间范围。
|
||||
- `metrics`：指标列表。
|
||||
- `constraints`：字段约束。
|
||||
- `risk_flags`：风险信号列表。
|
||||
- `permission`：权限结果。
|
||||
- `confidence`：整体置信度。
|
||||
- `missing_slots`：缺失槽位。
|
||||
- `ambiguity`：歧义说明。
|
||||
- `parse_strategy`：解析策略。
|
||||
- `clarification_required` / `clarification_question`：是否需要追问。
|
||||
- `run_id`：关联 `AgentRun.run_id`。
|
||||
- `field_errors`：字段级错误。
|
||||
|
||||
落库方式：
|
||||
|
||||
- `AgentRun.ontology_json` 保存本次解析概要。
|
||||
- `SemanticParseLog.entities_json` 保存实体。
|
||||
- `SemanticParseLog.time_range_json` 保存时间。
|
||||
- `SemanticParseLog.metrics_json` 保存指标。
|
||||
- `SemanticParseLog.constraints_json` 保存约束。
|
||||
- `SemanticParseLog.risk_flags_json` 保存风险信号。
|
||||
- `SemanticParseLog.permission_json` 保存权限。
|
||||
- `SemanticParseLog.confidence` 保存整体置信度。
|
||||
|
||||
## 不可复制壁垒资产
|
||||
|
||||
1. 专有财务本体
|
||||
- 由场景、意图、实体、约束、风险信号、权限和置信度构成。
|
||||
- 价值：把自然语言、规则中心和风险图谱统一到同一业务语义。
|
||||
|
||||
2. 对象中心财务事件日志
|
||||
- 由 `ObjectCentricEvent` 承载，统一申请、报销、票据、审批、退回、付款、归档、复盘。
|
||||
- 价值：形成可回放过程挖掘资产。
|
||||
|
||||
3. 风险观察反馈池
|
||||
- 由 `RiskObservationFeedback` 承载，记录确认、误报、忽略、改写、补件、升级和候选规则来源。
|
||||
- 价值：把人工判断变成模型和规则迭代样本。
|
||||
|
||||
4. 人机共审行为数据
|
||||
- 来源：AgentRun、ToolCall、反馈、数字员工执行日志。
|
||||
- 价值：记录谁在何时基于什么证据做了什么判断。
|
||||
|
||||
5. 可回放评测资产
|
||||
- 由 `AlgorithmReplaySet` 与 `RiskEvaluationCase` 承载。
|
||||
- 价值：每次规则、本体或算法升级后都能复跑历史样本，防止误报率失控。
|
||||
|
||||
6. 实体标准化资产
|
||||
- 由 `FinancialEntityResolver` 和 `CanonicalEntityRegistry` 承载。
|
||||
- 价值：沉淀供应商、商户、酒店、银行户名、员工姓名等标准主体。
|
||||
|
||||
7. 可解释决策资产
|
||||
- 由 `DecisionTrace`、贡献项、不确定性原因、数据血缘承载。
|
||||
- 价值：让每个风险结论都能被审计、复核和反事实推演。
|
||||
Reference in New Issue
Block a user