گشت‌آفرین (GashtAfarin): از قابلیت‌ها تا معماری — کالبدشکافی یک پلتفرم جامع گردشگری

src/GashtAfarin.Domain/Travel/Trip.cs — الگوی ارث‌بری در طراحی دامنه (DDD) با موجودیت پایه ممیزی‌شده (FullAuditedEntity) و فیلدهای تخصصی پرواز.

public class Trip : FullAuditedEntity<long>
{
    public string Title { get; set; }
    public DateTime StartDateTime { get; set; }
    public long BasePrice { get; set; }
    public int ChildDiscountPercent { get; set; } = 25;
    public int InfantDiscountPercent { get; set; } = 90;
    public TripSeatMap TripSeatMap { get; set; }
}

public class AirTrip : Trip
{
    public int AirLineId { get; set; }
    public AirLine AirLine { get; set; }
    public int? AirPlaneId { get; set; }
    public AirPlane AirPlane { get; set; }
    public DateTime LandingDateTime { get; set; }
    public FlightTypeEnum FlightTypeEnum { get; set; }
    public int TripClassId { get; set; }
    public TripClass TripClass { get; set; }
    public int StopsCount { get; set; }
    public string? SeatAndBaggageInfo { get; set; }
    public List<Amenity> FlightAmenities { get; set; } = new();
    public List<Policy> FareRules { get; set; } = new();
}

src/GashtAfarin.Domain/Booking/BookingManager.cs — محافظت از اینورینت‌های تجاری، اعتبارسنجی صندلی‌های رزروشده و جلوگیری از Overbooking پیش از نهایی‌سازی سفارش.

public async Task ValidateCapacityAsync(ReservationTypeEnum type, long targetId,
    int requestedCount, List<string>? requestedSeats = null)
{
    if (type == ReservationTypeEnum.Flight || type == ReservationTypeEnum.Cruise)
    {
        var trip = await _tripRepository.FindAsync(targetId);
        if (trip == null) throw new UserFriendlyException("سفر مورد نظر یافت نشد.");

        var seatMap = trip.TripSeatMapId.HasValue
            ? await _tripSeatMapRepository.FindAsync((int)trip.TripSeatMapId.Value)
            : await _tripSeatMapRepository.FirstOrDefaultAsync(m => m.TripId == targetId);

        if (seatMap != null)
        {
            var seatQuery = await _tripSeatRepository.GetQueryableAsync();
            var totalAvailable = await AsyncExecuter.CountAsync(
                seatQuery.Where(s => s.TripSeatMapId == seatMap.Id && !s.IsBooked));

            if (totalAvailable < requestedCount)
                throw new UserFriendlyException(
                    $"ظرفیت باقیمانده این سفر ({totalAvailable} صندلی) کمتر از تعداد مسافران است.");

            if (requestedSeats != null && requestedSeats.Any())
            {
                var bookedSeats = await AsyncExecuter.ToListAsync(seatQuery.Where(s =>
                    s.TripSeatMapId == seatMap.Id && requestedSeats.Contains(s.SeatNumber) && s.IsBooked));
                if (bookedSeats.Any())
                    throw new UserFriendlyException(
                        $"صندلی‌های ({string.Join(", ", bookedSeats.Select(s => s.SeatNumber))}) قبلاً رزرو شده‌اند.");
            }
        }
    }
}

src/GashtAfarin.Application/Cart/CartAppService.cs — ارکستراسیون میان امنیت (CurrentUser)، سرویس دامنه برای اعتبارسنجی و موتور محاسباتی رده‌های سنی، با ثبت اتمیک آیتم سبد.

[Authorize]
public async Task<CartDto> AddToCartAsync(AddToCartDto input)
{
    var totalPassengers = input.AdultsCount + input.ChildrenCount + input.InfantsCount;
    if (totalPassengers <= 0) totalPassengers = Math.Max(1, input.Quantity);

    // اعتبارسنجی ظرفیت و صندلی‌ها از طریق سرویس دامنه
    await _bookingManager.ValidateCapacityAsync(input.ReservationType, input.TargetId,
        totalPassengers, input.SelectedSeatNumbers);

    var userId = CurrentUser.GetId();
    var query = await _cartRepository.WithDetailsAsync(c => c.Items);
    var cart = await AsyncExecuter.FirstOrDefaultAsync(query.Where(c => c.UserId == userId))
               ?? await _cartRepository.InsertAsync(new Cart(GuidGenerator.Create(), userId), autoSave: true);

    var cartItem = new CartItem(GuidGenerator.Create(), cart.Id, input.ReservationType,
        input.TargetId, input.TargetTitle, input.UnitPrice, input.Quantity,
        input.StartDateTime, input.EndDateTime, input.AdultsCount, input.ChildrenCount,
        input.InfantsCount, input.ImageUrl);

    var calculatedPrice = AgeGroupPricingCalculator.CalculateItemTotal(
        input.UnitPrice, input.AdultsCount, input.ChildrenCount, input.InfantsCount);
    cartItem.TotalPrice = calculatedPrice > 0 ? calculatedPrice : input.UnitPrice * Math.Max(1, input.Quantity);

    await _cartItemRepository.InsertAsync(cartItem, autoSave: true);
    return await GetCartAsync();
}

src/GashtAfarin.Application.Contracts/Travel/AirTrip/AirTripDtos.cs — اعتبارسنجی اظهاری با پیام‌های چندزبانه، محدوده‌های مجاز چمدان و جداسازی کامل مدل ورودی از مدل پایگاه داده.

public class CreateUpdateAirTripDto
{
    [Required(ErrorMessage = "Validation:FlightTitleRequired")]
    [StringLength(128)]
    [Display(Name = "عنوان پرواز")]
    public string Title { get; set; } = string.Empty;

    [Display(Name = "توضیحات")]
    [StringLength(4000)]
    public string? Description { get; set; }

    [Required]
    public DateTime StartDateTime { get; set; }

    [Range(0, long.MaxValue)]
    public long BasePrice { get; set; }

    [Range(0, 50)]
    public int MaxBaggageCount { get; set; }

    [Range(0.0, 1000.0)]
    public decimal MaxBaggageWeightKg { get; set; }

    [Range(0, 100)]
    public int ChildDiscountPercent { get; set; } = 25;

    [Range(0, 100)]
    public int StopsCount { get; set; }

    public int AirLineId { get; set; }
    public int TripClassId { get; set; }
    public FlightTypeEnum FlightTypeEnum { get; set; }
}

src/GashtAfarin.EntityFrameworkCore/EntityFrameworkCore/GashtAfarinDbContext.cs — نگاشت Table-per-Type (TPT) با جدول مجزا برای AirTrip از طریق HasBaseType<Trip>()، به‌همراه Value Object مختصات جغرافیایی.

// پیکربندی موجودیت ریشه Trip در جدول پایه
builder.Entity<Trip>(b =>
{
    b.ToTable(GashtAfarinConsts.DbTablePrefix + "Trips", GashtAfarinConsts.DbSchema);
    b.ConfigureByConvention();
    b.Property(x => x.Title).IsRequired().HasMaxLength(128);
    b.Property(x => x.MaxBaggageWeightKg).HasPrecision(18, 2);
    b.OwnsOne(x => x.OriginCoordinates, l => {
        l.Property(p => p.Latitude).HasPrecision(18, 6);
        l.Property(p => p.Longitude).HasPrecision(18, 6);
    });
    b.HasOne(x => x.TripSeatMap).WithOne(x => x.Trip)
     .HasForeignKey<TripSeatMap>(x => x.TripId).OnDelete(DeleteBehavior.Cascade);
});

// مدل‌سازی وراثت Table-per-Type (TPT) برای AirTrip با جدول تفکیک‌شده
builder.Entity<AirTrip>(b =>
{
    b.ToTable(GashtAfarinConsts.DbTablePrefix + "AirTrips", GashtAfarinConsts.DbSchema);
    b.HasBaseType<Trip>(); // تعیین صریح والد در نگاشت وراثت EF Core
    b.HasOne(x => x.AirPlane).WithMany().HasForeignKey(x => x.AirPlaneId).OnDelete(DeleteBehavior.NoAction);
    b.HasMany(x => x.FareRules).WithMany();
});

src/GashtAfarin.Web/Pages/Cart/Index.cshtml.cs — هندلر AJAX برای حذف آیتم از سبد، محاسبه مالیات و جمع کل در بک‌اند و پاسخ JSON ساخت‌یافته برای به‌روزرسانی زنده صفحه.

public async Task<IActionResult> OnPostRemoveItemAsync(Guid itemId)
{
    if (!CurrentUser.IsAuthenticated)
        return new JsonResult(new { success = false, message = "لطفاً ابتدا وارد حساب کاربری خود شوید." });

    try
    {
        var updatedCart = await _cartAppService.RemoveCartItemAsync(itemId);
        var subtotal = updatedCart.TotalAmount;
        var tax = (long)(subtotal * GashtAfarinConsts.TaxRate);
        var grandTotal = subtotal + tax;

        return new JsonResult(new
        {
            success = true,
            message = "خدمت مورد نظر با موفقیت از سبد خرید حذف شد.",
            subtotalFormatted = subtotal.ToString("N0") + " تومان",
            taxFormatted = tax.ToString("N0") + " تومان",
            grandTotalFormatted = grandTotal.ToString("N0") + " تومان",
            itemsCount = updatedCart.TotalItemsCount,
            isEmpty = updatedCart.Items.Count == 0
        });
    }
    catch (Exception ex)
    {
        return new JsonResult(new { success = false, message = ex.Message });
    }
}