源码树和文件组织
版本信息
| 版本 |
日期 |
描述 |
作者 |
| 3.0 |
2025-10-15 |
更新为出行服务项目源码树 |
Winston |
实际项目结构
出行服务项目/
├── mini/ # Mini小程序应用
│ ├── pages/ # 小程序页面
│ │ ├── index/ # 首页
│ │ ├── activities/ # 活动页面
│ │ ├── routes/ # 路线页面
│ │ ├── orders/ # 订单页面
│ │ └── profile/ # 个人中心
│ ├── components/ # 小程序组件
│ ├── utils/ # 小程序工具函数
│ └── app.json # 小程序配置文件
├── mini-demo/ # Mini演示应用
│ ├── pages/ # 演示页面
│ ├── components/ # 演示组件
│ └── app.json # 演示应用配置
├── src/
│ ├── client/ # React前端应用
│ │ ├── admin/ # 管理后台应用
│ │ │ ├── components/ # 管理后台专用组件
│ │ │ │ ├── ProtectedRoute.tsx # 路由保护组件
│ │ │ │ ├── ErrorPage.tsx # 错误页面
│ │ │ │ └── NotFoundPage.tsx # 404页面
│ │ │ ├── hooks/ # 管理后台Hooks
│ │ │ │ └── AuthProvider.tsx # 认证状态管理
│ │ │ ├── layouts/ # 布局组件
│ │ │ │ └── MainLayout.tsx # 主布局
│ │ │ ├── pages/ # 页面组件
│ │ │ │ ├── Dashboard.tsx # 仪表板
│ │ │ │ ├── Login.tsx # 登录页面
│ │ │ │ └── Users.tsx # 用户管理
│ │ │ ├── routes.tsx # 路由配置
│ │ │ └── index.tsx # 管理后台入口
│ │ ├── home/ # 用户前台应用
│ │ │ ├── pages/ # 前台页面
│ │ │ │ ├── ActivityList.tsx # 活动列表页面
│ │ │ │ ├── ActivityDetail.tsx # 活动详情页面
│ │ │ │ ├── RouteDetail.tsx # 路线详情页面
│ │ │ │ ├── OrderList.tsx # 订单列表页面
│ │ │ │ ├── OrderDetail.tsx # 订单详情页面
│ │ │ │ └── Payment.tsx # 支付页面
│ │ │ ├── components/ # 前台专用组件
│ │ │ │ ├── ActivityCard.tsx # 活动卡片组件
│ │ │ │ ├── RouteCard.tsx # 路线卡片组件
│ │ │ │ ├── PassengerForm.tsx # 乘客信息表单
│ │ │ │ └── OrderSummary.tsx # 订单摘要组件
│ │ │ └── hooks/ # 前台Hooks
│ │ │ ├── useActivities.ts # 活动相关Hook
│ │ │ ├── useRoutes.ts # 路线相关Hook
│ │ │ └── useOrders.ts # 订单相关Hook
│ │ ├── components/ # 共享UI组件
│ │ │ └── ui/ # shadcn/ui组件库（50+组件）
│ │ │ ├── button.tsx # 按钮组件
│ │ │ ├── input.tsx # 输入框组件
│ │ │ ├── table.tsx # 表格组件
│ │ │ └── ... # 其他组件
│ │ ├── hooks/ # 共享Hooks
│ │ ├── lib/ # 工具库
│ │ ├── utils/ # 工具函数
│ │ ├── api.ts # API客户端配置
│ │ └── index.tsx # 前端入口
│ ├── server/ # Hono后端应用
│ │ ├── api/ # API路由
│ │ │ ├── auth/ # 认证相关路由
│ │ │ │ ├── login.ts # 登录路由
│ │ │ │ ├── logout.ts # 登出路由
│ │ │ │ └── register.ts # 注册路由
│ │ │ ├── users/ # 用户管理路由
│ │ │ │ ├── index.ts # 用户列表路由
│ │ │ │ ├── [id].ts # 用户详情路由
│ │ │ │ └── __tests__/ # 路由测试
│ │ │ ├── roles/ # 角色管理路由
│ │ │ ├── files/ # 文件管理路由
│ │ │ │ ├── multipart-policy/ # 多部分上传策略
│ │ │ │ ├── multipart-complete/ # 完成多部分上传
│ │ │ │ ├── [id]/ # 文件操作路由
│ │ │ │ └── upload-policy/ # 上传策略路由
│ │ │ ├── activities/ # 活动管理路由
│ │ │ │ ├── index.ts # 活动列表路由
│ │ │ │ ├── [id].ts # 活动详情路由
│ │ │ │ └── __tests__/ # 路由测试
│ │ │ ├── routes/ # 路线管理路由
│ │ │ │ ├── index.ts # 路线列表路由
│ │ │ │ ├── [id].ts # 路线详情路由
│ │ │ │ └── __tests__/ # 路由测试
│ │ │ ├── orders/ # 订单管理路由
│ │ │ │ ├── index.ts # 订单列表路由
│ │ │ │ ├── [id].ts # 订单详情路由
│ │ │ │ └── __tests__/ # 路由测试
│ │ │ ├── passengers/ # 乘客管理路由
│ │ │ │ ├── index.ts # 乘客列表路由
│ │ │ │ ├── [id].ts # 乘客详情路由
│ │ │ │ └── __tests__/ # 路由测试
│ │ │ └── __integration_tests__/ # 集成测试
│ │ ├── modules/ # 业务模块
│ │ │ ├── auth/ # 认证业务模块
│ │ │ │ ├── auth.service.ts # 认证服务
│ │ │ │ └── __tests__/ # 认证测试
│ │ │ ├── users/ # 用户业务模块
│ │ │ │ ├── user.entity.ts # 用户实体
│ │ │ │ ├── user.service.ts # 用户服务
│ │ │ │ └── __tests__/ # 用户测试
│ │ │ ├── files/ # 文件业务模块
│ │ │ │ ├── file.entity.ts # 文件实体
│ │ │ │ ├── file.service.ts # 文件服务
│ │ │ │ ├── minio.service.ts # MinIO服务
│ │ │ │ ├── file.schema.ts # 文件验证Schema
│ │ │ │ └── __tests__/ # 文件测试
│ │ │ ├── activities/ # 活动业务模块
│ │ │ │ ├── activity.entity.ts # 活动实体
│ │ │ │ ├── activity.service.ts # 活动服务
│ │ │ │ └── __tests__/ # 活动测试
│ │ │ ├── routes/ # 路线业务模块
│ │ │ │ ├── route.entity.ts # 路线实体
│ │ │ │ ├── route.service.ts # 路线服务
│ │ │ │ └── __tests__/ # 路线测试
│ │ │ ├── orders/ # 订单业务模块
│ │ │ │ ├── order.entity.ts # 订单实体
│ │ │ │ ├── order.service.ts # 订单服务
│ │ │ │ └── __tests__/ # 订单测试
│ │ │ └── passengers/ # 乘客业务模块
│ │ │ │ ├── passenger.entity.ts # 乘客实体
│ │ │ │ ├── passenger.service.ts # 乘客服务
│ │ │ │ └── __tests__/ # 乘客测试
│ │ ├── utils/ # 工具层
│ │ │ ├── generic-crud.service.ts # 通用CRUD服务
│ │ │ ├── generic-crud.routes.ts # 通用CRUD路由
│ │ │ ├── errorHandler.ts # 错误处理
│ │ │ ├── backup.ts # 数据库备份工具
│ │ │ ├── restore.ts # 数据库恢复工具
│ │ │ ├── logger.ts # 日志工具
│ │ │ └── __tests__/ # 工具测试
│ │ ├── middleware/ # 中间件层
│ │ │ ├── auth.middleware.ts # 认证中间件
│ │ │ └── permission.middleware.ts # 权限中间件
│ │ ├── types/ # 类型定义
│ │ ├── data-source.ts # 数据库连接配置
│ │ └── index.ts # 服务器入口
│ └── share/ # 前后端共享代码
│ ├── types.ts # TypeScript类型定义
│ ├── activity.types.ts # 活动相关类型
│ ├── route.types.ts # 路线相关类型
│ ├── order.types.ts # 订单相关类型
│ └── passenger.types.ts # 乘客相关类型
├── tests/
│ └── e2e/ # E2E测试 (Playwright)
└── package.json
集成指南
- 文件命名: 保持现有kebab-case命名约定
- 文件夹组织: 遵循功能模块划分，添加tests文件夹
- 测试结构: 单元测试位于
__tests__/目录，集成测试位于__integration_tests__/目录
- 导入/导出模式: 使用ES模块，保持现有别名系统（@/）
- 测试位置: 前端集成测试位于
__integration_tests__/，页面单元测试位于__tests__/
- 后端测试: API测试位于路由
__tests__/目录，服务测试位于模块__tests__/目录
- 工具测试: 通用工具测试位于
utils/__tests__/目录
- Mini小程序: 使用Taro框架开发，支持微信小程序
- Mini演示应用: 用于功能演示和测试的独立小程序应用
