存储管理 PRD

1. 背景与目标

存储管理是 ALLinONE OS 的核心 NAS 能力。用户需要将多块硬盘组织为稳定、可理解、可维护的存储空间，并在容量、性能和安全之间做出选择。

本模块目标是支持磁盘识别、存储池创建、常见 RAID/JBOD/单盘模式、文件系统选择、存储状态监控，以及群晖数据硬盘无损迁移能力。

2. 目标用户与核心场景

用户类型	核心场景	关键诉求
家庭用户	建立照片、视频、资料存储空间	安全可靠，配置简单
技术爱好者	自定义 RAID 和文件系统	可控、透明、能看到风险
群晖迁移用户	将已有群晖硬盘迁移到新系统	尽量不丢数据，降低迁移成本
小型团队/SOHO	构建共享资料池	多用户共享，状态可监控

3. 功能范围

3.1 范围内

• 磁盘识别与状态展示。
• 存储池创建、查看和基础管理。
• 支持单盘、JBOD、RAID 0、RAID 1、RAID 3、RAID 5、RAID 6、RAID 10。
• 支持 ext4、Btrfs、ZFS 文件系统。
• 存储容量、健康状态、阵列状态展示。
• 群晖数据硬盘无损迁移流程。

3.2 范围外

• 文件协议共享由《文件服务与文件管理 PRD》定义。
• 用户目录权限由《用户与权限管理 PRD》定义。
• 底层 RAID、ZFS、Btrfs 的具体实现方案需技术验证。
• 跨设备备份、快照策略、灾备策略暂不作为 MVP 强制范围。

4. 用户流程

4.1 创建存储池

text
进入存储管理 -> 查看可用磁盘 -> 选择存储池模式 -> 选择文件系统 -> 查看容量与风险说明 -> 确认创建 -> 创建完成

4.2 查看存储状态

text
进入存储管理 -> 查看存储池列表 -> 进入详情 -> 查看容量、磁盘、阵列、文件系统、健康状态

4.3 群晖硬盘迁移

text
插入群晖数据硬盘 -> 系统识别迁移来源 -> 展示可迁移数据和风险 -> 用户确认 -> 转换为本系统支持格式 -> 校验并挂载

5. 功能需求

5.1 磁盘识别

• 系统必须展示所有已识别磁盘。
• 磁盘信息至少包括名称、容量、接口类型、序列号、健康状态、使用状态。
• 系统盘必须与数据盘明确区分。
• 已被存储池占用的磁盘不可直接用于创建新存储池。
• 疑似包含数据的磁盘在格式化或组池前必须提示风险。

5.2 存储池创建

• 用户可以选择一块或多块磁盘创建存储池。
• 系统必须根据磁盘数量限制可选模式。
• 单盘模式允许一块磁盘。
• JBOD 允许多块磁盘组合为一个逻辑空间，无冗余。
• RAID 0 允许条带化，提示无冗余风险。
• RAID 1 允许镜像，提示容量利用率约为 50%。
• RAID 3、RAID 5、RAID 6、RAID 10 的磁盘数量门槛必须在界面展示。
• 创建前必须展示预计可用容量、冗余能力、性能倾向和数据清除风险。

5.3 文件系统选择

• 支持 ext4、Btrfs、ZFS 三种文件系统选项。
• ext4 作为成熟稳定选项。
• Btrfs 标记支持快照、压缩、校验等 NAS 友好能力。
• ZFS 标记为企业级数据完整性选项，并提示资源占用和技术要求。
• 文件系统能力的实际支持程度需与底层技术实现保持一致，未实现能力不得在界面承诺。

5.4 存储状态

• 存储池列表展示名称、模式、文件系统、总容量、已用容量、健康状态。
• 存储池详情展示成员磁盘、阵列状态、容量使用、错误或降级提示。
• 存储池异常时，桌面系统和仪表盘需要能读取并展示告警摘要。
• MVP 阶段至少支持查看状态，不强制支持在线扩容和修复流程。

5.5 群晖数据迁移

• 系统应识别插入磁盘是否疑似来自 Synology/群晖。
• 迁移目标是将群晖数据硬盘转化为本系统支持的存储格式，并尽量保持数据不丢失。
• 迁移前必须展示风险说明，并建议用户先备份重要数据。
• 迁移过程必须提供进度、当前阶段和失败提示。
• 迁移完成后，用户应能在文件管理中访问迁移后的数据。
• 该能力是核心差异化卖点，但底层可行性需技术验证；PRD 中必须标记为 P1 重点能力。

6. 权限与状态规则

• Owner 和管理员可以创建、查看和管理存储池。
• 普通用户只能通过文件管理访问被授权的数据空间，不能管理存储池。
• 未创建存储池时，文件服务和个人空间处于不可用或待初始化状态。
• 存储池降级或异常时，不应自动隐藏数据入口，但必须展示风险状态。
• 对数据有破坏风险的操作必须二次确认。

7. 异常与边界场景

场景	产品处理
磁盘数量不足	禁用不满足条件的 RAID 模式并说明原因
磁盘健康异常	允许查看但不推荐用于新存储池
创建过程中失败	展示失败原因，保留日志入口
存储池降级	标记为异常，提示尽快处理
文件系统能力未完整支持	不展示未实现能力，或明确标记为待支持
群晖迁移识别失败	允许用户取消，不进行破坏性转换
用户误选数据盘	创建前二次确认并明确数据风险

8. MVP / P1 / P2 分期

阶段	范围
MVP	磁盘识别、单盘/JBOD/RAID 0/1/5 基础创建、ext4/Btrfs 基础支持、存储状态展示
P1	RAID 6/10、ZFS 支持、群晖数据迁移、异常告警完善
P2	RAID 3、在线扩容、修复流程、快照/压缩/校验策略、迁移体验增强

9. 验收标准

• 系统能列出所有数据磁盘并区分系统盘。
• 用户能创建至少一种可用存储池并在文件管理中使用。
• 不满足磁盘数量的 RAID 模式不可被选择。
• 创建存储池前必须展示容量、冗余和数据风险。
• Owner/管理员可管理存储，普通用户不可管理存储池。
• 群晖迁移能力有完整流程定义和技术待验证标记。