From 69a908f903cf3ff240146e8ccef45b838799ad33 Mon Sep 17 00:00:00 2001 From: wangjia <809946525@qq.com> Date: Thu, 25 Jun 2026 13:05:47 +0800 Subject: [PATCH] =?UTF-8?q?docs(design):=20CONTRACT=20=E5=8A=A0=E5=BE=80?= =?UTF-8?q?=E6=9D=A5=E5=8D=95=E4=BD=8D=E9=AA=8C=E6=94=B6=E8=A1=8C=20+=20?= =?UTF-8?q?=E8=AE=B0=E5=BD=95=E5=AF=8C=E6=95=B0=E6=8D=AE=E7=BC=BA=E5=8F=A3?= =?UTF-8?q?=E7=AD=96=E7=95=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 往来单位桌面/移动验收勾全；记录「原型富数据 vs 现有后端」缺口与 本阶段「设计语言升级、富数据留二期」策略。 Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_01TSKEiHsvauyxYUW2itzUXX --- design/CONTRACT.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/design/CONTRACT.md b/design/CONTRACT.md index 66a811a..3ed9849 100644 --- a/design/CONTRACT.md +++ b/design/CONTRACT.md @@ -87,6 +87,15 @@ AppTokens 目前**仅颜色**。原型还驱动： |---|---|---|---|---|---| | 库存列表(桌面) | `inventory.html` | `inventory_list_screen.dart` | ✅ KPI/徽章/列/副标/toolbar 已还原 | ✅ golden 自比 | ✅ golden 自比 | | 库存列表(移动) | `m-inventory.html` | 同上窄屏(卡片流) | ✅ golden 自比 | ✅ golden 自比 | ✅ golden 自比 | +| 往来单位(桌面) | `partners.html` | `partners_screen.dart` | ✅ 副标/状态徽章/两行名称/响应式 toolbar | ✅ golden 自比 | ✅ golden 自比 | +| 往来单位(移动) | `m-partners.html` | 同上窄屏(卡片流) | ✅ golden 自比 | ✅ golden 自比 | ✅ golden 自比 | + +> **重要发现（原型 vs 现有数据）**：原型是「理想态富数据重设计」，多数屏的富数据区**当前后端不供给**，无法一次完整还原： +> - **商品列表**：8 tab vs 原型 5 tab；香型字典 / 商品介绍 缺后端 → 暂缓。 +> - **商品详情**：原型 3 KPI（库存/货值/出库）+ 仓库分布 + 流水，`getDetail` 仅返回商品主数据 → 需聚合接口，暂缓。 +> - **往来单位**：原型 应收/应付 列，Partner 模型无该字段 → 暂缓；类型 chips 暂保留为两 Tab。 +> +> 故本阶段策略 = **「设计语言升级」**：把每屏视觉升到新 token/组件系（副标 / StatusPill / KpiCard〔数据够时〕/ 两行名称 / 响应式 toolbar / token 间距）+ 接 golden 闸；富数据区（应收应付 / 富 KPI / 仓库分布 / 流水 / tab 重排）等后端聚合就绪再做二期。库存屏因 KPI 可由已加载数据现算，是少数能一次到位的。 **验收法（HTML→Flutter 特例）**：HTML(Chromium) 与 Flutter 渲染器不同，**严格 0.1% pixelmatch 不适用跨渲染器**（见 design-distill `references/flutter-golden.md`）。本项目双闸： 1. **保真闸（人工目检）**：`node tools/ds-compare.mjs --html .superpowers/prototype/screens/.html --prefix ` → 截原型基准 + 与 Flutter golden 用 montage 并排 → `design/_compare/`。