Provision

In plain words: Homestead: shopping and orders

Designed 2 min read 1 glossary terms 6 connected pages
The short version written for the Snayu team

How Homestead turns approved needs into shop offers, carts and a single checkout, reporting what became available, substituted or uncertain.

Why read it: Read when building shopping, merchant integrations or checkout.
  1. 1Fetching, login, cart edits, address disclosure, ordering and payment are separate powers.
  2. 2Checkout rechecks price, stock and terms; material changes return to you.
  3. 3A missing merchant acknowledgement stays unknown until reconciled.

Words on this page, decoded click one for its card

The original text Underlined words open their plain-English card.

An approved need is still several steps away from an order. Provision brings ordinary food, cleaning goods, toiletries, feed, substrate, and other consumables into shared household custody, keeping each step separately reviewable.

From need to result

homestead.observe_shops@1 admits dated, attributed offers from Kaufland, Lidl, another merchant, a local market, or another eligible source. A shop profile is independently revocable. Public fetch, rendered observation, authentication, cart mutation, address disclosure, order submission, and payment remain separate powers.

homestead.plan_provision@2 brings policy, stores, budget, and offers together with the needs being supplied: FoodNeed@1 from Eating, KeeperSupplyNeed@1 from Feeding, or CultivatorSupplyNeed@1 from Tending.

Each need gives Provision enough information to find the supply: its originating owner and revision, required quantities and units, exclusions, useful product traits, validity/expiry, privacy class, and unresolved flags. The care owner retains the subject and profile behind that requirement. No diagnosis, care journal, measurement history, medication record, genetics, movement history, or merchant instruction accompanies it.

A supply's availability cannot establish biological suitability. A material substitution outside the reviewed need returns to its owner before approval and checkout; Homestead cannot weaken species, culture, or human-food constraints to finish a cart. Live-animal acquisition, breeding commitments, clinical treatments, and hazardous or regulated agricultural interventions are not ordinary-consumable checkout paths.

homestead.build_cart@1 prepares the cart. Before homestead.checkout@1 submits it once, it rechecks merchant, product, package, price, stock, fees, delivery, substitutions, recurring terms, disclosure, and worst-case budget. A material change returns to the MagusYou, the Operator. Raw addresses, payment data, credentials, and one-time codes never enter prompts.

ProvisionResult@1 closes this work by reporting what became available, unavailable, substituted, refused, or uncertain. Eating, health, and adherence require their own evidence. Keep offers, plans, carts, orders, deliveries, and reconciliation independently revisioned so a later correction can identify the affected step.

If the merchant acknowledgement is missing, checkout or payment remains unknown. Reconcile that effect before retrying. Restart cannot duplicate cart changes, orders, notifications, or delivery reconciliation.

Personal meal choice, preparation guidance, and eating out remain with Wellbeing; confirmed cooking becomes a stock transformation in Stores. Scavenger owns irregular, high-value, compatibility-heavy, property, and seller-negotiated acquisitions.

Return to Homestead.