Skip to content

JNY-COM-CAT-001An administrator prepares a store for selling

Markdown

JNY-COM-CAT-001

An administrator prepares a store for selling

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationObserved

KindJourneyProduct areaCommerceModuleCatalog and Selling ConfigurationRevision1End-to-endRequired

Read atservices-commerce c8b66a98react-console baf6dae3

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Goal
Establish the policy, shelves and product presentations needed for a store.
Screens
/console/{tenantId}/configuration/orders/orderingProfiles/console/{tenantId}/configuration/orders/orderingProfiles/defaults/console/{tenantId}/configuration/orders/productCategories/console/{tenantId}/configuration/orders/stores/console/{tenantId}/configuration/orders/merchandise

Steps

#SurfaceActionCapabilityExpectedProvenance
1/console/{tenantId}/configuration/orders/orderingProfiles/newCreate Main with its Accounting context and card acceptance rangeCAP-COM-CAT-001The saved policy view presents its summary and active/default indicatorsdocumented
2/console/{tenantId}/configuration/orders/orderingProfiles/defaultsInspect application and workspace fallback selectionsCAP-COM-CAT-002The defaults view identifies Main as the workspace choice with no application overridestest
services-commerce:modules/configuration/tests/e2e/ordering-profiles.e2e.spec.js#reads the tenant default alone until an application default is set
3/console/{tenantId}/configuration/orders/productCategoriesPrepare Books and Apparel categoriesCAP-COM-CAT-005Both empty shelves are available for assortment selectiondocumented
4/console/{tenantId}/configuration/orders/stores/newSave Bookstore using Main and the two shelves, with Books as homeCAP-COM-CAT-003The store view presents its policy and admitted shelvestest
react-console:e2e/mock/commerce-view-edit.mock.spec.ts#create a store, land on its view, edit the default sort, save, and see it on the view
5/console/{tenantId}/configuration/orders/merchandise/{id}/editPublish the guide’s Storefront in Books while retaining another draftCAP-COM-CAT-006The published guide is eligible for the shelf and the draft remains excludeddocumented

Alternate and Failure Paths

PathFrom stepConditionPath takenOutcomeProvenance
alternate1The selected unit does not support that currencyThe save fails validation identifying the currencyThe administrator must choose a supported currency before creation succeedstest
services-commerce:modules/configuration/tests/e2e/ordering-profiles.e2e.spec.js#answers 400 currency_not_supported_by_business_unit to a currency the business unit does not transact in
alternate4Books is chosen as home while the store offers each category but BooksThe save fails validation identifying the home categoryCorrecting the landing shelf allows the store savetest
services-commerce:modules/configuration/tests/integration/services/persistence/stores.integration.spec.js#refuses a home category an "all_but" rule leaves out, 400 naming home_category_id
failure3A removal request targets a shelf still included by the storeThe delete fails validation identifying BookstoreThe shelf remains retained until its store reference is removedtest
services-commerce:modules/catalog/tests/integration/services/persistence/product-categories.integration.spec.js#is refused 409 category_in_use while a store has it as its home category, naming the store, and deleted once the store moves

Assertions

IdStatementProvenance
01The saved policy summary reflects the chosen payment arrangements and range changes.test
react-console:e2e/mock/commerce-checkout-policies.mock.spec.ts#create a policy, read its summary on the view, edit the card range, save, and see it on the view
02Store checkout uses Main and rejects an item requiring a different policy.documented
03The store view displays the retained policy and assortment.test
react-console:e2e/mock/commerce-view-edit.mock.spec.ts#create a store, land on its view, edit the default sort, save, and see it on the view
04A retained store reference prevents shelf deletion.test
services-commerce:modules/catalog/tests/integration/services/persistence/product-categories.integration.spec.js#is refused while stores name it in their assortment, naming five of them and the count
05The item view retains its published Storefront presentation and draft listings remain off the public shelf.test
react-console:e2e/mock/merchandise.mock.spec.ts#a new item is created with its storefront, shown on its view, and a price change comes back to the view

End-to-end policy: required: Initial selling setup crosses several staff screens and warrants a live browser journey beyond the available mock evidence.

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.