Struct InventoryReadService 

pub struct InventoryReadService { /* private fields */ }

Read-only queries over inventory balances (the consumer-facing read port).

This service only projects — the SQL lives in BinRepository, per the module’s 4-layer rule.

Implementations

impl InventoryReadService

pub fn new(db_pool: PgPool) -> Self

pub async fn availability( &self, item_id: Uuid, warehouse_id: Uuid, ) -> Result<AvailabilityView, Error>

Availability for one item in one warehouse. Returns a zeroed view (available 0) when no bin exists yet — an un-received item is simply unavailable, not an error.

pub async fn availability_across_warehouses( &self, item_id: Uuid, ) -> Result<Vec<AvailabilityView>, Error>

Availability for one item across every warehouse that holds a bin for it.

pub async fn stock_balance( &self, item_id: Uuid, warehouse_id: Uuid, ) -> Result<Option<StockBalance>, Error>

Valuation balance for one item in one warehouse (None if no bin exists).

pub async fn quant_availability( &self, item_id: Uuid, location_id: Uuid, ) -> Result<QuantAvailability, Error>

Quant-grain availability at one location: available = quantity − reserved over the location’s quant rows (T2 — the READ arm of the reservation triangle; the warehouse-grain Self::availability above projects the same invariant off the Bin balance). Zeroed view when no quant exists — an unreceived item is unavailable, not an error.

Trait Implementations

impl Clone for InventoryReadService

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.