Documents：上传与查找

上传文件并填写结构化元数据；WMS/TMS/Drayage/LastMile 的任务照片自动归档；搜索与签名链接下载。

不管是手机上随手拍的现场照片，还是电脑里的合同、发票、提单，所有文件都从这里进文档中心。上传时把元数据（下面讲）填好，以后按单号、货主一搜就有，不用翻文件夹大海捞针。

两种上传方式#

1. 页面上传：打开 Documents → 点 Upload（上传）→ 选择文件 → 填写元数据 → 确认上传。
2. 业务系统自动上传：WMS / TMS / Drayage / LastMile 里的任务照片、POD 照片经接口自动进文档中心，不用手工操作，关联单据、货主等元数据由系统自动带上。

元数据分两层#

• 文档类型（doc_type）：这是什么文件，如合同、发票、照片、POD 签收单。
• 来源系统（source_system）：文件从哪来，如 WMS、TMS、Drayage、LastMile 或手工上传。权限就按这个字段隔离。
• 货主（merchant）：文件属于哪个货主。
• 关联单据（ref_type + ref_id）：挂在哪张单上，如订单号 SO-000123、提单号。
• 创建人/创建时间：谁、什么时候传的，系统自动记录。
• 文件信息：文件名、大小、格式，系统自动记录。

业务上下文 JSON：各业务自己的扩展字段（如冷链的温度记录、柜号），以 JSON 形式附在文件上——JSON 就是一种结构化的文本格式，技术人员拿来存扩展信息。不影响上面的共性字段，普通用户不用管。

查找与下载#

1. 在列表页按文档类型、货主、来源系统、时间筛选，或直接输关键词搜索（OCR 启用后，图片里的文字也能搜，见 OCR 页）。
2. 点开文件查看详情和元数据。
3. 点下载：系统生成签名 URL（带时效的临时下载链接）供您下载，不直接暴露文件的真实存储地址。