UI 蓝图/采集后台 · 控制面/文档索引、版本与来源快照

TARGETF4B2 PARTIALQA 0/5 VERIFIEDR10 · 11/21 PASS COMPLETEAdmin · 内容运营、数据质量、BBS 与 Portal 发布 owner

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

从文档表进入原始来源、版本、内容块、素材、hash、修订和下游状态的完整证据链

/admin/documentsdata-sources对照 CURRENT · data-documents →

R10 · KNIFE 11 / 21

文档索引、版本与来源快照 · 页面级细化任务包

把文档记录、来源、capture 时间、内容块、素材、hash、版本和下游状态接成证据链。

CURRENT ROUTE / API

/admin/documents · /admin/api/documents 401 · /api/v1/documents 200

WORK MODE

govern · K10

ENTRY

从公开 API、来源、运行、BBS 或素材进入。

SUCCESS OUTPUT

定位可验证快照，或为修订/删除返回影响与 receipt。

COMMAND MODEL

Source capture → snapshot hash → parser revision → document revision → downstream refs → governed mutation。

RESPONSIVE + A11Y

桌面索引 + 详情；手机先证据元数据，再正文/素材/版本页签。

TELEMETRY

document_view · revision_compare · document_command；正文不进 telemetry。

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
主干 admin documents 支持 detail/save/delete，公开 `/api/v1/documents` 可读；未登录 admin 详情与真实记录未知。

IMPLEMENTATION GAPTARGET CONTRACT

缺 immutable snapshot 与版本时间线语义证明
缺 parser/source revision 到文档 revision 的完整 provenance
缺删除对 BBS、搜索和公开 API consumer 的影响预览

135-STATE PROGRAM / THIS SCREEN

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

QA 0 / 5 VERIFIED

READYDocumentEvidence 当前契约可评审

DocumentEvidence workspace

R10-DOCUMENT-READY→ 查看 document endpoints

LOADING正在读取 DocumentEvidence

DocumentEvidence independent regions

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

EMPTY公开或认证范围内没有文档

DocumentEvidence result set

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

PARTIAL ERRORDocumentEvidence 部分来源不可用

DocumentEvidence evidence rail

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

ERRORDocumentEvidence 请求失败

DocumentEvidence request

R10-DOCUMENT-ERROR→ 安全重试

OFFLINE离线只读 · DocumentEvidence

DocumentEvidence redacted snapshot

R10-DOCUMENT-OFFLINE→ 重新连接

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

DocumentEvidence authorization

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

CONFIRM确认修订、重新解析或删除文档记录？

DocumentEvidence command impact

R10-DOCUMENT-CONFIRM→ 确认并提交

SUCCESS文档命令已返回 revision receipt

DocumentEvidence receipt

R10-DOCUMENT-SUCCESS→ 查看回执

UI STUDIOtarget-data-documents

Admin1440 × 900100%

100%

/admin/documents

TARGET UI1440 × 900FIT 100%

R10 DESIGN CANDIDATEtarget-data-documentsNO PRODUCTION BUSINESS FIXTURE

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

DOCUMENT EVIDENCE

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

把来源、capture、内容块、素材、hash、版本与下游状态接成证据链。

SOURCE + PRODcb37d2cexact match

ROUTE SHELLHTTP 200/admin/documents

BUSINESS APIHTTP 401/admin/api/documents

BOOTSTRAPlogin_requiredzero values are gated

PRODUCT QA0 / 5B3 0 · blueprint only

CURRENT CONTRACT生产访问与页面字段

200/admin/documentsSPA shell only

401/admin/api/documentsprotected

200/api/v1/documentspublic probe

来源/captureschema slotsnapshot hashschema slot正文块schema slot素材/版本schema slot

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

DOCUMENT IDSOURCESNAPSHOTDOWNSTREAM

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

TARGET IMPLEMENTATION下一阶段合同与门禁

01immutable snapshotNOT PROVEN
02provenanceNOT PROVEN
03版本时间线NOT PROVEN
04删除影响NOT PROVEN

ARCHITECTURE GAP

公开接口可达不等于 admin 记录已核验；不展示文档样例。

OWNER · Content Data

REFERENCE VIEWPORT1440 × 900Desktop first · responsive

PRIMARY TASK筛选文档主操作、权限与完成反馈必须同屏可验证

DATA CONTRACTDocumentRecordready / 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 之前，不得宣称页面已经可以照稿实现。

页面区域

文档索引
详情头
证据元数据
正文块
素材与版本 Tabs
下游状态
危险区

用户动作

筛选文档
打开详情
打开原始来源
比较版本
重新解析
进入素材
删除记录

必须状态

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

数据契约

DocumentRecord
DocumentSnapshot
DocumentRevision
ContentBlock
SourceEvidence
MediaBinding
DownstreamPublication
DocumentReceipt

TARGET MODULES

目标页面必须交付的模块

01文档检索
02版本时间线
03来源与 capture 时间
04快照 hash
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

← 不可变审计事件与对象差异 BBS 候选审核、路由与发布回执 →

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

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

页面区域

用户动作

必须状态

数据契约

目标页面必须交付的模块

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

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