| | | 1 | | using MechanicsSoftware.Domain.Enums; |
| | | 2 | | using MechanicsSoftware.Domain.Exceptions; |
| | | 3 | | using MechanicsSoftware.Domain.ValueObjects; |
| | | 4 | | |
| | | 5 | | namespace MechanicsSoftware.Domain.Entities; |
| | | 6 | | |
| | | 7 | | public sealed class Part : Entity<Guid> |
| | | 8 | | { |
| | 96 | 9 | | private readonly List<StockMovement> _movements = []; |
| | | 10 | | |
| | | 11 | | public string Code { get; private set; } = null!; |
| | | 12 | | public string Name { get; private set; } = null!; |
| | | 13 | | public string? Description { get; private set; } |
| | | 14 | | public Money UnitPrice { get; private set; } = null!; |
| | | 15 | | public int StockQuantity { get; private set; } |
| | | 16 | | public int ReservedQuantity { get; private set; } |
| | | 17 | | |
| | 16 | 18 | | public IReadOnlyCollection<StockMovement> Movements => _movements.AsReadOnly(); |
| | | 19 | | |
| | 76 | 20 | | public int AvailableQuantity => StockQuantity - ReservedQuantity; |
| | | 21 | | |
| | 288 | 22 | | private Part() { } |
| | | 23 | | |
| | | 24 | | public static Part Create( |
| | | 25 | | Guid id, |
| | | 26 | | string code, |
| | | 27 | | string name, |
| | | 28 | | string? description, |
| | | 29 | | Money unitPrice, |
| | | 30 | | int initialStock = 0) |
| | 108 | 31 | | { |
| | 108 | 32 | | if (string.IsNullOrWhiteSpace(code)) |
| | 4 | 33 | | throw new DomainException("Part code is required."); |
| | | 34 | | |
| | 104 | 35 | | ValidateNameAndPrice(name, unitPrice); |
| | | 36 | | |
| | 98 | 37 | | if (initialStock < 0) |
| | 2 | 38 | | throw new DomainException("Initial stock cannot be negative."); |
| | | 39 | | |
| | 96 | 40 | | var part = new Part |
| | 96 | 41 | | { |
| | 96 | 42 | | Id = id, |
| | 96 | 43 | | Code = code.Trim().ToUpperInvariant(), |
| | 96 | 44 | | Name = name.Trim(), |
| | 96 | 45 | | Description = description?.Trim(), |
| | 96 | 46 | | UnitPrice = unitPrice, |
| | 96 | 47 | | StockQuantity = initialStock |
| | 96 | 48 | | }; |
| | | 49 | | |
| | 96 | 50 | | if (initialStock > 0) |
| | 84 | 51 | | part._movements.Add(StockMovement.Create(id, StockMovementType.Inbound, initialStock)); |
| | | 52 | | |
| | 96 | 53 | | return part; |
| | 96 | 54 | | } |
| | | 55 | | |
| | | 56 | | public void Reserve(int quantity, Guid reference) |
| | 40 | 57 | | { |
| | 40 | 58 | | if (quantity <= 0) |
| | 2 | 59 | | throw new DomainException("Reserve quantity must be greater than zero."); |
| | | 60 | | |
| | 38 | 61 | | if (reference == Guid.Empty) |
| | 2 | 62 | | throw new DomainException("Reference is required for reservation."); |
| | | 63 | | |
| | 36 | 64 | | if (AvailableQuantity < quantity) |
| | 2 | 65 | | throw new DomainException( |
| | 2 | 66 | | $"Insufficient available stock. Available: {AvailableQuantity}, requested: {quantity}."); |
| | | 67 | | |
| | 34 | 68 | | ReservedQuantity += quantity; |
| | 34 | 69 | | _movements.Add(StockMovement.Create(Id, StockMovementType.Reservation, quantity, reference)); |
| | 34 | 70 | | } |
| | | 71 | | |
| | | 72 | | public void ConfirmUsage(int quantity, Guid reference) |
| | 14 | 73 | | { |
| | 14 | 74 | | if (quantity <= 0) |
| | 2 | 75 | | throw new DomainException("Confirm usage quantity must be greater than zero."); |
| | | 76 | | |
| | 12 | 77 | | if (reference == Guid.Empty) |
| | 2 | 78 | | throw new DomainException("Reference is required for usage confirmation."); |
| | | 79 | | |
| | 10 | 80 | | if (ReservedQuantity - quantity < 0) |
| | 4 | 81 | | throw new DomainException( |
| | 4 | 82 | | $"Cannot confirm usage: not enough reserved quantity. Reserved: {ReservedQuantity}, requested: {quantity |
| | | 83 | | |
| | 6 | 84 | | StockQuantity -= quantity; |
| | 6 | 85 | | ReservedQuantity -= quantity; |
| | 6 | 86 | | _movements.Add(StockMovement.Create(Id, StockMovementType.Outbound, quantity, reference)); |
| | 6 | 87 | | } |
| | | 88 | | |
| | | 89 | | public void Release(int quantity, Guid reference) |
| | 12 | 90 | | { |
| | 12 | 91 | | if (quantity <= 0) |
| | 2 | 92 | | throw new DomainException("Release quantity must be greater than zero."); |
| | | 93 | | |
| | 10 | 94 | | if (reference == Guid.Empty) |
| | 2 | 95 | | throw new DomainException("Reference is required for release."); |
| | | 96 | | |
| | 8 | 97 | | if (ReservedQuantity - quantity < 0) |
| | 2 | 98 | | throw new DomainException( |
| | 2 | 99 | | $"Cannot release more than reserved. Reserved: {ReservedQuantity}, requested: {quantity}."); |
| | | 100 | | |
| | 6 | 101 | | ReservedQuantity -= quantity; |
| | 6 | 102 | | _movements.Add(StockMovement.Create(Id, StockMovementType.Release, quantity, reference)); |
| | 6 | 103 | | } |
| | | 104 | | |
| | | 105 | | public void Update(string name, string? description, Money unitPrice) |
| | 10 | 106 | | { |
| | 10 | 107 | | ValidateNameAndPrice(name, unitPrice); |
| | | 108 | | |
| | 4 | 109 | | Name = name.Trim(); |
| | 4 | 110 | | Description = description?.Trim(); |
| | 4 | 111 | | UnitPrice = unitPrice; |
| | 4 | 112 | | } |
| | | 113 | | |
| | | 114 | | public void Replenish(int quantity) |
| | 10 | 115 | | { |
| | 10 | 116 | | if (quantity <= 0) |
| | 4 | 117 | | throw new DomainException("Replenish quantity must be greater than zero."); |
| | | 118 | | |
| | 6 | 119 | | StockQuantity += quantity; |
| | 6 | 120 | | _movements.Add(StockMovement.Create(Id, StockMovementType.Inbound, quantity)); |
| | 6 | 121 | | } |
| | | 122 | | |
| | 8 | 123 | | public bool HasPendingReservations() => ReservedQuantity > 0; |
| | | 124 | | |
| | | 125 | | private static void ValidateNameAndPrice(string name, Money unitPrice) |
| | 114 | 126 | | { |
| | 114 | 127 | | if (string.IsNullOrWhiteSpace(name)) |
| | 8 | 128 | | throw new DomainException("Part name is required."); |
| | | 129 | | |
| | 106 | 130 | | if (unitPrice is null) |
| | 4 | 131 | | throw new DomainException("Unit price is required."); |
| | 102 | 132 | | } |
| | | 133 | | } |