完善维护入口并处理课程小结审核

app/MAINTENANCE.md

@@ -2,6 +2,8 @@
 
 新时空教务管理系统长期维护时，目标是每次更新都能做到可检查、可部署、可回滚，并且不误改业务数据。
 
+以下命令默认在仓库根目录 `/root/新时空教务管理系统` 执行。根目录 `Makefile` 会转发到 `app/` 下的实际应用配置；不要在根目录直接运行裸 `docker compose`，需要直接调用时使用 `docker compose -f app/docker-compose.yml <命令>`。
+
 ## 日常更新流程
 
 1. 查看当前改动：

app/README.md

@@ -15,6 +15,22 @@
 - `scripts/install_launch_agent.py`：安装 Mac 开机常驻同步任务。
 - `launchd/com.xsk.education-management.sync.plist.template`：LaunchAgent 模板。
 
+## 维护入口
+
+推荐在仓库根目录 `/root/新时空教务管理系统` 执行日常维护命令：
+
+```bash
+make check
+make smoke
+make deploy
+```
+
+根目录 `Makefile` 会自动转发到 `app/` 下的实际应用配置，避免在错误目录执行 `docker compose` 或 `make deploy`。需要直接运行 Docker Compose 时，使用：
+
+```bash
+docker compose -f app/docker-compose.yml <命令>
+```
+
 ## 后端结构
 
 - `app/main.py`：FastAPI 应用入口，只负责注册路由和全局异常处理。