Files
Academic-Affairs-System/web-react
T

明序校园 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 导出。
  • 迁移教师教学点名工作台,覆盖人工/扫码/定位签到、Excel 导入导出、提交及课程出勤统计。
  • 批量迁移教师授课意愿、等价课程规则、修读课程台账和学生余额管理四个教务工作流。
  • 迁移组织机构、学年学期、教学场所与课程分类基础数据,保留 Excel、服务端分页和学期归档审计闭环。
  • 迁移课程库游标台账,保留学院维护范围、先修关系、筛选导出、批量导入与归档审计。
  • 迁移培养方案管理,覆盖版本复制、模块与课程编制、公共课程组、发布替换和已发布方案受控调整。
  • 迁移教师与学生档案名册,覆盖分页筛选、完整个人资料、Excel、教师账号激活和人员归档审计。
  • 迁移教学任务管理,覆盖权限职责范围、草稿编制、授课资格、发布/归档流转、批量操作与公共课合班生成。
  • 迁移排课管理,覆盖版本修订、手工排课、后台自动排课和发布、作息、优化参数及课程约束。

迁移纪律

  1. 不因前端迁移修改后端业务合同;确需修改时必须单独评审。
  2. 每个页面迁移前登记路由、角色、API、写操作、查询参数和移动端行为。
  3. 页面只有在正常、空数据、异常、无权限和移动端状态都通过后才可标记完成。
  4. 未完成的页面返回 Vue 稳定版本,不提供半成品写操作。
  5. React 成为默认前端前,必须验证 PWA、Capacitor、SSO、TOTP、Passkey、文件导入导出及发布回滚。

迁移批次

批次 内容 状态
0 工程、主题、会话、登录、应用外壳 进行中
1 Dashboard、Users、Account、Notifications、个人课表、考试、学生档案、成绩、考勤、预警、选课与移动端代表页 已实现,进入联调验收
2 标准 CRUD 与基础数据模块 未开始
3 学生、教师与审批工作台 未开始
4 选课、排课、成绩、实验等复杂模块 未开始
5 PWA、Capacitor、发布切换与清理 未开始