Generates type artifacts from …

# 订单模块类型定义拆分指南

一、前期盘点

• 克隆/拉取 shop-api 仓库最新代码，定位订单模块（通常在 src/modules/order 或 src/order 下）。
• 梳理模块内所有类型来源：interface、type、enum、第三方依赖类型（如 ORM 生成的实体类型）。

二、识别可抽取的类型

从订单模块中筛选以下几类定义：

• 实体类型：Order、OrderItem、Address 等
• DTO 类型：CreateOrderInput、UpdateOrderStatusInput、分页查询参数
• 响应类型：OrderResponse、OrderListResponse
• 枚举/常量类型：订单状态 OrderStatus、支付方式 PaymentMethod
• 工具类型：如 type OrderPartial = Partial<Order>

注意：仅抽取「纯类型」，不引入运行时逻辑；若枚举在运行时使用，需保留在原处或用 const enum/enum 导入。

三、组织 types 目录结构

建议按域分层，避免单文件膨胀：

```

src/types/

├── order.ts # 订单核心类型

├── order.dto.ts # 请求/响应 DTO

├── order.enum.ts # 枚举（运行时需保留则放 src/enums）

└── index.ts # 统一导出

```

四、迁移与重构步骤

1. 新建类型文件，将类型定义原样迁移，补充 JSDoc 注释。

2. 在原订单模块中删除已迁移定义，改为 import type { Order } from '../../types'（使用 import type 确保零运行时开销）。

3. 处理循环依赖：若类型相互引用，用统一的 index.ts 聚合导出。

4. 检查路径别名：若 tsconfig.json 已配置 @types/* 别名可统一引用方式。

五、验证与提交

• 运行 tsc --noEmit 或项目构建命令，确认无类型报错。
• 跑一遍订单相关单测。
• 单独开分支提交，commit 信息注明「refactor: 抽取订单模块类型定义」，便于评审回溯。