Files
ssw-mvp/docs/e2e/sswflow
admin dd77057371 feat: web 品牌统一为尚数网可信数据空间平台 + 修复连接器审批超时 + 纳入金融风控 demo
- web: 登录页/顶栏/标题统一为「尚数网可信数据空间平台」,下载官方 logo 到 public/ssw-logo.png(white 版配深色底托);子系统名(TDS/TDC/FLOW)保留
- docs/e2e/dag-panel: 修复 connector_onboard_pair 节点卡在连接器审批——ConnectorManage.vue 行内按钮 label 为「通过」(弹窗 title 才是审批通过),rowAction 改为按「通过」匹配并加 API 兜底审批,避免链路卡死
- docs/e2e/sswflow: 纳入金融风控演示源码(README/demo-risk-control.mjs/run.sh/启动器),运行产物 results/ 按 docs/e2e/results 约定排除
- .gitignore: 补充 docs/e2e/sswflow/results/ 忽略规则
- .workbuddy/memory: 补充本日工作记录

注:上次排除的 docs/e2e/sswflow 按"所有修改"本次一并纳入源码;其 results/ 运行产物按团队约定不入库。
2026-08-11 18:56:18 +08:00
..

金融联合风控 · SSWFlow 自动化演示

在 SSWFlow(隐私计算流程编排子系统) 里,端到端演示一个金融风控场景的自动化脚本。 放在 docs/e2e/sswflow/,复用 docs/e2e 测试台同一套底座(fixtures / 登录 / 服务编排 / 浏览器驱动)。

场景

消费金融公司想给客户做信用评分,但自身样本薄;它联合两方做纵向联邦建模:

参与方 角色 持有数据
零售银行信贷部 数据提供方(标签方) 账户还款行为 + 12 个月违约标签
持牌征信机构 数据服务方(特征方) 外部征信评分 + 多头借贷指标
消费金融风控中心 数据使用方 发起方 & 评分卡结果接收方

三方都不愿把原始数据交出去 → 用隐私计算「数据可用不可见」地联合建模。

演示链路

三方入场 → 项目组建 → 数据集登记 → 授权投票放行
  → 画布编排(PSI 求交 → 训练/测试拆分 → 纵向 LR → 打分 → KS/AUC 评估 → 评分卡出域)
  → 真实 Nax 引擎执行 → 指标报告(命中行数 / AUC / KS / 准确率)

数据是 真的(fixtures/ 下两份带业务因果的 CSV,违约率 ~10.6%),计算也是 真的 (NaxComputeEngine 起 Python 子进程用 pandas/numpy 实算 PSI / 纵向 LR / 打分 / KS·AUC,不是模拟兜底)。 断言的是算出来的指标,不是脚本里写死的期望值。

运行

# 前置:后端 30000 与前端 5173 在跑(脚本会自动探针并按需拉起后端;已有实例则复用,绝不重启)
cd docs/e2e/sswflow

node demo-risk-control.mjs                 # 无头:API 直通真实计算,出控制台 + JSON + HTML 报告
node demo-risk-control.mjs --ui            # 额外用 Chrome 打开 FlowEditor,真实点击「▶ 运行」演示
node demo-risk-control.mjs --baseline      # 额外跑「银行单方基线」并对比联合建模提升幅度
node demo-risk-control.mjs --regen-fixtures# 先用 gen_riskctrl_data.py 重新生成两份 CSV
node demo-risk-control.mjs --no-services   # 不自动拉起后端/前端(假定已在运行)
node demo-risk-control.mjs --backend http://x:30000 --frontend http://x:5173 --account admin --password 123456

或双击 金融风控演示.command(macOS) / run.sh(终端)一键启动。

输出

运行后在 docs/e2e/sswflow/results/ 下生成:

  • risk-control-<时间戳>.json —— 完整过程与指标(可被其他脚本消费)
  • risk-control-<时间戳>.html —— 自包含可视化报告:参与方、DAG 流水线、真实指标、引擎日志、(UI 模式下)浏览器截图
  • results/shots/*.png —— UI 演示截图(仅 --ui)

与测试台的关系

  • 金融风控场景装置在 ../lib/riskctrl.mjs(三方 / 项目 / 数据集 / 画布 / 运行),本脚本直接复用,不重复造数据。
  • 单条用例版的同款链路见 ../cases/TC-FLOW-006.mjs(被测评执行台收录)。
  • 浏览器驱动沿用 ../lib/browser.mjs(playwright-core + 本机 Chrome)与 ../lib/human.mjs(贝塞尔移动 / 字符级输入), 与 ../dag-panel/dag-panel.mjs 多用户面板演示同源。

关键接口(脚本实际打的后端端点)

步骤 端点
机构入场 POST /api/ssw/sswflow/Party · POST /api/ssw/sswflow/Project · POST /api/ssw/sswflow/Project/{id}/Party
数据集 POST /api/ssw/sswflow/Dataset · POST /api/ssw/sswflow/Dataset/{id}/Auth · 逐方 Vote
画布 POST /api/ssw/sswflow/Flow · PUT /api/ssw/sswflow/Flow/{id}/Canvas · POST /api/ssw/sswflow/Flow/{id}/Validate
执行 POST /api/ssw/sswflow/FlowRun/Start · GET /api/ssw/sswflow/FlowRun/{id} · /Events · /Artifacts

后端必须宿主机网络启动(端口固定 30000,Redis DB=8),否则连不上 192.168.97.0/24 上的 PG/Redis。

UI 模式与前端编译错误的坑

--ui 模式用浏览器打开 web/(默认 http://localhost:5173)的 FlowEditor 真实点击「▶ 运行」。脚本内置三重防护,页面若存在编译/运行时错误覆盖层(如 Vite already been declared、compiler-sfc、Failed to resolve import),会直接判定 UI_FAIL 而不是假通过:

  • 进入画布前、画布渲染前、点击运行后各检查一次错误覆盖层(.vite-error-overlay + console/pageerror 报错 + 错误文本);
  • 命中即 fail() 并终止 UI 演示,报告显式红卡标注「UI 演示失败」,整体 verdict 置为 UI_FAIL。

前端偶发整屏编译错误(Vite 错误遮罩):通常是 web/node_modules/.vite 的 HMR 缓存损坏导致,不是源码 bug(如 App.vue 的 onUserMenu 源码经 compiler-sfc 编译确认无重复声明)。处理:删 web/node_modules/.vite 并重启 web dev server 即可恢复,无需改代码。 本机 HTTP_PROXY=127.0.0.1:60343 会把 localhost 请求也劫持(curl → 502),验证前端请用 playwright / node net.connect,别用 curl。