yss-project/DELIVERY_ENHANCEMENT_OVERVIEW.md

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

📋 需求概述

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. 消息模板配置

const MESSAGE_TEMPLATES = {
  white_model: [...],
  soft_decor: [...],
  rendering: [...],
  post_process: [...]
};

2. 改图工单数据结构

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 - 代码实现指南