添加数据备份和快捷查询优化

2026-06-12 02:50:15 +08:00
parent a18ef4fc42
commit af6cec50cf
5 changed files with 149 additions and 5 deletions
@@ -1,6 +1,6 @@
 # 新时空课程记录查询网页

-这是一个只读查询工具，用于把本机正式业务源中的 `classnotes.txt` 和 `学生课时账户.md` 同步到 VPS，并通过网页查询上课记录和课时账户。
+这是一个课程记录查询和登记工具，用于把本机正式业务源中的 `classnotes.txt` 和 `学生课时账户.md` 同步到 VPS，并通过网页查询上课记录、课时账户和登记新增记录。

 ## 目录

@@ -55,6 +55,32 @@ python3 scripts/sync_to_vps.py --once --use-sshpass
 /root/新时空数据/data/
 ```

+## 数据备份
+
+通过登记 API 修改数据时，服务会在写入前自动备份本次会改动的业务文件。备份目录位于：
+
+```text
+/root/新时空数据/data/backups/
+```
+
+每次登记生成一个事务备份目录，目录内包含变更前的业务文件副本和 `metadata.json`。系统自动保留最近 50 次备份，超过后删除最旧备份。
+
+查看备份：
+
+```bash
+ls -lt /root/新时空数据/data/backups/
+```
+
+恢复某次备份时，先停止服务，再把对应备份目录里的文件复制回数据目录，最后重启服务：
+
+```bash
+cd /root/新时空数据/app
+docker compose stop
+cp /root/新时空数据/data/backups/<备份目录>/classnotes.txt /root/新时空数据/data/classnotes.txt 2>/dev/null || true
+cp /root/新时空数据/data/backups/<备份目录>/学生课时账户.md /root/新时空数据/data/学生课时账户.md 2>/dev/null || true
+docker compose up -d
+```
+
 ## 安装自动同步

 ```bash