Senvra Backup 技术方案

flowchart LR
    A[当前空间数据] --> B[导出清单构建]
    B --> C[逐项读取媒体与元数据]
    C --> D[分块 AES-256-GCM 加密]
    D --> E[SNVRBKP3 流式写入]
    E --> F[原子落盘为 .senvrabackup]

    G[.senvrabackup] --> H[Header 与 AAD 校验]
    H --> I[凭据派生与解密]
    I --> J[中性查重]
    J --> K[临时导入区]
    K --> L[原子提交到当前空间]

mindmap
  root((Backup Threat Model))
    离线攻击
      暴力破解密码
      重放旧 Header
      篡改 Manifest
    身份泄露
      空间 ID 暴露
      文件名暴露
      错误提示暴露路径
    数据完整性
      媒体块被替换
      Note 与 Attachment 关系被伪造
      导入中断留下半成品
    体验风险
      长任务期间露出敏感缩略图
      大文件导出卡顿
      低磁盘导致损坏备份

flowchart TB
    subgraph PrivateSpace[私密空间备份]
        A1[Access Key] --> C1[KDF]
        B1[Backup Password] --> C1
        C1 --> D1[Backup Encryption Key]
    end

    subgraph PublicSpace[公共空间备份]
        A2[Random Backup Key] --> C2[KDF]
        B2[Backup Password 可选/按产品策略] --> C2
        C2 --> D2[Backup Encryption Key]
    end

    D1 --> E[AES-256-GCM 分块加密]
    D2 --> E

flowchart LR
    A[Magic<br/>SNVRBKP] --> B[Version<br/>3]
    B --> C[Header Length]
    C --> D[Public Header]
    D --> E[Salt<br/>KDF Params]
    E --> F[Manifest Digest]
    F --> G[Encrypted Manifest]
    G --> H[Encrypted Chunks]
    H --> I[Final Auth Trailer]

sequenceDiagram
    participant UI as Backup UI
    participant App as AppModel
    participant Store as VaultStore
    participant Crypto as Crypto Pipeline
    participant File as Backup Writer

    UI->>App: 用户确认导出
    App->>Store: 请求快照与导出清单
    Store-->>App: Notes / Attachments / Media refs
    App->>Crypto: 初始化 KDF 与 Header AAD
    loop 每个媒体或元数据块
        App->>Store: 流式读取
        Store-->>Crypto: 明文缓冲
        Crypto-->>File: 密文块 + tag
    end
    File->>File: fsync + 原子 rename
    App-->>UI: 完成或中性失败信息

flowchart TD
    A[选择 .senvrabackup] --> B{Magic / Version 合法?}
    B -- 否 --> X[中性失败提示]
    B -- 是 --> C[读取 Header 与 KDF 参数]
    C --> D[输入 Access Key / Backup Password]
    D --> E{Header AAD 校验通过?}
    E -- 否 --> X
    E -- 是 --> F[解密 Manifest]
    F --> G{归属关系校验}
    G -- 否 --> X
    G -- 是 --> H[中性查重]
    H --> I[写入临时导入区]
    I --> J{全部块校验通过?}
    J -- 否 --> Y[清理临时导入区]
    J -- 是 --> K[原子提交到当前空间]
    K --> L[完成]

stateDiagram-v2
    [*] --> Idle
    Idle --> Exporting: 开始备份
    Idle --> Importing: 开始导入
    Exporting --> Shielded: App 失活 / 锁屏 / 风险状态
    Importing --> Shielded: App 失活 / 锁屏 / 风险状态
    Shielded --> Exporting: 回到安全前台
    Shielded --> Importing: 回到安全前台
    Exporting --> Finished
    Importing --> Finished
    Exporting --> Failed
    Importing --> Failed
    Failed --> Idle
    Finished --> Idle

flowchart LR
    A[创建导入事务] --> B[写临时数据库记录]
    B --> C[写临时媒体文件]
    C --> D[校验所有 tag 与 digest]
    D --> E{校验通过?}
    E -- 是 --> F[批量提交记录]
    F --> G[移动媒体到正式目录]
    G --> H[提交事务]
    E -- 否 --> I[回滚数据库]
    I --> J[删除临时媒体]

flowchart LR
    A[SNVRBKP2<br/>只读兼容] --> B[SNVRBKP3<br/>当前写入格式]
    B --> C[Future<br/>新 KDF / 分块索引 / 压缩策略]

journey
    title 用户备份与迁移体验
    section 导出
      选择备份: 5: 用户
      设置备份密码: 4: 用户
      保存 Access Key 或 Backup Key: 3: 用户
      等待导出完成: 4: 用户
    section 保存
      把 .senvrabackup 放到可信位置: 4: 用户
      记录凭据: 3: 用户
    section 导入
      选择备份文件: 5: 用户
      输入凭据: 3: 用户
      导入当前空间: 5: 用户