biss
93ab6a7b9e
Add React account and user administration flows, including TOTP and SSO handling. Route /next SSO callbacks to React while preserving the existing Vue and native app behavior, and cover the routing policy with API tests.
51 lines
1.9 KiB
Markdown
51 lines
1.9 KiB
Markdown
# 明序校园 React 迁移应用
|
|
|
|
这是现有 Vue 前端的并行迁移工程。迁移完成并通过验收前，`web/` 仍是正式发布前端，`web-react/` 不覆盖 `src/Jiaowu.Api/wwwroot`。
|
|
|
|
## 本地运行
|
|
|
|
先在仓库根目录启动 API，然后在此目录执行：
|
|
|
|
```powershell
|
|
npm.cmd install
|
|
npm.cmd run dev
|
|
```
|
|
|
|
访问 `http://127.0.0.1:5174/next/`。Vite 会把 `/api` 和 `/health` 转发到 `http://localhost:5255`。
|
|
|
|
生产构建检查：
|
|
|
|
```powershell
|
|
npm.cmd run build
|
|
```
|
|
|
|
## 当前范围
|
|
|
|
- React、TypeScript、Vite、React Router 基础工程；
|
|
- Ant Design 主题和项目设计令牌；
|
|
- 与 Vue 版本兼容的本地会话键、刷新 Token 和 401 处理；
|
|
- 账号密码、验证码和 TOTP 登录；
|
|
- 权限感知的应用外壳；
|
|
- 读取真实 `/api/dashboard` 数据的首个页面；
|
|
- 完整迁移 `/account` 的身份信息、TOTP 和统一身份绑定流程；
|
|
- 完整迁移 `/users` 的分页筛选、Excel、账号、角色、状态和密码管理流程。
|
|
|
|
## 迁移纪律
|
|
|
|
1. 不因前端迁移修改后端业务合同；确需修改时必须单独评审。
|
|
2. 每个页面迁移前登记路由、角色、API、写操作、查询参数和移动端行为。
|
|
3. 页面只有在正常、空数据、异常、无权限和移动端状态都通过后才可标记完成。
|
|
4. 未完成的页面返回 Vue 稳定版本，不提供半成品写操作。
|
|
5. React 成为默认前端前，必须验证 PWA、Capacitor、SSO、TOTP、Passkey、文件导入导出及发布回滚。
|
|
|
|
## 迁移批次
|
|
|
|
| 批次 | 内容 | 状态 |
|
|
| --- | --- | --- |
|
|
| 0 | 工程、主题、会话、登录、应用外壳 | 进行中 |
|
|
| 1 | Dashboard、Users、Account、移动端代表页 | 前三项进入联调验收 |
|
|
| 2 | 标准 CRUD 与基础数据模块 | 未开始 |
|
|
| 3 | 学生、教师与审批工作台 | 未开始 |
|
|
| 4 | 选课、排课、成绩、实验等复杂模块 | 未开始 |
|
|
| 5 | PWA、Capacitor、发布切换与清理 | 未开始 |
|