lanyuanxiaoyao
4caf502908
- 引入 React Router v7 (Declarative mode) 实现 SPA 路由 - 重构 Layout 为 Header + 侧边栏 + 内容区的企业 Admin 布局 - 新增侧边栏菜单组件，支持折叠/展开，状态持久化到 localStorage - 新增示例页面：仪表盘、用户管理、系统设置、404 - 菜单配置与路由统一为单一数据源 (menu.tsx) - Vite code splitting 新增 vendor-router 组 - 更新 DEVELOPMENT.md 和 README.md 文档
1.8 KiB
1.8 KiB
1. 依赖与配置
- 1.1 安装 react-router 依赖
- 1.2 更新 vite.config.ts code splitting 配置，新增 vendor-router 组
2. 工具与 Hook
- 2.1 创建 src/web/menu.tsx，定义菜单项配置
- 2.2 创建 src/web/hooks/use-sidebar-collapsed.ts，实现侧边栏折叠状态 hook
3. 页面组件
- 3.1 创建 src/web/pages/dashboard/index.tsx，迁移原 app.tsx 内容区逻辑
- 3.2 创建 src/web/pages/users/index.tsx，实现用户管理占位页面
- 3.3 创建 src/web/pages/settings/index.tsx，实现系统设置占位页面
- 3.4 创建 src/web/pages/404/index.tsx，实现 404 页面
4. 侧边栏组件
- 4.1 创建 src/web/components/Sidebar/index.tsx，实现侧边栏菜单组件
5. 路由配置
- 5.1 创建 src/web/routes.tsx，定义所有路由
6. 根组件重构
- 6.1 重构 src/web/app.tsx，实现 Header + Aside + Content 布局
- 6.2 修改 src/web/main.tsx，添加 BrowserRouter 包裹
7. 样式更新
- 7.1 更新 src/web/styles.css，迁移 .dashboard-* 为 .app-*，新增布局样式
8. 测试工具增强
- 8.1 增强 tests/web/test-utils.tsx，提供 renderWithProviders 函数
9. 组件测试
- 9.1 创建 tests/web/components/Sidebar/index.test.tsx
- 9.2 创建 tests/web/routes/dashboard.test.tsx
- 9.3 创建 tests/web/routes/users.test.tsx
- 9.4 创建 tests/web/routes/settings.test.tsx
- 9.5 创建 tests/web/routes/404.test.tsx
- 9.6 更新 tests/web/App.test.tsx 适配 BrowserRouter
10. 文档更新
- 10.1 更新 DEVELOPMENT.md，更新技术栈表格、组件树、目录结构说明
- 10.2 更新 README.md，更新技术栈表格、项目结构说明
11. 质量保障
- 11.1 运行 bun run check 确保类型检查、lint、测试通过
- 11.2 运行 bun run build 验证构建成功