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

完整 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/` 下，每个模块独立目录