双盲复算前端复核修正(第 2 轮):「记入数据目录」不再说得比服务端宽——有服务端预告时照预告说,没有时只说必要条件、不写的几种照实说

问题:审批卡上那句「记入数据目录」的提示是照 vs/f1a 早先的规则写的。F1a 在 1491b5c 把写目录的规则收紧以后,有三种常见情况卡上说会记入,服务端却都不写:
- 只有一边按时间筛:卡上写「两边只差在按哪一列筛时间」,和正上方那条差异「盲算没有按时间筛选」自相矛盾
- 只多一个指标自己范围的条件(channel = 'web'):服务端只把排除退款、作废、测试这类无效记录的条件记成有效记录条件
- 只差去不去重,而审核人采用的是不去重的一边:服务端不写
审核人可能为了不让目录被写错,避开本来正确的原流程,结果出具降档;节点设为「判为失败」时运行还会终止。

审批卡(run/DualCheckApproval.tsx)
- 服务端在摘要里另带预告(payload.summary[].catalog,F1a 在 f7d1a2e 加的,约定之外另带)时照它说:三个选择各说一句,会写的写明哪张表的哪一项记成什么,不写的写「不记」。两边都不写就不提数据目录。审核人当前选中的那一句加重,选完一眼就能看出这一选会写什么。预告跟着摘要一起来,完整对照还没到或取不到时也照样能说。预告的形状认不出时整份不用,回到有条件的说法。
- 没有预告时(老服务端、升级前挂起的审批),三句改成只说必要条件(「仅当……才」),并把不写的几种照实写出来:只有一边按时间筛时不记;多出的条件得只在一边、并且是在排除无效记录,只看某个地区、某个渠道这类条件不记;采用不去重的一边时不记。
- payload 带了实际生效的「未采用原流程时」(同样是 f7d1a2e 加的)就照它说,不再去取图快照。子工作流里的节点在图快照里找不到,有了它也能说准;值认不出时仍回到图快照。

夹具与检查
- 夹具新增两个变体:只有一边按时间筛、只多一个渠道条件,差异说明都是 explain_sql_diff 的真实输出。每个指标、每个变体都附上服务端预告的真实输出(catalog_preview、variants[].catalog)。backend/tests/test_dual_check_fixture.py 有两项检查:一项不依赖服务端,查预告的形状和写目录的门槛;另一项在服务端模块合入后,逐项比对夹具和 dual_check_facts.preview。regenerate 也会一并重新生成预告。
- 预览用例 dual-check-approval 认地址参数 variant / catalog / on_reject,不带参数时 payload 只有约定里的几项。
- check-verify 按服务端的预告核对两种说法:没有预告的一节,在三种情况下都要以「仅当」开头,并照实说出不写;只差去不去重时,两种选择各断言一次。有预告的一节,核对两边写什么或不记、两边都不写时不提、选中那一句加重(去重的两种选择分别看)、认不出时回到有条件的说法、取不到完整对照时照样说,以及 390px 下深浅色的对比度。payload 的 on_reject 那一节核对:照它说、不取图快照、子工作流也说准、认不出时回到图快照。
- 去掉实现以后,检查脚本在这三种情况、预告和 on_reject 上共有 13 项变红。改动后为 274 项全部通过(原来 218 项)。check-all 里 check-verify 的耗时估计按实测改成 65 秒。
This commit is contained in:
ThearchyHelios
2026-10-05 16:56:05 +08:00
parent 52baa0d65c
commit b206665856
8 changed files with 623 additions and 46 deletions
+159 -1
View File
@@ -1,5 +1,5 @@
{
"_note": "双盲复算的预览用例和 scripts/check-verify.mjs 共用的夹具。表名、数字都是虚构的通用示例,不来自任何真实数据。各处的 diff(差异说明)是服务端 explain_sql_diff 对同一对 SQL 的真实输出(方言 sqlite),由 backend/tests/test_dual_check_fixture.py 核对和重新生成,不要手改。variants 是另几对 SQL 及其差异说明,检查脚本拿来换掉「销售额」那个指标,看不同的差异下卡上怎么说",
"_note": "双盲复算的预览用例和 scripts/check-verify.mjs 共用的夹具。表名、数字都是虚构的通用示例,不来自任何真实数据。各处的 diff(差异说明)是服务端 explain_sql_diff 对同一对 SQL 的真实输出(方言 sqlite),catalog_preview 和 variants 里的 catalog(采用哪一边会往数据目录里写什么)是服务端写目录预告的真实输出,都由 backend/tests/test_dual_check_fixture.py 核对和重新生成,不要手改。variants 是另几对 SQL 及其差异说明,检查脚本拿来换掉「销售额」那个指标,看不同的差异下卡上怎么说",
"approval": {
"id": "ap-dc-0001",
"run_id": "run-dc-0001",
@@ -163,6 +163,38 @@
}
]
},
"catalog_preview": {
"gmv": {
"a": {
"write": true,
"source": "shop",
"table": "orders",
"item": "business_date",
"value": {
"column": "paid_at"
}
},
"b": {
"write": true,
"source": "shop",
"table": "orders",
"item": "business_date",
"value": {
"column": "created_at"
}
}
},
"refund_rate": {
"a": {
"write": false,
"reason": "指标「退款率」两边的 SQL 不止差一个方面,或有未能归纳的差异,无法确定审核人认可的是哪一处,不写入数据目录"
},
"b": {
"write": false,
"reason": "指标「退款率」两边的 SQL 不止差一个方面,或有未能归纳的差异,无法确定审核人认可的是哪一处,不写入数据目录"
}
}
},
"graph": {
"nodes": [
{
@@ -394,6 +426,46 @@
"- orders.paid_at >= '2026-09-01' AND orders.paid_at < '2026-09-08'",
"+ orders.paid_at >= '2026-09-01' AND orders.paid_at < '2026-09-09'"
]
},
"catalog": {
"a": {
"write": false,
"reason": "指标「销售额」两边差在时间范围,对不上数据目录里的业务日期、有效记录条件或去重规则,不写入数据目录"
},
"b": {
"write": false,
"reason": "指标「销售额」两边差在时间范围,对不上数据目录里的业务日期、有效记录条件或去重规则,不写入数据目录"
}
}
},
"time_one_side": {
"sql": [
"SELECT SUM(amount) AS gmv\nFROM orders\nWHERE paid_at >= '2026-09-01'\n AND paid_at < '2026-09-08'",
"SELECT SUM(amount) AS gmv\nFROM orders"
],
"diff": {
"equivalent": false,
"items": [
{
"aspect": "time",
"text": "原流程按 paid_at 筛时间,盲算没有按时间筛选"
}
],
"fallback": false,
"text_diff": [
"- WHERE",
"- orders.paid_at >= '2026-09-01' AND orders.paid_at < '2026-09-08'"
]
},
"catalog": {
"a": {
"write": false,
"reason": "指标「销售额」只有被采纳的原流程按时间筛选,盲算没有:审核人判断的是要不要限定时间,不是按哪一列归属,没有可记的业务日期,不写入数据目录"
},
"b": {
"write": false,
"reason": "指标「销售额」被采纳的盲算没有按时间筛选,没有可记的业务日期,不写入数据目录"
}
}
},
"filter_extra": {
@@ -414,6 +486,49 @@
"- WHERE",
"- orders.status <> 'test'"
]
},
"catalog": {
"a": {
"write": true,
"source": "shop",
"table": "orders",
"item": "valid_filter",
"value": "status <> 'test'"
},
"b": {
"write": false,
"reason": "指标「销售额」多出筛选条件的是原流程,被采纳的盲算没有这个条件,不写入数据目录"
}
}
},
"filter_scope": {
"sql": [
"SELECT COUNT(*) AS orders\nFROM orders\nWHERE channel = 'web'",
"SELECT COUNT(*) AS orders\nFROM orders"
],
"diff": {
"equivalent": false,
"items": [
{
"aspect": "filter",
"text": "原流程只保留 channel = 'web' 的行,盲算没有这个条件"
}
],
"fallback": false,
"text_diff": [
"- WHERE",
"- orders.channel = 'web'"
]
},
"catalog": {
"a": {
"write": false,
"reason": "指标「销售额」多出的条件「channel = 'web'」不是在排除退款、作废、测试这类无效记录,可能是指标自己的筛选范围(例如只看某个地区、某个渠道),不是整张表的有效记录条件,不写入数据目录"
},
"b": {
"write": false,
"reason": "指标「销售额」多出筛选条件的是原流程,被采纳的盲算没有这个条件,不写入数据目录"
}
}
},
"two_filters": {
@@ -438,6 +553,16 @@
"- WHERE",
"- orders.channel = 'web' AND orders.status <> 'refunded'"
]
},
"catalog": {
"a": {
"write": false,
"reason": "指标「销售额」两边的 SQL 不止差一个方面,或有未能归纳的差异,无法确定审核人认可的是哪一处,不写入数据目录"
},
"b": {
"write": false,
"reason": "指标「销售额」两边的 SQL 不止差一个方面,或有未能归纳的差异,无法确定审核人认可的是哪一处,不写入数据目录"
}
}
},
"join": {
@@ -462,6 +587,16 @@
"- ON orders.id = refunds.order_id",
"+ orders.id = refunds.order_id"
]
},
"catalog": {
"a": {
"write": false,
"reason": "指标「销售额」两边差在关联,对不上数据目录里的业务日期、有效记录条件或去重规则,不写入数据目录"
},
"b": {
"write": false,
"reason": "指标「销售额」两边差在关联,对不上数据目录里的业务日期、有效记录条件或去重规则,不写入数据目录"
}
}
},
"dedup": {
@@ -482,6 +617,19 @@
"- COUNT(DISTINCT orders.user_id)",
"+ COUNT(orders.user_id)"
]
},
"catalog": {
"a": {
"write": true,
"source": "shop",
"table": "orders",
"item": "dedup",
"value": "对 user_id 计数时去重"
},
"b": {
"write": false,
"reason": "指标「销售额」被采纳的盲算没有去重:不去重是这个指标自己的算法,不是表的去重规则,不写入数据目录"
}
}
},
"parse": {
@@ -499,6 +647,16 @@
],
"fallback": false,
"text_diff": []
},
"catalog": {
"a": {
"write": false,
"reason": "指标「销售额」两边差在能否解析,对不上数据目录里的业务日期、有效记录条件或去重规则,不写入数据目录"
},
"b": {
"write": false,
"reason": "指标「销售额」两边差在能否解析,对不上数据目录里的业务日期、有效记录条件或去重规则,不写入数据目录"
}
}
}
}
+30 -2
View File
@@ -20,7 +20,14 @@ import data from './dual_check.json'
*
* 完整对照的工件(GET /api/artifacts/{id})、这次运行的图快照(GET /api/runs/{id}/graph,卡上按它说节点的
* 「未采用原流程时」)、审批回复、设置、校验都由检查脚本用 page.route 伪造,直接打开时卡上照实说无法加载完整对照、
* 有条件地说后果。提交后 onResolved 只把运行 id 记到 window.__dualResolved,不去接事件流
* 有条件地说后果。提交后 onResolved 只把运行 id 记到 window.__dualResolved,不去接事件流。
*
* ?syn=dual-check-approval 另认地址上的几个参数(检查脚本用;不带时 payload 只有约定里的几项,同老服务端):
* - variant=<名字>:「销售额」的摘要换成 variants 里那一对 SQL 的(前 3 条差异的原话、是否只有兜底,同节点的写法),
* 工件由检查脚本按同一个变体伪造
* - catalog=1:摘要里每个指标带上服务端预告的「采用哪一边会往数据目录里写什么」(catalog_preview;换了变体的
* 「销售额」用变体的 catalog)。catalog=bad:「销售额」带一份认不出的预告
* - on_reject=<值>:payload 带上节点实际生效的「未采用原流程时」
*/
const approval = (patch: Partial<Approval> = {}): Approval => ({
...(data.approval as unknown as Approval),
@@ -28,6 +35,27 @@ const approval = (patch: Partial<Approval> = {}): Approval => ({
...patch,
})
interface Variant { diff: { items: { aspect: string; text: string }[] }; catalog: unknown }
function approvalOf(search: string): Approval {
const q = new URLSearchParams(search)
const variant = (data.variants as unknown as Record<string, Variant>)[q.get('variant') ?? '']
const catalog = q.get('catalog')
const onReject = q.get('on_reject')
const previews = data.catalog_preview as unknown as Record<string, unknown>
const summary = data.approval.payload.summary.map((s) => {
const swapped = s.metric_id === 'gmv' && variant ? variant : null
const items = swapped?.diff.items
return {
...s,
...(items ? { diff: items.slice(0, 3).map((i) => i.text), fallback: !items.some((i) => i.aspect !== 'other' && i.aspect !== 'parse') } : {}),
...(catalog === '1' ? { catalog: swapped ? swapped.catalog : previews[s.metric_id] } : {}),
...(catalog === 'bad' && s.metric_id === 'gmv' ? { catalog: { a: { write: true, table: 'orders' }, b: { write: false } } } : {}),
}
})
return approval({ payload: { ...data.approval.payload, summary, ...(onReject ? { on_reject: onReject } : {}) } })
}
function Card({ value }: { value: Approval }) {
return (
<div className="overflow-hidden rounded-lg border" style={{ borderColor: 'var(--warn)' }}>
@@ -68,7 +96,7 @@ function InspectorCase() {
export const cases: Record<string, () => JSX.Element> = {
'dual-check-approval': () => (
<div className="mx-auto max-w-3xl p-4 text-sm" data-fixture="dual-check-approval"><Card value={approval()} /></div>
<div className="mx-auto max-w-3xl p-4 text-sm" data-fixture="dual-check-approval"><Card value={approvalOf(location.search)} /></div>
),
'dual-check-approval-rail': () => (
<div className="h-full w-[360px] max-w-full overflow-y-auto border-r bg-panel" data-fixture="dual-check-approval-rail">