kuaifan DooTask 数据备份
刚性技能——前置检查 → 选可选项 → 确认 → 执行 → 报告。只读取源数据生成归档，绝不删除或修改任何源数据/既有备份。任何一步失败立即停止。
备份范围
| 项 | 来源 | 是否必须 | 说明 |
|---|---|---|---|
| 数据库 | ./cmd mysql backup 产出的 .sql.gz |
必须 | 脚本内部用 mysqldump 导出当前库 |
| 上传文件 | public/uploads（排除 public/uploads/tmp） |
可选 | 头像/聊天/任务/文件等真实上传数据；tmp 是临时目录，可重建，不备份 |
| 应用配置 | docker/appstore/config |
可选 | 应用市场各应用的配置；含 root 属主子目录，收集时可能需 sudo |
docker/appstore/apps不在备份范围——可从应用市场重新安装，无需备份。
前置检查（全部通过才能继续）
- 工作目录：在项目根（存在
cmd、docker-compose.yml） - 数据库容器：
mariadb容器在跑（DB 备份依赖它；不在则提示用户先./cmd up起服务） - 磁盘空间：确认
backup/所在盘空间足够（数据库 dump 可能较大） - 选可选项：询问用户本次是否包含
public/uploads和docker/appstore/config（默认两个都含）
检查通过、可选项确定后，汇报本次将备份哪些项，向用户确认一次再执行。
执行
用一个统一时间戳贯穿全程：TS=$(date +%Y%m%d_%H%M%S)，临时目录 WORK="tmp/dootask-backup-${TS}"。
1) 建临时工作目录
mkdir -p "$WORK"
（tmp/ 已被 gitignore，安全）
2) 数据库（必须）
./cmd mysql backup
脚本会把 dump 写到 docker/mysql/backup/<库名>_<时间戳>.sql.gz 并打印「备份文件：...」。取该次产出的最新 dump 复制进工作目录（不用关心它原始落在哪）：
DB_FILE=$(ls -t docker/mysql/backup/*.sql.gz | head -1)
cp "$DB_FILE" "$WORK/"
3) public/uploads（可选，排除 tmp）
rsync -a --exclude='tmp' public/uploads/ "$WORK/uploads/"
无 rsync 时用 tar 管道：
mkdir -p "$WORK/uploads" && tar cf - --exclude='./tmp' -C public/uploads . | tar xf - -C "$WORK/uploads"
4) docker/appstore/config（可选）
cp -a docker/appstore/config "$WORK/appstore-config"
含 root 属主子目录，若报
permission denied：改用sudo cp -a ...，随后把整个工作目录属主归还当前用户，保证后续打包/清理不受阻：sudo chown -R "$(id -u):$(id -g)" "$WORK"
5) 写 README.md（备份说明）
在 $WORK/README.md 写明本次备份信息，便于日后识别与还原。模板：
# DooTask 备份 — <TS>
- 备份时间：<人类可读时间>
- DooTask 版本：<取自 package.json 的 version>
- 包含内容：
- 数据库：<DB dump 文件名>（来源 mysqldump 当前库）
- 上传文件：uploads/（来源 public/uploads，已排除 tmp） ← 未选则写「未包含」
- 应用配置：appstore-config/（来源 docker/appstore/config） ← 未选则写「未包含」
- 各项大小：<du -sh 列出工作目录内各项>
## 还原提示
- 数据库：`gunzip < <db>.sql.gz | mysql -u<user> -p<pass> <库名>`，或用 `./cmd mysql recovery` 选对应文件还原。
- 上传文件：将 uploads/ 内容覆盖回项目 public/uploads/。
- 应用配置：将 appstore-config/ 覆盖回 docker/appstore/config/。
6) 打包到 backup/，清理临时目录
mkdir -p backup
tar czf "backup/dootask_backup_${TS}.tar.gz" -C tmp "dootask-backup-${TS}"
rm -rf "$WORK"
报告
向用户报告：
- 最终归档路径：
backup/dootask_backup_<TS>.tar.gz - 归档大小（
ls -lh） - 实际包含了哪些项（数据库 + 视选择含/不含 uploads、appstore-config）
失败处理
- 任何步骤失败立即停止，原样报告错误
- 不要自动重试、不要静默跳过某一项（可选项是否包含由前置确认决定，不在执行中临时变更）
- DB 备份失败（如 mariadb 未运行）→ 停止，提示用户起服务后重试
- 打包前若工作目录有 root 属主残留导致 tar/rm 失败 →
sudo chown归还属主后继续，不要删源数据
禁止项
| 错误做法 | 正确做法 |
|---|---|
| 为"省空间"删除源数据或既有备份 | 只读取源数据生成归档，源数据一律不动 |
备份 public/uploads/tmp |
排除 tmp（临时、可重建） |
把 docker/appstore/apps 也打进去 |
不在范围，可从应用市场重装 |
| 遇 config 的 root 子目录就跳过该项 | sudo 收集后 chown 归还，完整备份 |
| 不写 README 直接打包 | 每个归档自带 README，便于日后识别还原 |
| 把归档写进 git | 归档放 backup/（已 gitignore），不提交 |
Red Flags —— 出现这些念头立即停下
- "源数据太大，删点旧的再备份" → 不，备份只读不删
- "config 有 root 目录，跳过算了" → 不，sudo 收集后归还属主
- "apps 也一起备了更全" → 不，apps 不在范围
- "tmp 里临时文件顺手也备了" → 不，明确排除
public/uploads/tmp