采购在询盘表单里选好型号，拖入一份 38 MB 的 STEP 图纸，进度条走到 99% 后页面提示“提交失败”。他改用邮件发送附件，邮件主题里又没有产品型号。销售第二天收到两条线索，一条只有表单文字，一条只有图纸，无法确认是不是同一个项目。
上传字段看起来只是一个按钮，背后却连接浏览器、服务器、邮件、CRM 和资料权限。设计时既要让客户知道什么文件能交，也要保证附件与询盘主记录始终绑在一起。
先定义文件用途，再决定格式和大小
不同入口需要的文件不同。非标加工常见 DWG、DXF、STEP、IGES 与 PDF；故障报修可能上传照片、视频和日志；资质审核则是证书或表格。页面应按用途列支持格式，不要写“支持所有文件”。扩展名、MIME 类型和文件头都要校验，只检查文件名后缀，很容易让错误文件或恶意内容进入服务器。
大小上限要由真实流程决定。浏览器能传 100 MB，不代表邮件通知、反病毒扫描和 CRM 附件都能接收。大文件可以先进入受控存储，通知邮件只带下载地址与过期时间。页面显示的上限必须与 Nginx、PHP、应用和存储服务一致；任何一层设得更小，客户都会在接近完成时失败。
多文件上传需要显示文件名、大小、状态和删除入口。图纸有总装、零件和技术要求时，客户应能一次提交并补充版本说明。系统生成的随机名用于存储可以接受，但询盘记录必须保留原文件名、上传顺序、文件哈希和页面来源。销售看到一串 UUID，无法判断 revision-B 是否覆盖 revision-A。
上传框旁边要提示脱敏。客户可删除无关的联系人、价格和项目编号，只提供报价判断所需部分。页面若声称“严格保密”，还要有对应的访问控制、日志与清理机制；做不到时，应如实说明资料用途和接触岗位，不用一句口号替代安全措施。
失败、扫描和交接都要留下状态
上传过程至少区分等待、传输、扫描、成功和失败。网络中断后可续传或单独重试附件，已填写的联系人和需求不能清空。失败提示要说清原因，例如文件过大、格式不支持或网络超时，并给出可执行处理方式。统一显示“系统错误”，只会把问题转给客服。
文件到达服务器后，应先放在非公开目录，完成类型校验和安全扫描，再与询盘 ID 关联。不要把原始文件直接放进可猜测的静态 URL。下载权限按销售、工程和售后角色分配，链接设置有效期；离职账号和已关闭项目的权限也要能收回。
CRM 里最好分开保存 attachment_id、original_name、storage_key、scan_status、uploaded_at 和 source_page。邮件只负责提醒，不能成为唯一存档。邮件转发一次，附件版本就可能失控；主记录里有文件状态，销售才能知道扫描是否完成、工程是否已经下载。
重复提交需要去重，但不能只按文件名判断。两个客户都可能上传 drawing.pdf，同一客户也可能用同名文件提交新版本。可以结合询盘 ID、文件哈希、上传时间和联系人判断，并把疑似重复标记给人工，不要直接覆盖。
上线验收应使用几种真实文件：带中文名的 PDF、包含空格的 STEP、接近上限的大文件、错误扩展名、同名不同内容和手机拍摄的 HEIC。再模拟网络中断、扫描失败和 CRM 接口超时，检查页面是否保留文字字段，后台是否出现孤立文件，通知是否会重复发送。
上传成功页要列出收到的文件，并提供补充资料入口。客户知道系统收到了哪一版，销售也能从同一个询盘打开附件。按钮本身很小，完整的状态与关联关系才是这个字段真正的功能。