gongxue-base/.omp/APPEND_SYSTEM.md

恭学教育学生管理系统 — 项目约束

完整 PRD 文档：../../Downloads/PRD-恭学教育学生管理系统.md（相对项目根目录）

技术栈

层级	技术
架构	Monorepo (Turborepo)
前端	React 19 + Vite + Ant Design 6 + ECharts
后端	NestJS 11 + TypeORM 0.3 + JWT + Passport
数据库	开发 SQLite / 生产 MySQL 8
部署	Docker Compose (MySQL + NestJS + Nginx)

核心用户角色

• 超级管理员：系统配置、账号管理、全部数据
• 教职工（宿管+财务）：宿舍管理、费用录入、账单生成、指定部门
• 班主任：本班学生信息、档案、费用、考勤
• 学生：仅本人数据

业务域

• 学员管理域：学生管理、学生档案、考勤管理
• 教务管理域：班级管理（新）、排课管理（新）、教师管理、教室管理
• 住宿管理域：宿舍管理、入住管理
• 财务运营域：费用管理、账单管理、押金管理、租赁方管理、数据面板

横切关注点

• RBAC 权限控制
• 操作日志（所有关键写操作）
• 钉钉/企业微信集成
• 报表导出、批量导入

上线优先级

P0（阻塞上线）：班级管理、排课管理、宿舍管理增强、账单管理（长租）、操作日志 P1（上线前完成）：考勤管理前端、数据面板、RBAC 扩展、教室管理增强、organization→tenant_id P2（可迭代）：报表导出、教师档案增强、多班型对比、押金分期、第三方集成

编码规范

• 所有涉及大量数据的列表/表单页面必须有详细的筛选方案
• 敏感信息（手机号、身份证）需脱敏展示，查看时二次确认+记录日志
• 遵循现有 NestJS 模块结构：每个业务模块独立目录，含 entity/dto/service/controller
• 前端页面放在 apps/admin/src/pages/ 下，每个模块独立目录