复盘修正:试运行不计入统计、评估标签遮罩、规则/评估卡可组合

This commit is contained in:
ThearchyHelios
2026-11-03 21:23:08 +08:00
parent 4bf9e56979
commit 753c35918d
27 changed files with 240 additions and 86 deletions
+3 -2
View File
@@ -130,7 +130,8 @@
剖析范围选「取值观察」或定时维护时,还会观察取值:行数、码值分布(包括人工确认过的码值列)、最新业务日期、最近 35 天每天的行数。
- 和同一口径(同样的取样方式)的历史比,比出新码值、比例剧变、断档、缺天、量跌、行数大起大落,记进变化记录(见下文)。
- 标了「已列全」的码值表出现目录里没有的取值时,系统撤销「已列全」,目录升一版。这是机器唯一会自己写进目录的事;新取值的含义仍要人填。
- 标了「已列全」的码值表出现目录里没有的取值时,系统撤销「已列全」,目录升一版。新取值的含义仍要人填。
- 新设遮罩列时,系统会清掉这些列在目录里留下的码值、含义、备注和确认依据,目录升一版。这是机器自己写目录的另一种情况。
- 遮罩列不观察。
## 版本与提醒
@@ -185,7 +186,7 @@
- 数据目录的「变化」视图按「要处理 / 提醒 / 说明」分组;数据源卡片上的角标是要处理的条数;表详情里有「结构与取值变化」一节。
- 每条写明影响面:说到这些列的目录项和它们的状态、写死了这一列的已发布模板、哪条 SQL 现在会报列不存在。
- 处理动作:「清理目录项」「加入码值」「重新起草」「重新剖析」「知道了」「误报」(误报必须写理由)。动作都落到目录已有的写入上,记下目录版本或建的任务。
- 机器自己只做一件事:数据证明码值表不再列全时,撤销「已列全」。
- 机器自己写目录只有两种情况:数据证明码值表不再列全时撤销「已列全」;新设遮罩列时清掉该列的码值、含义、备注和确认依据。
- 有「要处理」的变化时,可以推通知「数据源有变化要处理」,消息里只有源名、条数和链接,不放表名、列名和取值(见[通知](schedules.md#通知))。也可以作为定时任务的触发事件。
### 定时维护
+8 -1
View File
@@ -75,9 +75,16 @@
|---|---|
| 「等价已证明」 | SQL 被证明和口径等价 |
| 「助手选用」 | 助手选用口径拼出来的 |
| 「外部常量」 | 口径卡上的外部常量,带来源和生效日期;过期会降档 |
| 「规则派生」 | 规则型指标从查询格按结构化条件算出,不是某条查询与口径等价 |
| 「评估值」 | 评估型指标按评分协议算出的值,不是测量值 |
| 「相关口径」 | 用到同一张表却不等价,写明差在哪 |
| 「这次的推理」 | 和哪份口径都不沾边 |
后三种(外部常量、规则派生、评估值)不会让整题变成「等价已证明」,不自动正式出具;证据面板会照实写出处。
口径卡上的指标现在有四种:公式(`formula`)、外部常量(`external`)、规则(`rule`)、评估(`assessment`)。定义文本和参数随版本固定,并在「口径」目录页(`/ledger/calibers`)里能看、能按参数试运行;试运行是只读探索运行,不进使用统计,也不是正式出具。
- 证据面板的出处链最上面多一步「口径」;问数据每一轮底下有一行摘要。比对还没出结果时,写「正在比对口径」并按退避重取。
- 比对结果是一条封存后追加的事件 `ledger.matched`,出现在时间线和可验证报告的「封存后追加」里,不在封存范围内。启动时会补比最近 7 天的运行(跟着 `AGENTLAB_SCHEDULER` 开关)。
- 逐个数判:报告引用了一条查询的几列(例如销售额、订单数、首末日)时,每个数按它那一列单独和口径的指标列比,多查的列不影响这个数。只在去掉别的列不会改变这个数时才这样比;有 DISTINCT、按别的列排序后截断、多出来分组列的,照旧整条比。
@@ -85,7 +92,7 @@
- 整题要每个来自数据的数都被证明来自同一份口径,才自动出具。
- 分析结论里的数(占比、变化、波动范围)是从查询结果派生的,不比对、不标口径,摘要行也不计它们。
写口径的取数 SQL 时,最好不要取整(`ROUND(SUM(x), 2)`),也不要套 `COALESCE(…, 0)`。取整和缺省值交给口径卡的小数位和展示;否则问数据里没取整的写法永远认不成等价(差在哪会照实写出来)。
写口径的取数 SQL 时,不要取整(`ROUND(SUM(x), 2)`),也不要套 `COALESCE(…, 0)`。取整和缺省值交给口径卡的小数位和展示;否则问数据里没取整的写法永远认不成等价(差在哪会照实写出来)。受管级别发布时,这两类写法会直接挡住发布;已发布级别只提示。
### 按口径正式出具