docs/v2/12-prototype.md

# 兴邦智审 v2 · Superdesign 交互原型

日期：2026-09-28。目标：验证视觉风格、信息层级与核心操作，不代表新版业务功能已实现。

## 用户已选方向

深色导航＋浅色工作区；高端大气、直观易用、有科技感。以深绿导航、白色证据面板和精确的关系图呈现金融评审工作台。首屏先回答“当前建议是什么、依据是什么、下一步做什么”。

## 原型范围

一个连通的项目工作台：综合预审、历史经验、推进沙盘通过页签切换。证据抽屉展示原文与缺证，补件清单弹窗说明具体材料。模型选项展示本地开源模型（演示）、Jev（未配置）和关闭。正式审批不纳入原型操作。

虚构企业与项目：恒远精密设备有限公司 / DEMO-026；3,000万元、36个月及全部材料数量均为演示数据。主审意见为“补充材料后再判断”，不展示未经校准的真实通过概率；按用户新增要求，原型可展示明确标记且与真实结果字段隔离的演示概率，见 [概率与沙盘设计](13-probability-prototype.md)。

## 状态与交互约束

- 综合页：结论、两项重点问题、证据关系和下一步；来源节点可展开，关闭抽屉返回原位置。
- 历史经验：问询→补件→证据变化→历史意见，显示适用条件与例外；相似不直接导出相同结论。
- 推进沙盘：选择假设补件→即时比较概率、原因与待核实事项；持续标记假设条件，返回真实预审后原意见不变。
- 模型选择：本地仅演示，Jev未配置不可调用，关闭保留主审意见及缺失专项提示；切换不能伪称已连接模型。
- 补件清单：打开/关闭、可复制内容；不提供伪造的报告下载。
- 验证入口：只展示待开展的对照方案，不展示虚构准确率。

## 原型验收（与生产验收分开）

| ID | Given / When / Then | 需求关联 |
|---|---|---|
| P-01 | Given 演示项目，When 打开首页，Then 首屏显示预审意见、关键依据、下一步及演示标识 | AC-05/07/12 |
| P-02 | Given 一条问题，When 点击证据，Then 可读原文、定位和缺失项，关闭后回到原页面 | AC-08 |
| P-03 | Given 历史案例，When 切换历史经验，Then 看到问询/补件/判断变化与适用例外 | AC-02/04 |
| P-04 | Given 模拟补件，When 勾选假设并返回真实预审，Then 原意见未变，模拟结果有持续标识 | AC-11 |
| P-05 | Given 模型选项，When 选择关闭，Then 显示未执行专项核查；Jev未配置不可调用 | AC-17/21 |
| P-06 | Given 补件需求，When 生成清单，Then 可查看具体材料要求，无虚假的后端完成状态 | AC-07 |
| P-07 | Given 桌面/窄屏和键盘操作，When 阅读及展开界面，Then 正文无裁切、可见焦点、可退出弹层 | NFR-04 |

新增原型验收（用户新增概率可视化要求）：

| ID | Given / When / Then | 需求关联 |
|---|---|---|
| P-08 | Given 未校准的演示项目，When 看首页，Then 42%紧邻演示标识和人为设定说明，真实probability仍为空 | AC-12 |
| P-09 | Given 四种复选框组合，When 勾选/取消，Then 无需运行按钮即可得到42/58/51/64及0/16/9/22个百分点 | 概率与沙盘设计第2节 |
| P-10 | Given 多选与再次取消，When 比较，Then 组合结果不作简单相加，原因与剩余事项同步更新 | AC-11 |
| P-11 | Given 概率展示，When 查看依据，Then 看到数据卡/Skills/经验/规则及示例标识，并知道数字来自演示表 | AC-08/12 |
| P-12 | Given 模拟或关闭专项核查，When 返回综合预审，Then 基线42%与原意见不变；模型选项不会伪造概率变化 | AC-11/21 |
| P-13 | Given 窄屏，When 查看概率和比较，Then 数字/演示提示/原因完整可读，无横向裁切 | NFR-04 |

## 设计工具与数据边界

使用用户指定的 Superdesign，设计模型 Gemini 3.1 Pro。仅上传本轮独立编写的概念说明与虚构内容；上传现有前端源码的操作被自动审批拒绝，随后改用不含源码的概念设计。原项目源码不作为本次生成载荷。六份源码分析文件仅留本地供设计人员理解，不声称外部设计已与现有组件逐像素一致。

持久设计上下文及原型标识放 .superdesign/resume.json；临时生成日志/HTML在 .superdesign/tmp/，验证证据在 test-evidence/20260928-superdesign-prototype/。不修改现有应用路由、业务逻辑或部署。

## 实施边界

原型页面上的交互使用演示状态。源代码实现仍按 M3/M4 和项目流程落地；设计稿存在不证明接口、模型调用、权限或效果成立。视觉审阅与实际业务验收分别记录，不将作者目测称为独立验收。

## 已交付原型与检查

- [可点击预览](https://p.superdesign.dev/draft/7484f5c4-0415-4a87-a772-c42339680737)。
- [Superdesign 画布](https://superdesign.dev/teams/657ee591-1f83-46ec-8917-918dec0f0d4b/projects/88a8388d-b079-4118-833b-c8b396bf346f)。
- [本地 HTML](prototypes/prescreen-workbench.html) / [首页截图](prototypes/prescreen-overview.png)。HTML使用公开CDN样式和图标，首次打开需要网络。

首轮草稿 7484f5c4-0415-4a87-a772-c42339680737 保存为版本2（历史记录）。初稿由 Superdesign Gemini 3.1 Pro 生成，随后在同稿内直接补齐确定的交互、响应式和文案缺口；未额外生成视觉变体。云端回读HTML与本地已验文件一致；入库HTML仅清理3处行尾空白，内容与行为保持一致。

导出原型的20项行为检查通过：证据抽屉/关闭焦点、历史经验、空模拟守卫、假设结果与真实基线隔离、Jev禁用、本地/关闭切换、补件与验证弹窗、1440/1024/390三种宽度无文档横向溢出、移动导航及无运行脚本错误。首轮移动导航关闭失败，原因与修复留在fix-record.md，复验保留独立截图。同样20项检查在Superdesign线上预览再次通过，证据在remote-check-03/interaction-checks.json。

检查边界：使用独立无头浏览器验证演示状态；内置浏览器连接因本机环境故障未成功。作者截图自查不等于独立视觉评审；未完成全量无障碍审计，未连接业务接口或真实模型。首轮为设计文档交付，未重跑旧版套件；本次概率交互增量另按行为改动运行统一验证，结果见后续记录。

## 2026-09-29 概率沙盘增量交付

同一草稿更新为版本4。综合页显示42%演示基线；沙盘勾选与取消立即更新42/58/51/64、百分点、变化原因和待核实事项。依据抽屉串联数据卡、Skills、历史经验和规则，并明确概率数字来自人工情景表。缺证的规则状态为待核实，不视为通过。模型选择与模拟均不修改原项目结论。

- [概率首页截图](prototypes/prescreen-probability-overview.png) / [沙盘对照截图](prototypes/prescreen-probability-simulation.png)。首轮截图保留，不覆盖。
- [浏览器回归脚本](prototypes/check-probability.cjs)：需要Playwright与Chromium；可通过CHROMIUM_PATH指定浏览器，通过PROTOTYPE_URL选择线上预览，通过EVIDENCE_DIR指定新证据目录。默认检查旁边的HTML，不调用业务API。
- 本地与Superdesign实际预览分别通过74项断言，覆盖P-01–13的本次相关交互：四种组合、正反选择顺序、取消还原、即时原因、人工概率来源、基线隔离、提供方切换、原有弹窗/经验/导航，以及1440/1024/390宽度。
- 完整计划、交互日志及截图：test-evidence/20260929-probability-prototype/。浏览器检查不等于独立视觉验收或真实概率效果验证。
- 使用backend/venv运行scripts/verify.py，9项检查全部通过：后端单测、4项UI守卫、前端构建、2项Compose配置与diff。证据：test-evidence/20260929-003310-e2883bb/REPORT.md。运行基于e2883bb及本次未提交原型；最终HTML哈希与绑定说明见本次证据manifest.json。
- 云端回读版本4与入库HTML仅CRLF/LF换行不同；两端行为测试通过。中断前生成稿缺失即时原因更新、将缺证规则误写为通过，两项均在导入版本4前修正。

本次按原型交互轻量路径记录，沿用AC-08/11/12/21和P-01–13，补充设计与测试；没有越过业务实现门禁。交付为原型及文档备份，没有修改现有src/backend业务代码、没有合并main、没有发布镜像。真实概率仍待审批事件定义、历史数据验证与校准。

远程备份状态（2026-09-29）：已配置origin在SSH握手阶段关闭连接，重试与只读诊断均复现。本次增量先保存本地提交，Gitea远端SHA未核验，不能标记本次已远程备份。此前已核验的备份不受本地提交影响。日志在test-evidence/20260929-probability-prototype/gitea-connection.log。

## 2026-09-29 六维雷达与解释链增量

同一Superdesign草稿现为版本6。新增首页概率环、六维证据阶段雷达、可点击维度与等价按钮、数据卡→Skill→授权只读Tools→Rules→经验的具体追溯。新增概率出处抽屉：区分当前人工DEMO-TABLE-v1与未来真实估计/校准链路。沙盘只改变所选回款/权属轴，基线虚线保持不变；出处抽屉同步高亮所选00/10/01/11与42/58/51/64结果。

- [雷达首页](prototypes/prescreen-radar-overview.png) / [沙盘叠图](prototypes/prescreen-radar-simulation.png)；旧截图保留。
- 新增P-14–17详见[概率设计第6节](13-probability-prototype.md)，沿用BR-09/12/13与AC-08/11/12/13/21。
- 新增[雷达测试](prototypes/check-radar.cjs)由[原型回归入口](prototypes/check-probability.cjs)调用。本地与线上各163项断言通过：六维键盘/图轴点击、来源映射、四种情景、未选轴不变、主结果隔离、响应式与既有交互。
- 项目统一验证9项通过：test-evidence/20260929-010559-1351dd0/REPORT.md。执行期间仅补充手机SVG字号与测试，未改变业务源码；最终原型在local-final和remote-final重跑全部相关浏览器断言。完整日志、计划、图片与最终摘要位于test-evidence/20260929-radar-prototype/。
- 生成稿曾遗漏首页雷达/维度动作，并将维度误换为信用属性；已按确定规格补齐。手机图内文字缩放过小，放大后重新验证。测试与截图不等于独立视觉审核或真实模型准确性验收。
- 第6版云端回读与本地HTML仅换行风格不同。现有业务src/backend及部署未改；不越过业务实现门禁。

Gitea连接仍在SSH握手阶段被远端关闭，本次先保存本地提交，远程备份未完成。设计服务上的原型已更新；这与Gitea源码备份是不同边界。