Files
shanxia2.0/openspec/changes/simple-doclib/specs/document-library/spec.md
T

16 lines
1.5 KiB
Markdown

# 简单文档库(用户于 2026-10-26 确认原型并授权实施)
## 目录与文档
门户 SHALL 在同一界面左侧展示“我的文档”和“分享给我”的树形目录,右侧展示当前范围的文件。超级管理员 SHALL 可以进入当前租户的“全部文档”。所有登录用户 SHALL 可以创建自己的目录并上传文档;空目录可由创建人或超级管理员删除,非空目录禁止删除。文件夹路径展示使用 ` / `。
## 权限
文档 SHALL 按 tenant_no 强制隔离。读取和下载 SHALL 仅授权上传人、指定分享用户和当前租户超级管理员;删除和分享设置 SHALL 仅授权上传人和超级管理员。用户显式授权的逐文档 ACL 是本模块的数据权限特例:部门/角色数据范围不得扩大私有文档可见性,也不得阻断指定人员分享。超级管理员身份沿用门户有效角色集合的联合解析,客户端不得自行声明管理员或上传人。
分享撤回后,新发起的详情和下载请求 SHALL 被拒绝。目录只授予导航路径可见性,不得隐式共享其所有文件。删除 SHALL 软删除;批量删除必须全部验证通过后才能修改。
## 存储与接入
文件 SHALL 存入专用私有 MinIO 桶,普通附件公共 URL 不适用于本模块。下载 SHALL 使用受认证、ACL 和审计保护的接口;文件列表不得暴露存储对象地址。门户 SHALL 复用已有账号,不再通过 Cloudreve SSO 打开独立页面。旧系统数据 SHALL 保留,迁移和停服务须独立执行。