littleshop/LittleShop/DTOs/ProductDto.cs
sysadmin eb87148c63 Add variant collections system and enhance ProductVariant with weight/stock tracking
This commit introduces a comprehensive variant management system and enhances
the existing ProductVariant model with per-variant weight overrides and stock
tracking, integrated across Admin Panel and TeleBot.

Features Added:
- Variant Collections: Reusable variant templates (e.g., "Standard Sizes")
- Admin UI for managing variant collections (CRUD operations)
- Dynamic variant editor with JavaScript-based UI
- Per-variant weight and weight unit overrides
- Per-variant stock level tracking
- SalesLedger model for financial tracking

ProductVariant Enhancements:
- Added Weight (decimal, nullable) field for variant-specific weights
- Added WeightUnit (enum, nullable) field for variant-specific units
- Maintains backward compatibility with product-level weights

TeleBot Integration:
- Enhanced variant selection UI to display stock levels
- Shows weight information with proper unit conversion (µg, g, oz, lb, ml, L)
- Compact button format: "Medium (15 in stock, 350g)"
- Real-time stock availability display

Database Migrations:
- 20250928014850_AddVariantCollectionsAndSalesLedger
- 20250928155814_AddWeightToProductVariants

Technical Changes:
- Updated Product model to support VariantCollectionId and VariantsJson
- Extended ProductService with variant collection operations
- Enhanced OrderService to handle variant-specific pricing and weights
- Updated LittleShop.Client DTOs to match server models
- Added JavaScript dynamic variant form builder

Files Modified: 15
Files Added: 17
Lines Changed: ~2000

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-28 17:03:09 +01:00

209 lines
5.5 KiB
C#

using System.ComponentModel.DataAnnotations;
using LittleShop.Enums;
namespace LittleShop.DTOs;
public class ProductDto
{
public Guid Id { get; set; }
public string Name { get; set; } = string.Empty;
public string Description { get; set; } = string.Empty;
public decimal Price { get; set; }
public decimal Weight { get; set; }
public ProductWeightUnit WeightUnit { get; set; }
public int StockQuantity { get; set; }
public Guid CategoryId { get; set; }
public string CategoryName { get; set; } = string.Empty;
public Guid? VariantCollectionId { get; set; }
public string? VariantsJson { get; set; }
public DateTime CreatedAt { get; set; }
public DateTime UpdatedAt { get; set; }
public bool IsActive { get; set; }
public List<ProductPhotoDto> Photos { get; set; } = new();
public List<ProductMultiBuyDto> MultiBuys { get; set; } = new();
public List<ProductVariantDto> Variants { get; set; } = new();
}
public class ProductPhotoDto
{
public Guid Id { get; set; }
public string FileName { get; set; } = string.Empty;
public string FilePath { get; set; } = string.Empty;
public string? AltText { get; set; }
public int SortOrder { get; set; }
}
public class CreateProductDto
{
[Required]
[StringLength(200)]
public string Name { get; set; } = string.Empty;
[Required(AllowEmptyStrings = true)]
public string Description { get; set; } = string.Empty;
[Required]
[Range(0.01, double.MaxValue, ErrorMessage = "Price must be greater than 0")]
public decimal Price { get; set; }
[Required]
[Range(0.01, double.MaxValue, ErrorMessage = "Weight must be greater than 0")]
public decimal Weight { get; set; }
public ProductWeightUnit WeightUnit { get; set; } = ProductWeightUnit.Grams;
[Range(0, int.MaxValue)]
public int StockQuantity { get; set; } = 0;
[Required(ErrorMessage = "Please select a category")]
public Guid CategoryId { get; set; }
public Guid? VariantCollectionId { get; set; }
public string? VariantsJson { get; set; }
}
public class UpdateProductDto
{
[StringLength(200)]
public string? Name { get; set; }
public string? Description { get; set; }
[Range(0.01, double.MaxValue)]
public decimal? Price { get; set; }
public decimal? Weight { get; set; }
public ProductWeightUnit? WeightUnit { get; set; }
[Range(0, int.MaxValue)]
public int? StockQuantity { get; set; }
public Guid? CategoryId { get; set; }
public Guid? VariantCollectionId { get; set; }
public string? VariantsJson { get; set; }
public bool? IsActive { get; set; }
}
public class CreateProductPhotoDto
{
[Required]
public Guid ProductId { get; set; }
[Required]
public string PhotoUrl { get; set; } = string.Empty;
public string? AltText { get; set; }
public int DisplayOrder { get; set; }
}
public class ProductMultiBuyDto
{
public Guid Id { get; set; }
public Guid ProductId { get; set; }
public string Name { get; set; } = string.Empty;
public string Description { get; set; } = string.Empty;
public int Quantity { get; set; }
public decimal Price { get; set; }
public decimal PricePerUnit { get; set; }
public int SortOrder { get; set; }
public bool IsActive { get; set; }
public DateTime CreatedAt { get; set; }
public DateTime UpdatedAt { get; set; }
}
public class ProductVariantDto
{
public Guid Id { get; set; }
public Guid ProductId { get; set; }
public string Name { get; set; } = string.Empty;
public string VariantType { get; set; } = "Standard";
public int SortOrder { get; set; }
public int StockLevel { get; set; }
public bool IsActive { get; set; }
public DateTime CreatedAt { get; set; }
public DateTime UpdatedAt { get; set; }
}
public class CreateProductMultiBuyDto
{
[Required]
public Guid ProductId { get; set; }
[Required]
[StringLength(100)]
public string Name { get; set; } = string.Empty;
public string Description { get; set; } = string.Empty;
[Required]
[Range(1, int.MaxValue, ErrorMessage = "Quantity must be at least 1")]
public int Quantity { get; set; }
[Required]
[Range(0.01, double.MaxValue, ErrorMessage = "Price must be greater than 0")]
public decimal Price { get; set; }
[Range(0, int.MaxValue)]
public int SortOrder { get; set; }
}
public class CreateProductVariantDto
{
[Required]
public Guid ProductId { get; set; }
[Required]
[StringLength(100)]
public string Name { get; set; } = string.Empty;
[StringLength(50)]
public string VariantType { get; set; } = "Standard";
[Range(0, int.MaxValue)]
public int SortOrder { get; set; }
[Range(0, int.MaxValue)]
public int StockLevel { get; set; } = 0;
}
public class UpdateProductMultiBuyDto
{
[StringLength(100)]
public string? Name { get; set; }
public string? Description { get; set; }
[Range(1, int.MaxValue)]
public int? Quantity { get; set; }
[Range(0.01, double.MaxValue)]
public decimal? Price { get; set; }
[Range(0, int.MaxValue)]
public int? SortOrder { get; set; }
public bool? IsActive { get; set; }
}
public class UpdateProductVariantDto
{
[StringLength(100)]
public string? Name { get; set; }
[StringLength(50)]
public string? VariantType { get; set; }
[Range(0, int.MaxValue)]
public int? SortOrder { get; set; }
[Range(0, int.MaxValue)]
public int? StockLevel { get; set; }
public bool? IsActive { get; set; }
}