6.3 KiB
兴邦预审 v2 UI Spec
状态：候选表面规格，生产UI尚未开发；Superdesign 原型单独见 交互原型记录，不以原型替代生产验收。输入：需求规格与详细设计草案。
1. 交付面与骨架
| 表面 | 区域 / 信息层级 | 消费契约 |
|---|---|---|
| 预审总览 | 项目与数据域→意见及缺证状态→主要问题→经验对照→证据抽屉 | ScreeningRun、Finding、Evidence |
| 历史过程 | 左：来源材料；中：争议/补件时间线；右：经验卡草稿与审核记录 | CaseTimeline、DecisionEvent、ExperienceCard |
| 推进沙盘 | 左：证据→动作→问题变化图；右：假设动作；底：真实与模拟差异 | Simulation、ScreeningRun |
| 验证看板 | 数据集版本/保留状态→对照指标→分歧案例→人工复盘 | Evaluation |
拟集成至 xingbang-workbench / review-workbench 的项目上下文，实际路由与组件拆分在 UI 实现前定案，不恢复已合并的旧页面。
2. 组件所有权
ProjectContext 拥有 project_id、data_domain 和当前 run_id；RunSummary 只展示运行结果；CaseTimelinePanel 拥有选中事件；EvidenceDrawer 拥有证据展开状态；ExperienceEditor 拥有草稿和 expected_revision；ScenarioPanel 拥有 assumptions，不能写真实项目事实；EvaluationPanel 拥有数据集选择，不能提前获得保留标签。
组件名为提案，尚未创建。URL 仅保存 project_id/run_id/tab 等非敏感可分享状态；身份令牌、材料文本和假设正文不放 URL。切换项目清空选中证据与模拟动作。
3. 状态机
| 状态 | 可见内容 | 允许动作 / 禁用动作 |
|---|---|---|
| idle | 项目说明与启动入口 | 有权限可发起；无项目不发请求 |
| loading | 对应区域骨架与加载文案 | 可退出；禁重复提交 |
| ready | 已获数据与版本信息 | 按权限操作 |
| empty | “尚无历史经验”或“尚无运行”及下一步 | 可导入/发起；不能绘制虚构节点 |
| error | 错误码映射的文案、请求编号和恢复入口 | 仅可恢复错误显示重试 |
| submitting | 保留原内容，显示提交中 | 禁二次提交；不清除草稿 |
| stale（ready 附加标识） | “项目已有新版本，当前为历史结果” | 可查看/新运行；禁止覆写旧结果 |
业务运行 queued/running/awaiting_input/completed/partial/failed/cancelled 单独展示；partial 必须突出未完成项。更新失败时回 ready/error 且保留草稿，版本冲突提示刷新后合并。
4. 动作与权限
| 动作 | 客户经理 | 评审员/发布人 | 管理员 | 只读访客 |
|---|---|---|---|---|
| 查看项目结果和证据 | 授权项目 | 授权范围 | 授权范围，非默认全量 | 仅指定演示项目 |
| 确认材料、发起预审 | 项目授权 | 项目授权 | 不自动继承业务权限 | 隐藏 |
| 模拟动作 | 项目授权 | 项目授权 | 项目授权 | 仅演示授权 |
| 编辑经验候选 | 提议权限 | 编辑权限 | 不自动继承 | 隐藏 |
| 审核发布/撤回 | 隐藏 | 独立发布资格且不可自批 | 治理授权后 | 隐藏 |
| 修改模型出口与数据域 | 隐藏 | 隐藏 | 策略管理资格 | 隐藏 |
| 揭示保留集结果 | 隐藏 | 指定验证负责人且预测已锁定 | 不因管理员身份自动开放 | 隐藏 |
后端始终重验权限。无权限动作不显示控件；有权限但条件未满足显示禁用原因。经验发布前展示范围、例外、有效期和变更差异；撤回说明新运行不再使用、历史引用保留。
5. 沙盘视觉规则
证据→动作→受影响问题→预审意见；线宽最多三档，对应已定义影响等级，不能直接代表概率提升。未验证假设使用虚线和“模拟”文字；真实核验使用实线及来源。通过点击/键盘打开依据，颜色不单独传意。
一次只突出当前选中问题的关联路径，其他弱化；未知项不伪装为否定。补件可能发现新风险，允许意见变得更谨慎。图旁提供等价列表，缩小窗口时改纵向排列，不依赖复杂图才能理解结果。
P0 顶部不显示百分比“通过率”。展示 recommendation、missing_inputs、degradations 和数据域/版本；不凭空生成完整度或置信度数字。评分若后续加入，须另有明确算法和契约。
6. 文案与视觉
DESIGN.md 管理语义 token 候选。新增文案拟 key 化：prescreen.result., prescreen.error., experience.status., simulation., evaluation.；每个错误 key 对应规格 E-，中英文范围在 UI 门禁前确定。当前无对应 i18n 实现，不伪称可用。
正文按现有 16px 基线，主动作可键盘访问；可见 focus、表单 label、错误定位、减少动效、文本与图的等价表达。长标题换行，证据抽屉不截断关键原文。产品页面默认不暴露 question_version 等实现细节，只在“依据与版本”展开。
7. 验收映射与未决
来源点击与权限 AC-01/08；未知时间 AC-02；经验审核 AC-03/04；降级 AC-07/09；模拟隔离 AC-11；无伪概率 AC-12；盲测标签 AC-15。
UI 门禁尚未通过：路由位置、统一 token 实现、i18n 文件、视觉稿、键盘和对比度验收待完成。截图自评不能单独算通过，应有可复现的 DOM/行为断言及独立评审记录。
8. 专项判断选项（候选）
预审发起表单增加“专项核查”：关闭 / 本地模型 / Jev 官方服务；实际选项来自后端授权配置（JudgmentProfile），不能只按品牌静态显示可用。用户看到模型名称、提供方和可用状态；配置 ID/修订和供应商指标放“依据与版本”。管理员在部署配置中管理端点和凭据，P0 不新增在线编辑密钥页面。
无 Jev Key 时 Jev 配置不进入可选列表；本地可用则可选择本地。没有可用配置时仅保留关闭并说明未配置。业务请求只传 judgment_profile_id，不传 URL 或 Key；后端重新校验，失败按 E-13 显示。提交中禁改本次选择，运行结束或排队后修改选择均需发起新运行。
结果展示本次实际提供方、未完成题目和拒答/unknown；关闭显示“专项核查已关闭”。失效/超时不把选中项悄悄变为另一个模型，不展示占位高分。对应 AC-17/18/19/20/21；页面路由及真实交互待 UI 阶段实施。