IITOO 采购计划 UI交互设计稿 12 · 完整交付说明

交付日期:2026-10-21。以11.1完整交付版为基线,新增参数分组、跨组移动及组内排序、图片为主阅读和参数大图查看。11.1保留为历史基线,本版是新增需求方案及可交互实现,需结合下列未决项验收。

1. 使用与交付入口

在线设计稿:https://iitoo-plan-management-flow.jxyd1978.chatgpt.site

PC入口:dist/pc.html;移动H5入口:dist/mobile.html。

列表/卡片:dist/collection.html;创建与详情:dist/index.html。

字段规则、报错与宽度目录:dist/field-tests.html。

多视口真实页面验收:dist/layout-review.html。

本版主说明:dist/docs/ui-review-12.html;历史回归明细:dist/docs/ui-review-11.html。

ZIP包含完整静态原型、脚本、资源、说明、测试代码和测试日志。解压后在包根目录运行 python -m http.server 8000,浏览 http://localhost:8000/dist/pc.html 或 /dist/mobile.html。需要本机安装Python;也可使用任意静态HTTP服务。

原型使用浏览器本机演示数据,不连接真实采购业务,不跨设备同步。布局验收台嵌入真实页面,操作会使用同一份演示数据;字段测试台的示例输入不写入业务单据。历史文档用于追溯,不代表当前执行规范;发生冲突以本说明及本次对应代码为核查入口,业务冲突仍需确认。

2. 页面与交互范围

模块当前交付内容验收重点
列表与卡片数据范围、当前/归档、搜索、排序、显示设置、侧栏预览搜索提交与清空、名称和元信息对齐、返回位置
创建采购计划第一屏基本信息及协作设置,创建后进入详情必填与日期反馈、创建后不退回创建第一屏
单据详情商务摘要、商品集合、管理设置、进展与提醒单据权限、商品与单据编辑状态各自独立
商务按需条款、规则依据、锚点目录、搜索、编辑与摘要空白允许、保存/保存并返回、条件字段、规则来源
商品详情基本信息、参数、图片、视频、附件、数量价格、来源比对保存正式校验、来源约束、只读权限、主图稳定
选品项目→方案→配置下钻、待添加/已有集合、比对搜索范围、选择保留、SidePanel上下文
协作与归档协作进展与事件、审核和归档场景归档不可编辑、提示与实际权限一致
文档输出默认单据摘要与商品行,可选完整商务和商品明细全屏/还原、图像完整、DOCX生成
移动H5单列布局、目录入口、相关信息、来源阅读与差异比对390px不溢出;真实触控与软键盘另行验收

编辑/阅读、Assessment、打开/关闭是独立维度;“保存为正式”沿用既有用户习惯与校验动作。单据内数量、价格等按单据权限处理,不因商品阅读态而简单全禁用;来源商品的结构与媒体约束继续沿用原规则。商务允许为空;“有内容”不等于完整或Assessment通过。

3. 当前布局与状态规范

项目当前基线
PC布局1440设计基准;较窄正文使用横向滚动;侧栏默认326px;加宽侧栏不使商品主图跳行
字段行间基线24px;20px提示行+4px间隔占用这段空间,不再额外预留40px;多行错误自然撑高
商务章节“各项商务约定”的说明到下一张条款卡片24px
商务操作规则下拉与采用按钮顶边对齐;常用组合前消除反馈占位与margin叠加,恢复24px
搜索高32px;默认输入320px+按钮64px;按可用宽度收缩;焦点边界与按钮相接
搜索行为点击/Enter提交,清空恢复当前范围,输入法组合期间不误提交;真实输入法仍需实机验证
商务字段宽度短值与单位96;金额/数量160;日期及常规选择240;独立编号288;普通文本/长选项320;名称/地点等448;长文本/集合整行
移动控件受可用宽度约束,主要信息单列;比对允许局部横向滚动,不以页面溢出替代布局
列表资料PC测试重点、名称、可见范围、更新时间共用文字起点;移动不继承PC额外缩进

宽度是现有原型的语义映射,不能据此宣称DS-001全部规范已审核通过;DS-001部分抽取与微调的来源关系保持。

4. 字段规则、正则与校验机制

字段校验是常规交付组成部分。并非所有字段都适合正则:数值采用范围/步长校验,日期采用日期与区间判断,选择采用选项,跨字段条件采用业务校验器。不得为“补齐正则表”而新增字符白名单或业务限制。

对象当前实现及约束错误/边界
商品名称保存为正式时必填;浏览器maxlength=160;未新增字符正则空名称就地提示;160的计数方式与服务端一致性待确认
通用必填trim后空字符串视为空失焦或提交触发“请填写此字段”
数值Number转换及有限值检查,按控件min/max/step验证非数字、越界、步长错误;可选空值不误报
商品预计数量当前详情控件min=1、step=1;原处理器只接受正整数,草稿可暂空0、负数、小数拒绝;处理器可回退到旧值,不能描述成统一保存任意非法输入
商品预计单价min=0、step=any允许0与小数;不套用数量正整数规则
比例与税率按各控件的边界验证,上界100测试台0—100范围样例不等同于所有实际比例字段口径
付款比例原控件min=0.01、max=100、step=0.01业务校验器仍允许0且未统一精度;已知冲突,未纳入冻结通过
金额精度按各控件step校验;测试台用0.01测试步长不把测试台两位步长扩大为所有金额字段的新业务规则
日期原日期控件;业务检查开始日期不得晚于结束日期区间倒置报错;切换类型后隐藏字段不误报
分期付款按计算分组检查合计同组70+60超100报错;不同批次100+100不混合计算
商务空值商务整体允许全空不将“未说明”误作全部必填
字符格式沿用已有pattern时处理patternMismatch;未新增中文专用或编号白名单正则正则只描述已有格式,业务枚举/关联条件单独校验

主要实现:dist/field-design.js(宽度及控件反馈);dist/commercial-schema.js、dist/business-expanded.js、dist/business.js(商务定义及业务逻辑);dist/product-detail.js(商品);dist/field-tests.js(测试台)。目录覆盖488个schema定义,含重复明细、通用字段、付款补充;手写付款字段和规则参数仍需结合真实页面查看,不能称为488种业务组合已穷举。

5. 报错与恢复交互

初始显示适用规则提示;不因仅聚焦就报错或跳换侧栏。

失焦、选择变更、保存/保存正式时执行对应校验;已触达字段修改后更新错误。

错误就地显示,使用aria-invalid和aria-describedby关联;纠正后恢复字段提示。

多字段同时报错及多行错误不遮挡下个字段;多行内容允许撑开布局。

保存失败、版本冲突属于操作级反馈,不能用字段合法性替代保存成功。

原生控件限制、字段反馈、业务Assessment可能有不同触发时机;付款比例的已知冲突必须显式保留。

6. 验证结果与复测入口

本版代码86项Node回归通过,0失败,日志见evidence/ui-review-12-tests.log。字段测试台此前14项通过,覆盖可选空值、零值、上界、负数、越界、小数、非数字、金额精度、商务全空、同组付款合计、不同批次、日期倒置、隐藏条件字段、名称限制。测试代码与交互入口随包提供。

11版浏览器回归已覆盖列表/卡片、搜索、创建必填与恢复、供应商选择、商品保存正式、1440侧栏加宽、归档只读、来源/比对、文档预览及DOCX生成。桌面检查含1440/1920/1280,移动检查含390。含图样本27张加载成功,0损坏;Word/WPS实际分页未验收。详细矩阵见同包历史11版说明。

11.1商务补丁实测:说明至卡片24px、规则按钮与下拉顶边差0px、常用组合前24px;支付结构切换后保持。390px真实商务页新增检查全部通过:搜索边界、高度、输入范围、章节间距、按钮对齐、无叠加空白、22项可见反馈无裁切、页面无横向溢出。

常规验收操作预期
字段错误测试台填入错误示例,再修正多处错误分别出现;修正恢复提示
多行反馈点击多行错误压力样例不裁切、不覆盖下一个字段
搜索焦点聚焦、Enter提交、清空外框闭合,无按钮右侧多余空白,清空恢复
商务间距编辑商务,切换分期,打开布局检查24px基线,按钮对齐,动态字段不重叠
只读保护进入归档、来源及已锁定场景不出现越权编辑入口
商品主图1440加宽/还原SidePanel主图与信息双列保持,不跳行
输出范围默认预览,再选完整商务/明细默认简洁,扩展内容由用户主动选择

布局检查器只检测当前可见组件。自动回归不等于逐像素验收,14项规则测试不等于所有输入组合均覆盖。本版未重新完成所有历史浏览器路径;新增路径完成下述检查,真机与业务服务仍待验收。

7. 冻结范围、未决与变更管理

可交接固定:已检查的PC/H5页面、布局、入口、字段展示和交互行为。未决项保持未决,不因用户暂未发现问题或自动测试通过而转为通过。

未决项当前处理
付款比例0值与精度控件与业务校验口径冲突,待统一
名称160长度字符计数与服务端约束待确认
整单积分/商品完整度计算口径未定,不编造分数
逐张图片设置/跨页续标不宣称全部实现与验收
Word/WPS/实体打印客户端分页与实物输出待验收
真机与真实服务iOS/安卓/鸿蒙软键盘、上传、输入法,以及真实权限/保存服务另验
设计规范覆盖DS-001为部分抽取微调,保留审查状态

后续默认完整交付包含:页面与状态、交互路径、字段规则与适用正则、错误/空态/加载/只读/失败恢复、响应式与权限边界、测试记录、变更说明、未决清单和可运行ZIP。字段测试不再需要单独提醒。每次变更记录影响范围并复测公共组件使用方;未经确认不趁整理改变业务规则。

8. 第12版新增方案:分组与图片阅读

演示入口:index.html?plan=UI12-PARAM-IMAGES。列表顶部“12版分组与图片”可直接进入。样本含一个可编辑手工商品及一个来源只读商品;示例图片仅用于交互验收,不构成实际规格证明。演示记录首次安装,之后保留本机修改。

需求入口与行为边界
参数分组商品详情→编辑商品→参数;添加分组、改名;新增参数时选择所属分组单层分组;旧参数兼容为未分组
跨组移动参数更多→移至分组→选择目标→确认放至目标组末尾;保留参数ID、标题、值、摘要标记和图片
组内排序参数更多→上移/下移只交换本组相邻参数;边界不可越过;本版采用菜单操作
分组删除仅空分组提供删除,确认时说明概况图也会删除非空组需先移出或删除参数;不会自动级联删除参数
分组概况图组标题处查看/管理概况图图片属于分组;参数移走后概况图不跟随
图片为主商品详情工具栏切换;左侧基本信息、组、参数标题与值;右侧大图及缩略图仍在正文;辅助侧栏保持原职责;切换不修改商品资料
参数有图参数行缩略图或N张→直接查看大图显示分组/参数标题/值;上一张、下一张仅浏览该参数;关闭返回原页面
参数无图图片为主仍显示该参数与完整值显示暂无直接关联图片,不用组图替代参数证据
移动端上方可滚动信息树,下方大图;点击大图放大单列,避免将PC双栏挤入手机
只读与来源阅读模式、组图和参数图片均可读来源或锁定商品不提供分组/移动/排序/媒体修改入口
文档输出商品明细按组输出标题、概况图、参数与参数图片未分组参数保留;遵守已有可见/导出限制

图片关联按商品、分组、参数三个对象分别保存;界面选中哪个对象就显示其直接关联图片。参数列表使用“2张”表达实际数量,查看器使用“1 / 2”表达位置;“管理关联图片”独立于日常看图。图片为主是阅读方式,不产生第二份商品数据;编辑态切换阅读方式后,切回参数为主继续编辑。

新增字段与错误规则:分组名trim后必填,当前原型maxlength=60,同商品内组名不重复;不新增字符正则。空名/重名给出错误且不保存。60字符上限为本次UI方案值,业务/服务端口径待确认。跨组目标必须存在;历史失效关联回到未分组。新参数沿用原有名称与值规则。

媒体沿用JPG/PNG/GIF/WebP、单文件不超过10MB的现有检查及失败重试。商品图片上限6张、参数图片上限3张保持既有实现;分组概况图尚未指定数量上限,本版不擅自增加限额,需业务确认。新增上传沿用现有图片处理链路,真实设备上传仍需验收。

9. 第12版验收记录与回归范围

新增6项自动测试:旧数据/孤立关联归一化;跨组对象与图片保持;组内边界;来源与锁定保护;看图上下文和空态/无数据写入;文档分组图片及未分组输出。既有80项同时运行通过。

浏览器实际检查:手工商品参数缩略图直接打开、两张切换、切入图片为主、无图空态;跨组后组内上移并重新打开,值/摘要/两张图保留;新增组与参数;来源商品无编辑入口、完整来源按组阅读。PC 1440正文图文区宽832且无内部溢出;移动390测试框完成单列检查,并修正商品正文继承PC最小宽度及叠加内边距的问题。浏览器检查为模拟视口,不替代真机。

复测操作预期
移动表面材质到另一组再上移组内顺序更新,标题/值/2图/摘要不丢失
点击参数缩略图,再下一张、关闭仅在本参数图片间切换,关闭回原阅读上下文
图片为主选择适配说明显示完整参数值和无图说明
选择分组概况图,再选择商品基本信息分别显示分组图和商品主图,不混淆关联
来源商品进入图片为主可看组与参数图片,不可修改结构
新建组留空/与已有重名阻止保存,纠正后可继续
完整商品明细输出分组、组图、参数值与参数图片顺序一致

11.1的24px行间、商务间距、搜索聚焦规则继续保留。未决业务清单仍适用;新方案不代表全系统规范已经确认。下一次完整交付仍默认整合字段规则、错误反馈和测试记录。