safety-eval-service-frontend/.cursor/skills/specs/03-项目页面结构/03-页面目录规则/SKILL.md

1.6 KiB
Raw Blame History

name description
jjb-page-directory-rules 定义 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