tiku-backend.net/Tiku.Application/Growth/CommissionModels.cs

using System.Text.Json;

namespace Tiku.Application.Growth;

public sealed record CommissionAdminActor(Guid TenantId, Guid UserId);

public sealed record UpdateCommissionSettingsCommand(decimal? DefaultRate, int? MinSettlementCents, string? SettlementCycle, JsonElement? Config);

public sealed record UpdateMemberCommissionRateCommand(Guid UserId, decimal? CommissionRate, JsonElement? CommissionConfig);

public sealed record CommissionPeriodQuery(DateOnly? StartDate = null, DateOnly? EndDate = null, Guid? ReferrerUserId = null, int? Limit = null);

public sealed record CommissionSettlementQuery(string? Status = null, Guid? ReferrerUserId = null, int? Limit = null);

public sealed record GenerateCommissionSettlementCommand(DateOnly StartDate, DateOnly EndDate, Guid ReferrerUserId, string? Status, string? Remark, JsonElement? Metadata);

public sealed record UpdateCommissionSettlementStatusCommand(Guid SettlementId, string? Status, string? ReviewNote, string? PaymentMethod, string? PaymentAccount, JsonElement? Metadata);

public sealed record CreateCommissionProofCommand(Guid SettlementId, string? ProofType, string? Title, string? Description, Guid? AssetId, string? ExternalUrl, int? AmountCents, string? PaymentMethod, string? PaymentAccount, DateTimeOffset? PaidAt, JsonElement? Metadata);

public sealed record UpdateCommissionProofStatusCommand(Guid ProofId, string? Status, string? ReviewNote, JsonElement? Metadata);

public sealed record CommissionSettingsItem(decimal DefaultRate, int MinSettlementCents, string SettlementCycle, JsonElement Config);

public sealed record CommissionSourceItem(
    string SourceType,
    Guid SourceId,
    string? SourceNo,
    Guid ReferrerUserId,
    Guid? StudentUserId,
    int GrossAmountCents,
    decimal CommissionRate,
    int CommissionAmountCents,
    string RateSource,
    Guid? SettlementId);

public sealed record CommissionSummaryItem(int SourceCount, int PaidUserCount, int GrossAmountCents, int CommissionAmountCents);

public sealed record CommissionSettlementItemDto(
    Guid Id,
    string SettlementNo,
    Guid ReferrerUserId,
    string Status,
    DateOnly PeriodStart,
    DateOnly PeriodEnd,
    int SourceCount,
    int PaidUserCount,
    int GrossAmountCents,
    int CommissionAmountCents,
    DateTimeOffset? ReviewedAt,
    DateTimeOffset? PaidAt);

public sealed record CommissionProofItem(
    Guid Id,
    Guid SettlementId,
    string ProofType,
    string Status,
    string? Title,
    Guid? AssetId,
    string? ExternalUrl,
    int? AmountCents,
    string? PaymentMethod,
    string? PaymentAccount,
    DateTimeOffset? PaidAt,
    DateTimeOffset? ReviewedAt);

public sealed record CommissionExportItem(Guid SettlementId, string Filename, string Format, string MimeType, int RowCount, string ContentBase64, string Sha256, int SizeBytes);

public sealed record CommissionList<T>(IReadOnlyCollection<T> Items);

public interface ICommissionService
{
    Task<CommissionSettingsItem> GetSettingsAsync(CommissionAdminActor actor, CancellationToken cancellationToken = default);
    Task<CommissionSettingsItem> UpdateSettingsAsync(CommissionAdminActor actor, UpdateCommissionSettingsCommand command, CancellationToken cancellationToken = default);
    Task<object> UpdateMemberRateAsync(CommissionAdminActor actor, UpdateMemberCommissionRateCommand command, CancellationToken cancellationToken = default);
    Task<CommissionSummaryItem> GetSummaryAsync(CommissionAdminActor actor, CommissionPeriodQuery query, CancellationToken cancellationToken = default);
    Task<CommissionList<CommissionSourceItem>> GetOrdersAsync(CommissionAdminActor actor, CommissionPeriodQuery query, CancellationToken cancellationToken = default);
    Task<CommissionList<CommissionSettlementItemDto>> GetSettlementsAsync(CommissionAdminActor actor, CommissionSettlementQuery query, CancellationToken cancellationToken = default);
    Task<CommissionExportItem> ExportSettlementAsync(CommissionAdminActor actor, Guid settlementId, string? format, CancellationToken cancellationToken = default);
    Task<CommissionSettlementItemDto> GenerateSettlementAsync(CommissionAdminActor actor, GenerateCommissionSettlementCommand command, CancellationToken cancellationToken = default);
    Task<CommissionSettlementItemDto> UpdateSettlementStatusAsync(CommissionAdminActor actor, UpdateCommissionSettlementStatusCommand command, CancellationToken cancellationToken = default);
    Task<CommissionList<CommissionProofItem>> GetProofsAsync(CommissionAdminActor actor, Guid settlementId, CancellationToken cancellationToken = default);
    Task<CommissionProofItem> CreateProofAsync(CommissionAdminActor actor, CreateCommissionProofCommand command, CancellationToken cancellationToken = default);
    Task<CommissionProofItem> UpdateProofStatusAsync(CommissionAdminActor actor, UpdateCommissionProofStatusCommand command, CancellationToken cancellationToken = default);
}

public sealed class CommissionException(string message, string code) : Exception(message)
{
    public string Code { get; } = code;
}