工作台总览
汇总机构、班级、学生、签到、作业、反馈、动态、错题和签退指标，支持按班级查看每日运营状态。
覆盖托管机构日常运营的核心模块
系统从工作台出发，把学生档案、课堂过程、家校沟通和运营数据串成一条连续链路。
学生档案管理
维护学生基础资料、监护人、接送人、紧急联系人、健康信息、转班离园记录和缴费记录。
班级与学科配置
配置班级负责人、容量、学科关系和学生名册，为考勤、作业、反馈和错题流程提供基础数据。
到校与离校管理
支持签到、迟到、接送确认、异常上报、临时代领、家长提醒和接送核验记录。
作业登记与反馈
按学生和学科登记作业内容、图片、音频和完成状态，并生成评价、星级、评语与家长推送记录。
错题本与学习闭环
支持拍照采集、审核入库、掌握度更新、同类变式、打印任务和家长通知，沉淀个性化学习资料。
班级成长动态
发布图文动态，关联学生、标签、评论和点赞，帮助机构沉淀日常成长记录与家校互动内容。
机构资料与权限
支持机构信息维护、账号登录、JWT 鉴权、角色权限控制和多机构账号绑定。
部署与数据初始化
内置数据库初始化、演示数据、生产打包脚本和环境配置，便于本地调试与服务器部署。
从入园到反馈的业务闭环
每个操作都落到数据库业务表，工作台统计会随内页数据保存同步变化。
学生建档
录入学生、监护人、接送人、健康和缴费信息，建立完整的机构内学生档案。
日常托管
围绕班级执行签到、作业登记、签退确认、异常上报和家长通知。
学习反馈
按学科完成作业评价、整体评语、AI 建议记录和反馈发送，形成可追踪记录。
运营复盘
通过工作台和历史记录查看到校、作业、反馈、动态、错题和接送完成情况。
清晰的前后端分层架构
小程序不直接连接数据库，所有业务通过 HTTP API 访问后端，后端再读写 MySQL。
小程序前端
- 路径：apps/miniprogram
- 页面：登录、工作台、动态、档案、考勤、作业、错题、机构等
- 组件：KPI 卡片、学生卡片、状态标签、语音录制、空状态等
Node.js API
- 路径：apps/api
- 框架：Express
- 能力：鉴权、租户隔离、业务路由、媒体静态服务、错误处理
MySQL 数据库
- 数据库：tgedu_merged
- 脚本：初始化、核心数据、考勤、工作台、错题、个人中心、运营记录
- 约束：业务表包含 institution_id 支持多机构隔离
关键接口与项目结构
仓库已经把前端、后端、数据库脚本和生产打包脚本合并在同一项目中，便于交付和维护。
项目根目录D:\otherproject\tgedu-merged
小程序源码apps/miniprogram
API 服务apps/api，默认监听 3001
数据库脚本apps/api/sql 与 tgedu_merged.sql
生产包dist/tgedu-merged-production.zip
GET /health
POST /auth/account-login
GET /profile
GET /home/summary
GET /classes
GET /students
POST /students/create
GET /checkin
POST /checkout/confirm
GET /homework
POST /homework-feedback/send
GET /feeds
GET /mistake-book/grouped适合外网服务器展示与后续部署
当前页面是静态 HTML，可放在 Web 服务根目录；业务系统后端可按生产配置单独启动。
静态介绍页
本页面将保存为 D:\testhtml\index.html。只要服务器把 D:\testhtml 作为 Web 根目录或静态目录，即可通过阿里云外网 IP + 端口访问。
后端生产配置位于 apps/api/.env.production，可使用 NODE_ENV=production npm start 启动；Windows 环境可通过 npm run pack:prod 生成上传包。