feat: complete phase six backoffice operations

2026-07-28 14:31:43 +08:00
parent 747ff59d76
commit 99e4e43122
31 changed files with 23504 additions and 26 deletions
--- a/Tiku.Api/Controllers/TenantCommerceController.cs
+++ b/Tiku.Api/Controllers/TenantCommerceController.cs
@@ -2,6 +2,7 @@ using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Mvc;
 using Tiku.Api.Contracts;
 using Tiku.Application.Commerce;
+using Tiku.Application.Jobs;
 using Tiku.Application.Security;
 using Tiku.Domain.Commerce;

@@ -374,6 +375,34 @@ public sealed class TenantCommerceController(
            cancellationToken));
    }

+    [HttpGet("reconciliation/items")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("查询对账明细")]
+    [ProducesResponseType<TenantReconciliationItemList>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<TenantReconciliationItemList>> ReconciliationItems(
+        [FromQuery] Guid batchId,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.GetReconciliationItemsAsync(
+            ResolveActor(),
+            batchId,
+            cancellationToken));
+    }
+
+    [HttpGet("reconciliation/issues/events")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("查询对账工单事件")]
+    [ProducesResponseType<TenantReconciliationIssueEventList>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<TenantReconciliationIssueEventList>> ReconciliationIssueEvents(
+        [FromQuery] Guid issueId,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.GetReconciliationIssueEventsAsync(
+            ResolveActor(),
+            issueId,
+            cancellationToken));
+    }
+
    [HttpPost("reconciliation/issues/status")]
    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
    [EndpointSummary("更新对账异常状态")]
@@ -388,6 +417,154 @@ public sealed class TenantCommerceController(
            cancellationToken));
    }

+    [HttpGet("adjustment-vouchers")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("查询调账凭证")]
+    [ProducesResponseType<TenantAdjustmentVoucherList>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<TenantAdjustmentVoucherList>> AdjustmentVouchers(
+        [FromQuery] TenantCommerceQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.GetAdjustmentVouchersAsync(
+            ResolveActor(),
+            ToQuery(query),
+            cancellationToken));
+    }
+
+    [HttpGet("adjustment-vouchers/detail")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("查询调账凭证详情")]
+    [ProducesResponseType<CommerceAdjustmentVoucher>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CommerceAdjustmentVoucher>> AdjustmentVoucherDetail(
+        [FromQuery] Guid voucherId,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.GetAdjustmentVoucherAsync(
+            ResolveActor(),
+            voucherId,
+            cancellationToken));
+    }
+
+    [HttpPost("adjustment-vouchers")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("创建调账凭证")]
+    [ProducesResponseType<CommerceAdjustmentVoucher>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CommerceAdjustmentVoucher>> CreateAdjustmentVoucher(
+        CreateAdjustmentVoucherDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.CreateAdjustmentVoucherAsync(
+            ResolveActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    [HttpPost("adjustment-vouchers/status")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("审核或关闭调账凭证")]
+    [ProducesResponseType<CommerceAdjustmentVoucher>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CommerceAdjustmentVoucher>> UpdateAdjustmentVoucherStatus(
+        UpdateAdjustmentVoucherStatusDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.UpdateAdjustmentVoucherStatusAsync(
+            ResolveActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    [HttpGet("adjustment-vouchers/events")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("查询调账凭证事件")]
+    [ProducesResponseType<TenantAdjustmentVoucherEventList>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<TenantAdjustmentVoucherEventList>> AdjustmentVoucherEvents(
+        [FromQuery] Guid voucherId,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.GetAdjustmentVoucherEventsAsync(
+            ResolveActor(),
+            voucherId,
+            cancellationToken));
+    }
+
+    [HttpGet("adjustment-vouchers/report")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("查询调账统计报告")]
+    [ProducesResponseType<TenantAdjustmentReport>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<TenantAdjustmentReport>> AdjustmentVoucherReport(CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.GetAdjustmentReportAsync(
+            ResolveActor(),
+            cancellationToken));
+    }
+
+    [HttpGet("reconciliation/anomalies")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("查询对账异常汇总")]
+    [ProducesResponseType<TenantCommerceAnomalySummary>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<TenantCommerceAnomalySummary>> ReconciliationAnomalies(CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.GetAnomalySummaryAsync(
+            ResolveActor(),
+            cancellationToken));
+    }
+
+    [HttpPost("reconciliation/preview")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("预览支付渠道账单对账")]
+    [ProducesResponseType<ReconciliationImportPreview>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ReconciliationImportPreview>> PreviewReconciliation(
+        PreviewReconciliationImportDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.PreviewReconciliationImportAsync(
+            ResolveActor(),
+            request.ToPreviewCommand(),
+            cancellationToken));
+    }
+
+    [HttpPost("reconciliation/import")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("导入支付渠道账单并创建对账批次")]
+    [ProducesResponseType<CommerceReconciliationBatch>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CommerceReconciliationBatch>> ImportReconciliation(
+        PreviewReconciliationImportDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.ImportReconciliationAsync(
+            ResolveActor(),
+            request.ToImportCommand(),
+            cancellationToken));
+    }
+
+    [HttpGet("reconciliation/provider-bills/jobs")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("查询渠道账单下载任务")]
+    [ProducesResponseType<IReadOnlyCollection<BackgroundJobItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<IReadOnlyCollection<BackgroundJobItem>>> ProviderBillJobs(
+        [FromQuery] TenantCommerceQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.GetProviderBillJobsAsync(
+            ResolveActor(),
+            ToQuery(query),
+            cancellationToken));
+    }
+
+    [HttpPost("reconciliation/provider-bills/request")]
+    [Authorize(Policy = TikuPolicies.TenantCommerceOperateAllScope)]
+    [EndpointSummary("创建渠道官方账单下载任务")]
+    [ProducesResponseType<BackgroundJobItem>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<BackgroundJobItem>> RequestProviderBill(
+        RequestProviderBillJobDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceAdminService.RequestProviderBillJobAsync(
+            ResolveActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
    private CommerceAdminActor ResolveActor()
    {
        if (currentTenant.TenantId is null || currentUser.UserId is null)