77 lines
6.3 KiB
Markdown
77 lines
6.3 KiB
Markdown
# 兴邦预审 v2 UI Spec
|
||
|
||
状态：候选表面规格，生产UI尚未开发；Superdesign 原型单独见 [交互原型记录](12-prototype.md)，不以原型替代生产验收。输入：需求规格与详细设计草案。
|
||
|
||
## 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](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 阶段实施。
|