Files

czl231 99324acc89 feat: 新增配送合同附件安全上传功能

- 增加合同专用 PDF 上传、鉴权预览和失败清理接口
- 支持草稿附件替换移除、并发保护和启用完整性校验
- 修复循环模板引用导致文件选择器无法打开的问题
- 补充专项测试、中文项目文档和操作日志

2026-08-12 21:38:49 +08:00

操作日志：配送合同附件上传

操作时间：2026-08-12 20:42:47 操作类型：扩展影响模块：平台总后台配送合同、后端合同业务、受控文件存储

操作前状态

backend/api/internal/logic/platform/gasorder/contract_attachment.go：新增 349 行，合同附件核心服务。
backend/api/internal/logic/platform/gasorder/contract_attachment_test.go：新增 83 行，安全与边界测试。
backend/api/internal/logic/platform/gasorder/gasorder.go：约新增 88 行、删除 7 行，接入创建、更新、并发和启用校验。
backend/api/internal/routers/platform.go：新增 3 条专用路由。
backend/api/internal/routers/platform_contract_attachment_test.go：新增 25 行，路由测试。
frontend/platform_admin/src/api/contract-attachment.ts：新增 73 行，附件 API 客户端。
frontend/platform_admin/src/views/resource/use-contract-attachment.ts：新增 147 行，附件页面状态与保存编排。
frontend/platform_admin/src/views/resource/ResourceFieldForm.vue：约新增 145 行、删除 1 行，上传控件和样式。
frontend/platform_admin/src/views/resource/ResourceRecordPage.vue：约新增 81 行、删除 2 行，详情预览和保存集成。
frontend/platform_admin/src/api/resources.ts、ResourceDetailContent.vue：字段类型、动作状态和详情隐藏调整。

go test ./...：通过。
npm.cmd run type:check：通过。
npm.cmd run build：通过。
npm.cmd run contract:check：通过，48 个资源。
npm.cmd run resource-pages:check：通过，详情 46 类、新建 25 类、编辑 23 类。
git diff --check：通过。
本地页面只读检查：应用可正常打开且无控制台错误；独立测试浏览器因未登录被重定向至登录页，因此未执行需要平台账号和测试合同数据的交互式保存、替换及预览验证。
npm.cmd run lint：未通过；项目已有 2 个错误、165 个警告和 12 个提示，诊断集中在既有文件。对本次 6 个前端改动文件单独执行 Biome lint 无错误，仅有项目现存的模板变量识别类警告。
边界测试：伪装 PDF、错误 MIME、缺少结束标记、过期或篡改凭证、跨操作人凭证、路径穿越、外部 URL 和附件版本变化均覆盖。

ResourceFieldForm.vue 在字段 v-for 内为文件 input 使用同一个 attachmentInput 模板引用。
Vue 将循环内模板引用解析为元素数组，点击上传区域调用 .click() 时抛出 TypeError: attachmentInput.value?.click is not a function。

新增 ContractAttachmentField.vue，将文件 input 和单一模板引用移出字段循环。
通用字段表单只负责渲染独立组件并转发选择、预览、移除和取消选择事件。
上传区域增加按钮语义、Tab 焦点、Enter/空格键入口和可见焦点样式。
操作按钮同时阻止点击与键盘事件冒泡，避免预览或移除时误打开选择器。
新增 scripts/check-contract-attachment-control.mjs 和 contract-attachment:check 命令。