# 交付执行阶段增强方案 - 总览

## 📋 需求概述

### 1. 消息发送功能
- ✅ 上传交付物后，支持发送消息到客户群
- ✅ 提供预设消息模板供选择
- ✅ 支持自定义编辑消息
- ✅ 支持单独发送图片（不带消息）
- ✅ 左侧消息面板 + 右侧上传区域的布局

### 2. 各阶段预设消息模板
- **白模**："老师我这里硬装模型做好了，看下是否有问题，如果没有，我去做渲染"
- **软装**："软装好了，准备渲染，有问题可以留言"
- **渲染**："小图已完成，请查看整体效果"
- **后期**："后期处理已完成，请查看最终成品"

### 3. 改图工单系统
#### 小修改
- 人工执行，不需要通知甲方
- 内部查看即可
- 不创建正式工单

#### 大修改
- 需要创建正式工单
- 多选涉及的空间
- 选择预估时间：2-3天 / 3-5天 / 5-7天
- 客服协商价格
- 通知组长审批

---

## 🎨 UI布局设计

```
┌─────────────────────────────────────────────────────┐
│  交付执行阶段                                         │
├──────────────────┬──────────────────────────────────┤
│ 【左侧】消息面板  │ 【右侧】交付物上传                 │
│  - 消息模板       │  - 白模                          │
│  - 自定义编辑     │  - 软装                          │
│  - 发送按钮       │  - 渲染                          │
│  - 消息历史       │  - 后期                          │
├──────────────────┴──────────────────────────────────┤
│ 【底部】改图工单管理                                  │
│  - 创建改图任务   - 工单列表   - 审批流程            │
└─────────────────────────────────────────────────────┘
```

---

## 📁 文件修改清单

### 新增文件
1. `src/app/pages/services/message.service.ts` - 消息服务
2. `src/app/pages/services/revision-task.service.ts` - 改图工单服务
3. `src/modules/project/components/message-panel.component.ts` - 消息面板组件
4. `src/modules/project/components/revision-task-modal.component.ts` - 改图工单弹窗

### 修改文件
1. `stage-delivery.component.ts` - 主组件逻辑
2. `stage-delivery-new.component.html` - 模板结构
3. `stage-delivery-new.component.scss` - 样式

### 数据表新增
1. `ProjectMessage` - 消息记录表
2. `RevisionTask` - 改图工单表

---

## 🔧 核心功能模块

### 模块1：消息发送面板
- 消息模板选择
- 文本编辑器
- 图片预览和管理
- 发送历史

### 模块2：改图工单管理
- 创建改图任务
- 工单列表展示
- 审批流程
- 客服报价

### 模块3：通知系统
- 通知组长
- 通知客服
- 企业微信集成

---

## 📊 数据流程

### 消息发送流程
```
上传交付物 → 打开消息面板 → 选择模板/自定义 → 发送到客户群 → 记录到数据库
```

### 改图工单流程
```
组员创建工单 
  ↓
通知组长审批
  ↓
组长审批通过
  ↓
通知客服报价
  ↓
客服协商确定价格
  ↓
工单进入执行阶段
  ↓
完成后标记完成
```

---

## ⚙️ 技术实现要点

### 1. 消息模板配置
```typescript
const MESSAGE_TEMPLATES = {
  white_model: [...],
  soft_decor: [...],
  rendering: [...],
  post_process: [...]
};
```

### 2. 改图工单数据结构
```typescript
interface RevisionTask {
  type: 'minor' | 'major';
  spaceIds: string[];
  estimatedDays: string;
  status: string;
  // ...
}
```

### 3. Service 层
- MessageService: 消息发送和查询
- RevisionTaskService: 工单CRUD和审批

---

## 📅 开发计划

### Phase 1: 消息发送功能（3-4天）
- Day 1: MessageService + 数据表
- Day 2: 消息面板UI组件
- Day 3: 集成到主组件
- Day 4: 测试和优化

### Phase 2: 改图工单系统（4-5天）
- Day 1: RevisionTaskService + 数据表
- Day 2: 创建工单UI
- Day 3: 工单列表和审批流程
- Day 4: 客服报价功能
- Day 5: 测试和优化

### Phase 3: 通知系统集成（2-3天）
- 企业微信消息推送
- 系统内通知
- 测试

---

## 🎯 验收标准

### 消息发送功能
- ✅ 能够选择预设模板
- ✅ 能够自定义编辑消息
- ✅ 能够单独发送图片
- ✅ 消息正确发送到客户群
- ✅ 消息历史正确显示

### 改图工单功能
- ✅ 能够创建小修改和大修改工单
- ✅ 能够多选空间
- ✅ 能够选择预估时间
- ✅ 组长能够审批
- ✅ 客服能够报价
- ✅ 通知正确发送

---

详细设计文档请查看以下文件：
- `DELIVERY_MESSAGE_DESIGN.md` - 消息功能详细设计
- `DELIVERY_REVISION_DESIGN.md` - 改图工单详细设计
- `DELIVERY_CODE_IMPLEMENTATION.md` - 代码实现指南