UI 蓝图/采集后台 · 控制面/素材下载、解析与使用边界

TARGETF4B2 PARTIALQA 0/5 VERIFIEDR10 · 11/21 PASS COMPLETEAdmin · 内容资产运营、采集值班和合规人员

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

统一原始链接、下载、解析、本地路径、使用限制、关联内容和失败重试，并保留未来资源服务边界

/admin/mediadata-sources对照 CURRENT · data-media →

R10 · KNIFE 11 / 21

素材下载、解析与使用边界 · 页面级细化任务包

统一原始链接、下载/解析、本地路径、使用限制、关联文档和失败恢复，同时显式保留资源服务边界。

CURRENT ROUTE / API

/admin/media · /admin/api/media/* 401 · /api/v1/media-assets 200

WORK MODE

operate · K10

ENTRY

从文档素材、失败任务或公开 media API 进入。

SUCCESS OUTPUT

完成重试/校验/关联变更并返回 MediaReceipt；删除动作单独确认。

COMMAND MODEL

Media reference → download attempt → parse → local ownership → usage policy → document binding → command receipt。

RESPONSIVE + A11Y

桌面状态摘要 + 清单 + 详情；手机以失败/受限优先，批量动作收起。

TELEMETRY

media_view · media_retry · media_delete；原始 URL query、本地绝对路径与正文脱敏。

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
主干有 media retry/batch/import/reconcile/disable/delete-local/unlink/delete/file；素材文件仍由 data-sources 本地目录拥有。

IMPLEMENTATION GAPTARGET CONTRACT

未迁移到 reits-media 统一 Asset/Blob/UsagePolicy 真值
缺下载/解析 attempt、hash 与引用计数稳定契约
缺删除本地文件、解除关联、删除记录的统一影响预览

135-STATE PROGRAM / THIS SCREEN

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

QA 0 / 5 VERIFIED

READYMediaAsset 当前契约可评审

MediaAsset workspace

R10-MEDIA-READY→ 查看 media ownership

LOADING正在读取 MediaAsset

MediaAsset independent regions

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

EMPTY公开或认证范围没有素材记录

MediaAsset result set

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

PARTIAL ERRORMediaAsset 部分来源不可用

MediaAsset evidence rail

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

ERRORMediaAsset 请求失败

MediaAsset request

R10-MEDIA-ERROR→ 安全重试

OFFLINE离线只读 · MediaAsset

MediaAsset redacted snapshot

R10-MEDIA-OFFLINE→ 重新连接

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

MediaAsset authorization

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

CONFIRM确认重试、解除关联、删除文件或删除记录？

MediaAsset command impact

R10-MEDIA-CONFIRM→ 确认并提交

SUCCESSMedia command 已返回逐项 receipt

MediaAsset receipt

R10-MEDIA-SUCCESS→ 查看回执

UI STUDIOtarget-data-media

Admin1440 × 900100%

100%

/admin/media

TARGET UI1440 × 900FIT 100%

R10 DESIGN CANDIDATEtarget-data-mediaNO PRODUCTION BUSINESS FIXTURE

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

MEDIA ASSET OPS

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

呈现原始引用、下载/解析、本地所有权、使用限制、文档绑定和失败恢复。

SOURCE + PRODcb37d2cexact match

ROUTE SHELLHTTP 200/admin/media

BUSINESS APIHTTP 401/admin/api/media/*

BOOTSTRAPlogin_requiredzero values are gated

PRODUCT QA0 / 5B3 0 · blueprint only

CURRENT CONTRACT生产访问与页面字段

200/admin/mediaSPA shell only

401/admin/api/media/*protected

200/api/v1/media-assetspublic probe

原始引用schema slothash/下载schema slot本地路径schema slotusage policyschema slot

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

ASSETDOWNLOAD / PARSEUSAGEBINDINGS

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

TARGET IMPLEMENTATION下一阶段合同与门禁

01Attempt schemaNOT PROVEN
02引用计数NOT PROVEN
03统一 Asset IDNOT PROVEN
04reits-media handoffNOT PROVEN

ARCHITECTURE GAP

文件仍由 data-sources 本地目录拥有；不得冒充统一资源真值。

OWNER · Media Operations

REFERENCE VIEWPORT1440 × 900Desktop first · responsive

PRIMARY TASK手动登记主操作、权限与完成反馈必须同屏可验证

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

页面区域

状态摘要
筛选与批量栏
素材清单
预览详情
来源/文档绑定
操作与回执

用户动作

手动登记
下载待处理
重试失败
重新校验
打开文件
解除关联
删除本地文件
删除记录

必须状态

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

数据契约

MediaAsset
DownloadState
ParseState
LocalPathState
UsageRestriction
DocumentMediaBinding
MediaCommand
MediaReceipt

TARGET MODULES

目标页面必须交付的模块

01素材 KPI
02网格/表视图
03下载与解析状态
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

← BBS 候选审核、路由与发布回执来源政策证据与合规 Casework →

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

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

页面区域

用户动作

必须状态

数据契约

目标页面必须交付的模块

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

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