# 报价编辑器 - 协作分工功能使用指南

## 🎯 功能概述

协作分工功能允许您为每个设计空间添加协作人员，设置他们的角色和工作占比，系统会自动计算费用分配。

## 📖 使用步骤

### 步骤1: 打开报价编辑器

1. 进入项目详情页
2. 切换到"订单分配"标签
3. 找到"报价分析"板块

### 步骤2: 展开空间详情

1. 在产品列表中找到需要添加协作的空间
2. 点击空间卡片展开详情
3. 滚动到"协作分工管理"区域

### 步骤3: 添加协作人员

1. 点击"添加协作人员"按钮
2. 弹出协作人员选择模态框
3. 在搜索框中输入姓名或部门进行筛选
4. 点击团队成员进行选择（可多选）
5. 在底部"已选择"区域配置：
   - **角色**: 协作设计师、建模师、渲染师、软装师
   - **占比**: 0-100%（默认20%）
6. 点击"确认添加"

### 步骤4: 管理协作人员

**查看协作人员**：
- 协作人员卡片显示头像、姓名、角色
- 实时显示工作占比和分配金额

**修改工作占比**：
1. 在"工作占比"输入框中修改数值
2. 系统自动计算新的分配金额
3. 修改后自动保存到数据库

**移除协作人员**：
1. 点击协作人员卡片右侧的"×"按钮
2. 确认删除
3. 协作人员从列表中移除

## 💡 使用场景

### 场景1: 跨团队协作
**情况**: 客厅设计需要两个团队协作完成

**操作**:
1. 打开客厅空间详情
2. 添加协作人员：
   - 张设计师（协作设计师，30%）
   - 李建模师（建模师，20%）
3. 系统自动计算：
   - 客厅总价: ¥5000
   - 张设计师分配: ¥1500
   - 李建模师分配: ¥1000

### 场景2: 专项外包
**情况**: 主卧渲染外包给专业渲染师

**操作**:
1. 打开主卧空间详情
2. 添加协作人员：
   - 王渲染师（渲染师，40%）
3. 系统自动计算：
   - 主卧总价: ¥4000
   - 王渲染师分配: ¥1600

### 场景3: 软装协作
**情况**: 书房需要专业软装师配合

**操作**:
1. 打开书房空间详情
2. 添加协作人员：
   - 赵软装师（软装师，25%）
3. 系统自动计算：
   - 书房总价: ¥3000
   - 赵软装师分配: ¥750

## 🔍 界面说明

### 协作分工管理区域
```
┌─────────────────────────────────────────┐
│ 🤝 协作分工管理 (少数需协作情况可手动设置)  │
│                                         │
│ [+ 添加协作人员]                         │
│                                         │
│ ┌─────────────────────────────────────┐ │
│ │ 👤 张设计师                          │ │
│ │    协作设计师                        │ │
│ │                                     │ │
│ │    工作占比: [30] %                 │ │
│ │    分配金额: ¥1500                  │ │
│ │                              [×]    │ │
│ └─────────────────────────────────────┘ │
│                                         │
│ ┌─────────────────────────────────────┐ │
│ │ 👤 李建模师                          │ │
│ │    建模师                            │ │
│ │                                     │ │
│ │    工作占比: [20] %                 │ │
│ │    分配金额: ¥1000                  │ │
│ │                              [×]    │ │
│ └─────────────────────────────────────┘ │
└─────────────────────────────────────────┘
```

### 协作人员选择模态框
```
┌─────────────────────────────────────────┐
│ 添加协作人员                      [×]   │
├─────────────────────────────────────────┤
│ 🔍 [搜索团队成员...]                     │
│                                         │
│ ┌─────────────────────────────────────┐ │
│ │ 👤 张设计师 - 设计部            ✓   │ │
│ │ 👤 李建模师 - 建模部            ✓   │ │
│ │ 👤 王渲染师 - 渲染部                │ │
│ │ 👤 赵软装师 - 软装部                │ │
│ └─────────────────────────────────────┘ │
│                                         │
│ 已选择 (2人)                            │
│ ┌─────────────────────────────────────┐ │
│ │ 👤 张设计师                          │ │
│ │    角色: [协作设计师▼]  占比: [30]% │ │
│ │                              [×]    │ │
│ ├─────────────────────────────────────┤ │
│ │ 👤 李建模师                          │ │
│ │    角色: [建模师▼]      占比: [20]% │ │
│ │                              [×]    │ │
│ └─────────────────────────────────────┘ │
│                                         │
│           [取消]  [确认添加 (2)]        │
└─────────────────────────────────────────┘
```

## 📊 费用计算说明

### 计算公式
```
协作人员分配金额 = 空间总价 × 工作占比 ÷ 100
```

### 示例计算
**空间**: 客厅  
**总价**: ¥5000

**协作人员**:
- 张设计师（30%）: ¥5000 × 30% = ¥1500
- 李建模师（20%）: ¥5000 × 20% = ¥1000

**总计**: ¥2500（占空间总价的50%）

### 注意事项
- 协作占比总和可以超过100%（灵活分配）
- 协作占比可以为0（仅记录协作关系）
- 分配金额自动四舍五入到整数

## 🎨 角色说明

### 协作设计师
- **职责**: 协助主设计师完成设计工作
- **适用**: 跨团队协作、大型项目
- **占比建议**: 20-40%

### 建模师
- **职责**: 负责3D建模工作
- **适用**: 专业建模外包
- **占比建议**: 10-30%

### 渲染师
- **职责**: 负责效果图渲染
- **适用**: 专业渲染外包
- **占比建议**: 20-40%

### 软装师
- **职责**: 负责软装搭配设计
- **适用**: 软装专项协作
- **占比建议**: 15-35%

## 🔧 技术说明

### 数据存储
- **表**: Parse Product表
- **字段**: `data.collaborations`
- **结构**:
  ```json
  {
    "collaborations": [
      {
        "profileId": "profile001",
        "role": "协作设计师",
        "workload": 30
      }
    ]
  }
  ```

### 数据加载
1. 打开报价编辑器时自动加载
2. 从Product表读取`data.collaborations`
3. 根据profileId查询Profile表获取详细信息
4. 渲染到界面

### 数据保存
1. 添加/修改/删除协作人员时触发
2. 更新Product表的`data.collaborations`字段
3. 自动保存，无需手动操作

## ❓ 常见问题

### Q1: 为什么看不到团队成员？
**A**: 
- 确保Profile表中有团队成员数据
- 检查company字段是否正确
- 确认isDeleted字段为false

### Q2: 协作占比可以超过100%吗？
**A**: 
- 可以！系统支持灵活分配
- 例如：主设计师100% + 协作设计师30%

### Q3: 如何修改协作人员的角色？
**A**: 
- 当前版本不支持直接修改角色
- 需要先移除，再重新添加并设置新角色

### Q4: 协作人员数据会同步到其他地方吗？
**A**: 
- 数据保存在Product表的data字段
- 可以在其他功能中读取和使用

### Q5: 如何批量添加协作人员？
**A**: 
- 在选择模态框中多选团队成员
- 统一设置角色和占比
- 一次性确认添加

## 📞 技术支持

如有问题，请联系技术团队或查看：
- Parse数据库文档: `docs/Database/database-tables-overview.md`
- 报价编辑器实现总结: `QUOTATION-EDITOR-FINAL-IMPLEMENTATION.md`

---

**文档版本**: v1.0  
**更新时间**: 2025-11-02  
**适用版本**: YSS项目管理系统 v1.0+