diff --git a/MAINTENANCE.md b/MAINTENANCE.md index c672b90..429e204 100644 --- a/MAINTENANCE.md +++ b/MAINTENANCE.md @@ -75,18 +75,18 @@ git push origin HEAD:<当前分支> 业务数据文件位于: ```text -/root/新时空数据/data/classnotes.txt -/root/新时空数据/data/学生课时账户.md -/root/新时空数据/data/admin_tasks.json -/root/新时空数据/data/course_summaries/ -/root/新时空数据/data/course_summary_state.json -/root/新时空数据/data/operation_logs.jsonl +/root/新时空教务管理系统/data/classnotes.txt +/root/新时空教务管理系统/data/学生课时账户.md +/root/新时空教务管理系统/data/admin_tasks.json +/root/新时空教务管理系统/data/course_summaries/ +/root/新时空教务管理系统/data/course_summary_state.json +/root/新时空教务管理系统/data/operation_logs.jsonl ``` 普通前端和查询类改动不应该改变这些文件;课程小结查询页是只读功能,也不应该改变这些文件。部署前后 `make data-hash` 输出应一致;如果涉及登记 API、课时账户编辑、课程小结自动入账或审核批准,先确认自动备份目录: ```text -/root/新时空数据/data/backups/ +/root/新时空教务管理系统/data/backups/ ``` 恢复备份时先停止服务,把备份文件复制回数据目录,再重新启动服务。 diff --git a/README.md b/README.md index c4d1fa6..0917bee 100644 --- a/README.md +++ b/README.md @@ -45,7 +45,7 @@ python3 scripts/deploy_to_vps.py --use-sshpass http://121.199.172.246:18080/ ``` -默认网页用户名为 `wolfydw`。网页密码只写入 VPS 的 `/root/新时空数据/app/.env`,不会提交进 Git。 +默认网页用户名为 `wolfydw`。网页密码只写入 VPS 的 `/root/新时空教务管理系统/新时空教务管理系统/.env`,不会提交进 Git。 如果 VPS 无法访问 Docker Hub,部署脚本会默认使用 `swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/library/python:3.12-slim` 作为基础镜像。需要更换时设置: @@ -71,7 +71,7 @@ python3 scripts/sync_to_vps.py --once --use-sshpass 远端数据目录: ```text -/root/新时空数据/data/ +/root/新时空教务管理系统/data/ ``` ## 课程小结推送 @@ -103,7 +103,7 @@ python3 /Users/yangdawei/Desktop/新时空业务源数据/新时空课程记录 把本机历史课程小结目录同步或上传到 VPS 后,可在容器内执行一次性导入。历史导入只重建小结库和状态;历史 `classnotes缺失.txt` 默认转为审核任务,不自动扣课时。 ```bash -cd /root/新时空数据/app +cd /root/新时空教务管理系统/新时空教务管理系统 docker compose exec xsk-education-management python scripts/import_course_summaries.py \ --source /data/import/课程小结采集 \ --target /data/course_summaries \ @@ -118,17 +118,17 @@ docker compose exec xsk-education-management python scripts/import_course_summar 通过登记 API、课程小结自动入账或审核批准修改正式课时数据时,服务会在写入前自动备份本次会改动的业务文件。正式数据和辅助状态位于: ```text -/root/新时空数据/data/classnotes.txt -/root/新时空数据/data/学生课时账户.md -/root/新时空数据/data/course_summaries/ -/root/新时空数据/data/course_summary_state.json -/root/新时空数据/data/operation_logs.jsonl +/root/新时空教务管理系统/data/classnotes.txt +/root/新时空教务管理系统/data/学生课时账户.md +/root/新时空教务管理系统/data/course_summaries/ +/root/新时空教务管理系统/data/course_summary_state.json +/root/新时空教务管理系统/data/operation_logs.jsonl ``` 备份目录位于: ```text -/root/新时空数据/data/backups/ +/root/新时空教务管理系统/data/backups/ ``` 每次登记生成一个事务备份目录,目录内包含变更前的业务文件副本和 `metadata.json`。系统自动保留最近 50 次备份,超过后删除最旧备份。 @@ -136,16 +136,16 @@ docker compose exec xsk-education-management python scripts/import_course_summar 查看备份: ```bash -ls -lt /root/新时空数据/data/backups/ +ls -lt /root/新时空教务管理系统/data/backups/ ``` 恢复某次备份时,先停止服务,再把对应备份目录里的文件复制回数据目录,最后重启服务: ```bash -cd /root/新时空数据/app +cd /root/新时空教务管理系统/新时空教务管理系统 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 +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 ``` @@ -179,10 +179,10 @@ rm ~/Library/LaunchAgents/com.xsk.education-management.sync.plist ## 更换网页访问密码 -登录 VPS 后修改 `/root/新时空数据/app/.env` 中的 `BASIC_AUTH_PASSWORD`,然后重启: +登录 VPS 后修改 `/root/新时空教务管理系统/新时空教务管理系统/.env` 中的 `BASIC_AUTH_PASSWORD`,然后重启: ```bash -cd /root/新时空数据/app +cd /root/新时空教务管理系统/新时空教务管理系统 docker compose up -d ``` diff --git a/scripts/deploy_to_vps.py b/scripts/deploy_to_vps.py index 4389c3b..e22c201 100755 --- a/scripts/deploy_to_vps.py +++ b/scripts/deploy_to_vps.py @@ -14,7 +14,7 @@ PROJECT_DIR = Path(__file__).resolve().parents[1] DEFAULT_REMOTE_HOST = "121.199.172.246" DEFAULT_REMOTE_USER = "root" DEFAULT_REMOTE_PORT = 22222 -DEFAULT_REMOTE_DIR = "/root/新时空数据" +DEFAULT_REMOTE_DIR = "/root/新时空教务管理系统" DEFAULT_IDENTITY_FILE = Path.home() / ".ssh" / "xsk_records_vps_ed25519" diff --git a/scripts/sync_to_vps.py b/scripts/sync_to_vps.py index 78271e6..069a3dd 100755 --- a/scripts/sync_to_vps.py +++ b/scripts/sync_to_vps.py @@ -16,7 +16,7 @@ DEFAULT_LOCAL_DIR = Path("/Users/yangdawei/Desktop/新时空业务源数据/新 DEFAULT_REMOTE_HOST = "121.199.172.246" DEFAULT_REMOTE_USER = "root" DEFAULT_REMOTE_PORT = 22222 -DEFAULT_REMOTE_DIR = "/root/新时空数据" +DEFAULT_REMOTE_DIR = "/root/新时空教务管理系统" DEFAULT_IDENTITY_FILE = Path.home() / ".ssh" / "xsk_records_vps_ed25519" SYNC_FILES = ("classnotes.txt", "学生课时账户.md")