湘湖未来学校 玩在未来课后服务平台

面向学校课后服务场景的校内部署教务管理系统。当前确认只服务一个校区，即 湘湖未来学校。第一阶段按“管理员建立课程与班级 -> 家长选课 -> 生成线下缴费单 -> 管理员确认收款 -> 自动发放课时并正式入班”的流程推进；数据存放在校内 NAS 上的 MariaDB 中，后续可通过内网穿透开放家长端访问。

技术路线

• Web 应用：PHP 8.1 + 原生页面
• 数据库：NAS 上的 MariaDB
• 部署：群晖 Web Station，直接把项目目录放到 /volume1/web/after-school-saas
• 第一阶段形态：校内单体 SaaS，后续可继续扩展教师端、家长端和接口层
• 当前部署策略：不再依赖 Docker，页面修改后可直接刷新查看

当前优先级

1. 管理员后台
2. 家长端选课与缴费通知
3. 管理员确认收款并自动发放课时
4. 教师点名、课堂发布、学员点评

核心模块

• 管理员：课程管理、班级排课、学员与家长、选课审核、收费订单、课时账户、教师审批
• 老师：课程申请、我的班级、课堂点名、课堂发布、学员评星点评
• 家长：选课手册、我的选课、缴费通知、班级详情、点名状态、课时情况、课程评价

本地预览

直接用浏览器打开 index.php 所在目录即可查看。页面默认提供三套演示账号，登录后能看到管理员、老师、家长三种工作台。

NAS 部署

目录位置

建议把项目放到：

/volume1/web/after-school-saas

然后在群晖 Web Station 中把站点根目录指向这个文件夹。

MariaDB 配置

复制 config.example.php 为 config.local.php，写入 NAS 的数据库连接信息即可。当前已经按 NAS 本机 MariaDB 设计好默认连接方式。

数据库初始化

导入 database/schema.sql，创建业务表和基础库。

同步脚本

chmod +x scripts/deploy-nas.sh
NAS_HOST=192.168.100.2 NAS_USER=codex scripts/deploy-nas.sh

脚本会把最新代码同步到 NAS 的 Web 目录，并保留 config.local.php 不被覆盖。

测试账号

• 管理员：admin / Admin@123456
• 老师：teacher / Teacher@123456
• 家长：parent / Parent@123456