package com.erp.logistics.entity;

import com.baomidou.mybatisplus.annotation.*;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.experimental.Accessors;

import java.time.LocalDateTime;

/**
 * 物流轨迹记录表
 */
@Data
@Accessors(chain = true)
@Builder
@NoArgsConstructor
@AllArgsConstructor
@TableName("logistics_trace")
public class LogisticsTrace {

    /**
     * 主键ID
     */
    @TableId(type = IdType.AUTO)
    private Long id;

    /**
     * 运单号
     */
    private String waybillNo;

    /**
     * 物流商编码：SF-顺丰, YTO-圆通, ZTO-中通, YUNDA-韵达
     */
    private String carrier;

    /**
     * 轨迹节点状态
     */
    private String status;

    /**
     * 状态标签
     */
    private String statusLabel;

    /**
     * 轨迹发生地点
     */
    private String location;

    /**
     * 轨迹描述
     */
    private String description;

    /**
     * 轨迹发生时间
     */
    private LocalDateTime traceTime;

    /**
     * 物流商返回的原始状态码
     */
    private String rawStatusCode;

    /**
     * 原始轨迹数据（JSON格式，保留原始数据便于排查）
     */
    private String rawData;

    /**
     * 创建时间
     */
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createdAt;

    /**
     * 逻辑删除：0-未删除, 1-已删除
     */
    @TableLogic
    private Integer deleted;
}
