44 lines
2.6 KiB
C#
44 lines
2.6 KiB
C#
using Distribution.Models;
|
|
|
|
namespace Distribution.Features.Stock;
|
|
|
|
public interface IStockRepository
|
|
{
|
|
// Balance
|
|
Task<StockBalance?> GetBalanceAsync(Guid itemId, Guid locationId);
|
|
Task<StockBalance?> GetBalanceAsync(Guid itemId, Guid locationId, Guid? itemBatchId, Guid? itemSerialNumberId);
|
|
/// <summary>Positive balances for the item at the location in pick order: batches by earliest expiry, serials oldest first, untracked last.</summary>
|
|
Task<List<StockBalance>> GetAllocatableBalancesAsync(Guid itemId, Guid locationId);
|
|
Task<List<StockBalance>> GetBalancesByLocationAsync(Guid locationId, LocationType locationType);
|
|
Task<List<StockBalance>> GetBalancesAsync(Guid? locationId, LocationType? locationType, Guid? itemId, int page, int pageSize);
|
|
Task<int> GetBalancesCountAsync(Guid? locationId, LocationType? locationType, Guid? itemId);
|
|
Task<List<StockBalance>> GetBalancesByItemAsync(Guid itemId);
|
|
Task<List<StockBalance>> GetLowStockAsync(Guid? locationId);
|
|
Task AddBalanceAsync(StockBalance balance);
|
|
void UpdateBalance(StockBalance balance);
|
|
|
|
// Movements
|
|
Task AddMovementAsync(StockMovement movement);
|
|
Task<StockMovement?> GetMovementByIdAsync(Guid id);
|
|
void UpdateMovement(StockMovement movement);
|
|
Task<List<StockMovement>> GetMovementsAsync(MovementFilter filter, int page, int pageSize);
|
|
Task<int> GetMovementsCountAsync(MovementFilter filter);
|
|
/// <summary>Opening balance, quantity in/out within [from, toExclusive), closing balance, and the live balance to reconcile against.</summary>
|
|
Task<MovementSummary> GetMovementSummaryAsync(Guid itemId, Guid locationId, DateTime from, DateTime toExclusive);
|
|
|
|
Task<List<StockMovement>> GetMovementsByReferenceAsync(Guid referenceId, Guid itemId, MovementType type);
|
|
/// <summary>The warehouse the item most recently arrived at <paramref name="vehicleId"/> from, or null if it never did.</summary>
|
|
Task<Guid?> GetLastWarehouseSourceAsync(Guid vehicleId, Guid itemId);
|
|
|
|
// Batches — a null batchNumber always creates a fresh expiry-only lot (no dedup possible on null).
|
|
Task<ItemBatch?> FindBatchAsync(Guid itemId, string batchNumber);
|
|
Task AddItemBatchAsync(ItemBatch batch);
|
|
|
|
// Serial numbers
|
|
Task<ItemSerialNumber?> GetSerialAsync(Guid serialId);
|
|
Task<bool> SerialNumberExistsAsync(Guid itemId, string serialNumber);
|
|
/// <summary>One past the highest numeric suffix among the item's existing serials that start with <paramref name="prefix"/> (1 if none).</summary>
|
|
Task<int> GetNextSerialSequenceAsync(Guid itemId, string prefix);
|
|
Task AddItemSerialNumberAsync(ItemSerialNumber serial);
|
|
}
|