ANTOOZA-BACKEND/Domain/Entities/Payments/Toss/TossLog.cs

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
using Domain.Entities.Members;
using Domain.Entities.Payments.Toss.ValueObject;

namespace Domain.Entities.Payments.Toss;

/// <summary>
/// 토스페이먼츠 결제 에러 / 실패 / 웹훅 / 대사 통합 로그
/// 웹훅은 회원을 특정하지 못할 수 있어 MemberID 는 nullable.
/// </summary>
public class TossLog
{
    [ForeignKey(nameof(MemberID))]
    public virtual Member? Member { get; private set; }

    [Key]
    public int ID { get; private set; }

    public int? MemberID { get; private set; }

    /// <summary>로그 유형 (Failed, Error, Webhook, Reconcile)</summary>
    public TossLogType LogType { get; private set; }

    /// <summary>결과/에러 코드</summary>
    public string Code { get; private set; } = default!;

    /// <summary>결과/에러 메시지</summary>
    public string Message { get; private set; } = default!;

    /// <summary>토스 결제 키 (있는 경우)</summary>
    public string? PaymentKey { get; private set; }

    /// <summary>가맹점 주문번호 (있는 경우)</summary>
    public string? OrderID { get; private set; }

    /// <summary>추가 데이터 (JSON 등)</summary>
    public string? ExtraData { get; private set; }

    public DateTime CreatedAt { get; private set; } = DateTime.UtcNow;

    private TossLog() { }

    public static TossLog Create(
        int? memberID,
        TossLogType logType,
        string code,
        string message,
        string? paymentKey = null,
        string? orderID = null,
        string? extraData = null
    ) {
        return new TossLog
        {
            MemberID = memberID,
            LogType = logType,
            Code = code,
            Message = message.Length > 500 ? message[..500] : message,
            PaymentKey = paymentKey,
            OrderID = orderID,
            ExtraData = extraData
        };
    }
}