forked from gongxuegit/tiku-backend.net
feat: add commission settlement endpoints
This commit is contained in:
xiong
136
Tiku.Api/Contracts/CommissionDtos.cs
Normal file
136
Tiku.Api/Contracts/CommissionDtos.cs
Normal file
@@ -0,0 +1,136 @@
|
||||
using System.ComponentModel.DataAnnotations;
|
||||
using System.Globalization;
|
||||
using System.Text.Json;
|
||||
using Tiku.Application.Growth;
|
||||
|
||||
namespace Tiku.Api.Contracts;
|
||||
|
||||
public sealed class UpdateCommissionSettingsDto
|
||||
{
|
||||
[Range(0, 1)]
|
||||
public decimal? DefaultRate { get; set; }
|
||||
[Range(0, int.MaxValue)]
|
||||
public int? MinSettlementCents { get; set; }
|
||||
[StringLength(50)]
|
||||
public string? SettlementCycle { get; set; }
|
||||
public JsonElement? Config { get; set; }
|
||||
public UpdateCommissionSettingsCommand ToCommand() => new(DefaultRate, MinSettlementCents, SettlementCycle, Config);
|
||||
}
|
||||
|
||||
public sealed class UpdateMemberCommissionRateDto
|
||||
{
|
||||
[Required]
|
||||
public Guid UserId { get; set; }
|
||||
[Range(0, 1)]
|
||||
public decimal? CommissionRate { get; set; }
|
||||
public JsonElement? CommissionConfig { get; set; }
|
||||
public UpdateMemberCommissionRateCommand ToCommand() => new(UserId, CommissionRate, CommissionConfig);
|
||||
}
|
||||
|
||||
public class CommissionPeriodQueryDto
|
||||
{
|
||||
[RegularExpression("^\\d{4}-\\d{2}-\\d{2}$")]
|
||||
public string? StartDate { get; set; }
|
||||
[RegularExpression("^\\d{4}-\\d{2}-\\d{2}$")]
|
||||
public string? EndDate { get; set; }
|
||||
public Guid? ReferrerUserId { get; set; }
|
||||
[Range(1, 500)]
|
||||
public int? Limit { get; set; }
|
||||
public CommissionPeriodQuery ToQuery() => new(ParseDate(StartDate), ParseDate(EndDate), ReferrerUserId, Limit);
|
||||
protected static DateOnly? ParseDate(string? value) => string.IsNullOrWhiteSpace(value) ? null : DateOnly.ParseExact(value, "yyyy-MM-dd", CultureInfo.InvariantCulture);
|
||||
}
|
||||
|
||||
public sealed class CommissionSettlementsQueryDto
|
||||
{
|
||||
[StringLength(50)]
|
||||
public string? Status { get; set; }
|
||||
public Guid? ReferrerUserId { get; set; }
|
||||
[Range(1, 500)]
|
||||
public int? Limit { get; set; }
|
||||
public CommissionSettlementQuery ToQuery() => new(Status, ReferrerUserId, Limit);
|
||||
}
|
||||
|
||||
public sealed class GenerateCommissionSettlementDto
|
||||
{
|
||||
[Required]
|
||||
[RegularExpression("^\\d{4}-\\d{2}-\\d{2}$")]
|
||||
public string StartDate { get; set; } = string.Empty;
|
||||
[Required]
|
||||
[RegularExpression("^\\d{4}-\\d{2}-\\d{2}$")]
|
||||
public string EndDate { get; set; } = string.Empty;
|
||||
[Required]
|
||||
public Guid ReferrerUserId { get; set; }
|
||||
[StringLength(50)]
|
||||
public string? Status { get; set; }
|
||||
[StringLength(1000)]
|
||||
public string? Remark { get; set; }
|
||||
public JsonElement? Metadata { get; set; }
|
||||
public GenerateCommissionSettlementCommand ToCommand() => new(Parse(StartDate), Parse(EndDate), ReferrerUserId, Status, Remark, Metadata);
|
||||
private static DateOnly Parse(string value) => DateOnly.ParseExact(value, "yyyy-MM-dd", CultureInfo.InvariantCulture);
|
||||
}
|
||||
|
||||
public sealed class UpdateCommissionSettlementStatusDto
|
||||
{
|
||||
[Required]
|
||||
public Guid SettlementId { get; set; }
|
||||
[StringLength(50)]
|
||||
public string? Status { get; set; }
|
||||
[StringLength(1000)]
|
||||
public string? ReviewNote { get; set; }
|
||||
[StringLength(100)]
|
||||
public string? PaymentMethod { get; set; }
|
||||
[StringLength(200)]
|
||||
public string? PaymentAccount { get; set; }
|
||||
public JsonElement? Metadata { get; set; }
|
||||
public UpdateCommissionSettlementStatusCommand ToCommand() => new(SettlementId, Status, ReviewNote, PaymentMethod, PaymentAccount, Metadata);
|
||||
}
|
||||
|
||||
public sealed class CommissionSettlementExportQueryDto
|
||||
{
|
||||
[Required]
|
||||
public Guid SettlementId { get; set; }
|
||||
[StringLength(10)]
|
||||
public string? Format { get; set; }
|
||||
}
|
||||
|
||||
public sealed class CommissionSettlementProofQueryDto
|
||||
{
|
||||
[Required]
|
||||
public Guid SettlementId { get; set; }
|
||||
}
|
||||
|
||||
public sealed class CreateCommissionProofDto
|
||||
{
|
||||
[Required]
|
||||
public Guid SettlementId { get; set; }
|
||||
[StringLength(50)]
|
||||
public string? ProofType { get; set; }
|
||||
[StringLength(200)]
|
||||
public string? Title { get; set; }
|
||||
[StringLength(2000)]
|
||||
public string? Description { get; set; }
|
||||
public Guid? AssetId { get; set; }
|
||||
[StringLength(2048)]
|
||||
public string? ExternalUrl { get; set; }
|
||||
[Range(0, int.MaxValue)]
|
||||
public int? AmountCents { get; set; }
|
||||
[StringLength(100)]
|
||||
public string? PaymentMethod { get; set; }
|
||||
[StringLength(200)]
|
||||
public string? PaymentAccount { get; set; }
|
||||
public DateTimeOffset? PaidAt { get; set; }
|
||||
public JsonElement? Metadata { get; set; }
|
||||
public CreateCommissionProofCommand ToCommand() => new(SettlementId, ProofType, Title, Description, AssetId, ExternalUrl, AmountCents, PaymentMethod, PaymentAccount, PaidAt, Metadata);
|
||||
}
|
||||
|
||||
public sealed class UpdateCommissionProofStatusDto
|
||||
{
|
||||
[Required]
|
||||
public Guid ProofId { get; set; }
|
||||
[StringLength(50)]
|
||||
public string? Status { get; set; }
|
||||
[StringLength(1000)]
|
||||
public string? ReviewNote { get; set; }
|
||||
public JsonElement? Metadata { get; set; }
|
||||
public UpdateCommissionProofStatusCommand ToCommand() => new(ProofId, Status, ReviewNote, Metadata);
|
||||
}
|
||||
75
Tiku.Api/Controllers/CommissionController.cs
Normal file
75
Tiku.Api/Controllers/CommissionController.cs
Normal file
@@ -0,0 +1,75 @@
|
||||
using Microsoft.AspNetCore.Authorization;
|
||||
using Microsoft.AspNetCore.Mvc;
|
||||
using Tiku.Api.Contracts;
|
||||
using Tiku.Application.Growth;
|
||||
using Tiku.Application.Security;
|
||||
|
||||
namespace Tiku.Api.Controllers;
|
||||
|
||||
[ApiController]
|
||||
[Authorize(Policy = TikuPolicies.TenantAdmin)]
|
||||
[Produces("application/json")]
|
||||
[Route("api/commission")]
|
||||
public sealed class CommissionController(
|
||||
ICommissionService commissionService,
|
||||
ICurrentUser currentUser,
|
||||
ICurrentTenant currentTenant) : ControllerBase
|
||||
{
|
||||
[HttpGet("settings")]
|
||||
public async Task<ActionResult<CommissionSettingsItem>> Settings(CancellationToken cancellationToken) =>
|
||||
Ok(await commissionService.GetSettingsAsync(ResolveActor(), cancellationToken));
|
||||
|
||||
[HttpPut("settings")]
|
||||
public async Task<ActionResult<CommissionSettingsItem>> UpdateSettings(UpdateCommissionSettingsDto request, CancellationToken cancellationToken) =>
|
||||
Ok(await commissionService.UpdateSettingsAsync(ResolveActor(), request.ToCommand(), cancellationToken));
|
||||
|
||||
[HttpPut("member-rate")]
|
||||
public async Task<ActionResult<object>> MemberRate(UpdateMemberCommissionRateDto request, CancellationToken cancellationToken) =>
|
||||
Ok(await commissionService.UpdateMemberRateAsync(ResolveActor(), request.ToCommand(), cancellationToken));
|
||||
|
||||
[HttpGet("summary")]
|
||||
public async Task<ActionResult<CommissionSummaryItem>> Summary([FromQuery] CommissionPeriodQueryDto query, CancellationToken cancellationToken) =>
|
||||
Ok(await commissionService.GetSummaryAsync(ResolveActor(), query.ToQuery(), cancellationToken));
|
||||
|
||||
[HttpGet("orders")]
|
||||
public async Task<ActionResult<CommissionList<CommissionSourceItem>>> Orders([FromQuery] CommissionPeriodQueryDto query, CancellationToken cancellationToken) =>
|
||||
Ok(await commissionService.GetOrdersAsync(ResolveActor(), query.ToQuery(), cancellationToken));
|
||||
|
||||
[HttpGet("settlements")]
|
||||
public async Task<ActionResult<CommissionList<CommissionSettlementItemDto>>> Settlements([FromQuery] CommissionSettlementsQueryDto query, CancellationToken cancellationToken) =>
|
||||
Ok(await commissionService.GetSettlementsAsync(ResolveActor(), query.ToQuery(), cancellationToken));
|
||||
|
||||
[HttpGet("settlements/export")]
|
||||
public async Task<ActionResult<CommissionExportItem>> Export([FromQuery] CommissionSettlementExportQueryDto query, CancellationToken cancellationToken) =>
|
||||
Ok(await commissionService.ExportSettlementAsync(ResolveActor(), query.SettlementId, query.Format, cancellationToken));
|
||||
|
||||
[HttpPost("settlements/generate")]
|
||||
public async Task<ActionResult<CommissionSettlementItemDto>> Generate(GenerateCommissionSettlementDto request, CancellationToken cancellationToken) =>
|
||||
Ok(await commissionService.GenerateSettlementAsync(ResolveActor(), request.ToCommand(), cancellationToken));
|
||||
|
||||
[HttpPost("settlements/status")]
|
||||
public async Task<ActionResult<CommissionSettlementItemDto>> UpdateStatus(UpdateCommissionSettlementStatusDto request, CancellationToken cancellationToken) =>
|
||||
Ok(await commissionService.UpdateSettlementStatusAsync(ResolveActor(), request.ToCommand(), cancellationToken));
|
||||
|
||||
[HttpGet("settlements/proofs")]
|
||||
public async Task<ActionResult<CommissionList<CommissionProofItem>>> Proofs([FromQuery] CommissionSettlementProofQueryDto query, CancellationToken cancellationToken) =>
|
||||
Ok(await commissionService.GetProofsAsync(ResolveActor(), query.SettlementId, cancellationToken));
|
||||
|
||||
[HttpPost("settlements/proofs")]
|
||||
public async Task<ActionResult<CommissionProofItem>> CreateProof(CreateCommissionProofDto request, CancellationToken cancellationToken) =>
|
||||
Ok(await commissionService.CreateProofAsync(ResolveActor(), request.ToCommand(), cancellationToken));
|
||||
|
||||
[HttpPost("settlements/proofs/status")]
|
||||
public async Task<ActionResult<CommissionProofItem>> UpdateProofStatus(UpdateCommissionProofStatusDto request, CancellationToken cancellationToken) =>
|
||||
Ok(await commissionService.UpdateProofStatusAsync(ResolveActor(), request.ToCommand(), cancellationToken));
|
||||
|
||||
private CommissionAdminActor ResolveActor()
|
||||
{
|
||||
if (currentTenant.TenantId is null || currentUser.UserId is null)
|
||||
{
|
||||
throw new CommissionException("Commission admin actor was not resolved.", "commission_access_denied");
|
||||
}
|
||||
|
||||
return new CommissionAdminActor(currentTenant.TenantId.Value, currentUser.UserId.Value);
|
||||
}
|
||||
}
|
||||
@@ -215,6 +215,16 @@ public sealed class ExceptionHandlingMiddleware(
|
||||
return;
|
||||
}
|
||||
|
||||
if (exception is CommissionException commissionException)
|
||||
{
|
||||
await WriteProblemAsync(
|
||||
context,
|
||||
commissionException.Message,
|
||||
CommissionStatusCode(commissionException.Code),
|
||||
commissionException.Code);
|
||||
return;
|
||||
}
|
||||
|
||||
if (exception is PaymentProviderException paymentProviderException)
|
||||
{
|
||||
await WriteProblemAsync(
|
||||
@@ -410,4 +420,17 @@ public sealed class ExceptionHandlingMiddleware(
|
||||
_ => StatusCodes.Status400BadRequest
|
||||
};
|
||||
}
|
||||
|
||||
private static int CommissionStatusCode(string code)
|
||||
{
|
||||
return code switch
|
||||
{
|
||||
"commission_access_denied" => StatusCodes.Status403Forbidden,
|
||||
"commission_member_not_found" or "commission_settlement_not_found" or "commission_proof_not_found" =>
|
||||
StatusCodes.Status404NotFound,
|
||||
"commission_no_unsettled_sources" or "commission_below_minimum" or "commission_status_invalid" or
|
||||
"commission_proof_closed" => StatusCodes.Status409Conflict,
|
||||
_ => StatusCodes.Status400BadRequest
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user