feat(qa-ops): 交付十一项统计看板与完整图片导出
build / build (push) Successful in 1m10s

以治理库单一只读事务分开聚合累计、自然周、截止月及当前通讯录使用分母;浏览器不再读取全量长答案来构建看板。

新增迁移52与普通worker周质量冻结,保留真实冻结时点、规则和标量贡献;缺少当时快照留空。提交后冻结头与贡献不可修改、删除或追加;只读接口保留管理员、固定租户、严格JSON与输入冲突保护。

已验证:make verify退出0,686个Go用例和305个前端用例通过,必需跳过0;镜像与组织隔离PostgreSQL竞态回归退出0。真实治理副本浏览器核对第41周累计1885与新增471、十一项和完整PNG下载,390px无外溢、JS异常0;明确模拟503后不伪零且重试恢复。没有修改DobotAI原始问答、真实区域规则或生产发布门禁。
This commit is contained in:
姚章浩
2026-10-18 23:26:55 +08:00
parent 76671e0784
commit 6e67034fbd
32 changed files with 2103 additions and 356 deletions
@@ -0,0 +1,10 @@
DO $$ BEGIN
IF EXISTS(SELECT 1 FROM qa_ops_weekly_quality_snapshots) THEN
RAISE EXCEPTION 'frozen weekly quality history exists; keep additive schema during application rollback';
END IF;
END $$;
DROP TABLE qa_ops_weekly_quality_snapshot_records;
DROP TABLE qa_ops_weekly_quality_snapshots;
DROP TABLE qa_ops_weekly_quality_tracking;
DROP FUNCTION qa_ops_require_new_weekly_quality_header();
DROP FUNCTION qa_ops_reject_frozen_quality_mutation();
@@ -0,0 +1,50 @@
CREATE TABLE qa_ops_weekly_quality_tracking (
tenant_key TEXT PRIMARY KEY CHECK(length(tenant_key) BETWEEN 1 AND 128),
started_at TIMESTAMPTZ NOT NULL, first_data_at TIMESTAMPTZ
);
CREATE TABLE qa_ops_weekly_quality_snapshots (
tenant_key TEXT NOT NULL, week_start TIMESTAMPTZ NOT NULL, week_end TIMESTAMPTZ NOT NULL,
frozen_at TIMESTAMPTZ NOT NULL, mirror_revision BIGINT NOT NULL CHECK(mirror_revision>=0),
source_observed_at TIMESTAMPTZ NOT NULL, policy_version TEXT NOT NULL,
record_count INTEGER NOT NULL CHECK(record_count>=0),
coverage_numerator INTEGER NOT NULL CHECK(coverage_numerator>=0), coverage_denominator INTEGER NOT NULL CHECK(coverage_denominator>=coverage_numerator),
correctness_numerator INTEGER NOT NULL CHECK(correctness_numerator>=0), correctness_denominator INTEGER NOT NULL CHECK(correctness_denominator>=correctness_numerator),
PRIMARY KEY(tenant_key,week_start), CHECK(week_end=week_start+interval '7 days'),
CHECK(date_trunc('day',week_start AT TIME ZONE 'Asia/Shanghai')=week_start AT TIME ZONE 'Asia/Shanghai'),
CHECK(EXTRACT(ISODOW FROM week_start AT TIME ZONE 'Asia/Shanghai')=1),
CHECK(frozen_at>=week_end), CHECK(source_observed_at>=week_end AND source_observed_at<=frozen_at),
CHECK(coverage_denominator<=record_count AND correctness_denominator<=record_count)
);
-- Frozen scalar contributions preserve the original formula under future policy
-- changes and allow literal keyword filtering without recalculating old reviews.
-- No answers, staff IDs, names or organization memberships are duplicated here.
CREATE TABLE qa_ops_weekly_quality_snapshot_records (
tenant_key TEXT NOT NULL, week_start TIMESTAMPTZ NOT NULL, record_id TEXT NOT NULL,
question TEXT NOT NULL,
coverage_numerator SMALLINT NOT NULL CHECK(coverage_numerator BETWEEN 0 AND 1),
coverage_denominator SMALLINT NOT NULL CHECK(coverage_denominator BETWEEN coverage_numerator AND 1),
correctness_numerator SMALLINT NOT NULL CHECK(correctness_numerator BETWEEN 0 AND 1),
correctness_denominator SMALLINT NOT NULL CHECK(correctness_denominator BETWEEN correctness_numerator AND 1),
PRIMARY KEY(tenant_key,week_start,record_id),
FOREIGN KEY(tenant_key,week_start) REFERENCES qa_ops_weekly_quality_snapshots(tenant_key,week_start) ON DELETE CASCADE
);
CREATE FUNCTION qa_ops_reject_frozen_quality_mutation() RETURNS trigger LANGUAGE plpgsql AS $$
BEGIN
RAISE EXCEPTION 'committed weekly quality snapshots are immutable' USING ERRCODE='55000';
END $$;
CREATE TRIGGER immutable_weekly_quality_header BEFORE UPDATE OR DELETE ON qa_ops_weekly_quality_snapshots FOR EACH ROW EXECUTE FUNCTION qa_ops_reject_frozen_quality_mutation();
CREATE TRIGGER immutable_weekly_quality_records BEFORE UPDATE OR DELETE ON qa_ops_weekly_quality_snapshot_records FOR EACH ROW EXECUTE FUNCTION qa_ops_reject_frozen_quality_mutation();
-- Contributions may only be inserted in the SAME transaction as their header.
-- This rejects a later append while allowing the initial atomic CopyFrom batch.
CREATE FUNCTION qa_ops_require_new_weekly_quality_header() RETURNS trigger LANGUAGE plpgsql AS $$
DECLARE parent_xid bigint;
BEGIN
SELECT xmin::text::bigint INTO parent_xid FROM qa_ops_weekly_quality_snapshots WHERE tenant_key=NEW.tenant_key AND week_start=NEW.week_start;
IF parent_xid IS NULL OR parent_xid <> mod(pg_current_xact_id()::text::numeric,4294967296)::bigint THEN
RAISE EXCEPTION 'cannot append to a committed weekly quality snapshot' USING ERRCODE='55000';
END IF;
RETURN NEW;
END $$;
CREATE TRIGGER append_only_new_weekly_quality BEFORE INSERT ON qa_ops_weekly_quality_snapshot_records FOR EACH ROW EXECUTE FUNCTION qa_ops_require_new_weekly_quality_header();
@@ -11,8 +11,8 @@ func TestEmbeddedMigrationsAreVersionSorted(t *testing.T) {
if err != nil {
t.Fatalf("loadMigrations() error = %v", err)
}
if len(migrations) != 51 {
t.Fatalf("migration count = %d, want 51", len(migrations))
if len(migrations) != 52 {
t.Fatalf("migration count = %d, want 52", len(migrations))
}
if migrations[0].Version != 1 || !strings.Contains(migrations[0].UpSQL, "CREATE TABLE IF NOT EXISTS jobs") {
t.Fatalf("migration 1 = %#v", migrations[0])
@@ -0,0 +1,33 @@
package postgres
import (
"strings"
"testing"
)
func TestWeeklyQualityMigrationPreservesFrozenHistory(t *testing.T) {
migrations, e := loadMigrations()
if e != nil {
t.Fatal(e)
}
var up, down string
for _, m := range migrations {
if m.Version == 52 {
up = m.UpSQL
down = m.DownSQL
}
}
for _, part := range []string{"CREATE TABLE qa_ops_weekly_quality_tracking", "first_data_at TIMESTAMPTZ", "CREATE TABLE qa_ops_weekly_quality_snapshots", "CREATE TABLE qa_ops_weekly_quality_snapshot_records", "AT TIME ZONE 'Asia/Shanghai'", "BEFORE UPDATE OR DELETE", "BEFORE INSERT", "pg_current_xact_id()", "coverage_denominator<=record_count"} {
if !strings.Contains(up, part) {
t.Fatal("missing frozen weekly quality contract", part)
}
}
if !strings.Contains(down, "IF EXISTS(SELECT 1 FROM qa_ops_weekly_quality_snapshots)") || !strings.Contains(down, "RAISE EXCEPTION") || !strings.Contains(down, "DROP FUNCTION qa_ops_require_new_weekly_quality_header()") {
t.Fatal("lossy history rollback or stale trigger functions")
}
for _, forbidden := range []string{"ALTER TABLE qa_ops_mirror_records", "UPDATE qa_ops_quality_reviews", "answer TEXT", "staff_id TEXT"} {
if strings.Contains(up, forbidden) {
t.Fatal("snapshot migration widened into original records or employee identity")
}
}
}