| | |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | - **路由与菜单**：`routeConfig.tsx` 是唯一数据源，配置 `path`、`title`、`icon`、`element` 后侧边栏与面包屑自动生效。支持 2-3 级嵌套；分组路由（无 `element`）通过 `<Outlet />` 渲染并默认跳转到第一个子页面；未匹配路由显示 404。 |
|---|
| | | - **路由懒加载**：页面组件统一通过 `lazy(() => import('@/pages/...'))` 注册，`BasicLayout` 的内容区已提供 `<Suspense>` 边界；新增页面不要用静态 import，避免所有页面打进入口 chunk。 |
|---|
| | | - **登录态**：`src/store/auth.ts` 持久化 `token` 与 `user`；`src/api/auth.ts` 调用 `POST /auth/tenant-login`（`{ phone, password, tenantCode }`）。未登录访问受保护页面跳转 `/login`，登录成功后返回原地址。 |
|---|
| | | - **布局与样式**：页面只负责内容区。全局 CSS 变量 `--app-primary`、`--app-bg`、`--app-border`、`--app-text`、`--app-text-secondary`；通用类 `.page-header`、`.page-toolbar`、`.filter-card`、`.table-card`、`.text-muted`；Ant Design 主题在 `main.tsx` 的 `ConfigProvider` 统一配置。 |
|---|
| | | |
|---|
| | |
|---|
| | | /new-page 根据 <接口文档路径>，添加一个【页面名】页面，放到【分组名】目录下 |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | 仅改动现有页面（如调整某一列）等不涉及脚手架的场景才直接改代码。新页面必须在 `src/router/routeConfig.tsx` 用完整路径注册（`path`、`title`、`icon`、`element`，需要分组时使用 `children`），完成后执行 `npm run typecheck`。 |
|---|
| | | 仅改动现有页面（如调整某一列）等不涉及脚手架的场景才直接改代码。新页面必须在 `src/router/routeConfig.tsx` 用完整路径注册（`path`、`title`、`icon`、`element`，需要分组时使用 `children`），页面组件使用 `lazy(() => import(...))` 懒加载，完成后执行 `npm run typecheck`。 |
|---|
| | | |
|---|
| | | ## 五、接口与状态约定 |
|---|
| | | |
|---|
| | |
|---|
| | | |
|---|
| | | - 使用 BrowserRouter，生产环境需配置 SPA fallback：所有前端路由回退到 `index.html`；构建产物在 `dist/`。 |
|---|
| | | - 开发环境通过 Vite 代理 `/proxy-api` 转发到 `VITE_API_PROXY_TARGET`（未配置时取 `VITE_API_BASE_URL`），浏览器端不会跨域；生产环境需后端开启 CORS，或将前端与接口部署在同一域名下由反向代理转发。 |
|---|
| | | - 当前主包较大（Ant Design 全量依赖），后续可通过路由懒加载 / 手动分包优化。 |
|---|
| | | - 已启用路由懒加载与依赖拆包：`vite.config.ts` 的 `manualChunks` 将 React、antd 核心、其余依赖拆成长缓存 chunk，ProComponents 及业务页面依赖由 Rollup 按需拆分为异步 chunk。新增页面时保持懒加载即可，无需再调整拆包配置。 |
|---|
