docs: 标记自提档期完成

2025-12-04 11:51:09 +08:00
parent 2022d1c377
commit 7d6b7d8760
29 changed files with 1165 additions and 2 deletions
--- a/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/CreateStorePickupSlotCommandHandler.cs
+++ b/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/CreateStorePickupSlotCommandHandler.cs
@@ -0,0 +1,64 @@
+using MediatR;
+using Microsoft.Extensions.Logging;
+using TakeoutSaaS.Application.App.Stores.Commands;
+using TakeoutSaaS.Application.App.Stores.Dto;
+using TakeoutSaaS.Domain.Stores.Entities;
+using TakeoutSaaS.Domain.Stores.Repositories;
+using TakeoutSaaS.Shared.Abstractions.Constants;
+using TakeoutSaaS.Shared.Abstractions.Exceptions;
+using TakeoutSaaS.Shared.Abstractions.Tenancy;
+
+namespace TakeoutSaaS.Application.App.Stores.Handlers;
+
+/// <summary>
+/// 创建自提档期处理器。
+/// </summary>
+public sealed class CreateStorePickupSlotCommandHandler(
+    IStoreRepository storeRepository,
+    ITenantProvider tenantProvider,
+    ILogger<CreateStorePickupSlotCommandHandler> logger)
+    : IRequestHandler<CreateStorePickupSlotCommand, StorePickupSlotDto>
+{
+    /// <inheritdoc />
+    public async Task<StorePickupSlotDto> Handle(CreateStorePickupSlotCommand request, CancellationToken cancellationToken)
+    {
+        // 1. 校验门店
+        var tenantId = tenantProvider.GetCurrentTenantId();
+        var store = await storeRepository.FindByIdAsync(request.StoreId, tenantId, cancellationToken);
+        if (store is null)
+        {
+            throw new BusinessException(ErrorCodes.NotFound, "门店不存在");
+        }
+
+        // 2. 新建档期
+        var slot = new StorePickupSlot
+        {
+            TenantId = tenantId,
+            StoreId = request.StoreId,
+            Name = request.Name.Trim(),
+            StartTime = request.StartTime,
+            EndTime = request.EndTime,
+            CutoffMinutes = request.CutoffMinutes,
+            Capacity = request.Capacity,
+            ReservedCount = 0,
+            Weekdays = request.Weekdays,
+            IsEnabled = request.IsEnabled
+        };
+        await storeRepository.AddPickupSlotsAsync(new[] { slot }, cancellationToken);
+        await storeRepository.SaveChangesAsync(cancellationToken);
+        logger.LogInformation("创建自提档期 {SlotId} for store {StoreId}", slot.Id, request.StoreId);
+        return new StorePickupSlotDto
+        {
+            Id = slot.Id,
+            StoreId = slot.StoreId,
+            Name = slot.Name,
+            StartTime = slot.StartTime,
+            EndTime = slot.EndTime,
+            CutoffMinutes = slot.CutoffMinutes,
+            Capacity = slot.Capacity,
+            ReservedCount = slot.ReservedCount,
+            Weekdays = slot.Weekdays,
+            IsEnabled = slot.IsEnabled
+        };
+    }
+}
--- a/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/DeleteStorePickupSlotCommandHandler.cs
+++ b/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/DeleteStorePickupSlotCommandHandler.cs
@@ -0,0 +1,28 @@
+using MediatR;
+using Microsoft.Extensions.Logging;
+using TakeoutSaaS.Application.App.Stores.Commands;
+using TakeoutSaaS.Domain.Stores.Repositories;
+using TakeoutSaaS.Shared.Abstractions.Tenancy;
+
+namespace TakeoutSaaS.Application.App.Stores.Handlers;
+
+/// <summary>
+/// 删除自提档期处理器。
+/// </summary>
+public sealed class DeleteStorePickupSlotCommandHandler(
+    IStoreRepository storeRepository,
+    ITenantProvider tenantProvider,
+    ILogger<DeleteStorePickupSlotCommandHandler> logger)
+    : IRequestHandler<DeleteStorePickupSlotCommand, bool>
+{
+    /// <inheritdoc />
+    public async Task<bool> Handle(DeleteStorePickupSlotCommand request, CancellationToken cancellationToken)
+    {
+        // 1. 删除档期
+        var tenantId = tenantProvider.GetCurrentTenantId();
+        await storeRepository.DeletePickupSlotAsync(request.SlotId, tenantId, cancellationToken);
+        await storeRepository.SaveChangesAsync(cancellationToken);
+        logger.LogInformation("删除自提档期 {SlotId}", request.SlotId);
+        return true;
+    }
+}
--- a/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/GetAvailablePickupSlotsQueryHandler.cs
+++ b/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/GetAvailablePickupSlotsQueryHandler.cs
@@ -0,0 +1,83 @@
+using MediatR;
+using TakeoutSaaS.Application.App.Stores.Dto;
+using TakeoutSaaS.Application.App.Stores.Queries;
+using TakeoutSaaS.Domain.Stores.Repositories;
+using TakeoutSaaS.Shared.Abstractions.Tenancy;
+
+namespace TakeoutSaaS.Application.App.Stores.Handlers;
+
+/// <summary>
+/// 可用自提档期查询处理器。
+/// </summary>
+public sealed class GetAvailablePickupSlotsQueryHandler(
+    IStoreRepository storeRepository,
+    ITenantProvider tenantProvider)
+    : IRequestHandler<GetAvailablePickupSlotsQuery, IReadOnlyList<StorePickupSlotDto>>
+{
+    /// <inheritdoc />
+    public async Task<IReadOnlyList<StorePickupSlotDto>> Handle(GetAvailablePickupSlotsQuery request, CancellationToken cancellationToken)
+    {
+        var tenantId = tenantProvider.GetCurrentTenantId();
+        var date = request.Date.Date;
+        // 1. 读取配置
+        var setting = await storeRepository.GetPickupSettingAsync(request.StoreId, tenantId, cancellationToken);
+        var allowDays = setting?.AllowDaysAhead ?? 0;
+        var allowToday = setting?.AllowToday ?? false;
+        var defaultCutoff = setting?.DefaultCutoffMinutes ?? 30;
+
+        // 2. 校验日期范围
+        if (!allowToday && date == DateTime.UtcNow.Date)
+        {
+            return [];
+        }
+
+        if (date > DateTime.UtcNow.Date.AddDays(allowDays))
+        {
+            return [];
+        }
+
+        // 3. 读取档期
+        var slots = await storeRepository.GetPickupSlotsAsync(request.StoreId, tenantId, cancellationToken);
+        var weekday = (int)date.DayOfWeek;
+        weekday = weekday == 0 ? 7 : weekday;
+        var nowUtc = DateTime.UtcNow;
+
+        // 4. 过滤可用
+        var available = slots
+            .Where(x => x.IsEnabled && ContainsDay(x.Weekdays, weekday))
+            .Select(slot =>
+            {
+                var cutoff = slot.CutoffMinutes == 0 ? defaultCutoff : slot.CutoffMinutes;
+                var slotStartUtc = date.Add(slot.StartTime);
+                // 判断截单
+                var cutoffTime = slotStartUtc.AddMinutes(-cutoff);
+                var isCutoff = nowUtc > cutoffTime;
+                var remaining = slot.Capacity - slot.ReservedCount;
+                return (slot, isCutoff, remaining);
+            })
+            .Where(x => !x.isCutoff && x.remaining > 0)
+            .Select(x => new StorePickupSlotDto
+            {
+                Id = x.slot.Id,
+                StoreId = x.slot.StoreId,
+                Name = x.slot.Name,
+                StartTime = x.slot.StartTime,
+                EndTime = x.slot.EndTime,
+                CutoffMinutes = x.slot.CutoffMinutes,
+                Capacity = x.slot.Capacity,
+                ReservedCount = x.slot.ReservedCount,
+                Weekdays = x.slot.Weekdays,
+                IsEnabled = x.slot.IsEnabled
+            })
+            .ToList();
+
+        return available;
+    }
+
+    private static bool ContainsDay(string weekdays, int target)
+    {
+        // 解析适用星期
+        var parts = weekdays.Split(',', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
+        return parts.Any(p => int.TryParse(p, out var val) && val == target);
+    }
+}
--- a/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/GetStorePickupSettingQueryHandler.cs
+++ b/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/GetStorePickupSettingQueryHandler.cs
@@ -0,0 +1,37 @@
+using MediatR;
+using TakeoutSaaS.Application.App.Stores.Dto;
+using TakeoutSaaS.Application.App.Stores.Queries;
+using TakeoutSaaS.Domain.Stores.Repositories;
+using TakeoutSaaS.Shared.Abstractions.Tenancy;
+
+namespace TakeoutSaaS.Application.App.Stores.Handlers;
+
+/// <summary>
+/// 获取自提配置处理器。
+/// </summary>
+public sealed class GetStorePickupSettingQueryHandler(
+    IStoreRepository storeRepository,
+    ITenantProvider tenantProvider)
+    : IRequestHandler<GetStorePickupSettingQuery, StorePickupSettingDto?>
+{
+    /// <inheritdoc />
+    public async Task<StorePickupSettingDto?> Handle(GetStorePickupSettingQuery request, CancellationToken cancellationToken)
+    {
+        var tenantId = tenantProvider.GetCurrentTenantId();
+        var setting = await storeRepository.GetPickupSettingAsync(request.StoreId, tenantId, cancellationToken);
+        if (setting is null)
+        {
+            return null;
+        }
+
+        return new StorePickupSettingDto
+        {
+            Id = setting.Id,
+            StoreId = setting.StoreId,
+            AllowToday = setting.AllowToday,
+            AllowDaysAhead = setting.AllowDaysAhead,
+            DefaultCutoffMinutes = setting.DefaultCutoffMinutes,
+            MaxQuantityPerOrder = setting.MaxQuantityPerOrder
+        };
+    }
+}
--- a/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/ListStorePickupSlotsQueryHandler.cs
+++ b/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/ListStorePickupSlotsQueryHandler.cs
@@ -0,0 +1,38 @@
+using MediatR;
+using TakeoutSaaS.Application.App.Stores.Dto;
+using TakeoutSaaS.Application.App.Stores.Queries;
+using TakeoutSaaS.Domain.Stores.Repositories;
+using TakeoutSaaS.Shared.Abstractions.Tenancy;
+
+namespace TakeoutSaaS.Application.App.Stores.Handlers;
+
+/// <summary>
+/// 自提档期列表查询处理器。
+/// </summary>
+public sealed class ListStorePickupSlotsQueryHandler(
+    IStoreRepository storeRepository,
+    ITenantProvider tenantProvider)
+    : IRequestHandler<ListStorePickupSlotsQuery, IReadOnlyList<StorePickupSlotDto>>
+{
+    /// <inheritdoc />
+    public async Task<IReadOnlyList<StorePickupSlotDto>> Handle(ListStorePickupSlotsQuery request, CancellationToken cancellationToken)
+    {
+        var tenantId = tenantProvider.GetCurrentTenantId();
+        var slots = await storeRepository.GetPickupSlotsAsync(request.StoreId, tenantId, cancellationToken);
+        return slots
+            .Select(x => new StorePickupSlotDto
+            {
+                Id = x.Id,
+                StoreId = x.StoreId,
+                Name = x.Name,
+                StartTime = x.StartTime,
+                EndTime = x.EndTime,
+                CutoffMinutes = x.CutoffMinutes,
+                Capacity = x.Capacity,
+                ReservedCount = x.ReservedCount,
+                Weekdays = x.Weekdays,
+                IsEnabled = x.IsEnabled
+            })
+            .ToList();
+    }
+}
--- a/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/UpdateStorePickupSlotCommandHandler.cs
+++ b/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/UpdateStorePickupSlotCommandHandler.cs
@@ -0,0 +1,57 @@
+using MediatR;
+using Microsoft.Extensions.Logging;
+using TakeoutSaaS.Application.App.Stores.Commands;
+using TakeoutSaaS.Application.App.Stores.Dto;
+using TakeoutSaaS.Domain.Stores.Repositories;
+using TakeoutSaaS.Shared.Abstractions.Constants;
+using TakeoutSaaS.Shared.Abstractions.Exceptions;
+using TakeoutSaaS.Shared.Abstractions.Tenancy;
+
+namespace TakeoutSaaS.Application.App.Stores.Handlers;
+
+/// <summary>
+/// 更新自提档期处理器。
+/// </summary>
+public sealed class UpdateStorePickupSlotCommandHandler(
+    IStoreRepository storeRepository,
+    ITenantProvider tenantProvider,
+    ILogger<UpdateStorePickupSlotCommandHandler> logger)
+    : IRequestHandler<UpdateStorePickupSlotCommand, StorePickupSlotDto?>
+{
+    /// <inheritdoc />
+    public async Task<StorePickupSlotDto?> Handle(UpdateStorePickupSlotCommand request, CancellationToken cancellationToken)
+    {
+        // 1. 查询档期
+        var tenantId = tenantProvider.GetCurrentTenantId();
+        var slot = await storeRepository.FindPickupSlotByIdAsync(request.SlotId, tenantId, cancellationToken);
+        if (slot is null || slot.StoreId != request.StoreId)
+        {
+            return null;
+        }
+
+        // 2. 更新字段
+        slot.Name = request.Name.Trim();
+        slot.StartTime = request.StartTime;
+        slot.EndTime = request.EndTime;
+        slot.CutoffMinutes = request.CutoffMinutes;
+        slot.Capacity = request.Capacity;
+        slot.Weekdays = request.Weekdays;
+        slot.IsEnabled = request.IsEnabled;
+        await storeRepository.UpdatePickupSlotAsync(slot, cancellationToken);
+        await storeRepository.SaveChangesAsync(cancellationToken);
+        logger.LogInformation("更新自提档期 {SlotId}", request.SlotId);
+        return new StorePickupSlotDto
+        {
+            Id = slot.Id,
+            StoreId = slot.StoreId,
+            Name = slot.Name,
+            StartTime = slot.StartTime,
+            EndTime = slot.EndTime,
+            CutoffMinutes = slot.CutoffMinutes,
+            Capacity = slot.Capacity,
+            ReservedCount = slot.ReservedCount,
+            Weekdays = slot.Weekdays,
+            IsEnabled = slot.IsEnabled
+        };
+    }
+}
--- a/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/UpsertStorePickupSettingCommandHandler.cs
+++ b/src/Application/TakeoutSaaS.Application/App/Stores/Handlers/UpsertStorePickupSettingCommandHandler.cs
@@ -0,0 +1,63 @@
+using MediatR;
+using Microsoft.Extensions.Logging;
+using TakeoutSaaS.Application.App.Stores.Commands;
+using TakeoutSaaS.Application.App.Stores.Dto;
+using TakeoutSaaS.Domain.Stores.Entities;
+using TakeoutSaaS.Domain.Stores.Repositories;
+using TakeoutSaaS.Shared.Abstractions.Constants;
+using TakeoutSaaS.Shared.Abstractions.Exceptions;
+using TakeoutSaaS.Shared.Abstractions.Tenancy;
+
+namespace TakeoutSaaS.Application.App.Stores.Handlers;
+
+/// <summary>
+/// 自提配置维护处理器。
+/// </summary>
+public sealed class UpsertStorePickupSettingCommandHandler(
+    IStoreRepository storeRepository,
+    ITenantProvider tenantProvider,
+    ILogger<UpsertStorePickupSettingCommandHandler> logger)
+    : IRequestHandler<UpsertStorePickupSettingCommand, StorePickupSettingDto>
+{
+    /// <inheritdoc />
+    public async Task<StorePickupSettingDto> Handle(UpsertStorePickupSettingCommand request, CancellationToken cancellationToken)
+    {
+        // 1. 校验门店存在
+        var tenantId = tenantProvider.GetCurrentTenantId();
+        var store = await storeRepository.FindByIdAsync(request.StoreId, tenantId, cancellationToken);
+        if (store is null)
+        {
+            throw new BusinessException(ErrorCodes.NotFound, "门店不存在");
+        }
+
+        // 2. 读取或创建配置
+        var setting = await storeRepository.GetPickupSettingAsync(request.StoreId, tenantId, cancellationToken);
+        if (setting is null)
+        {
+            setting = new StorePickupSetting
+            {
+                TenantId = tenantId,
+                StoreId = request.StoreId
+            };
+            await storeRepository.AddPickupSettingAsync(setting, cancellationToken);
+        }
+
+        // 3. 更新字段
+        setting.AllowToday = request.AllowToday;
+        setting.AllowDaysAhead = request.AllowDaysAhead;
+        setting.DefaultCutoffMinutes = request.DefaultCutoffMinutes;
+        setting.MaxQuantityPerOrder = request.MaxQuantityPerOrder;
+        await storeRepository.UpdatePickupSettingAsync(setting, cancellationToken);
+        await storeRepository.SaveChangesAsync(cancellationToken);
+        logger.LogInformation("更新门店 {StoreId} 自提配置", request.StoreId);
+        return new StorePickupSettingDto
+        {
+            Id = setting.Id,
+            StoreId = setting.StoreId,
+            AllowToday = setting.AllowToday,
+            AllowDaysAhead = setting.AllowDaysAhead,
+            DefaultCutoffMinutes = setting.DefaultCutoffMinutes,
+            MaxQuantityPerOrder = setting.MaxQuantityPerOrder
+        };
+    }
+}