背景: - 前端路由缺少统一规范:导航模块 key 与 URL 首段不一致,页面目录未镜像 路由,04 规范中的历史路由示例与实际实现不符; - 用户确认「平台」更名为「管理中心」,路由统一为 /<模块>/<功能>。 改动: - 新增 11-前端路由与目录规范:模块与基础路径表、路径语法(复数 kebab-case、 /new、:id、层级与 query 状态)、pages/<模块>/<功能>/ 目录映射、路由注册、 旧链重定向、新增页面检查清单; - 04 §8 的 API-27 改为模块化路由并链接 11;工程规范索引与 AGENTS §9 登记 11; - 开发计划:平台更名管理中心,附录 C 页面清单收敛为模块化路由,§7.1 / §8.3 同步,版本记录补「路由规范回写」; - A1 实施报告路由说明更新为 /system/users(旧 /users* 重定向)。 影响面: - 仅文档与规范,不改变功能范围、权限点与后端接口;后续批次按 11 执行。 回滚方式: - 回滚本提交即恢复原附录 C 与 04 §8 描述;代码不受影响。 验证证据: - pnpm format:check 通过;路由与代码行为见相邻的 web 重构提交。
This commit is contained in:
1 parent
f8b6232b4c
commit
a1e28daec5
6 files changed
+152
-22
No files matched your search
@@ -129,8 +129,10 @@ JwtGuard → PermissionGuard(权限点)→ SpecialPermissionGuard(特殊
|
||||
|
||||
## 8 前端路由
|
||||
|
||||
> 前端路由的模块表、路径语法与目录映射以 [11](11-前端路由与目录规范.md) 为准;本节保留通用约束。
|
||||
|
||||
- `API-26` 路由常量集中 `apps/web/src/routes.ts`,禁止散落字符串路径。
|
||||
- `API-27` 路径反映「行业 → 客户」归属:`/clients/:clientId/scripts`、`/clients/:clientId/media/batches/:batchId`。
|
||||
- `API-27` 前端路由统一为 `/<模块>/<功能>`:`/system/users`、`/scripts/library`;模块表、目录映射与旧路径重定向见 [11 · 前端路由与目录规范](11-前端路由与目录规范.md)。
|
||||
- `API-28` 统一布局路由:登录后进入 `AppLayout`(侧边导航 + 面包屑),未登录访问自动跳 `/login` 并带回跳地址。
|
||||
- `API-29` 权限守卫组件 `<RequirePermission code="SCRIPT_APPROVE">`;无权限渲染 403 页,**不隐藏路由**(避免"菜单有、点进去白屏")。
|
||||
- `API-30` 页面级懒加载(`React.lazy` + `Suspense`),首屏包体积纳入性能预算。
|
||||
|
||||
Reference in new issue
Block a user