文件、附件与业务文档¶

适用基线：测试环境目标 / dev 分支 / 2026-07-15。阅读对象：测试、实施、运维（主）。

本页解决什么问题¶

文件能力统一承接业务附件、导入文件、证据材料等二进制内容的存储、列表、预览、下载与删除。读完本页，应能配置/排查平台文件服务，并分清：业务何时强制上传、附件是否参与审批，仍以业务页为准。

何时用本页 / 不归本页

何时进来	不归本页
配存储后端、查文件列表、上传失败先查主配置	某单据是否必传附件、展示哪些附件 → 业务页
区分「文件记录在、内容丢了」	导入错误文件联查 → 导入导出；谁上传/下载 → 日志
评估换存储/容量/备份	把文件列表当成全部业务文档库；MES SOP 等业务文件库细则 → 业务页

📷 截图占位

文件配置与文件列表；脱敏路径与文件名。

flowchart LR A["业务页上传"] --> B["文件服务写入存储"] B --> C["登记文件元数据"] C --> D["预览 / 下载 / 列表 / 删除"]

能力	业务含义
文件配置	维护存储方式（如数据库、本地磁盘、FTP、SFTP），可指定主配置并测试连通。
文件列表	管理端分页查询已上传文件元数据。
上传	支持单文件/多文件上传；可携带业务表与业务主键类关联信息。
预览 / 下载	按配置与路径读取内容供预览或下载。
删除	管理端可按权限删除文件记录及存储内容（以实际服务行为为准）。
业务关联	上传时可关联业务对象标识，便于按单据回查附件。

业务用户通常在业务页上传；运维在基础设施维护文件配置与排查文件列表。

情况	建议处理
换存储后旧文件打不开	勿随意切换主配置；迁移需专项方案。
业务要求版本管理	当前不能默认存在完整文档版本库；以业务是否另建版本字段为准。
以为文件列表等于全部业务文档库	许多附件只在业务上下文可见，列表是平台治理视图。

类型	后续补充	目的
配置截图	主文件配置与测试。	实施。
关联样例	一笔业务单据与附件回查。	培训。