diff --git a/.gitignore b/.gitignore index a60131c..57e16bc 100644 --- a/.gitignore +++ b/.gitignore @@ -77,3 +77,8 @@ nul deploy/*.env server-deploy.conf ori_file/ + +# Superdesign temporary exports and generation logs +.superdesign/tmp/ +# Regenerable local UI discovery cache (contains source copies) +.superdesign/init/ diff --git a/.superdesign/concept-design-system.md b/.superdesign/concept-design-system.md new file mode 100644 index 0000000..d74e709 --- /dev/null +++ b/.superdesign/concept-design-system.md @@ -0,0 +1,25 @@ +# 兴邦智审 v2 · 独立概念原型视觉说明 + +这是为用户本次原型请求新写的设计说明,不包含现有源码、真实客户资料或内部部署信息。用户希望高端大气、直观、科技感,并已选择深色导航+浅色工作区。 + +## 设计系统(全部为本原型拟定值) +深绿导航 #102B27;导航选中 #244D41;导航浅色文字 #F3F7F5,次级 #B1C6BE。主工作区 #F3F5F4;卡片 #FFFFFF;浅面板 #F8FAF9;边线 #DCE4DF。主要正文 #182D26;次级 #52675C;注释 #64766C。主按钮 #17634C,悬停 #124F3D,白色文字。警示文字 #805418 配 #FBF2DF;风险 #A33C38 配 #FBEFEC;技术关系线 #226A7A 配 #EDF5F7;正常状态 #17634C 配 #EAF3EC。仅使用这些颜色与其透明度变体。 +中文系统无衬线 Microsoft YaHei/PingFang SC,正文16px,标签14px,元信息12px最低,栏目20px,主标题28px,结论24px。间距4/8/12/16/20/24/32/40/48px。面板圆角12px,按钮8px,标签胶囊;细边线,阴影0 4px 20px rgba(16,43,39,.04)。按钮高44px。 +1440x1000桌面画布;导航216px,正文边距32px,内容左右主栏与320px动作侧栏,间隔24px;1100px以下侧栏折叠为纵向,768px以下导航变菜单。克制、留白、清晰金融研究台。用可点击证据关系图体现科技感;不做营销首页,不放炫光大脑或装饰大图,不放虚构概率仪表盘。 +正文判断优先于数字;颜色同时有文字/图标。focus2px outline;动效160–200ms,支持reduced-motion。抽屉关闭键/Escape/焦点返回。品牌只写 兴邦金租 / 智审工作台,没有官方图片标识,不发明logo。 + +## 产品内容(虚构演示) +单项目预审工作台:主审Agent综合证据和历史经验,专项模块可选择本地模型/Jev/关闭,正式审批属于人工流程。 +示例企业 恒远精密设备有限公司(虚构);项目DEMO-026,设备直租,融资3,000万元,36个月,装备制造。主审意见 补充材料后再判断;解释 经营现金流与回款说明存在待核实差异,建议先补齐两项关键证据,再推进评审。引用6份材料、参考3条经验、2项待补充均为演示数量,不显示任何百分比。 +持久提示 原型演示 · 未连接真实数据与模型。所有材料、判断、数值为虚构演示。综合意见不是正式审批意见。 + +## 页面层级和交互 +侧栏:项目预审、历史经验、推进沙盘、验证看板;底部演示评审员。 +顶部项目编号和演示提示,项目标题及融资事实一行。主按钮生成补件清单,次按钮模拟补件。首屏大结论模块,然后证据关系图:回款说明→账期变化解释→专项支持不足→主审补件建议;线条和节点克制精确,每个节点可点开依据。 +正文页签 综合预审 / 历史经验 / 推进沙盘;右侧 下一步行动 列补充银行流水、核实设备权属。下方两条问题 回款依据尚不完整 / 设备权属证明待核实,每项可看证据和历史依据。 +证据抽屉:回款说明.pdf第3页,虚构原文 主要客户账期延长,预计下一季度集中回款;缺证 未提供对应银行流水。抽屉切换原文片段/判断依据。 +历史经验页签:初审关注现金流→问询账期原因→补齐银行流水/应收账龄→历史意见由待核实转为附条件推进。经验适用条件 客户结构稳定且回款可逐笔匹配;例外 收入集中或关联回款未穿透。提示 条件相似不等于结论相同。 +推进沙盘页签:勾选补充近六个月银行流水、补充设备权属证明→运行模拟→对比原本2项待核实与假设完成后变化。明确 假设证据真实且完成核验;仍需人工复核;模拟结果,不改变真实项目。有返回真实预审,禁止写通过率提升。 +专项模型选择:本地开源模型(演示)默认;Jev官方服务(未配置)禁用且说明;关闭可选,选后显示专项核查已关闭,主审仍可基于证据与经验给出有限意见。禁止输入密钥/地址,无真实模型请求。 +生成补件清单打开含两项具体补件的弹窗,可复制文本。不做假的下载。验证看板入口打开待开展脱敏盲测说明,列基线/本地专项/Jev可选对照,不能编准确率。 +按钮、页签、导航、菜单均须有行为或清楚禁用。只生成一个连通的高保真原型,所有状态本地模拟。 diff --git a/.superdesign/design-system.md b/.superdesign/design-system.md new file mode 100644 index 0000000..0b24422 --- /dev/null +++ b/.superdesign/design-system.md @@ -0,0 +1,5 @@ +# Superdesign 设计上下文入口 + +当前兴邦 v2 原型的完整视觉系统是 [concept-design-system.md](concept-design-system.md)。用户已选深色导航+浅色工作区。 + +继续设计以 resume.json 中保存的 contextFiles 和 designSystemPath 为准,只使用独立编写的概念说明。不得自动加入现有源码;此前源码上传被自动审批拒绝。 diff --git a/.superdesign/resume.json b/.superdesign/resume.json new file mode 100644 index 0000000..408ae33 --- /dev/null +++ b/.superdesign/resume.json @@ -0,0 +1,27 @@ +{ + "schemaVersion": 1, + "targets": { + "xingbang-v2-prescreen": { + "targetKind": "new-ui", + "projectId": "88a8388d-b079-4118-833b-c8b396bf346f", + "activeDraftId": "7484f5c4-0415-4a87-a772-c42339680737", + "designSystemPath": ".superdesign/concept-design-system.md", + "referenceIds": [], + "contextFiles": [ + ".superdesign/concept-design-system.md" + ], + "fingerprints": { + ".superdesign/concept-design-system.md": "ce41609cd6186253f129b9ae6c90e465c4303b260ef88aeb431c9363c2a5f623" + }, + "components": [], + "drafts": { + "7484f5c4-0415-4a87-a772-c42339680737": { + "title": "兴邦金租智审工作台", + "visualDirection": "深色导航+浅色工作区;深绿金融评审风格", + "currentVersion": 2 + } + }, + "updatedAt": "2026-09-28T09:46:39.856342+00:00" + } + } +} \ No newline at end of file diff --git a/docs/v2/04-ui-spec.md b/docs/v2/04-ui-spec.md index 7490d81..113d74f 100644 --- a/docs/v2/04-ui-spec.md +++ b/docs/v2/04-ui-spec.md @@ -1,6 +1,6 @@ # 兴邦预审 v2 UI Spec -状态:候选表面规格,未开发、未做浏览器验收;不把本文件当作可点击原型。输入:需求规格与详细设计草案。 +状态:候选表面规格,生产UI尚未开发;Superdesign 原型单独见 [交互原型记录](12-prototype.md),不以原型替代生产验收。输入:需求规格与详细设计草案。 ## 1. 交付面与骨架 diff --git a/docs/v2/12-prototype.md b/docs/v2/12-prototype.md new file mode 100644 index 0000000..ca9d7bd --- /dev/null +++ b/docs/v2/12-prototype.md @@ -0,0 +1,56 @@ +# 兴邦智审 v2 · Superdesign 交互原型 + +日期:2026-09-28。目标:验证视觉风格、信息层级与核心操作,不代表新版业务功能已实现。 + +## 用户已选方向 + +深色导航+浅色工作区;高端大气、直观易用、有科技感。以深绿导航、白色证据面板和精确的关系图呈现金融评审工作台。首屏先回答“当前建议是什么、依据是什么、下一步做什么”。 + +## 原型范围 + +一个连通的项目工作台:综合预审、历史经验、推进沙盘通过页签切换。证据抽屉展示原文与缺证,补件清单弹窗说明具体材料。模型选项展示本地开源模型(演示)、Jev(未配置)和关闭。正式审批不纳入原型操作。 + +虚构企业与项目:恒远精密设备有限公司 / DEMO-026;3,000万元、36个月及全部材料数量均为演示数据。主审意见为“补充材料后再判断”,不展示未经校准的通过概率。 + +## 状态与交互约束 + +- 综合页:结论、两项重点问题、证据关系和下一步;来源节点可展开,关闭抽屉返回原位置。 +- 历史经验:问询→补件→证据变化→历史意见,显示适用条件与例外;相似不直接导出相同结论。 +- 推进沙盘:选择假设补件→运行模拟→比较变化;持续标记假设条件,返回真实预审后原意见不变。 +- 模型选择:本地仅演示,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 | + +## 设计工具与数据边界 + +使用用户指定的 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。 + +检查边界:使用独立无头浏览器验证演示状态;内置浏览器连接因本机环境故障未成功。作者截图自查不等于独立视觉评审;未完成全量无障碍审计,未连接业务接口或真实模型。现有生产源码不变,不重跑与此次原型无关的旧版应用套件。 diff --git a/docs/v2/DESIGN.md b/docs/v2/DESIGN.md index 70893b9..01c820e 100644 --- a/docs/v2/DESIGN.md +++ b/docs/v2/DESIGN.md @@ -59,3 +59,7 @@ RunSummary、EvidenceDrawer、CaseTimelinePanel、ExperienceEditor、ScenarioPan ## 缺口与门禁 needs-design-decision:完整状态色、间距尺度、响应断点、组件状态 token;owner 前端负责人;needed-by UI 实现前。需要 token 导出检查、对比度测试、键盘测试及文案 key 检查,结果纳入 test-evidence。 + +## 2026-09-28 原型方向补充 + +用户已选“深色导航+浅色工作区”。Superdesign 原型采用深绿导航、浅灰工作背景和白色证据面板,通过关系图与克制动效体现科技感。具体候选颜色、间距及交互在 .superdesign/concept-design-system.md;记录与验收见 [交互原型](12-prototype.md)。这些为原型设计决策,尚未写入生产CSS,以上已观察值的事实状态不变。 diff --git a/docs/v2/README.md b/docs/v2/README.md index 8b65067..ae0032e 100644 --- a/docs/v2/README.md +++ b/docs/v2/README.md @@ -20,6 +20,7 @@ | [架构](02-architecture.md) | 已有能力、目标边界、职责与 ADR | | [详细设计](03-detailed-design.md) | 候选接口、数据契约、状态、失败处理 | | [专项判断模型切换](11-judgment-providers.md) | 无 Jev Key 的本地路径、统一契约、能力差异与切换验收 | +| [交互原型](12-prototype.md) | Superdesign 视觉方向、演示范围与原型验收 | | [UI Spec](04-ui-spec.md) | 页面骨架、状态、权限和演示交互 | | [设计契约](DESIGN.md) | 已观察视觉来源、语义 token 提案及缺口 | | [实施计划](05-implementation-plan.md) | 核心代码迁移与分批交付 | diff --git a/docs/v2/prototypes/prescreen-overview.png b/docs/v2/prototypes/prescreen-overview.png new file mode 100644 index 0000000..826042e Binary files /dev/null and b/docs/v2/prototypes/prescreen-overview.png differ diff --git a/docs/v2/prototypes/prescreen-workbench.html b/docs/v2/prototypes/prescreen-workbench.html new file mode 100644 index 0000000..1c66080 --- /dev/null +++ b/docs/v2/prototypes/prescreen-workbench.html @@ -0,0 +1,431 @@ + + + + + +兴邦金租 - 智审工作台 + + + + + + + +
+ + + +
+ +
+
+ +原型演示 · 未连接真实数据与模型。所有材料、判断、数值为虚构演示。综合意见不是正式审批意见。 +
+
+ + + 演示评审员 + +
+
+ +
+ +
+ +
+
+

恒远精密设备有限公司

+项目 DEMO-026 +
+
+ + + 设备直租 + + + + 融资 3,000 万元 + + + + 36 个月 + + + + 装备制造 + +
+
+ +
+
+
+

主审意见:补充材料后再判断

+

+ 经营现金流与回款说明存在待核实差异,建议先补齐两项关键证据,再推进评审。 +

+
+
+ +
+
+
+
+引用材料 +6 份 +
+
+参考经验 +3 条 +
+
+待补充项 +2 项 +
+
+
+ +
+
+ + + +
+ +
+ +
+

+ + 证据关系图 +

+ +
+ + + + + + + + + +
+
+ + +
+ + +
+
+ 主审补件建议 +
+
+
+ +
+

关键问题核实

+
+
+
+
+
+

回款依据尚不完整

+待核实 +
+

主要客户账期延长,需通过近六个月银行流水穿透核实实际回款情况,当前证据链断裂。

+
+ +
+
+
+
+
+
+
+

设备权属证明待核实

+待核实 +
+

拟租赁设备发票与实际采购清单存在部分品名不符,需核实底层资产真实权属。

+
+ +
+
+
+
+
+
+ + +
+
+ + +
+
+ +
EVIDENCE / 演示材料

回款说明与判断依据

+
+

回款说明.pdf · 第3页 · 虚构演示

主要客户账期延长,预计下一季度集中回款。
尚未提供对应银行流水,不能仅凭解释确认回款。

来源可定位不代表材料真实性已经核验。

+ +
+
NEXT ACTION / 演示清单

项目补件清单

  1. 近六个月银行流水与应收账龄

    标注主要客户逐笔回款,说明与合同账期的对应关系。

  2. 设备权属材料

    提供采购合同、发票和设备清单,并解释品名差异。

DEMO-026 · 虚构演示,未发送至任何业务系统。

+
VALIDATION / 验证计划

待开展脱敏盲测

先冻结样本和预测,再揭示专家参考意见。当前没有真实验证结果。

  1. 基础预审:不使用历史经验
  2. 经验增强:主审结合已审核经验
  3. 专项增强:分别验证本地模型与 Jev(可选)
关注重大问题漏检、无依据结论、有效补件与耗时。阈值在试点前约定。
+
+