UI 蓝图/采集后台 · 控制面/解析规则 Studio 与样本验证

TARGETF4B2 PARTIALQA 0/5 VERIFIEDR10 · 11/21 PASS COMPLETEAdmin · 采集工程师与数据质量负责人

解析规则 Studio 与样本验证

将规则列表变成版本化编辑器，用输入证据、字段映射、断言、样本输出和差异支撑发布

/admin/rulesdata-sources对照 CURRENT · data-rules →

R10 · KNIFE 11 / 21

解析规则 Studio 与样本验证 · 页面级细化任务包

在同一编辑器核对 selector、字段映射、断言、输入 fixture、解析输出和版本差异。

CURRENT ROUTE / API

/admin/rules · /admin/api/source-rules/* 401

WORK MODE

configure · K10

ENTRY

从来源详情、漂移告警或失败 run 进入。

SUCCESS OUTPUT

保存草稿、通过 fixture 测试并发布 RuleRevision receipt。

COMMAND MODEL

Rule draft → deterministic fixtures → assertions → diff → publish revision → rollback pointer。

RESPONSIVE + A11Y

桌面规则/编辑器/样本三栏；平板折叠清单；手机只读 diff 优先。

TELEMETRY

rule_view · fixture_run · rule_publish；fixture 中 PII 与 secret 脱敏。

CURRENT SOURCE + PRODUCTIONmain/prod cb37d2c

data-sources origin/main 与生产 VERSION 均为 cb37d2ce9633e7395d614f3b3239c5efea2902f7；本地 feat/p1-knives-1-8@8dd0de4 仅作 branch-only 证据
生产 15 个 `/admin/*` 页面路径返回 SPA shell HTTP 200；bootstrap 明确 login_required=true，operations/resources/sources/logs 等受保护 API 未登录返回 401
`/healthz` 与公开只读 documents/options/search API 返回 200；bootstrap 的业务零值是未登录占位，不能作为来源、运行、内容或风险数量
E04 只读生产聚合：88 个来源全部 active，50 个需法务复核、19 个高风险、58 个 robots 待检查；当前 1 个 run 为 453 jobs / 64 fetch success / 383 fetch failed / 0 stored
公开默认投影与存储总量分轨：documents 5,645 / 8,817，media 2,081 / 13,382；1.2 GiB backup、20 GiB data 与 1.36 GB SQLite 仍在同一 EC2/EBS 故障域
主干前端集中在 8,567 行 App.vue；Go server 14,402 行、server_test 4,378 行、63 个 Go 测试文件、70 个显式路由、0 个仓库 CI workflow
主干存在 source-rules detail/save/toggle handler；未发现独立 parser preview/version API。

IMPLEMENTATION GAPTARGET CONTRACT

缺 RuleRevision、fixture store、parser preview 和版本发布 API
缺字段级断言/差异与漂移基线
缺发布前回归集合和一键回滚 receipt

135-STATE PROGRAM / THIS SCREEN

九态分别改变当前模块，不用通用遮罩冒充完整交互

QA 0 / 5 VERIFIED

READYRuleRevision 当前契约可评审

RuleRevision workspace

R10-RULE-READY→ 查看 rule gap

LOADING正在读取 RuleRevision

RuleRevision independent regions

R10-RULE-LOAD→ 保留筛选并等待

EMPTY尚未选择规则或认证后规则为空

RuleRevision result set

R10-RULE-EMPTY→ 查看当前接口与创建条件

PARTIAL ERRORRuleRevision 部分来源不可用

RuleRevision evidence rail

R10-RULE-PARTIAL→ 只重试失败区域

ERRORRuleRevision 请求失败

RuleRevision request

R10-RULE-ERROR→ 安全重试

OFFLINE离线只读 · RuleRevision

RuleRevision redacted snapshot

R10-RULE-OFFLINE→ 重新连接

FORBIDDEN没有读取或管理 RuleRevision 的权限

RuleRevision authorization

R10-RULE-DENY→ 重新登录或返回概览

CONFIRM确认发布或回滚规则 revision？

RuleRevision command impact

R10-RULE-CONFIRM→ 确认并提交

SUCCESSRuleRevision 已登记，后台生效状态待核验

RuleRevision receipt

R10-RULE-SUCCESS→ 查看回执

UI STUDIOtarget-data-rules

Admin1440 × 900100%

100%

/admin/rules

TARGET UI1440 × 900FIT 100%

R10 DESIGN CANDIDATEtarget-data-rulesNO PRODUCTION BUSINESS FIXTURE

CURRENT / TARGET SPLIT15 个 route shell=200；受保护 API=401；业务数量与记录未认证，不作为生产真值。

PARSER RULE STUDIO

解析规则 Studio 与样本验证

把 selector、字段映射、断言、fixture、输出和版本差异放在一个发布面。

SOURCE + PRODcb37d2cexact match

ROUTE SHELLHTTP 200/admin/rules

BUSINESS APIHTTP 401/admin/api/source-rules/*

BOOTSTRAPlogin_requiredzero values are gated

PRODUCT QA0 / 5B3 0 · blueprint only

CURRENT CONTRACT生产访问与页面字段

200/admin/rulesSPA shell only

401/admin/api/source-rules/*protected

Selectorschema slot字段映射schema slot断言schema slot样本输入/输出schema slot

AUTHENTICATED DATA REGION记录区 · 当前未载入

RULEDRAFTFIXTUREPUBLISH

∅未登录，不展示生产业务记录AUTH REQUIRED · 不用 bootstrap 0 值或演示 fixture 填充

TARGET IMPLEMENTATION下一阶段合同与门禁

01RuleRevisionNOT PROVEN
02fixture storeNOT PROVEN
03parser previewNOT PROVEN
04回归门禁NOT PROVEN

ARCHITECTURE GAP

当前有规则 CRUD/开关；独立 preview、revision 与回滚 API 未证明。

OWNER · Parser Engineering

REFERENCE VIEWPORT1440 × 900Desktop first · responsive

PRIMARY TASK新建规则主操作、权限与完成反馈必须同屏可验证

DATA CONTRACTSourceRuleready / loading / empty / error 使用同一 fixture

ACCESSIBILITYKeyboard + WCAG AA焦点顺序、可读名称、对比度进入 UI CI

VISUAL BASELINETARGET · 2026-07-17桌面/移动、浅色/错误态按稳定 Screen ID 留档

IMPLEMENTATION MAP

目标定义与下一轮逐页细化入口

当前处于 B1/B2：可以拆出架构、设计、交互和 QA 任务，但完成 D01–D12、通过 B3/B4 之前，不得宣称页面已经可以照稿实现。

页面区域

规则导航
编辑器
映射表
样本浏览器
测试摘要
版本历史
发布确认

用户动作

新建规则
编辑草稿
测试样本
切换 fixture
保存草稿
发布版本
回滚版本

必须状态

工作台就绪
模块数据加载
当前范围为空
部分 API 或依赖失败
页面读取失败
离线只读快照
操作权限不足
高影响操作确认
操作回执

数据契约

SourceRule
RuleRevision
SelectorSet
FieldMapping
ParserFixture
ParserTestResult
RulePublishReceipt

TARGET MODULES

目标页面必须交付的模块

01规则清单
02版本与草稿
03Selector 编辑
04字段映射
05断言
06输入/输出样本
07测试结果
08发布/回滚

PRODUCT ROUTE INDEX

采集后台 · 控制面的 30 个稳定 Screen ID

同一产品内的页面共享 token、导航和状态语言，但每个 Screen ID 保留自己的字段、数据契约和 QA 基线。

采集概览/admin/overview

Admin02

采集源管理/admin/sources

Admin03

运行日志/admin/logs

Admin04

素材资产/admin/media

Admin05

分类管理/admin/topics

Admin06

来源发现/admin/discovery

Admin07

采集规则/admin/rules

Admin08

采集策略/admin/settings

Admin09

备份恢复/admin/backups

Admin10

系统资源/admin/resources

Admin11

审计日志/admin/audit

Admin12

采集内容/admin/documents

Admin13

BBS 发帖候选/admin/bbs

Admin14

合规复核/admin/compliance

Admin15

公开 API 目录/admin/public-api

Admin16

采集运行总览与行动队列/admin/overview

Admin17

分类树、绑定与影响治理/admin/topics

Admin18

候选源发现、探测与接入判定/admin/discovery

Admin19

采集源注册表与责任详情/admin/sources

Admin20

解析规则 Studio 与样本验证/admin/rules

Admin21

三级策略、调度与容量模拟/admin/settings

Admin22

运行、阶段、事件与恢复探索器/admin/logs

Admin23

备份校验、恢复演练与故障域/admin/backups

Admin24

系统容量、Worker 与依赖健康/admin/resources

Admin25

不可变审计事件与对象差异/admin/audit

Admin26

文档索引、版本与来源快照/admin/documents

Admin27

BBS 候选审核、路由与发布回执/admin/bbs

Admin28

素材下载、解析与使用边界/admin/media

Admin29

来源政策证据与合规 Casework/admin/compliance

Admin30

公开 API 配置与消费者参考/admin/public-api

Admin

← 采集源注册表与责任详情三级策略、调度与容量模拟 →

解析规则 Studio 与样本验证

目标定义与下一轮逐页细化入口

页面区域

用户动作

必须状态

数据契约

目标页面必须交付的模块

采集后台 · 控制面 的 30 个稳定 Screen ID

采集后台 · 控制面的 30 个稳定 Screen ID