using System;

namespace MassTransit.Message;

/// <summary>
/// ============================================================
/// Point-to-Point 通信模式示例 - 消息契约
/// ============================================================
/// 
/// Point-to-Point（点对点）通信模式特点：
/// 
/// 1. 单向消息传递
///    - 发送方只发送消息，不等待响应
///    - 消息发送后立即返回，提高性能
///    - 适用于不需要立即知道处理结果的场景
/// 
/// 2. 消息只被一个消费者处理
///    - RabbitMQ 队列确保消息只被一个消费者消费
///    - 多个消费者会形成竞争关系，每个消息只被处理一次
///    - 适合负载均衡和水平扩展
/// 
/// 3. 高性能
///    - 无需等待响应，消息发送后立即返回
///    - 减少网络往返时间（RTT）
///    - 提高系统吞吐量
/// 
/// 4. 可靠性
///    - 消息持久化保证消息不丢失
///    - 死信队列（DLQ）处理失败的消息
///    - 重试机制处理临时性错误
/// 
/// 使用场景：
/// - 订单创建后异步通知库存服务扣减库存
/// - 用户注册后发送欢迎邮件（不等待邮件发送完成）
/// - 数据同步和事件通知
/// - 日志和监控数据收集
/// 
/// 与 Request-Response 模式的区别：
/// - Request-Response: 使用 IRequestClient.GetResponse<T>()，等待响应
/// - Point-to-Point: 使用 IBus.Send()，不等待响应
/// 
/// ============================================================
public record OrderInventoryNotificationRequest
{
    /// <summary>
    /// 消息唯一标识符
    /// 用于消息去重和追踪
    /// </summary>
    public string MessageId { get; init; } = Guid.NewGuid().ToString("N");
    
    /// <summary>
    /// 关联ID，用于关联相关消息
    /// 例如：订单ID、用户ID等业务标识
    /// </summary>
    public string CorrelationId { get; init; } = string.Empty;
    
    /// <summary>
    /// 通知类型
    /// - OrderCreated: 订单创建
    /// - OrderCancelled: 订单取消
    /// </summary>
    public string NotificationType { get; init; } = string.Empty;
    
    /// <summary>
    /// 产品信息列表
    /// </summary>
    public List<ProductInfo> Products { get; init; } = new();
    
    /// <summary>
    /// 消息创建时间
    /// </summary>
    public DateTime CreatedAt { get; init; } = DateTime.UtcNow;
    
    /// <summary>
    /// 无参构造函数（用于反序列化）
    /// </summary>
    public OrderInventoryNotificationRequest() { }
    
    /// <summary>
    /// 带参数构造函数
    /// </summary>
    public OrderInventoryNotificationRequest(
        string correlationId,
        string notificationType,
        List<ProductInfo> products)
    {
        CorrelationId = correlationId;
        NotificationType = notificationType;
        Products = products;
    }
}

/// <summary>
/// 产品信息
/// </summary>
public record ProductInfo
{
    /// <summary>
    /// 产品ID
    /// </summary>
    public string ProductId { get; init; } = string.Empty;
    
    /// <summary>
    /// 产品名称
    /// </summary>
    public string ProductName { get; init; } = string.Empty;
    
    /// <summary>
    /// 操作数量
    /// 正数表示增加库存，负数表示减少库存
    /// </summary>
    public int Quantity { get; init; }
    
    /// <summary>
    /// 操作原因
    /// </summary>
    public string Reason { get; init; } = string.Empty;
    
    /// <summary>
    /// 无参构造函数（用于反序列化）
    /// </summary>
    public ProductInfo() { }
    
    /// <summary>
    /// 带参数构造函数
    /// </summary>
    public ProductInfo(string productId, string productName, int quantity, string reason)
    {
        ProductId = productId;
        ProductName = productName;
        Quantity = quantity;
        Reason = reason;
    }
}