文件服务与文件管理 PRD

1. 背景与目标

文件服务与文件管理是用户最常使用的 NAS 能力。ALLinONE OS 需要同时满足局域网共享、跨平台访问、Web 文件管理、个人空间、共享空间、网络硬盘挂载和云存储挂载。

本模块目标是提供统一的文件访问体验，让用户可以通过 Web 界面和常见协议访问个人与共享数据。

2. 目标用户与核心场景

用户类型	核心场景	关键诉求
家庭用户	管理照片、视频、文档和共享文件夹	简单易用，跨设备访问
技术爱好者	使用 SMB/NFS/WebDAV 等协议	协议完整，可配置
小型团队/SOHO	多人共享资料和项目文件	权限清晰，空间隔离
云盘用户	挂载外部云盘和远程共享	统一入口管理多来源文件

3. 功能范围

3.1 范围内

• SMB/CIFS、NFS、FTP、SFTP、WebDAV 文件服务。
• 个人空间管理。
• 共享空间查看和访问。
• 基础文件操作：浏览、上传、下载、新建文件夹、重命名、移动、复制、删除。
• 网络硬盘挂载：SMB、NFS、WebDAV。
• 云存储挂载：OneDrive、Dropbox、Google Drive。

3.2 范围外

• 用户和权限模型由《用户与权限管理 PRD》定义。
• 底层存储池创建由《存储管理 PRD》定义。
• 高级协作能力、在线文档编辑、版本管理、全文搜索暂不纳入 MVP。
• 外部云盘授权细节需按各云服务 API 技术验证。

4. 用户流程

4.1 Web 文件管理

text
登录系统 -> 进入文件管理 -> 选择个人空间或共享空间 -> 浏览目录 -> 执行上传/下载/新建/移动/删除等操作

4.2 启用文件协议

text
管理员进入文件服务 -> 选择协议 -> 配置服务参数 -> 选择共享目录和授权用户 -> 启用服务 -> 客户端连接访问

4.3 挂载网络硬盘

text
进入挂载管理 -> 选择 SMB/NFS/WebDAV -> 填写地址和认证信息 -> 测试连接 -> 保存挂载 -> 文件管理中展示

4.4 挂载云存储

text
进入云存储挂载 -> 选择云服务 -> 完成授权 -> 选择挂载位置 -> 文件管理中展示云存储入口

5. 功能需求

5.1 文件服务协议

• 支持 SMB/CIFS，用于 Windows 和主流局域网文件共享。
• 支持 NFS，用于 Linux、Unix 和虚拟化场景。
• 支持 FTP，用于兼容传统文件传输场景。
• 支持 SFTP，基于 SSH 提供安全文件传输。
• 支持 WebDAV，用于 HTTP 文件访问和跨网络客户端。
• 管理员可以按协议启用或停用服务。
• 每个协议必须能够绑定可访问目录和授权用户或用户组。
• 协议启用状态、端口和访问地址需要在界面展示。

5.2 个人空间

• 每个用户拥有独立个人空间。
• 用户登录文件管理后默认进入个人空间。
• 个人空间仅用户本人、Owner 和具备授权的管理员可访问。
• 若存储池未创建，个人空间入口展示不可用原因和创建引导。

5.3 共享空间

• 管理员和 Owner 可以创建共享空间。
• 用户只能查看被授权的共享空间。
• 共享空间至少支持只读、读写两种访问级别。
• 文件管理界面需要明确区分个人空间和共享空间。

5.4 基础文件操作

• 支持浏览目录和文件列表。
• 支持上传文件和文件夹。
• 支持下载单个文件；批量下载可在 P1 支持。
• 支持新建文件夹、重命名、移动、复制、删除。
• 删除操作必须提示风险；是否进入回收站由后续策略决定，MVP 可直接删除但需二次确认。
• 操作失败时必须展示可理解的失败原因。

5.5 网络硬盘挂载

• 支持挂载 SMB、NFS、WebDAV 远程共享。
• 挂载配置至少包括协议、地址、路径、认证信息、显示名称。
• 保存前支持连接测试。
• 挂载成功后在文件管理中以独立入口展示。
• 挂载失败不影响本地文件空间使用。

5.6 云存储挂载

• 支持 OneDrive、Dropbox、Google Drive 等主流云盘挂载。
• 云盘授权过程必须提示第三方服务依赖。
• 授权成功后，云盘入口展示在文件管理中。
• 云盘挂载能力列为 P2，MVP 不强制实现。

6. 权限与状态规则

• 普通用户只能访问个人空间和被授权共享空间。
• 管理员可以管理共享空间和文件服务协议。
• Owner 拥有所有文件空间和服务配置的最高管理权限。
• 文件协议访问必须遵循同一套用户与共享空间权限模型。
• 网络硬盘和云存储挂载的可见性需要绑定创建者或管理员配置。

7. 异常与边界场景

场景	产品处理
未创建存储池	文件管理展示初始化引导
协议端口冲突	阻止启用并提示冲突原因
上传空间不足	中止上传并提示释放空间
用户无权限访问目录	隐藏目录或展示无权限提示
网络硬盘连接失败	保存前测试失败，不创建挂载
云盘授权过期	展示重新授权入口
文件操作中断	保留失败状态，避免显示为成功

8. MVP / P1 / P2 分期

阶段	范围
MVP	Web 文件管理、个人空间、共享空间查看、SMB/NFS/WebDAV 基础服务、基础文件操作
P1	FTP/SFTP、共享空间管理、批量下载、网络硬盘挂载、文件操作体验完善
P2	OneDrive/Dropbox/Google Drive 云存储挂载、跨来源统一管理、高级分享能力

9. 验收标准

• 用户登录后可以进入个人空间并执行基础文件操作。
• 管理员可以启用至少一种文件服务协议，并通过客户端访问授权目录。
• 普通用户无法访问未授权共享空间。
• 未创建存储池时，文件管理不会假装可用，必须展示引导。
• 网络硬盘挂载流程包含连接测试。
• 云存储挂载作为 P2 能力明确标记，不影响 MVP 验收。