Procházet zdrojové kódy

📝 docs(architecture): 更新项目结构和测试文档

- 修正Mini小程序目录结构,明确Taro项目架构
- 细化测试目录结构,区分单元测试、集成测试和E2E测试位置
- 添加版本记录,更新为3.1版本
- 补充Taro小程序测试体系说明,明确其独立项目性质
- 统一测试文件存放规范,提高项目文档清晰度
yourname před 4 měsíci
rodič
revize
4d348931fe

+ 39 - 19
docs/architecture/source-tree.md

@@ -3,21 +3,30 @@
 ## 版本信息
 | 版本 | 日期 | 描述 | 作者 |
 |------|------|------|------|
+| 3.1 | 2025-10-16 | 修正测试目录结构,更新Mini小程序结构 | Winston |
 | 3.0 | 2025-10-15 | 更新为出行服务项目源码树 | Winston |
 
 ## 实际项目结构
 ```text
 出行服务项目/
-├── mini/                       # Mini小程序应用
-│   ├── pages/                  # 小程序页面
-│   │   ├── index/              # 首页
-│   │   ├── activities/         # 活动页面
-│   │   ├── routes/             # 路线页面
-│   │   ├── orders/             # 订单页面
-│   │   └── profile/            # 个人中心
-│   ├── components/             # 小程序组件
-│   ├── utils/                  # 小程序工具函数
-│   └── app.json               # 小程序配置文件
+├── mini/                       # Mini小程序应用 (Taro项目)
+│   ├── src/                    # 小程序源码
+│   │   ├── pages/              # 小程序页面
+│   │   │   ├── index/          # 首页
+│   │   │   ├── activities/     # 活动页面
+│   │   │   ├── routes/         # 路线页面
+│   │   │   ├── orders/         # 订单页面
+│   │   │   └── profile/        # 个人中心
+│   │   ├── components/         # 小程序组件
+│   │   ├── utils/              # 小程序工具函数
+│   │   ├── layouts/            # 布局组件
+│   │   ├── schemas/            # 数据验证模式
+│   │   ├── app.config.ts       # 应用配置
+│   │   ├── app.tsx            # 应用入口
+│   │   └── api.ts             # API客户端
+│   ├── config/                 # 构建配置
+│   ├── dist/                   # 构建输出
+│   └── package.json           # 项目依赖配置
 ├── mini-demo/                  # Mini演示应用
 │   ├── pages/                  # 演示页面
 │   ├── components/             # 演示组件
@@ -150,18 +159,29 @@
 │       ├── route.types.ts     # 路线相关类型
 │       ├── order.types.ts     # 订单相关类型
 │       └── passenger.types.ts # 乘客相关类型
-├── tests/
-│   └── e2e/                    # E2E测试 (Playwright)
+├── tests/                      # 测试目录
+│   ├── e2e/                    # E2E测试 (Playwright)
+│   │   ├── fixtures/           # 测试数据
+│   │   ├── pages/              # 页面测试
+│   │   ├── specs/              # 测试规范
+│   │   └── utils/              # 测试工具
+│   ├── integration/            # 集成测试
+│   │   ├── client/             # 前端集成测试
+│   │   └── server/             # 后端集成测试
+│   ├── unit/                   # 单元测试
+│   │   ├── client/             # 前端单元测试
+│   │   └── server/             # 后端单元测试
+│   └── utils/                  # 测试工具
 └── package.json
 ```
 
 ## 集成指南
 - **文件命名**: 保持现有kebab-case命名约定
-- **文件夹组织**: 遵循功能模块划分,添加__tests__文件夹
-- **测试结构**: 单元测试位于`__tests__/`目录,集成测试位于`__integration_tests__/`目录
+- **文件夹组织**: 遵循功能模块划分,测试文件统一在`tests/`目录
+- **测试结构**: 单元测试位于`tests/unit/`目录,集成测试位于`tests/integration/`目录,E2E测试位于`tests/e2e/`目录
 - **导入/导出模式**: 使用ES模块,保持现有别名系统(@/)
-- **测试位置**: 前端集成测试位于`__integration_tests__/`,页面单元测试位于`__tests__/`
-- **后端测试**: API测试位于路由`__tests__/`目录,服务测试位于模块`__tests__/`目录
-- **工具测试**: 通用工具测试位于`utils/__tests__/`目录
-- **Mini小程序**: 使用Taro框架开发,支持微信小程序
-- **Mini演示应用**: 用于功能演示和测试的独立小程序应用
+- **测试位置**: 前端测试在`tests/unit/client/`和`tests/integration/client/`,后端测试在`tests/unit/server/`和`tests/integration/server/`
+- **后端测试**: API测试位于`tests/integration/server/`目录,服务测试位于`tests/unit/server/modules/`目录
+- **工具测试**: 通用工具测试位于`tests/unit/server/utils/`目录
+- **Mini小程序**: 使用Taro框架开发,支持微信小程序,基于现代前端技术栈
+- **Mini演示应用**: 用于功能演示和测试的独立小程序应用,传统小程序结构

+ 9 - 2
docs/architecture/testing-strategy.md

@@ -3,6 +3,7 @@
 ## 版本信息
 | 版本 | 日期 | 描述 | 作者 |
 |------|------|------|------|
+| 3.1 | 2025-10-16 | 修正测试路径描述,更新Taro测试说明 | Winston |
 | 3.0 | 2025-10-15 | 更新为出行服务项目测试策略 | Winston |
 | 2.6 | 2025-10-15 | 完成遗留测试文件迁移到统一的tests目录结构 | Winston |
 | 2.5 | 2025-10-14 | 更新测试文件位置到统一的tests目录结构 | Claude |
@@ -21,7 +22,9 @@
 #### 单元测试 (Unit Tests)
 - **范围**: 单个函数、类或组件
 - **目标**: 验证独立单元的correctness
-- **位置**: `tests/unit/**/*.test.{ts,tsx}`
+- **位置**:
+  - 前端: `tests/unit/client/**/*.test.{ts,tsx}`
+  - 后端: `tests/unit/server/**/*.test.{ts,tsx}`
 - **框架**: Vitest
 - **覆盖率目标**: ≥ 80%
 - **执行频率**: 每次代码变更
@@ -29,7 +32,9 @@
 #### 集成测试 (Integration Tests)
 - **范围**: 多个组件/服务协作
 - **目标**: 验证模块间集成和交互
-- **位置**: `tests/integration/**/*.test.{ts,tsx}`
+- **位置**:
+  - 前端: `tests/integration/client/**/*.test.{ts,tsx}`
+  - 后端: `tests/integration/server/**/*.test.{ts,tsx}`
 - **框架**: Vitest + Testing Library + hono/testing
 - **覆盖率目标**: ≥ 60%
 - **执行频率**: 每次API变更
@@ -44,6 +49,8 @@
 
 ### Taro小程序测试体系 (独立项目)
 
+**注意**: Taro小程序项目位于 `mini/` 目录,是独立的项目结构,拥有自己的测试配置和运行方式。
+
 #### 组件测试 (Component Tests)
 - **范围**: Taro小程序组件
 - **目标**: 验证组件渲染和交互行为