Module retail 

Retail contracts for POS, inventory, recommendations, vendors, and reorder signals. Retail service-line models for POS sale eligibility, inventory position, reorder workflows, vendor partnerships, and care-safe product recommendations.

Operator summary: this module supports staff queues for retail sale drafts, checkout attachments, customer-safe recommendation drafts, low-stock reorder work, and vendor-managed notices. It reduces front-desk and manager labor by turning SKU/catalog facts, stock counts, customer preference, care sensitivity, checkout source, price exceptions, and reorder thresholds into typed decisions instead of ad hoc manual review.

It is not a live automation layer. domain::retail does not send customer messages, promise medical outcomes, place vendor orders, mutate POS/Gingr transactions, reconcile payments, approve comps/refunds, or attach products to reservations. Provider DTOs/endpoints, storage records/codes, and source/provenance facts remain authoritative in their own layers; this module only evaluates promoted domain facts.

Review gates protect pets, customers, and staff: unavailable or non-sellable items are denied, opted-out customers and unavailable products suppress recommendations, supplement/diet and care-plan conflicts require staff or manager review, medical-claim customer copy is rejected or approval-gated, reservation-checkout attachments require customer-message approval, price exceptions require manager approval, impossible stock math is rejected, and reorder actions become threshold-backed manager tasks or vendor notices rather than automatic purchases.

Re-exports

pub use product::LocationOffering;

pub use product::OfferingStatus;

pub use product::Product;

pub use product::Sku;

pub use product::SkuError;

pub use vendor::Partner;

Modules

inventory

Inventory models stock position, available units, reorder thresholds, and oversell checks for retail staff workflows. Inventory models for retail stock counts, available units, and reorder threshold decisions.

pos

POS models standalone sales, reservation-checkout attachments, price exceptions, and comps so checkout writes stay approval-gated. POS models for attaching retail sales to staff transactions or reservation checkout while preserving approval gates.

product

Product catalog models SKUs, location offerings, sellability, and in-house consumable use for staff-facing retail decisions. Product catalog models for SKUs, categories, location offerings, and sellability rules.

recommendation

Recommendation models personalized upsells with inventory, preference, and care-safety gates before any customer copy is approved. Retail recommendation models for personalized upsell candidates, review gates, and safe customer copy.

reorder

Reorder models manager tasks, vendor-managed notices, and no-action outcomes from location stock thresholds. Reorder models for stock-threshold decisions and manager/vendor workflow creation.

vendor

Vendor models partner-product catalog relationships and externally managed assortments without placing orders. Vendor models for partner products and external catalog-management flags.

Structs

Contract

Location retail policy bundle tying catalog product, POS policy, inventory policy, recommendation rule, and reorder policy together.

ContractBuilder

Use builder syntax to set the inputs and finish with build().

Enums

Error

Retail validation failures that prevent impossible stock math or unsupported recommendations from becoming workflow facts.

Type Aliases

Result

Result type returned by fallible retail operations.