32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
|
---
|
|||
|
|
name: jjb-page-directory-rules
|
|||
|
|
description: 定义 JJB 项目页面目录规则。在创建新页面、区分 Container 与外部页面、配置 appIdentifier/container 路由时使用。
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 项目页面结构
|
|||
|
|
|
|||
|
|
## 页面目录规则
|
|||
|
|
|
|||
|
|
- **页面目录**：
|
|||
|
|
- **常规页面（在底座中访问）**：所有需要在底座（主应用）中访问的页面统一放在 `src/pages/Container/`
|
|||
|
|
- **路由约束**：后端资源输出系统要求，在底座中访问子应用路由必须是 `appIdentifier/container/xxx` 格式，否则是不合法路由，无法访问
|
|||
|
|
- **Container 下页面的独立访问**：若 `Container` 下的页面需要脱离底座独立打开访问，必须在路由 URL 上拼接 `token=<平台登录token>` 参数，否则会被网关拦截无法访问。例如：`/appIdentifier/container/UserList?token=xxx`
|
|||
|
|
- **外部页面（独立页面）**：应用提供的完全独立页面（不在底座中访问的页面）可以不放在 `Container` 下，直接放在 `src/pages/` 目录下
|
|||
|
|
- **默认规则**：通常新增页面都是底座中打开的，除非提示语明确要求是外部页面。
|
|||
|
|
|
|||
|
|
- **新增页面流程**：
|
|||
|
|
|
|||
|
|
1. 先创建文件夹
|
|||
|
|
|
|||
|
|
2. 再创建 `index.js`
|
|||
|
|
|
|||
|
|
- **嵌套路由**：若该文件夹下还要继续建子路由目录（如 `_id`），父级**仍须**有 `index.js`，并在组件内渲染 **`props.children`** 以承接子路由。详见 **`06-动态路由规范/SKILL.md`**（「嵌套路由父级 `index.js`（必须）」）。
|
|||
|
|
|
|||
|
|
- **公共组件目录**：所有公共组件统一放在 `src/components/`
|
|||
|
|
|
|||
|
|
- **新增组件流程**：
|
|||
|
|
|
|||
|
|
1. 先创建文件夹
|
|||
|
|
|
|||
|
|
2. 再创建 `index.js`
|