Draft-Final 模式

# 订单导出功能
 
## 需求
用户希望能够导出订单列表为 Excel 文件
 
## 初步想法
- 支持按时间范围筛选
- 支持选择导出字段
- 大量数据时需要异步处理
- 导出完成后邮件通知
 
## 问题
- 不确定用什么库生成 Excel
- 不确定异步任务怎么处理
- 需要考虑导出权限

# 订单导出功能 - 技术方案
 
## 技术选型
- Excel 生成：使用 exceljs（项目已有依赖）
- 异步任务：使用现有的 Bull 队列
- 文件存储：复用现有的 S3 配置
 
## 数据模型
 
### ExportTask 表
​```sql
CREATE TABLE export_tasks (
  id SERIAL PRIMARY KEY,
  user_id INTEGER REFERENCES users(id),
  status VARCHAR(20) DEFAULT 'pending',
  file_url TEXT,
  created_at TIMESTAMP DEFAULT NOW()
);
​```
 
## API 设计
 
### POST /api/orders/export
创建导出任务
 
**请求：**
​```json
{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "fields": ["orderId", "customerName", "amount"]
}
​```
 
**响应：**
​```json
{
  "taskId": "export_123",
  "status": "pending"
}
​```
 
### GET /api/orders/export/:taskId
查询导出任务状态
 
## 实现步骤
 
1. 创建 ExportTask 数据模型
2. 实现导出任务创建接口
3. 实现 Bull 队列消费者
4. 实现 Excel 生成逻辑
5. 实现文件上传到 S3
6. 实现邮件通知
7. 实现前端导出按钮和进度显示
 
## 权限控制
- 复用现有的 @middleware/auth.ts 认证中间件
- 添加 'order:export' 权限检查
 
## 注意事项
- 单次导出最多 10000 条记录
- 文件保留 7 天后自动删除
- 失败任务自动重试 3 次

✅ 好的 Draft
# 功能名称
## 需求背景（为什么做）
## 核心功能（做什么）
## 初步想法（怎么做的思路）
## 不确定的点（需要 AI 补充）
 
❌ 不好的 Draft
- 太简单：只有一句话
- 太详细：写成了完整方案（那就直接用 Document 模式）

specs/
├── 001-order-export/
│   ├── draft.md          # 原始需求草稿
│   ├── final.md          # AI 完善的技术方案
│   └── api-spec.json     # 可选：详细 API 规格
├── 002-user-auth/
│   ├── draft.md
│   └── final.md
└── ...