docs(pl): 明确计划用证弹窗的四列布局与验收范围。

This commit is contained in:
wuzilong committed 2026-11-02 14:34:14 +08:00
1 parent 4d10142bfb
commit 26c6dc3a93
1 file changed
+29
@@ -0,0 +1,29 @@
# 计划用证弹窗布局(工单 #11)
工单:https://gitea.aichengyan.com/cykj/shanxia2.0/issues/11
## 范围与设计
用户已确认仅修改 Web 新增、编辑购买证及运输证弹窗。目标分支 V3.0,基线 4d10142bfb6c211feee8d82e52bc10f844989cfe。采用 1440px 上限的弹窗,沿用现有视口最大宽度与固定头部、底栏规则。相较全屏弹窗,保留上下文;相较仅改为四列,增加字段可用宽度。
建档方式单独一行。下一行左侧为证件类型,右侧为证件附件及其解析操作,宽屏比例约 1:3,窄屏适当缩小类型区,手机窄视口垂直排列。附件沿用 AttachmentUploadField 的 140×96 卡片和自适应换行,不改变上传限制、已上传列表、解析与禁用条件。
证面信息复用全局 form-grid-4:宽屏四列,视口不超过 900px 时两列,不超过 560px 时一列。字段顺序、数据绑定、必填校验和错误定位不变;日期输入撑满所在列。弹窗底栏固定、正文独立滚动。
## 视觉与复用
依据 Fresh Mint 规范 §9–10,模式 P12(多分区表单),参考现有 web-admin/src/views/pl/quota-cert/index.vue 与全局 src/assets/styles/core/app.scss。复用 el-dialog、el-form、AttachmentUploadField;无 API、后端或数据库改动。
可编辑原型 v1:https://www.figma.com/design/ImDcikQnCX5GiJQLwUHwDC/shanxia2.0?node-id=36-314
原型的宽屏、窄屏均已查看;248 个可编辑后代节点,含 46 个组件实例,无完整界面图片。Inter 字体与规范一致。原型重点表达本次布局,已有证面引用、合同绑定及保存规则仍以已验收 #10 实现为准。
## 验收与风险
Agent 执行针对性验证:真实 Vue 模板与全局样式在 1600、1024、800、375 像素视口渲染;购买证、运输证新增/编辑;多附件、长文件名、解析中、保存中及必填错误;检查字段列数、同行关系、无页面级横向溢出和底栏可达。
运行既有前端 17 项行为回归、改动文件 ESLint 和生产构建。已知全仓类型检查有既存错误,不以局部检查声称全仓通过。业务 API/上传不连接真实数据,合成组件视觉验证与真实业务联调明确区分。
主要风险是附件区挤压和窄屏字段溢出;通过复用全局降列规则、子项 min-width:0 及真实渲染核查。不得改变 #10 已关联行保护、子数据 ID、表单载荷、图片解析逻辑。
状态:范围已确认;原型及本设计等待用户确认。