一条命令跑起来

需要 Node ≥ 22、pnpm 10、Docker。

git clone https://github.com/manzhi-tech/opskool-ce
cd opskool-ce
pnpm demo

pnpm demo = docker compose -f deploy/compose.demo.yml up --build，它会起 Postgres → 跑迁移 → 写种子数据 → 起 web（:4800）与 jobs，并在日志里打印演示账号与初始密码。

打开 http://localhost:4800 登录。

停止：

docker compose -f deploy/compose.demo.yml down      # 保留数据卷
docker compose -f deploy/compose.demo.yml down -v   # 连数据卷一起清掉

如果你想做开发而不是看演示

make setup     # pnpm install + 复制 .env + 起本地 Postgres + migrate + seed
make dev       # web(:4800) + jobs 并起

make help 列出全部命令。质量门是 make check（lint + 类型检查 + 依赖方向检查）与 make build——社区版不随附测试用例，见社区版与专业版对照。

种子不能跳过

无论哪条路，都必须跑过一次种子，否则登录进去排课、班级、花名册全是关的。原因见首次初始化必读。

端口被占了

宿主机端口锁在 4800-4809 段（4800 web、4802 Postgres）。要换 web 端口， export PORT=4807 到 shell 里再起——写进 .env 不生效。见部署前须知。

下一步

跑起来之后，先读核心概念，再从建校区开始录数据。