4. 数据模型设计

资产移交接口的核心在于数据模型的清晰与完整。本章将围绕资产台账主表、维护计划子表、质保记录子表，定义其ER关系与字段规范，确保移交过程中数据不丢失、不歧义。

4.1 三表ER关系图

资产台账主表（Asset）作为核心实体，与维护计划子表（MaintenancePlan）、质保记录子表（WarrantyRecord）构成一对多的主从关系。每项资产可拥有多个维护计划与多条质保记录，移交时子表数据随主表同步迁移。

4.2 资产台账主表字段定义

主表记录资产的核心静态信息，是移交的基础数据载体。以下字段为必选配置：

4.3 维护计划子表字段定义

维护计划子表记录每项资产的周期性维护任务，移交时需完整携带未执行的计划：

4.4 质保记录子表字段定义

质保记录子表跟踪资产的保修状态与供应商信息，移交时需确保质保期内的记录完整：

4.5 字段映射与移交数据包结构

在移交接口中，三表数据以 JSON 结构打包传输。以下为典型数据包示例：

{
  "asset": {
    "asset_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "asset_code": "AST-2024-088",
    "asset_name": "高性能服务器",
    "category_id": "cat-srv-01",
    "department_id": "dept-it-02",
    "location": "A栋3楼机房",
    "purchase_date": "2024-03-15",
    "status": "使用中"
  },
  "maintenance_plans": [
    {
      "plan_id": "plan-001",
      "plan_type": "季度保养",
      "plan_cycle": 90,
      "next_execute_date": "2025-02-10",
      "plan_status": "待执行"
    }
  ],
  "warranty_records": [
    {
      "warranty_id": "war-001",
      "supplier_name": "华为技术有限公司",
      "warranty_type": "整机质保",
      "start_date": "2024-03-15",
      "end_date": "2027-03-14",
      "warranty_status": "有效"
    }
  ]
}

4.6 数据模型设计检查清单

• 主键策略： 三表均使用 UUID 主键，避免分布式环境下主键冲突。
• 外键约束： 子表 asset_id 必须引用主表 asset_id，移交时先写主表再写子表。
• 状态字段： 维护计划与质保记录均包含状态字段，移交时按状态过滤有效数据。
• 时间字段： 日期类型统一使用 DATE，时间戳使用 DATETIME，避免时区转换问题。
• 附件处理： 质保附件仅存储 URL 链接，文件本身通过独立文件服务传输，不嵌入数据包。