面对的问题
照片存在相机胶卷中。文档存在收件箱中。收据存在卡车中。这些都无法链接回工作单。
工作方式
- Step 01
从任何地方上传
移动应用、网页或 API — 数据直接上传到 S3。
- Step 02
设置可见性范围
owner_only / organization_only / shared / client_visible。
- Step 03
通过签名 URL 访问
短期签名 URL 控制每次读取。
包含哪些
S3 支持的存储
大文件存储在 S3；Supabase 仅存储元数据。
按范围的可见性
四级可见性分类在签署前强制执行。
通用附件
附加到客户、工作项、调查、报告、发票、估价单、提案、费用、交付、车辆、路线。
上传验证
服务器端 mime 和大小检查，按类别进行。
签名 URL 访问
存储桶是私有的；读取始终通过新签名 URL 进行。
未来提供商支持
Google Drive 和 Dropbox 提供商插槽已预留。
团队为什么选择
- 数据库中没有原始字节 — 快速查询，成本可预测。
- 存储桶保持私有；共享通过签名 URL 有意进行。
- 组织中每个附件使用一个文件表。
- 可见性控制在操作层捕获过度共享。
界面预览
Screenshot
文件上传
Screenshot
照片库
Screenshot
可见性设置
使用场景
前后对比照片
照片附加到调查或报告，显示在提案上。
收据
费用收据从移动应用上传并附加到费用行。
签署文件
签署的 PDF 上传到工作项，通过门户对客户可见。
配合使用
常见问题
我的文件存储在哪里？
存储在您的 S3 存储桶中。我们从不将数据复制到 Supabase 或我们的基础设施。
我可以使用自己的 S3 存储桶吗？
可以 — 设置 AWS_S3_BUCKET 和相应的凭证即可。我们从不在配置的存储桶之外读取或写入数据。
可见性如何工作？
四个级别：owner_only、organization_only、shared、client_visible。在数据库 (RLS) 和签署每个 URL 之前强制执行。
允许哪些文件类型？
图像 (png、jpeg、webp、svg)、文档 (pdf、office、csv、txt、zip)、视频 (mp4、mov)。每个类别都有大小限制。
上传的文件会扫描恶意软件吗？
不会在热路径上扫描。恶意软件扫描集成随企业版提供。
签名 URL 的有效期有多长？
默认为 10 分钟。UI 每次都会重新请求，因此没有 URL 会在过期后被缓存。