统一空间数据管理实现方案

📋 实施概述

已成功实现统一空间数据管理系统，解决了项目空间在不同阶段显示不一致的问题。

核心改进

✅ 统一存储字段: Project.data.unifiedSpaces 作为唯一真实数据源
✅ 初始空间优化: 家装项目只创建2个空间（客厅+主卧），工装项目只创建1个空间
✅ 自动同步机制: Product表与统一存储自动双向同步
✅ 数据修复工具: 提供数据迁移和一致性检查功能

🔧 实现的核心方法

1. `saveUnifiedSpaceData(projectId, spaces)`

功能: 保存统一空间数据到 Project.data.unifiedSpaces

数据结构:

{
  id: string,                    // 空间唯一ID
  name: string,                  // 空间名称
  type: string,                  // 空间类型
  area: number,                  // 面积
  priority: number,              // 优先级
  status: string,                // 状态
  complexity: string,            // 复杂度
  estimatedBudget: number,       // 预算
  order: number,                 // 排序
  quotation: {                   // 报价信息
    price: number,
    processes: {},
    subtotal: number
  },
  requirements: {},              // 需求信息
  designerId: string | null,     // 设计师ID
  progress: [],                  // 进度信息
  createdAt: string,             // 创建时间
  updatedAt: string              // 更新时间
}

同步行为:

保存到 Project.data.unifiedSpaces
同时更新 Project.data.quotation.spaces（向后兼容）
自动同步到 Product 表

2. `getUnifiedSpaceData(projectId)`

功能: 获取统一空间数据

查询优先级:

优先从 Project.data.unifiedSpaces 读取
如果为空，从 Product 表迁移
如果都没有，返回空数组

自动迁移: 首次调用时会自动将 Product 表数据迁移到统一存储

3. `createInitialSpaces(projectId, projectType)`

功能: 创建初始空间（解决一次性生成9个空间的问题）

家装项目 (projectType = '家装'):

创建2个空间：客厅 + 主卧
每个空间预算: 300元
工序: 建模(100) + 软装(100) + 渲染(100)

工装项目 (projectType = '工装'):

创建1个空间：主要空间
预算: 500元
工序: 建模(150) + 软装(150) + 渲染(150) + 后期(50)

4. `forceRepairSpaceData(projectId)`

功能: 强制修复项目空间数据

修复流程:

从 Product 表读取所有空间
从 Project.data.quotation.spaces 读取报价信息
合并数据，以 Product 表为准
保存到 Project.data.unifiedSpaces
同步到 Product 表和报价数据

使用场景: 修复历史项目的空间数据不一致问题

5. `debugProjectSpaceData(projectId)`

功能: 检查项目空间数据存储情况

检查内容:

Project.data.unifiedSpaces 数量
Project.data.quotation.spaces 数量
Product 表空间数量
数据一致性验证

输出示例:

🔍 [调试] 检查项目 xxx 的空间数据存储情况...
📊 [调试] Project.data.unifiedSpaces: 3 个空间
   - 统一空间列表: ['客厅', '主卧', '次卧']
📊 [调试] Project.data.quotation.spaces: 3 个空间
   - 报价空间列表: ['客厅', '主卧', '次卧']
📊 [调试] Product表: 3 个空间
   - Product空间列表: ['客厅', '主卧', '次卧']
🔍 [调试] 数据一致性检查:
   - 统一存储: 3 个
   - 报价数据: 3 个
   - Product表: 3 个
✅ [调试] 数据一致性检查通过

📊 数据存储结构

Project 表 - data 字段

{
  // ✅ 新增：统一空间数据（唯一真实来源）
  unifiedSpaces: [
    {
      id: 'space_xxx_1',
      name: '客厅',
      type: 'living_room',
      area: 30,
      priority: 5,
      status: 'not_started',
      complexity: 'medium',
      estimatedBudget: 300,
      order: 0,
      quotation: {
        price: 300,
        processes: {
          modeling: { enabled: true, price: 100, unit: '张', quantity: 1 },
          softDecor: { enabled: true, price: 100, unit: '张', quantity: 1 },
          rendering: { enabled: true, price: 100, unit: '张', quantity: 1 },
          postProcess: { enabled: false, price: 0, unit: '张', quantity: 1 }
        },
        subtotal: 300
      },
      requirements: {},
      designerId: null,
      progress: [],
      createdAt: '2024-01-01T00:00:00.000Z',
      updatedAt: '2024-01-01T00:00:00.000Z'
    }
  ],
  
  // 保留：报价数据（向后兼容）
  quotation: {
    spaces: [
      {
        name: '客厅',
        spaceId: 'space_xxx_1',  // 关联 unifiedSpaces.id
        processes: { ... },
        subtotal: 300
      }
    ],
    total: 300,
    spaceBreakdown: [ ... ]
  },
  
  // 保留：特殊需求
  spaceSpecialRequirements: {
    'space_xxx_1': {
      content: '需要充足的储物空间',
      updatedAt: '2024-01-01T00:00:00.000Z',
      updatedBy: 'user_id'
    }
  },
  
  // 保留：设计师分配
  designerSpaceAssignments: {
    'designer_id_1': ['space_xxx_1', 'space_xxx_2'],
    'designer_id_2': ['space_xxx_3']
  }
}

🔄 同步机制

数据流向

订单分配阶段
    ↓
创建/编辑空间
    ↓
saveUnifiedSpaceData()
    ├─ 保存到 Project.data.unifiedSpaces ✅
    ├─ 同步到 Project.data.quotation.spaces
    └─ 同步到 Product 表
    
需求确认阶段
    ↓
getUnifiedSpaceData()
    ├─ 从 Project.data.unifiedSpaces 读取 ✅
    └─ 如果为空，从 Product 表迁移
    
交付执行阶段
    ↓
getUnifiedSpaceData()
    ├─ 从 Project.data.unifiedSpaces 读取 ✅
    └─ 显示交付物列表
    
设计师分配
    ↓
getUnifiedSpaceData()
    ├─ 从 Project.data.unifiedSpaces 读取 ✅
    └─ 显示可分配空间列表

🚀 使用指南

1. 创建新项目时

// 在订单分配阶段，初始化空间
await this.productSpaceService.createInitialSpaces(
  projectId,
  '家装'  // 或 '工装'
);

// 结果：家装项目创建2个空间（客厅+主卧）
//       工装项目创建1个空间（主要空间）

2. 添加/编辑空间时

// 获取当前空间列表
const spaces = await this.productSpaceService.getUnifiedSpaceData(projectId);

// 添加新空间
spaces.push({
  id: `space_${Date.now()}`,
  name: '次卧',
  type: 'bedroom',
  area: 15,
  priority: 5,
  status: 'not_started',
  complexity: 'medium',
  estimatedBudget: 300,
  order: spaces.length,
  quotation: { price: 300, processes: {}, subtotal: 300 },
  requirements: {},
  designerId: null,
  progress: [],
  createdAt: new Date().toISOString(),
  updatedAt: new Date().toISOString()
});

// 保存更新
await this.productSpaceService.saveUnifiedSpaceData(projectId, spaces);

3. 加载空间数据时

// 所有阶段统一使用此方法
const spaces = await this.productSpaceService.getUnifiedSpaceData(projectId);

// 空间数量
const spaceCount = spaces.length;

// 遍历空间
spaces.forEach(space => {
  console.log(`空间: ${space.name}, 状态: ${space.status}`);
});

4. 修复历史数据时

// 修复单个项目
await this.productSpaceService.forceRepairSpaceData(projectId);

// 检查数据一致性
await this.productSpaceService.debugProjectSpaceData(projectId);

✅ 解决的问题

问题1: 空间数量不一致

原因: 不同阶段从不同数据源读取空间解决: 统一从 Project.data.unifiedSpaces 读取

问题2: 初始创建9个空间

原因: 订单分配阶段默认创建所有常见空间类型解决: 只创建1-2个默认空间，用户可自行添加

问题3: 数据同步延迟

原因: Product 表和 Project.data 不同步解决: 保存时自动双向同步

问题4: 历史数据不一致

原因: 旧项目使用旧的数据结构解决: 提供 forceRepairSpaceData 修复工具

🔍 验证方法

1. 创建新项目

进入订单分配阶段
检查初始空间数量（应为1-2个）
添加新空间
进入需求确认阶段，检查空间数量是否一致
进入交付执行阶段，检查空间数量是否一致
打开设计师分配弹窗，检查空间数量是否一致

2. 修复历史项目

打开浏览器控制台
执行: await productSpaceService.debugProjectSpaceData('项目ID')
查看数据一致性报告
如果不一致，执行: await productSpaceService.forceRepairSpaceData('项目ID')
再次检查一致性

📝 注意事项

向后兼容: Project.data.quotation.spaces 仍然保留，确保旧代码正常运行
自动迁移: 首次调用 getUnifiedSpaceData 会自动迁移 Product 表数据
双向同步: 修改 unifiedSpaces 会自动同步到 Product 表和报价数据
数据修复: 对于历史项目，建议运行 forceRepairSpaceData 进行一次性修复

🎯 下一步建议

批量修复: 创建后台任务，批量修复所有历史项目
监控告警: 添加数据一致性监控，发现不一致时自动告警
UI优化: 在订单分配阶段添加"快速添加空间"功能
权限控制: 限制只有特定角色可以修改空间数据

📞 技术支持

如有问题，请查看:

SPACE_SYNC_ANALYSIS_PART1.md - 详细分析报告
SPACE_SYNC_ANALYSIS_PART2.md - 实现细节
SPACE_SYNC_QUICK_REFERENCE.md - 快速参考指南

UNIFIED_SPACE_IMPLEMENTATION.md 9.4 KB 文件歷史 原始文件