biss
b19c40f09a
Add React workflows for experiments, campus registration, student approvals, account activation, document verification, classroom repair, venue displays, and teacher rosters. Wire role-aware navigation while preserving existing API authorization boundaries.
3.3 KiB
3.3 KiB
明序校园 React 迁移应用
这是现有 Vue 前端的并行迁移工程。迁移完成并通过验收前，web/ 仍是正式发布前端，web-react/ 不覆盖 src/Jiaowu.Api/wwwroot。
本地运行
先在仓库根目录启动 API，然后在此目录执行：
npm.cmd install
npm.cmd run dev
访问 http://127.0.0.1:5174/next/。Vite 会把 /api 和 /health 转发到 http://localhost:5255。
生产构建检查：
npm.cmd run build
当前范围
- React、TypeScript、Vite、React Router 基础工程；
- Ant Design 主题和项目设计令牌；
- 与 Vue 版本兼容的本地会话键、刷新 Token 和 401 处理；
- 账号密码、验证码和 TOTP 登录；
- 权限感知的应用外壳；
- 读取真实
/api/dashboard数据的首个页面； - 完整迁移
/account的身份信息、TOTP 和统一身份绑定流程； - 完整迁移
/users的分页筛选、Excel、账号、角色、状态和密码管理流程。 - 迁移
/notifications的收件箱、已读回执、权限范围/筛选/指定收件人群发和已发送记录； - 迁移
/my-timetable的周视图、考试与实验融合、Excel/PDF/ICS 导出和日历订阅管理。 - 迁移
/exams的学生考试与教师监考安排； - 迁移学生
/grades成绩单、绩点排名，以及/warnings预警确认和帮扶进度。 - 迁移学生
/my-profile个人档案、/my-attendance定位/二维码签到与申诉、/course-selections选课/退选和候补流程。 - 迁移学生
/my-curriculum培养方案进度、/academic-overview学业排名趋势与/free-classrooms空闲教室查询。 - 批量迁移学生校历、学籍异动、电子凭证、毕业审核和学费分项缴纳流程。
- 迁移学生其他考试成绩、补考安排和教学评价提交闭环。
- 迁移学生学业规划与毕业模拟、体质健康、学位授予和毕业离校进度。
- 迁移学生实验预约、实验成绩、校园报名缴费及免修/缓考/课程替代申请闭环。
- 迁移公开账号激活、电子凭证验真、教室扫码报修及场地信息屏。
- 迁移教师选课名单工作台，支持按学期查看本人教学班、学生支持信息和 Excel 导出。
迁移纪律
- 不因前端迁移修改后端业务合同；确需修改时必须单独评审。
- 每个页面迁移前登记路由、角色、API、写操作、查询参数和移动端行为。
- 页面只有在正常、空数据、异常、无权限和移动端状态都通过后才可标记完成。
- 未完成的页面返回 Vue 稳定版本，不提供半成品写操作。
- React 成为默认前端前，必须验证 PWA、Capacitor、SSO、TOTP、Passkey、文件导入导出及发布回滚。
迁移批次
| 批次 | 内容 | 状态 |
|---|---|---|
| 0 | 工程、主题、会话、登录、应用外壳 | 进行中 |
| 1 | Dashboard、Users、Account、Notifications、个人课表、考试、学生档案、成绩、考勤、预警、选课与移动端代表页 | 已实现，进入联调验收 |
| 2 | 标准 CRUD 与基础数据模块 | 未开始 |
| 3 | 学生、教师与审批工作台 | 未开始 |
| 4 | 选课、排课、成绩、实验等复杂模块 | 未开始 |
| 5 | PWA、Capacitor、发布切换与清理 | 未开始 |