📝 docs(story): add order cancellation function story documentation

- create story document for order cancellation feature implementation
- define acceptance criteria including UI, service, API and status validation requirements
- outline tasks for service method, API endpoint, UI integration and testing
- document technical stack, existing code status and integration points
- specify order status transition rules and testing requirements

docs/stories/011.002.order-cancel-function.md

@@ -0,0 +1,116 @@
+# Story 011.002: 实现订单取消功能
+
+## Status
+Draft
+
+## Story
+**As a** 小程序用户，
+**I want** 能够在订单详情页面取消订单，
+**so that** 对于已支付订单可以触发退款流程，对于待支付订单可以直接取消，确保订单状态正确流转
+
+## Acceptance Criteria
+1. 在订单详情页面添加取消订单按钮
+2. 取消订单时验证订单状态（仅允许取消"待支付"和"已支付"订单）
+3. 对于已支付订单，触发退款流程
+4. 订单状态正确更新为"已取消"（支付状态更新为5）
+5. 取消原因和操作时间正确记录
+6. 在OrderMtService中添加cancelOrder方法
+
+## Tasks / Subtasks
+- [ ] 在 OrderMtService 中添加 cancelOrder 方法 (AC: 2, 3, 4, 5, 6)
+  - [ ] 在 `packages/orders-module-mt/src/services/order.mt.service.ts` 中添加方法签名：`cancelOrder(tenantId: number, orderId: number, reason: string, userId: number): Promise<void>`
+  - [ ] 实现订单状态验证逻辑（仅允许取消支付状态为0或2的订单）
+  - [ ] 对于已支付订单（支付状态=2），调用支付模块的退款功能
+  - [ ] 更新订单状态为5（订单关闭），记录取消时间和原因
+  - [ ] 确保多租户数据隔离
+- [ ] 添加取消订单API接口 (AC: 1, 2, 3)
+  - [ ] 在 `packages/orders-module-mt/src/routes/user/orders.mt.ts` 中添加取消订单API端点
+  - [ ] 实现请求参数验证（订单ID、取消原因）
+  - [ ] 调用 OrderMtService 的 cancelOrder 方法
+  - [ ] 添加适当的错误处理和响应格式
+- [ ] 集成取消订单UI到订单详情页面 (AC: 1)
+  - [ ] 在 `mini/src/pages/order-detail/index.tsx` 中添加取消订单按钮
+  - [ ] 实现取消订单的UI交互逻辑
+  - [ ] 添加取消原因输入对话框
+  - [ ] 处理取消成功/失败的页面反馈
+- [ ] 编写单元测试和集成测试 (AC: 1-6)
+  - [ ] 为 OrderMtService 的 cancelOrder 方法编写单元测试
+  - [ ] 为取消订单API编写集成测试
+  - [ ] 验证订单状态验证逻辑
+  - [ ] 测试多租户数据隔离
+  - [ ] 测试已支付订单的退款触发
+
+## Dev Notes
+
+### 技术栈和架构
+- **后端框架**: Hono 4.8.5 + TypeORM 0.3.25
+- **数据库**: PostgreSQL 17
+- **多租户支持**: 通过租户ID字段实现数据隔离
+- **项目结构**: Monorepo 架构，模块化包设计
+
+### 现有代码状态分析
+- **OrderMtService** (`packages/orders-module-mt/src/services/order.mt.service.ts`): 需要添加 cancelOrder 方法
+- **订单实体** (`packages/orders-module-mt/src/entities/order.mt.entity.ts:72`): 支付状态字段定义：0未支付、1支付中、2支付成功、3已退款、4支付失败、5订单关闭
+- **用户订单路由** (`packages/orders-module-mt/src/routes/user/orders.mt.ts`): 需要添加取消订单API端点
+- **订单详情页面** (`mini/src/pages/order-detail/index.tsx`): 需要集成取消订单UI
+
+### 关键集成点
+- **多租户订单模块**: OrderMtService 需要与多租户支付模块集成
+- **支付退款功能**: 需要调用 PaymentMtService 的退款功能（将在Story 3中实现）
+- **租户数据隔离**: 所有操作必须包含租户ID参数确保数据隔离
+- **前端集成**: Mini小程序前端需要调用新的取消订单API
+
+### 文件位置和命名约定
+- **订单服务**: `packages/orders-module-mt/src/services/order.mt.service.ts`
+- **用户订单路由**: `packages/orders-module-mt/src/routes/user/orders.mt.ts`
+- **订单详情页面**: `mini/src/pages/order-detail/index.tsx`
+- **测试文件**: `packages/orders-module-mt/tests/integration/order-cancel.integration.test.ts`
+
+### 技术约束
+- **向后兼容性**: 现有订单API保持不变，新增API不影响现有功能
+- **多租户支持**: 所有新功能必须支持租户隔离
+- **错误处理**: 需要完善的错误处理和用户友好的错误信息
+- **性能要求**: 取消订单操作应在合理时间内完成
+
+### 订单状态流转规则
+- **0未支付** → **5订单关闭** (用户取消)
+- **2支付成功** → **5订单关闭** (用户取消 + 触发退款)
+- 其他状态（1支付中、3已退款、4支付失败）不允许取消
+
+### Testing
+
+#### 测试标准
+- **测试框架**: Vitest + hono/testing
+- **测试位置**: `packages/orders-module-mt/tests/integration/`
+- **覆盖率目标**: 核心业务逻辑 > 80%
+- **测试类型**: 单元测试 + 集成测试
+
+#### 测试要求
+- **单元测试**: 验证 cancelOrder 方法的订单状态验证逻辑
+- **集成测试**: 验证完整的取消订单流程
+- **多租户测试**: 验证不同租户的数据隔离
+- **边界测试**: 测试各种订单状态的取消权限
+- **错误测试**: 测试订单不存在、状态不允许取消等异常情况
+
+#### 测试文件命名
+- `order-cancel.integration.test.ts` - 取消订单集成测试
+- `order-service.unit.test.ts` - 订单服务单元测试
+
+## Change Log
+| Date | Version | Description | Author |
+|------|---------|-------------|---------|
+| 2025-11-21 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
+
+## Dev Agent Record
+*This section is populated by the development agent during implementation*
+
+### Agent Model Used
+
+### Debug Log References
+
+### Completion Notes List
+
+### File List
+
+## QA Results
+*Results from QA Agent QA review of the completed story implementation*