---
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`