48 lines
1.9 KiB
Markdown
48 lines
1.9 KiB
Markdown
# 恭学教育学生管理系统 — 项目约束
|
||
|
||
完整 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/` 下，每个模块独立目录
|