Feature/voucher

Backend/src/ShoeStore.Api/Controllers/VoucherController.cs

@@ -0,0 +1,71 @@
+using ErrorOr;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using ShoeStore.Application.DTOs.VoucherDtos;
+using ShoeStore.Application.Interface.VoucherInterface;
+
+namespace ShoeStore.Api.Controllers;
+
+/// <summary>
+///     Controller for managing vouchers in the system.
+///     Provides endpoints for voucher creation and management (Admin only).
+/// </summary>
+/// <param name="voucherService">Service for handling voucher logic operations.</param>
+[ApiController]
+[Route("api/admin/vouchers")]
+// [Authorize(Roles = "Admin")]
+public class VoucherController(IVoucherService voucherService) : ControllerBase
+{
+    /// <summary>
+    ///     Creates a new voucher for the store.
+    /// </summary>
+    /// <remarks>
+    ///     Requires Admin role authorization.
+    ///     The request body should include:
+    ///     - VoucherName: Name of the voucher
+    ///     - Discount: Value of the discount
+    ///     - DiscountType: Type of discount (Percentage/FixedAmount)
+    ///     - TotalQuantity: Number of vouchers available
+    ///     - ValidFrom/ValidTo: Expiration dates
+    /// </remarks>
+    /// <param name="createVoucherDto">Data transfer object containing voucher creation details.</param>
+    /// <param name="token">Cancellation token for the request.</param>
+    /// <response code="201">Voucher created successfully.</response>
+    /// <response code="400">Bad request; invalid voucher data provided.</response>
+    /// <response code="401">Unauthorized; user must be authenticated with Admin role.</response>
+    /// <response code="500">Internal server error; an unexpected error occurred.</response>
+    /// <returns>An action result with status 201 (Created) on success, or an error response.</returns>
+    [ProducesResponseType(StatusCodes.Status201Created)]
+    [ProducesResponseType(typeof(object), StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(typeof(object), StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(typeof(object), StatusCodes.Status500InternalServerError)]
+
+    [HttpPost]
+    public async Task<IActionResult> CreateVoucher([FromBody] CreateVoucherDto createVoucherDto, CancellationToken token)
+    {
+        var result = await voucherService.CreateVoucherAsync(createVoucherDto, token);
+
+        return result.Match<IActionResult>(
+            _ => Created("", new { message = "Voucher created successfully" }),
+            errors => BadRequest(new
+            {
+                message = "Failed to create voucher",
+                details = errors
+            }));
+    }
+
+    [HttpPut("{voucherGuid}")]
+    public async Task<IActionResult> UpdateVoucher(Guid voucherGuid, [FromBody] UpdateVoucherDto updateVoucherDto, CancellationToken token)
+    {
+        var result = await voucherService.UpdateVoucherAsync(voucherGuid, updateVoucherDto, token);
+        return result.Match<IActionResult>(
+            _ => Ok(new { message = "Voucher updated successfully" }),
+            errors => errors.Any(e => e.Type == ErrorType.NotFound)
+                ? NotFound(new { message = "Voucher not found" })
+                : BadRequest(new
+                {
+                    message = "Failed to update voucher",
+                    details = errors
+                }));
+    }
+}

Backend/src/ShoeStore.Application/DTOs/VoucherDtos/CreateVoucherDto.cs

@@ -0,0 +1,29 @@
+
+namespace ShoeStore.Application.DTOs.VoucherDtos
+{
+    public class CreateVoucherDto
+    {
+        public string? VoucherName { get; set; }
+        public string? VoucherDescription { get; set; }
+        public decimal? Discount { get; set; }
+        public int VoucherScope { get; set; } = 1; // Default to AllProducts
+        public int DiscountType { get; set; } = 1; // Default to Percentage 
+        public decimal MaxPriceDiscount { get; set; }
+        private DateTime? _validFrom;
+        public DateTime? ValidFrom
+        {
+            get => _validFrom;
+            set => _validFrom = value.HasValue ? DateTime.SpecifyKind(value.Value, DateTimeKind.Utc) : null;
+        }
+
+        private DateTime? _validTo;
+        public DateTime? ValidTo
+        {
+            get => _validTo;
+            set => _validTo = value.HasValue ? DateTime.SpecifyKind(value.Value, DateTimeKind.Utc) : null;
+        }
+        public int? MaxUsagePerUser { get; set; }
+        public int? TotalQuantity { get; set; }
+        public decimal? MinOrderPrice { get; set; }
+    }
+}

Backend/src/ShoeStore.Application/DTOs/VoucherDtos/ResponseVoucherDto.cs

@@ -0,0 +1,11 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace ShoeStore.Application.DTOs.VoucherDtos
+{
+    public class ResponseVoucherDto
+    {
+
+    }
+}

Backend/src/ShoeStore.Application/DTOs/VoucherDtos/UpdateVoucherDto.cs

@@ -0,0 +1,27 @@
+namespace ShoeStore.Application.DTOs.VoucherDtos
+{
+    public class UpdateVoucherDto
+    {
+        public string? VoucherDescription { get; set; }
+        public decimal? Discount { get; set; }
+        public int VoucherScope { get; set; } = 1; // Default to AllProducts
+        public int DiscountType { get; set; } = 1; // Default to Percentage 
+        public decimal MaxPriceDiscount { get; set; }
+        private DateTime? _validFrom;
+        public DateTime? ValidFrom
+        {
+            get => _validFrom;
+            set => _validFrom = value.HasValue ? DateTime.SpecifyKind(value.Value, DateTimeKind.Utc) : null;
+        }
+
+        private DateTime? _validTo;
+        public DateTime? ValidTo
+        {
+            get => _validTo;
+            set => _validTo = value.HasValue ? DateTime.SpecifyKind(value.Value, DateTimeKind.Utc) : null;
+        }
+        public int? MaxUsagePerUser { get; set; }
+        public int? TotalQuantity { get; set; }
+        public decimal? MinOrderPrice { get; set; }
+    }
+}

Backend/src/ShoeStore.Application/Interface/VoucherInterface/IVoucherRepository.cs

@@ -0,0 +1,11 @@
+using ShoeStore.Application.Interface.Common;
+using ShoeStore.Domain.Entities;
+
+namespace ShoeStore.Application.Interface.VoucherInterface
+{
+    public interface IVoucherRepository : IGenericRepository<Voucher, int>
+    {
+        IQueryable<Voucher> GetAllVouchers();
+        IQueryable<Voucher> GetVoucherByGuid(Guid voucherGuid);
+    }
+}

Backend/src/ShoeStore.Application/Interface/VoucherInterface/IVoucherService.cs

@@ -0,0 +1,13 @@
+using ShoeStore.Application.DTOs.VoucherDtos;
+using ErrorOr;
+namespace ShoeStore.Application.Interface.VoucherInterface
+{
+    public interface IVoucherService
+    {
+            Task<ErrorOr<Created>> CreateVoucherAsync(CreateVoucherDto voucherCreateDto, CancellationToken token);
+            //Task<ErrorOr<VoucherDto>> GetVoucherByGuidAsync(Guid voucherGuid, CancellationToken token);
+            //Task<ErrorOr<IEnumerable<VoucherDto>>> GetAllVouchersAsync(CancellationToken token);
+            Task<ErrorOr<Updated>> UpdateVoucherAsync(Guid voucherGuid, UpdateVoucherDto voucherUpdateDto, CancellationToken token);
+            //Task<ErrorOr<Deleted>> DeleteVoucherAsync(Guid voucherGuid, CancellationToken token );
+    }
+}

Backend/src/ShoeStore.Application/Services/VoucherService.cs

@@ -0,0 +1,89 @@
+using ShoeStore.Application.Interface.VoucherInterface;
+using ShoeStore.Application.DTOs.VoucherDtos;
+using ErrorOr;
+using ShoeStore.Application.Interface.Common;
+using ShoeStore.Domain.Entities;
+using ShoeStore.Domain.Enum;
+using Microsoft.EntityFrameworkCore;
+
+namespace ShoeStore.Application.Services
+{
+    public class VoucherService : IVoucherService
+    {
+        private readonly IVoucherRepository repository;
+        private readonly IUnitOfWork uow;
+
+        public VoucherService(IVoucherRepository repository, IUnitOfWork uow)
+        {
+            this.repository = repository;
+            this.uow = uow;
+        }
+        public async Task<ErrorOr<Created>> CreateVoucherAsync(CreateVoucherDto voucherCreateDto, CancellationToken token)
+        {
+
+            var voucher = new Voucher
+            {
+                VoucherName = voucherCreateDto.VoucherName ?? string.Empty,
+                VoucherDescription = voucherCreateDto.VoucherDescription,
+                Discount = voucherCreateDto.Discount ?? 0,
+                VoucherScope = (VoucherScope)voucherCreateDto.VoucherScope,
+                DiscountType = (DiscountType)voucherCreateDto.DiscountType,
+                MaxPriceDiscount = voucherCreateDto.MaxPriceDiscount,
+                ValidFrom = voucherCreateDto.ValidFrom,
+                ValidTo = voucherCreateDto.ValidTo,
+                MaxUsagePerUser = voucherCreateDto.MaxUsagePerUser,
+                TotalQuantity = voucherCreateDto.TotalQuantity ?? 0,
+                MinOrderPrice = voucherCreateDto.MinOrderPrice ?? 0,
+                IsDeleted = false
+            };
+
+            repository.Add(voucher);
+            await uow.SaveChangesAsync(token);
+            return Result.Created;
+
+        }
+
+        public async Task<ErrorOr<Updated>> UpdateVoucherAsync(
+    Guid voucherGuid,
+    UpdateVoucherDto voucherUpdateDto,
+    CancellationToken token)
+        {
+
+            var voucher = await repository
+                .GetVoucherByGuid(voucherGuid)
+                .FirstOrDefaultAsync();
+
+            if (voucher == null)
+            {
+                return Error.NotFound(
+                    "VOUCHER_NOT_FOUND",
+                    "The voucher with the specified GUID does not exist."
+                );
+            }
+
+            // Update logic
+            voucher.VoucherDescription = voucherUpdateDto.VoucherDescription ?? voucher.VoucherDescription;
+
+            voucher.VoucherScope = (VoucherScope)voucherUpdateDto.VoucherScope;
+            voucher.DiscountType = (DiscountType)voucherUpdateDto.DiscountType;
+
+            voucher.MaxPriceDiscount = voucherUpdateDto.MaxPriceDiscount;
+
+            voucher.ValidFrom = voucherUpdateDto.ValidFrom ?? voucher.ValidFrom;
+            voucher.ValidTo = voucherUpdateDto.ValidTo ?? voucher.ValidTo;
+
+            voucher.MaxUsagePerUser = voucherUpdateDto.MaxUsagePerUser ?? voucher.MaxUsagePerUser;
+            voucher.TotalQuantity = voucherUpdateDto.TotalQuantity ?? voucher.TotalQuantity;
+            voucher.MinOrderPrice = voucherUpdateDto.MinOrderPrice ?? voucher.MinOrderPrice;
+
+            voucher.UpdatedAt = DateTime.UtcNow;
+
+            repository.Update(voucher);
+            await uow.SaveChangesAsync(token);
+
+            return Result.Updated;
+
+        }
+
+    }
+}

Backend/src/ShoeStore.Application/Validations/VoucherValidation/CreateVoucherDtoValidation.cs

@@ -0,0 +1,26 @@
+using FluentValidation;
+using ShoeStore.Application.DTOs.VoucherDtos;
+
+namespace ShoeStore.Application.Validations.VoucherValidation;
+
+public class CreateVoucherDtoValidation : AbstractValidator<CreateVoucherDto>
+{
+    public CreateVoucherDtoValidation()
+    {
+        RuleFor(x => x.VoucherName)
+            .NotEmpty().WithMessage("Voucher name is required")
+            .MaximumLength(100).WithMessage("Voucher name must not exceed 100 characters");
+
+        RuleFor(x => x.Discount)
+            .NotNull().WithMessage("Discount is required")
+            .GreaterThanOrEqualTo(0).WithMessage("Discount must be greater than or equal to 0");
+
+        RuleFor(x => x.TotalQuantity)
+            .GreaterThan(0).WithMessage("Total quantity must be greater than 0");
+
+        RuleFor(x => x.ValidFrom)
+            .LessThanOrEqualTo(x => x.ValidTo)
+            .When(x => x.ValidFrom.HasValue && x.ValidTo.HasValue)
+            .WithMessage("Valid from date must be less than or equal to valid to date");
+    }
+}

Backend/src/ShoeStore.Infrastructure/DependencyInjection/DependencyInjection.cs

@@ -20,6 +20,7 @@
 using ShoeStore.Infrastructure.Notification;
 using ShoeStore.Infrastructure.Repositories;
 using ShoeStore.Infrastructure.RestorePassService;
+using ShoeStore.Application.Interface.VoucherInterface;
 
 namespace ShoeStore.Infrastructure.DependencyInjection;
 
@@ -62,6 +63,8 @@ public static IServiceCollection AddInfrastructure(this IServiceCollection servi
         services.AddScoped<IColorRepository, ColorRepository>();
         services.AddScoped<ISizeRepository, SizeRepository>();
         services.AddScoped<ICategoryRepository, CategoryRepository>();
+        services.AddScoped<IVoucherRepository, VoucherRepository>();
+        services.AddScoped<IVoucherService, VoucherService>();
         return services;
     }
 }

Backend/src/ShoeStore.Infrastructure/Repositories/VoucherRepository.cs

@@ -0,0 +1,19 @@
+using Microsoft.EntityFrameworkCore;
+using ShoeStore.Application.Interface.VoucherInterface;
+using ShoeStore.Domain.Entities;
+using ShoeStore.Infrastructure.Data;
+namespace ShoeStore.Infrastructure.Repositories
+{
+    public class VoucherRepository(AppDbContext context) : GenericRepository<Voucher, int>(context), IVoucherRepository
+    {
+        public IQueryable<Voucher> GetAllVouchers()
+        {
+            return context.Vouchers.AsNoTracking();
+        }
+
+        public IQueryable<Voucher> GetVoucherByGuid(Guid voucherGuid)
+        {
+            return context.Vouchers.Where(v => v.PublicId == voucherGuid).AsNoTracking();
+        }
+    }
+}