Bladeren bron

📝 docs(story): add order confirm time optimization story

- 创建007.009.order-confirm-time-optimization.story.md文档
- 描述订单确认页出发时间显示优化需求
- 定义用户故事和验收标准
- 列出开发任务和技术实现要点
- 包含测试策略和数据模型分析
yourname 3 maanden geleden
bovenliggende
commit
cf45e2522b
1 gewijzigde bestanden met toevoegingen van 104 en 0 verwijderingen
  1. 104 0
      docs/stories/007.009.order-confirm-time-optimization.story.md

+ 104 - 0
docs/stories/007.009.order-confirm-time-optimization.story.md

@@ -0,0 +1,104 @@
+# Story 007.009: 订单确认页出发时间显示优化
+
+## Status
+Draft
+
+## Story
+**As a** 小程序用户,
+**I want** 在订单确认页面看到出发时间显示为"客服将与您沟通确认",
+**so that** 避免对具体出发时间的误解,同时保持其他班次信息的完整显示。
+
+## Acceptance Criteria
+1. 在订单确认页面将出发时间显示改为"客服将与您沟通确认"
+2. 保持其他班次信息(车辆型号、上下车地点、价格等)正常显示
+3. 确保拼车和包车服务都应用相同的优化
+4. 验证订单确认功能正常工作
+
+## Tasks / Subtasks
+- [ ] 修改订单确认页面出发时间显示 (AC: 1, 2, 3)
+  - [ ] 在 `mini/src/pages/order/index.tsx` 中修改出发时间显示(第552行)
+  - [ ] 将出发时间显示从具体时间改为"客服将与您沟通确认"
+  - [ ] 确保其他班次信息(车辆型号、上下车地点、价格等)保持正常显示
+  - [ ] 验证拼车和包车服务都应用相同的优化
+- [ ] 修改订单详情页面出发时间显示 (AC: 1, 2, 3)
+  - [ ] 在 `mini/src/pages/order-detail/index.tsx` 中修改出发时间显示(第176行)
+  - [ ] 将出发时间显示从具体时间改为"客服将与您沟通确认"
+  - [ ] 确保其他订单信息保持正常显示
+- [ ] 更新相关测试 (AC: 4)
+  - [ ] 更新 `mini/tests/pages/order-page.test.tsx` 测试文件
+  - [ ] 更新 `mini/tests/pages/order-detail.test.tsx` 测试文件
+  - [ ] 验证时间显示优化后的页面渲染正确
+  - [ ] 确保订单确认和详情功能测试通过
+- [ ] 验证功能完整性 (AC: 4)
+  - [ ] 验证订单确认页面功能正常工作
+  - [ ] 验证订单详情页面功能正常工作
+  - [ ] 验证拼车和包车服务都正确应用时间显示优化
+  - [ ] 确保所有班次信息显示完整且正确
+
+## Dev Notes
+
+### 技术栈要求
+- **前端框架**: Taro 4.x + React [Source: architecture/tech-stack.md#现有技术栈维护]
+- **小程序平台**: 微信小程序 [Source: architecture/tech-stack.md#现有技术栈维护]
+- **状态管理**: React Query (TanStack Query) [Source: architecture/tech-stack.md#现有技术栈维护]
+- **UI组件**: 自定义组件 + Heroicons [Source: architecture/tech-stack.md#现有技术栈维护]
+
+### 项目结构
+- **订单确认页面位置**: `mini/src/pages/order/index.tsx` [Source: architecture/source-tree.md#实际项目结构]
+- **订单详情页面位置**: `mini/src/pages/order-detail/index.tsx` [Source: architecture/source-tree.md#实际项目结构]
+- **测试文件位置**:
+  - `mini/tests/pages/order-page.test.tsx` [Source: architecture/testing-strategy.md#taro小程序测试体系]
+  - `mini/tests/pages/order-detail.test.tsx` [Source: architecture/testing-strategy.md#taro小程序测试体系]
+- **API客户端**: `mini/src/api.ts` [Source: architecture/source-tree.md#实际项目结构]
+
+### 现有实现分析
+基于对相关页面的分析:
+- **订单确认页面** (`mini/src/pages/order/index.tsx` 第552行):
+  - 当前显示: `{schedule.departureTime ? format(new Date(schedule.departureTime), 'yyyy-MM-dd HH:mm', { locale: zhCN }) : '未知时间'}`
+  - 需要修改为: "客服将与您沟通确认"
+  - 其他班次信息显示在相邻行(车辆型号、上下车地点、价格等)
+
+- **订单详情页面** (`mini/src/pages/order-detail/index.tsx` 第176行):
+  - 当前显示: `{order.routeSnapshot?.departureTime ? format(new Date(order.routeSnapshot.departureTime), 'yyyy-MM-dd HH:mm:ss', { locale: zhCN }) : '未知时间'}`
+  - 需要修改为: "客服将与您沟通确认"
+  - 其他订单信息显示在相邻行
+
+### 修改策略
+- **时间显示替换**: 将具体时间显示替换为固定文本"客服将与您沟通确认"
+- **保持其他信息**: 车辆型号、上下车地点、价格、剩余座位等信息保持不变
+- **服务类型覆盖**: 确保拼车和包车服务都应用相同的优化
+- **数据模型不变**: 不需要修改后端数据模型,仅修改前端显示逻辑
+
+### 数据模型
+- **Route接口**: 包含 `departureTime` 字段 [Source: mini/src/pages/order/index.tsx:50-67]
+- **Order接口**: 包含 `routeSnapshot` 字段,其中有 `departureTime` [Source: mini/src/pages/order-detail/index.tsx:26-42]
+- **显示逻辑**: 仅修改前端显示文本,不修改数据获取逻辑
+
+### Testing
+- **测试框架**: Jest + @testing-library/react + React Query + Taro API mock [Source: architecture/testing-strategy.md#taro小程序测试体系]
+- **测试位置**:
+  - `mini/tests/pages/order-page.test.tsx` [Source: architecture/testing-strategy.md#taro小程序测试体系]
+  - `mini/tests/pages/order-detail.test.tsx` [Source: architecture/testing-strategy.md#taro小程序测试体系]
+- **测试模式**: 页面级集成测试,包含完整的业务逻辑和API集成 [Source: architecture/testing-strategy.md#taro小程序测试模式]
+- **测试重点**:
+  - 验证出发时间显示为"客服将与您沟通确认"
+  - 验证其他班次信息正常显示
+  - 验证拼车和包车服务都正确应用优化
+  - 验证订单确认和详情功能正常工作
+
+## Change Log
+| Date | Version | Description | Author |
+|------|---------|-------------|--------|
+| 2025-11-01 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
+
+## Dev Agent Record
+
+### Agent Model Used
+
+### Debug Log References
+
+### Completion Notes List
+
+### File List
+
+## QA Results