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

Makefile

@@ -0,0 +1,40 @@
+SHELL := /bin/bash
+
+APP_DIR := app
+APP_MAKE := $(MAKE) -C $(APP_DIR) --no-print-directory
+COMPOSE := docker compose -f $(APP_DIR)/docker-compose.yml
+
+.PHONY: check smoke data-hash build up ps health deploy logs install-gitea-backup compose-config
+
+check:
+	$(APP_MAKE) check
+
+smoke:
+	$(APP_MAKE) smoke
+
+data-hash:
+	$(APP_MAKE) data-hash
+
+build:
+	$(APP_MAKE) build
+
+up:
+	$(APP_MAKE) up
+
+ps:
+	$(APP_MAKE) ps
+
+health:
+	$(APP_MAKE) health
+
+deploy:
+	$(APP_MAKE) deploy
+
+logs:
+	$(APP_MAKE) logs
+
+install-gitea-backup:
+	$(APP_MAKE) install-gitea-backup
+
+compose-config:
+	$(COMPOSE) config

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 应用入口，只负责注册路由和全局异常处理。