@endora-commerce/mod-catalog 0.106.0 → 0.108.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/admin/components/PackagingUnitsEditor.d.ts +3 -0
- package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
- package/dist/admin/components/PackagingUnitsEditor.js +51 -5
- package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
- package/dist/admin/components/ProductOrderRulesCard.d.ts +19 -0
- package/dist/admin/components/ProductOrderRulesCard.d.ts.map +1 -0
- package/dist/admin/components/ProductOrderRulesCard.js +147 -0
- package/dist/admin/components/ProductOrderRulesCard.js.map +1 -0
- package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +1 -1
- package/dist/admin/components/ProductsBulkEditDialog.js +31 -3
- package/dist/admin/components/ProductsBulkEditDialog.js.map +1 -1
- package/dist/admin/pages/CategoriesTree.d.ts.map +1 -1
- package/dist/admin/pages/CategoriesTree.js +21 -4
- package/dist/admin/pages/CategoriesTree.js.map +1 -1
- package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
- package/dist/admin/pages/ProductEditor.js +12 -33
- package/dist/admin/pages/ProductEditor.js.map +1 -1
- package/dist/admin/pages/ProductsList.d.ts.map +1 -1
- package/dist/admin/pages/ProductsList.js +36 -3
- package/dist/admin/pages/ProductsList.js.map +1 -1
- package/dist/backend/admin-search-provider.d.ts +56 -0
- package/dist/backend/admin-search-provider.d.ts.map +1 -0
- package/dist/backend/admin-search-provider.js +109 -0
- package/dist/backend/admin-search-provider.js.map +1 -0
- package/dist/backend/demo/reset.d.ts +1 -1
- package/dist/backend/demo/rows.d.ts +7 -3
- package/dist/backend/demo/rows.d.ts.map +1 -1
- package/dist/backend/demo/rows.js +7 -5
- package/dist/backend/demo/rows.js.map +1 -1
- package/dist/backend/demo/seed.d.ts.map +1 -1
- package/dist/backend/demo/seed.js +1 -4
- package/dist/backend/demo/seed.js.map +1 -1
- package/dist/backend/entities/product-list-saved-view.entity.d.ts +31 -0
- package/dist/backend/entities/product-list-saved-view.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-list-saved-view.entity.js +75 -0
- package/dist/backend/entities/product-list-saved-view.entity.js.map +1 -0
- package/dist/backend/entities/product-packaging-unit.entity.d.ts +7 -1
- package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-packaging-unit.entity.js +10 -0
- package/dist/backend/entities/product-packaging-unit.entity.js.map +1 -1
- package/dist/backend/entities/product-variant.entity.d.ts +1 -2
- package/dist/backend/entities/product-variant.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-variant.entity.js +0 -5
- package/dist/backend/entities/product-variant.entity.js.map +1 -1
- package/dist/backend/entities/product.entity.d.ts +25 -1
- package/dist/backend/entities/product.entity.d.ts.map +1 -1
- package/dist/backend/entities/product.entity.js +60 -0
- package/dist/backend/entities/product.entity.js.map +1 -1
- package/dist/backend/index.d.ts +5 -5
- package/dist/backend/index.d.ts.map +1 -1
- package/dist/backend/index.js +24 -4
- package/dist/backend/index.js.map +1 -1
- package/dist/backend/plugin.d.ts +7 -2
- package/dist/backend/plugin.d.ts.map +1 -1
- package/dist/backend/plugin.js +4 -0
- package/dist/backend/plugin.js.map +1 -1
- package/dist/backend/routes.admin.d.ts +6 -0
- package/dist/backend/routes.admin.d.ts.map +1 -1
- package/dist/backend/routes.admin.js +68 -2
- package/dist/backend/routes.admin.js.map +1 -1
- package/dist/backend/routes.public.d.ts.map +1 -1
- package/dist/backend/routes.public.js +13 -8
- package/dist/backend/routes.public.js.map +1 -1
- package/dist/backend/saved-view-actor.d.ts +16 -0
- package/dist/backend/saved-view-actor.d.ts.map +1 -0
- package/dist/backend/saved-view-actor.js +24 -0
- package/dist/backend/saved-view-actor.js.map +1 -0
- package/dist/backend/services/catalog-admin-search.service.d.ts +32 -0
- package/dist/backend/services/catalog-admin-search.service.d.ts.map +1 -0
- package/dist/backend/services/catalog-admin-search.service.js +141 -0
- package/dist/backend/services/catalog-admin-search.service.js.map +1 -0
- package/dist/backend/services/catalog-admin.service.d.ts +14 -0
- package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-admin.service.js +69 -22
- package/dist/backend/services/catalog-admin.service.js.map +1 -1
- package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-bulk-update.service.js +8 -1
- package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
- package/dist/backend/services/catalog-org-price-decorator.d.ts +7 -3
- package/dist/backend/services/catalog-org-price-decorator.d.ts.map +1 -1
- package/dist/backend/services/catalog-org-price-decorator.js +32 -23
- package/dist/backend/services/catalog-org-price-decorator.js.map +1 -1
- package/dist/backend/services/catalog-product-read.service.d.ts +52 -3
- package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-product-read.service.js +153 -3
- package/dist/backend/services/catalog-product-read.service.js.map +1 -1
- package/dist/backend/services/catalog-query.service.d.ts +19 -3
- package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-query.service.js +416 -89
- package/dist/backend/services/catalog-query.service.js.map +1 -1
- package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
- package/dist/backend/services/packaging-unit.service.js +39 -4
- package/dist/backend/services/packaging-unit.service.js.map +1 -1
- package/dist/backend/services/product-link.service.d.ts +5 -0
- package/dist/backend/services/product-link.service.d.ts.map +1 -1
- package/dist/backend/services/product-link.service.js +18 -6
- package/dist/backend/services/product-link.service.js.map +1 -1
- package/dist/backend/services/product-list-view-service.d.ts +53 -0
- package/dist/backend/services/product-list-view-service.d.ts.map +1 -0
- package/dist/backend/services/product-list-view-service.js +191 -0
- package/dist/backend/services/product-list-view-service.js.map +1 -0
- package/dist/backend/services/product-value-resolver.service.d.ts +11 -1
- package/dist/backend/services/product-value-resolver.service.d.ts.map +1 -1
- package/dist/backend/services/product-value-resolver.service.js +29 -9
- package/dist/backend/services/product-value-resolver.service.js.map +1 -1
- package/dist/backend/services/storefront-value-overrides.d.ts +31 -0
- package/dist/backend/services/storefront-value-overrides.d.ts.map +1 -0
- package/dist/backend/services/storefront-value-overrides.js +48 -0
- package/dist/backend/services/storefront-value-overrides.js.map +1 -0
- package/dist/manifest.d.ts +6 -2
- package/dist/manifest.d.ts.map +1 -1
- package/dist/manifest.js +39 -3
- package/dist/manifest.js.map +1 -1
- package/dist/migrations/20261014T170531_catalog_product_list_saved_views.d.ts +22 -0
- package/dist/migrations/20261014T170531_catalog_product_list_saved_views.d.ts.map +1 -0
- package/dist/migrations/20261014T170531_catalog_product_list_saved_views.js +38 -0
- package/dist/migrations/20261014T170531_catalog_product_list_saved_views.js.map +1 -0
- package/dist/migrations/20261016T082008_catalog_order_rules.d.ts +22 -0
- package/dist/migrations/20261016T082008_catalog_order_rules.d.ts.map +1 -0
- package/dist/migrations/20261016T082008_catalog_order_rules.js +48 -0
- package/dist/migrations/20261016T082008_catalog_order_rules.js.map +1 -0
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts +26 -0
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts.map +1 -0
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.js +32 -0
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.js.map +1 -0
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts +38 -0
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts.map +1 -0
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.js +89 -0
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.js.map +1 -0
- package/dist/migrations/index.d.ts +5 -1
- package/dist/migrations/index.d.ts.map +1 -1
- package/dist/migrations/index.js +9 -1
- package/dist/migrations/index.js.map +1 -1
- package/docs/catalog/attributes.md +11 -6
- package/docs/catalog/packaging-units.md +44 -7
- package/docs/catalog/per-channel-per-language-overrides.md +36 -9
- package/docs/catalog.md +276 -4
- package/i18n/en.json +41 -5
- package/i18n/pl.json +41 -5
- package/package.json +9 -9
|
@@ -159,7 +159,7 @@ additive.
|
|
|
159
159
|
|
|
160
160
|
## Read paths
|
|
161
161
|
|
|
162
|
-
|
|
162
|
+
These consumers go through the resolver:
|
|
163
163
|
|
|
164
164
|
- **Admin endpoint** — `GET /api/v1/admin/catalog/products/:id?channelId=&languageCode=&includeOverridesMap=true`
|
|
165
165
|
returns the baseline product PLUS, when context params are passed, a
|
|
@@ -168,13 +168,40 @@ Three consumers go through the resolver:
|
|
|
168
168
|
is attached for client-side switcher previews.
|
|
169
169
|
- **Storefront public read** — pulls the channel from the
|
|
170
170
|
`x-sales-channel` header (the existing convention) and
|
|
171
|
-
the language from `Accept-Language
|
|
172
|
-
to the public client
|
|
171
|
+
the language from `Accept-Language`, else the channel's default
|
|
172
|
+
language. The override layer is invisible to the public client: it
|
|
173
|
+
receives the effective value. The product page (name, description,
|
|
174
|
+
SEO fields, attribute values, the product-page attribute list, grouped
|
|
175
|
+
children and bundle options) and every listing card walk the storefront's own baseline language pick — requested
|
|
176
|
+
language, then the channel's default language, then `en-US`, `en` and
|
|
177
|
+
the first stored language — and at each language take the
|
|
178
|
+
`(channel + language)` slot if it is filled, else stop there if the
|
|
179
|
+
baseline has text for that language. An override therefore answers
|
|
180
|
+
only for the language whose baseline text the page would show, or an
|
|
181
|
+
earlier one in that order: a request in `en-US` on a channel whose
|
|
182
|
+
default is `pl-PL` shows the `en-US` baseline, not the `pl-PL`
|
|
183
|
+
override, while a `de-DE` request for a product with no `de-DE` text
|
|
184
|
+
falls through to `pl-PL` and shows its override. The `(channel-only)`
|
|
185
|
+
slot is asked last and wins over the baseline wherever the walk
|
|
186
|
+
stopped. Product-link tiles keep their own language pick, which has
|
|
187
|
+
no channel-default leg, and walk the override slots over it, so a
|
|
188
|
+
tile can show the `en-US` baseline where the listing card shows the
|
|
189
|
+
channel default's override. A product without overrides shows exactly what
|
|
190
|
+
it showed before. Listing filters, attribute filters and name sorting
|
|
191
|
+
still read the baseline.
|
|
173
192
|
- **Search indexer (Meilisearch)** — builds one document per
|
|
174
193
|
`(product, channel)` pair. Each document's `name` and `description`
|
|
175
194
|
fields are run through the resolver with `channel.defaultLanguage`
|
|
176
195
|
as the active language, so per-channel overrides flow into
|
|
177
|
-
storefront search ranking.
|
|
196
|
+
storefront search ranking and name sorting.
|
|
197
|
+
- **Search result cards** — the search module re-reads every hit from
|
|
198
|
+
Postgres before it answers, and the card name it shows is resolved
|
|
199
|
+
there, not taken from the index: the request's sales channel override
|
|
200
|
+
rows are read once per results page and the card walks the same
|
|
201
|
+
languages and slots, in the same order, as a listing card above. The indexed name is
|
|
202
|
+
resolved for the channel's default language only, so it would be
|
|
203
|
+
wrong for a request in any other language. A product without an
|
|
204
|
+
override for the channel shows exactly what it showed before.
|
|
178
205
|
|
|
179
206
|
## Admin UI
|
|
180
207
|
|
|
@@ -223,11 +250,11 @@ exact inverse — drop the two tables and the two columns.
|
|
|
223
250
|
surfaces only the system Name + Description today. User attribute
|
|
224
251
|
overrides are accepted by the PATCH endpoint and resolved on read,
|
|
225
252
|
but the admin SPA does not yet expose a write affordance for them.
|
|
226
|
-
- **
|
|
227
|
-
`
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
follow-up.
|
|
253
|
+
- **Override-aware listing filters and sorting** — the public catalog
|
|
254
|
+
endpoint returns `name` and `description` as the resolved string for
|
|
255
|
+
the request's sales channel and language (see *Read paths* above), but
|
|
256
|
+
listing filters, attribute filters and name sorting still read the
|
|
257
|
+
baseline values. Making them follow the overrides is a follow-up.
|
|
231
258
|
- **Channel-aware reindex enqueue** — the PATCH endpoint does not
|
|
232
259
|
yet enqueue a Meilisearch reindex job per touched channel; the
|
|
233
260
|
next per-product upsert (driven by any catalog mutation) picks it
|
package/docs/catalog.md
CHANGED
|
@@ -15,6 +15,12 @@ depends on and the admin-side authoring surface.
|
|
|
15
15
|
Admin routes are gated by `catalog:read` (list / get) /
|
|
16
16
|
`catalog:write` (mutations).
|
|
17
17
|
|
|
18
|
+
The storefront reads that carry a price — the product list, the product detail and
|
|
19
|
+
`/products/:idOrSlug/links` — accept `?currency=` (an ISO 4217 code). The response is priced in
|
|
20
|
+
that currency when the Sales Channel offers it, and in the channel's default currency
|
|
21
|
+
otherwise; every price names its currency either way. A malformed code is refused with
|
|
22
|
+
`400 VALIDATION_FAILED`.
|
|
23
|
+
|
|
18
24
|
| Verb + Path | Audience | Purpose |
|
|
19
25
|
| --- | --- | --- |
|
|
20
26
|
| `GET /api/v1/catalog/products` | storefront / API key | List/search/filter products in the active Sales Channel |
|
|
@@ -28,6 +34,7 @@ Admin routes are gated by `catalog:read` (list / get) /
|
|
|
28
34
|
| `POST /api/v1/admin/catalog/products` | admin | Create product (`type` immutable post-create; `sku` is editable) |
|
|
29
35
|
| `PATCH /api/v1/admin/catalog/products/:id` | admin | Update (incl. `sku`); writes an audit row with stateBefore / stateAfter; refuses with `409 sku_in_use` if the new SKU already belongs to another product |
|
|
30
36
|
| `DELETE /api/v1/admin/catalog/products/:id` | admin | Archive (soft) |
|
|
37
|
+
| `GET`, `POST /api/v1/admin/catalog/products/list-views`; `PATCH`, `DELETE …/list-views/:id` | admin | Saved views on the product list — see *Saved views* below |
|
|
31
38
|
| `GET /api/v1/admin/catalog/attributes` | admin | List attributes |
|
|
32
39
|
| `GET /api/v1/admin/catalog/attributes/by-flag?flag=isPromoRule\|isComparable\|...` | admin | Picker payload — every attribute carrying the requested flag |
|
|
33
40
|
| `GET /api/v1/admin/catalog/attributes/:idOrKey` | admin | Single attribute read |
|
|
@@ -47,11 +54,169 @@ Admin routes are gated by `catalog:read` (list / get) /
|
|
|
47
54
|
| `PUT /api/v1/admin/catalog/categories/:id/content` | admin | Replace the category's page content; `null` clears it |
|
|
48
55
|
| `PUT /api/v1/catalog/products/by-sku/:sku` | API key | Idempotent upsert (PIM sync) |
|
|
49
56
|
|
|
57
|
+
## Prices
|
|
58
|
+
|
|
59
|
+
**A product carries no price of its own.** Every price is a row of a price book of the
|
|
60
|
+
`price_lists` module: the product's base price per currency, its variants' prices, and any
|
|
61
|
+
catalogue, buyer or sale price. Set a product's base price on the product editor's **Pricing** tab
|
|
62
|
+
— the *Base prices* panel there, and the list of the price books that price the product, are
|
|
63
|
+
contributed by `price_lists` — or in the base book's grid. Variant prices are set in the same
|
|
64
|
+
places, never on the variant itself. The `price_lists` module's page explains how the price a
|
|
65
|
+
buyer pays is chosen.
|
|
66
|
+
|
|
67
|
+
- **Listing cards, the product page and related products** show the viewer's own price — their
|
|
68
|
+
organization's and customer group's prices on the request's sales channel and currency. A product
|
|
69
|
+
whose variants cost different amounts shows its lowest price as a *from* price
|
|
70
|
+
(`ProductSummary.price` carries `variesByVariant` and `maxAmount`); a charged sale carries the
|
|
71
|
+
buyer's regular price as the compare-at price; with `pricing.show_list_price` on, a lower buyer
|
|
72
|
+
price carries the catalogue price as `listPrice`. A product nothing prices has no price and
|
|
73
|
+
follows the quote-request path.
|
|
74
|
+
- **Sorting and filtering by price** — `?sort=price`, `?sort=-price`, `minPrice`, `maxPrice` on
|
|
75
|
+
`GET /api/v1/catalog/products` — order and select by the same quantity-1 price the cards show to
|
|
76
|
+
that viewer, the *from* price for a variant product. Priced products always come before unpriced
|
|
77
|
+
ones. A price ordering is always answered from PostgreSQL, never from the search index. Paging
|
|
78
|
+
through a price ordering with the cursor meets every product once, provided its price does not
|
|
79
|
+
change meanwhile; a product repriced during the walk may be met twice or not at all, as with any
|
|
80
|
+
cursor over a live price. A page may be short, or even empty, and still have more after it
|
|
81
|
+
(`hasMore: true`) when most of the rows it read are hidden from the viewer; follow its cursor.
|
|
82
|
+
- **The product detail on a non-public sales channel** omits the price.
|
|
83
|
+
|
|
84
|
+
For developers: the listing paths price a whole page in one batched call —
|
|
85
|
+
`resolveListingPrices`, or `resolveListingPriceDetails` where the page renders the split
|
|
86
|
+
(`ProductSummary.resolvedPrice`: `basePrice`, `salePrice`, `listPrice`, `displayMode`) — through the
|
|
87
|
+
`pricingService` port slices of `@endora-commerce/contracts`, passing the viewer's organization and
|
|
88
|
+
customer account rather than a resolved group. A price ordering reads `ListingPriceOrderPort`
|
|
89
|
+
(`orderByUnitPrice`, `pricedProductIds`) over `price_lists`' precomputed price surface and composes
|
|
90
|
+
the unpriced tail itself (`catalog-query.service.ts`). The external catalogue API prices through
|
|
91
|
+
`resolveLinePrices` and builds a bound organization's tier ladder from `listTierStarts`. Product,
|
|
92
|
+
category and attribute writes publish the events `price_lists` subscribes to, which clear the
|
|
93
|
+
pricing caches and mark on the price surface the products each event concerns, for the surface
|
|
94
|
+
worker to refresh.
|
|
95
|
+
|
|
96
|
+
### Removed price fields (migration note)
|
|
97
|
+
|
|
98
|
+
The release that introduced price books removed the product's *Default unit price* (the
|
|
99
|
+
`defaultPrice` and `price` keys of `attributeValues`, and the editor field) and the variant price
|
|
100
|
+
override (`product_variants.price_override`, and the variant editor's price field), without
|
|
101
|
+
converting either. Product and variant create and update, and the products import, refuse those
|
|
102
|
+
fields with `400 PRICE_SET_IN_PRICE_BOOKS` (`PRICE_FIELDS_REFUSED_ON_PRODUCTS`,
|
|
103
|
+
`PRICE_FIELDS_REFUSED_ON_VARIANTS` in `@endora-commerce/contracts`), saying that prices are set in
|
|
104
|
+
price books. The catalogue's migration `20261022T111811_catalog_price_fields_removed.ts` dropped the
|
|
105
|
+
column and stripped the keys.
|
|
106
|
+
|
|
50
107
|
## Entities
|
|
51
108
|
|
|
52
109
|
`Product`, `ProductVariant`, `Category`, `ProductAttribute`,
|
|
53
110
|
`SalesChannel`, plus the M:N bridges
|
|
54
|
-
`product_categories`, `sales_channel_products`, `product_assets
|
|
111
|
+
`product_categories`, `sales_channel_products`, `product_assets`, and
|
|
112
|
+
`ProductListSavedView` (`product_list_saved_views`, the product list's saved
|
|
113
|
+
views).
|
|
114
|
+
|
|
115
|
+
## Saved views
|
|
116
|
+
|
|
117
|
+
A saved view is a named set of product-list filters that an admin can apply
|
|
118
|
+
again with one selection.
|
|
119
|
+
|
|
120
|
+
### Using saved views
|
|
121
|
+
|
|
122
|
+
The product list's toolbar carries a **Saved views** selector, whose first
|
|
123
|
+
entry is **— Select a view —**, and two buttons beside it: **Save view** and
|
|
124
|
+
**Delete view**.
|
|
125
|
+
|
|
126
|
+
- **What a view remembers.** The status, the type and the search text — and
|
|
127
|
+
nothing else. The **Stock**, **Category** and **Channel** chips are not saved.
|
|
128
|
+
Choosing a view sets status, type and search to the view's values (a value
|
|
129
|
+
the list no longer offers loads as *All*), resets the Stock chip to *All*,
|
|
130
|
+
discards anything you had changed and not saved, clears the row selection and
|
|
131
|
+
goes back to the first page.
|
|
132
|
+
- **Saving.** **Save view** opens one dialog with a **Name** field and a
|
|
133
|
+
**Share with every admin who can open this list** checkbox. The checkbox
|
|
134
|
+
starts unchecked, so a new view is private unless you tick it. The name is
|
|
135
|
+
required, leading and trailing spaces are removed, and it can be at most 160
|
|
136
|
+
characters long. Problems are shown on the field and nothing is sent until
|
|
137
|
+
they are fixed; a refusal from the server is shown inside the dialog, which
|
|
138
|
+
stays open with what you typed.
|
|
139
|
+
- **Private or shared.** A private view is listed only for you. A shared view
|
|
140
|
+
is listed for every admin who can open the product list, with **(shared)**
|
|
141
|
+
after its name. The selector does not show who saved a shared view.
|
|
142
|
+
- **One name per admin.** You cannot hold two views on this list whose names
|
|
143
|
+
differ only in letter case or in surrounding spaces. The dialog answers
|
|
144
|
+
**You already have a view with this name.** before sending anything, and the
|
|
145
|
+
server refuses the name as well. Accented letters are different letters:
|
|
146
|
+
*Wózki* and *Wozki* are two names. Names other admins use, and names used on
|
|
147
|
+
other lists, do not count.
|
|
148
|
+
- **Deleting.** **Delete view** is enabled only when the selected view is one
|
|
149
|
+
you may delete. It asks for confirmation and names the view —
|
|
150
|
+
**Delete the view “…”?** — and for a shared view adds that it will disappear
|
|
151
|
+
for every admin who can open this list. Nothing is deleted until you press
|
|
152
|
+
**Delete**.
|
|
153
|
+
- **Who may delete or change a shared view.** Its owner, or **any admin whose
|
|
154
|
+
role is not `sales_representative`** — not only the `platform_admin` role: a
|
|
155
|
+
custom role such as a catalog manager counts as well. **Such a deletion or
|
|
156
|
+
change leaves no audit trail**: saved views are not written to the audit log.
|
|
157
|
+
Decide which roles you grant with that in mind before your team relies on
|
|
158
|
+
shared views. A sales representative can delete only their own views, and
|
|
159
|
+
nobody can see or delete another admin's private view.
|
|
160
|
+
- **Only save, load and delete.** The Admin UI does not rename a view, change
|
|
161
|
+
whether it is shared, or overwrite it with the current filters; save a new
|
|
162
|
+
view and delete the old one instead. There is no limit on the number of
|
|
163
|
+
views.
|
|
164
|
+
|
|
165
|
+
### Saved views API
|
|
166
|
+
|
|
167
|
+
| Method and path | Answers |
|
|
168
|
+
| --- | --- |
|
|
169
|
+
| `GET /api/v1/admin/catalog/products/list-views` | `200` — the caller's own views plus every shared view, ordered by name |
|
|
170
|
+
| `POST /api/v1/admin/catalog/products/list-views` | `201` — the created view |
|
|
171
|
+
| `PATCH /api/v1/admin/catalog/products/list-views/:id` | `200` — the modified view; any of `name`, `shared`, `filters`. The Admin UI does not call it. A body that changes nothing — empty, or every value as stored — writes nothing, logs nothing and answers the current view |
|
|
172
|
+
| `DELETE /api/v1/admin/catalog/products/list-views/:id` | `200` — `{ data: { deleted: <id> } }` |
|
|
173
|
+
|
|
174
|
+
- **Gate.** All four routes are gated by `catalog:read` — the code that gates
|
|
175
|
+
reading the product list; there is no separate permission code. A request
|
|
176
|
+
without an admin actor is refused with `401 UNAUTHORIZED`. The static
|
|
177
|
+
`list-views` segment takes precedence over `products/:id`.
|
|
178
|
+
- **Body.** `name` (trimmed, 1–160 characters, no Unicode control or format
|
|
179
|
+
characters), `shared` (boolean) and `filters` (an object, at most 8192 bytes
|
|
180
|
+
as UTF-8 JSON). The product list has no sort or column control, so a view
|
|
181
|
+
stores no `sort` or `visibleColumns`; those keys are dropped. The Admin UI
|
|
182
|
+
writes `filters` as `{ status?, type?, q? }`, only the non-default ones.
|
|
183
|
+
Anything outside those bounds is `400 VALIDATION_FAILED`. The shapes are
|
|
184
|
+
`createProductSavedViewRequestSchema` and
|
|
185
|
+
`updateProductSavedViewRequestSchema` in `@endora-commerce/contracts`.
|
|
186
|
+
- **Two caller-relative flags.** Every view in a response carries
|
|
187
|
+
`ownedByCaller` and `canModify` — `true` when the caller owns the view, or
|
|
188
|
+
the view is shared and the caller is a platform admin in the sense below. The
|
|
189
|
+
Admin UI enables **Delete view** from `canModify`, and before saving runs a
|
|
190
|
+
best-effort duplicate-name pre-check against the listed views with
|
|
191
|
+
`ownedByCaller`. The server's `lower(btrim(name))` comparison is
|
|
192
|
+
authoritative: a name the pre-check lets through can still be refused with
|
|
193
|
+
`409`.
|
|
194
|
+
- **Platform admin, for saved views,** is an admin whose request tenant context
|
|
195
|
+
has `mode === 'all'` — every role except `sales_representative`. The order,
|
|
196
|
+
product and quote request lists derive it the same way, and it fails closed:
|
|
197
|
+
an admin whose reach cannot be resolved is not a platform admin.
|
|
198
|
+
- **Refusals.** An absent view, or another admin's private view, is
|
|
199
|
+
`404 NOT_FOUND` — the two are indistinguishable. A shared view the caller
|
|
200
|
+
neither owns nor may modify as a platform admin is `403 FORBIDDEN`. A name
|
|
201
|
+
whose key the view's owner already uses on this list is
|
|
202
|
+
`409 PRODUCT_SAVED_VIEW_NAME_TAKEN`, *"You already have a saved view with this
|
|
203
|
+
name on the product list. Choose a different name."*, in the request's
|
|
204
|
+
language.
|
|
205
|
+
- **The name key** is the name trimmed and lower-cased — no accent folding. The
|
|
206
|
+
rule binds the view's **owner**: a platform admin renaming a colleague's
|
|
207
|
+
shared view is refused when the colleague already uses that key. Creating a
|
|
208
|
+
view and changing a name's key take a transaction-scoped advisory lock keyed
|
|
209
|
+
on the owner, and a unique index on `(owner_admin_user_id, lower(name))`
|
|
210
|
+
backs it, so two concurrent saves under one name leave exactly one view.
|
|
211
|
+
- **No audit.** Saved views are personal UI configuration and do not run
|
|
212
|
+
through the Command Bus. When an admin modifies or deletes a view they do not
|
|
213
|
+
own, the service writes one `info` log record:
|
|
214
|
+
`{ event: 'saved_view.updated' | 'saved_view.deleted', list: 'product_list_saved_views', viewId, ownerAdminUserId, actorAdminUserId }`.
|
|
215
|
+
That log line is the only trace.
|
|
216
|
+
- **Storage.** `product_list_saved_views` (`ProductListSavedView`) is
|
|
217
|
+
platform-global, not organization-scoped: it holds filter values, never list
|
|
218
|
+
results, and every list read after a view is applied runs under the loader's
|
|
219
|
+
own scope.
|
|
55
220
|
|
|
56
221
|
## Events emitted
|
|
57
222
|
|
|
@@ -104,13 +269,105 @@ modules are present. The payload is sent whole; the strict schemas are
|
|
|
104
269
|
|
|
105
270
|
## Extension points
|
|
106
271
|
|
|
107
|
-
- **Per-Sales-Channel
|
|
108
|
-
context
|
|
109
|
-
composing into
|
|
272
|
+
- **Per-Sales-Channel listing** — the query service receives a SalesChannel
|
|
273
|
+
context, and every price it renders is resolved for that channel; new gating
|
|
274
|
+
(e.g. customer-segment-specific catalogs) is added by composing into
|
|
275
|
+
`catalog-query.service.ts`.
|
|
110
276
|
- **Slug uniqueness** — the slug is unique across all Sales Channels by
|
|
111
277
|
default; override the slugifier in `catalog-admin.service.ts` if locale
|
|
112
278
|
collisions become a concern.
|
|
113
279
|
|
|
280
|
+
## Order rules: minimum order quantity and returnable
|
|
281
|
+
|
|
282
|
+
Two rules on a product decide how it may be ordered and whether it may be sent
|
|
283
|
+
back. Both are edited in the **Order rules** card on the product editor's
|
|
284
|
+
**Inventory** tab.
|
|
285
|
+
|
|
286
|
+
> **Upgrading: every existing product starts as not returnable.** A product on
|
|
287
|
+
> which nobody has set **Returnable** reads as not returnable, and that includes
|
|
288
|
+
> every product that existed before the setting was introduced. Lines of orders
|
|
289
|
+
> placed after the upgrade are therefore not returnable until you mark their
|
|
290
|
+
> products. To mark many at once, select them on the product list and use
|
|
291
|
+
> **Bulk edit → Returnable → Yes — returnable**. Orders placed before the
|
|
292
|
+
> upgrade are unaffected: their lines stay returnable under the usual rules.
|
|
293
|
+
|
|
294
|
+
### Minimum order quantity
|
|
295
|
+
|
|
296
|
+
- **Minimum order quantity (pcs)** — the fewest pieces of the product a buyer
|
|
297
|
+
may order in one order. Optional; a whole number from **1 to 1 000 000**, or
|
|
298
|
+
empty for no minimum. It applies to `simple` and `configurable` products
|
|
299
|
+
only: on a `grouped`, `bundle` or `virtual` product the card says so, and
|
|
300
|
+
the API refuses the field with `422 VALIDATION_FAILED` naming
|
|
301
|
+
`minOrderQuantity`, on create and on update. A value outside the range is
|
|
302
|
+
refused with `400 VALIDATION_FAILED`.
|
|
303
|
+
- **A minimum per packaging unit** — each packaging unit may carry its own
|
|
304
|
+
minimum number of units; see [Packaging Units](./catalog/packaging-units.md).
|
|
305
|
+
|
|
306
|
+
The minimum is judged on the **product total**: every line of the product in
|
|
307
|
+
the basket counts — single-piece and packaging-unit lines, every variant. A
|
|
308
|
+
packaging-unit minimum counts the units of that unit ordered for the product,
|
|
309
|
+
over every variant. The two checks are independent; a basket must satisfy
|
|
310
|
+
every minimum that is set. Variants inherit the product's minimum.
|
|
311
|
+
|
|
312
|
+
Every way into a basket, a quote request or an order applies it — the cart,
|
|
313
|
+
checkout, quick order, one-click buy, shopping lists, quote requests, the
|
|
314
|
+
admin's Create order screen and the external order API. Each of those modules'
|
|
315
|
+
pages says what its path does with a line below the minimum. A refusal answers
|
|
316
|
+
`422 PRODUCT_BELOW_MINIMUM_QUANTITY` (pieces) or
|
|
317
|
+
`422 PACKAGING_UNIT_BELOW_MINIMUM_QUANTITY` (a packaging unit), with a message
|
|
318
|
+
in the buyer's language naming the product and the minimum. Removing a line is
|
|
319
|
+
always allowed.
|
|
320
|
+
|
|
321
|
+
A product a buyer may not see, or that the request's sales channel does not
|
|
322
|
+
publish, is reported as an unknown product on every path — its name and its
|
|
323
|
+
minimum are never disclosed.
|
|
324
|
+
|
|
325
|
+
The storefront product detail, the product list, search results and the
|
|
326
|
+
comparison carry `minOrderQuantity` (`null` when there is none, or when the
|
|
327
|
+
product's type takes no minimum); the product detail's `packagingUnits[]`
|
|
328
|
+
carries each unit's `minOrderUnits`. The storefront starts the quantity at the
|
|
329
|
+
minimum and does not offer less.
|
|
330
|
+
|
|
331
|
+
### Returnable
|
|
332
|
+
|
|
333
|
+
**Returnable** (yes / no, on every product type) says whether buyers may
|
|
334
|
+
include the product in a **return**. It does not restrict **complaints**. The
|
|
335
|
+
default is no.
|
|
336
|
+
|
|
337
|
+
The value is **recorded on each order line when the order is placed**
|
|
338
|
+
(`order_items.returnable_at_purchase`); changing the flag later changes no
|
|
339
|
+
order already placed. A line whose product could not be read at placement is
|
|
340
|
+
recorded as not returnable. What the Returns module does with the recorded
|
|
341
|
+
value is on its own page.
|
|
342
|
+
|
|
343
|
+
### Audit and copies
|
|
344
|
+
|
|
345
|
+
Setting or clearing either rule is audited like any product edit, with the old
|
|
346
|
+
and the new value. **Bulk edit → Returnable** writes one audit entry per
|
|
347
|
+
product it changes, for up to 200 products in one synchronous request and
|
|
348
|
+
through the queued bulk edit beyond. Changing a rule never alters an existing
|
|
349
|
+
cart, order, quote request or return. **Duplicate** does not copy either rule:
|
|
350
|
+
the copy starts with no minimum and as not returnable.
|
|
351
|
+
|
|
352
|
+
### API
|
|
353
|
+
|
|
354
|
+
| Field | Where | Values |
|
|
355
|
+
| --- | --- | --- |
|
|
356
|
+
| `minOrderQuantity` | `POST` / `PATCH /api/v1/admin/catalog/products[/:id]`, the admin product response | integer `1…1000000`, or `null` to clear |
|
|
357
|
+
| `returnable` | the same, and `POST /api/v1/admin/catalog/products/bulk-update` | boolean |
|
|
358
|
+
| `minOrderUnits` | `POST` / `PATCH …/packaging-units[/:unitId]`, the packaging-unit response | integer `1…1000000`, or `null` to clear |
|
|
359
|
+
|
|
360
|
+
The catalogue read port (`CatalogProductReadPort`) reports `minOrderQuantity`
|
|
361
|
+
and `returnable` on each product record and `minOrderUnits` on each packaging
|
|
362
|
+
unit, and gains `listPackagingUnitsByProductIds` for batch reads. Like every
|
|
363
|
+
method of the port it applies no visibility policy: a caller passes only
|
|
364
|
+
product ids it has already vetted.
|
|
365
|
+
|
|
366
|
+
Migration `20261016T082008_catalog_order_rules.ts` adds
|
|
367
|
+
`products.min_order_quantity` (nullable, `CHECK` 1–1 000 000),
|
|
368
|
+
`products.returnable` (not null, default `false`) and
|
|
369
|
+
`product_packaging_units.min_order_units` (nullable, `CHECK` 1–1 000 000).
|
|
370
|
+
|
|
114
371
|
## Product structure and composition surfaces
|
|
115
372
|
|
|
116
373
|
The catalog grew several capability surfaces, each with its own page:
|
|
@@ -253,3 +510,18 @@ promotions port, the scope editor) read attributes through the
|
|
|
253
510
|
catalog-exported `CatalogAttributeReadService`, which composes the
|
|
254
511
|
definition and the extension into the legacy-shaped
|
|
255
512
|
`CatalogAttributeView`.
|
|
513
|
+
|
|
514
|
+
## Global search
|
|
515
|
+
|
|
516
|
+
The admin's global search (the command palette, ⌘K / Ctrl+K) finds products and categories. This module offers the fields below; which of them are used is chosen on the Global search configuration screen.
|
|
517
|
+
|
|
518
|
+
| Field | Searched by default |
|
|
519
|
+
| --- | --- |
|
|
520
|
+
| Product: SKU | yes |
|
|
521
|
+
| Product: Name | yes |
|
|
522
|
+
| Product: URL key (slug) | no |
|
|
523
|
+
| Product: Quick-search attributes | no |
|
|
524
|
+
| Category: Name | yes |
|
|
525
|
+
| Category: URL key (slug) | yes |
|
|
526
|
+
|
|
527
|
+
Names match in every language and are shown in the admin's language. Drafts and inactive products are found and show their status; deleted products and categories are not. A category result opens the category tree with that category highlighted. Both appear for a role holding `catalog:read`.
|
package/i18n/en.json
CHANGED
|
@@ -42,6 +42,10 @@
|
|
|
42
42
|
"productsList.bulkEdit.section.categories": "Categories",
|
|
43
43
|
"productsList.bulkEdit.section.attributeSet": "Attribute Set",
|
|
44
44
|
"productsList.bulkEdit.section.attributes": "Attribute values",
|
|
45
|
+
"productsList.bulkEdit.section.returnable": "Returnable",
|
|
46
|
+
"productsList.bulkEdit.returnable.yes": "Yes — returnable",
|
|
47
|
+
"productsList.bulkEdit.returnable.no": "No — not returnable",
|
|
48
|
+
"productsList.bulkEdit.returnable.hint": "Products are not returnable until you mark them — including every product that existed before the Returnable setting was introduced. Select the products buyers may send back and set them returnable here. Orders placed earlier keep the setting they were placed with.",
|
|
45
49
|
"productsList.bulkEdit.attributeSet.none": "— No attribute set —",
|
|
46
50
|
"productsList.bulkEdit.untouched": "(leave unchanged)",
|
|
47
51
|
"productsList.bulkEdit.mode.add": "Add",
|
|
@@ -327,6 +331,7 @@
|
|
|
327
331
|
"inventoryTab.stockMgmt.backorderGloballyDisabled": "Enable “Allow ordering below stock” in the Settings module (Inventory) first.",
|
|
328
332
|
"inventoryTab.stockMgmt.backorderUnmanaged": "Not applicable while stock management is disabled — any quantity is already allowed.",
|
|
329
333
|
"productEditor.loading": "Loading…",
|
|
334
|
+
"productEditor.tab.pricing": "Pricing",
|
|
330
335
|
"productEditor.scopeEditor.title": "Scope: Sales Channel + Language",
|
|
331
336
|
"productEditor.scopeEditor.help": "Preview how this product resolves per (channel, language) using the platform's resolver.",
|
|
332
337
|
"productEditor.scopeEditor.overridesCount": "{count} channel-aware override(s) in place.",
|
|
@@ -383,8 +388,6 @@
|
|
|
383
388
|
"productEditor.field.status.help": "Choose draft, active, or inactive. Inactive withdraws the product from merchandising without deleting it.",
|
|
384
389
|
"productEditor.action.delete": "Delete",
|
|
385
390
|
"productEditor.deleteConfirm": "Permanently delete this product from the catalog? This cannot be undone in the admin.",
|
|
386
|
-
"productEditor.field.defaultPrice": "Default unit price",
|
|
387
|
-
"productEditor.field.defaultPrice.help": "Price-list overrides take precedence at checkout.",
|
|
388
391
|
"productEditor.field.localizedName": "Name [{locale}]",
|
|
389
392
|
"productEditor.field.localizedDescription": "Description [{locale}]",
|
|
390
393
|
"productEditor.seo.title": "Per-locale SEO",
|
|
@@ -400,7 +403,6 @@
|
|
|
400
403
|
"productEditor.variants.deleteConfirm": "Delete variant \"{sku}\"?",
|
|
401
404
|
"productEditor.variants.column.sku": "SKU",
|
|
402
405
|
"productEditor.variants.column.attributes": "Attributes",
|
|
403
|
-
"productEditor.variants.column.priceOverride": "Price override",
|
|
404
406
|
"productEditor.variants.column.stock": "Stock",
|
|
405
407
|
"productEditor.variants.column.actions": "Actions",
|
|
406
408
|
"productEditor.variants.action.delete": "Delete",
|
|
@@ -409,7 +411,6 @@
|
|
|
409
411
|
"productEditor.variants.field.sku": "SKU",
|
|
410
412
|
"productEditor.variants.field.attributes": "Attributes",
|
|
411
413
|
"productEditor.variants.field.attributesPlaceholder": "color=red, size=M",
|
|
412
|
-
"productEditor.variants.field.priceOverride": "Price override",
|
|
413
414
|
"productEditor.variants.field.stock": "Stock",
|
|
414
415
|
"productEditor.gallery.title": "Gallery",
|
|
415
416
|
"productEditor.gallery.productImages.title": "Product images",
|
|
@@ -541,6 +542,7 @@
|
|
|
541
542
|
"errors.PRICE_RANGE_INVALID": "The minimum price must not exceed the maximum price.",
|
|
542
543
|
"errors.PRODUCT_NOT_FOUND": "Product Not Found.",
|
|
543
544
|
"errors.PRODUCT_ARCHIVED": "Product is inactive.",
|
|
545
|
+
"errors.PRODUCT_SAVED_VIEW_NAME_TAKEN": "You already have a saved view with this name on the product list. Choose a different name.",
|
|
544
546
|
"errors.PRODUCT_DELETE_BLOCKED": "This product cannot be deleted because it is still referenced.",
|
|
545
547
|
"errors.SKU_ALREADY_EXISTS": "Sku Already Exists.",
|
|
546
548
|
"errors.VARIANT_COMBINATION_EXISTS": "Variant Combination Exists.",
|
|
@@ -577,6 +579,9 @@
|
|
|
577
579
|
"errors.PRODUCT_NOT_IN_COMPARISON": "Product Not In Comparison.",
|
|
578
580
|
"errors.PRODUCT_UNMANAGED_STOCK": "Product Unmanaged Stock.",
|
|
579
581
|
"errors.SYSTEM_ATTRIBUTE_SET_IMMUTABLE": "This attribute set is part of the platform's own configuration. Its code is a stable integration key and cannot be changed, and the set itself cannot be deleted. Create your own attribute set and move the products onto it if you need a different one.",
|
|
582
|
+
"errors.PRODUCT_BELOW_MINIMUM_QUANTITY": "\"{productName}\" has a minimum order quantity of {minimum} pcs.",
|
|
583
|
+
"errors.PACKAGING_UNIT_BELOW_MINIMUM_QUANTITY": "\"{productName}\" must be ordered in at least {minimum} × {packagingUnitName}.",
|
|
584
|
+
"errors.PACKAGING_UNIT_MISMATCH": "The packaging unit on line {lineNumber} (\"{productName}\") does not match the product's packaging units.",
|
|
580
585
|
"auditLog.product.update": "Product updated",
|
|
581
586
|
"auditLog.attribute_set.create": "Attribute set created",
|
|
582
587
|
"auditLog.attribute_set.update": "Attribute set updated",
|
|
@@ -621,6 +626,25 @@
|
|
|
621
626
|
"packagingUnits.error.load": "Failed to load packaging units.",
|
|
622
627
|
"packagingUnits.error.save": "Save failed.",
|
|
623
628
|
"packagingUnits.error.invalid": "Enter a name and a whole number of pieces (at least 1).",
|
|
629
|
+
"packagingUnits.col.minOrderUnits": "Minimum (units)",
|
|
630
|
+
"packagingUnits.newMinimum": "Minimum (optional)",
|
|
631
|
+
"packagingUnits.minOrderUnitsHelp": "Minimum: the fewest of this unit a buyer may order at once. Leave it empty for no minimum.",
|
|
632
|
+
"packagingUnits.error.invalidMinimum": "The minimum must be a whole number from 1 to {max}, or empty for none.",
|
|
633
|
+
"orderRules.title": "Order rules",
|
|
634
|
+
"orderRules.loading": "Loading order rules…",
|
|
635
|
+
"orderRules.error.load": "Could not load the order rules. Reload the page to try again.",
|
|
636
|
+
"orderRules.error.save": "Could not save the order rules. Try again.",
|
|
637
|
+
"orderRules.saving": "Saving…",
|
|
638
|
+
"orderRules.saved": "Order rules saved.",
|
|
639
|
+
"orderRules.returnable.label": "Returnable",
|
|
640
|
+
"orderRules.returnable.help": "Buyers can include this product in a return. Products are not returnable until marked; to mark many at once, select them on the product list and use Bulk edit → Returnable.",
|
|
641
|
+
"orderRules.minimum.label": "Minimum order quantity (pcs)",
|
|
642
|
+
"orderRules.minimum.help": "The fewest pieces a buyer may order in one order. Leave it empty for no minimum.",
|
|
643
|
+
"orderRules.minimum.placeholder": "No minimum",
|
|
644
|
+
"orderRules.minimum.invalid": "Enter a whole number from 1 to {max}, or leave the field empty.",
|
|
645
|
+
"orderRules.minimum.save": "Save minimum",
|
|
646
|
+
"orderRules.minimum.clear": "Remove minimum",
|
|
647
|
+
"orderRules.minimum.notApplicable": "A minimum order quantity applies to simple and configurable products only.",
|
|
624
648
|
"bulkOperations.undo.action": "Undo",
|
|
625
649
|
"bulkOperations.undo.running": "Undoing…",
|
|
626
650
|
"bulkOperations.undo.confirm": "Undo this bulk edit and restore {count} product(s) to their previous values?",
|
|
@@ -661,5 +685,17 @@
|
|
|
661
685
|
"blocks.emailCategoryGrid.label": "Category grid",
|
|
662
686
|
"blocks.emailCategoryGrid.description": "A grid of catalog categories, rendered for e-mail.",
|
|
663
687
|
"blocks.category.catalog": "Catalog",
|
|
664
|
-
"blocks.category.content": "Content"
|
|
688
|
+
"blocks.category.content": "Content",
|
|
689
|
+
"adminSearch.product.group.label": "Products",
|
|
690
|
+
"adminSearch.product.field.sku": "SKU",
|
|
691
|
+
"adminSearch.product.field.name": "Name",
|
|
692
|
+
"adminSearch.product.field.slug": "URL key (slug)",
|
|
693
|
+
"adminSearch.product.field.quickSearchAttributes": "Quick-search attributes",
|
|
694
|
+
"adminSearch.product.status.draft": "Draft",
|
|
695
|
+
"adminSearch.product.status.active": "Active",
|
|
696
|
+
"adminSearch.product.status.inactive": "Inactive",
|
|
697
|
+
"adminSearch.category.group.label": "Categories",
|
|
698
|
+
"adminSearch.category.field.name": "Name",
|
|
699
|
+
"adminSearch.category.field.slug": "URL key (slug)",
|
|
700
|
+
"errors.PRICE_SET_IN_PRICE_BOOKS": "Prices are set in price books, not on the product."
|
|
665
701
|
}
|
package/i18n/pl.json
CHANGED
|
@@ -42,6 +42,10 @@
|
|
|
42
42
|
"productsList.bulkEdit.section.categories": "Kategorie",
|
|
43
43
|
"productsList.bulkEdit.section.attributeSet": "Zestaw atrybutów",
|
|
44
44
|
"productsList.bulkEdit.section.attributes": "Wartości atrybutów",
|
|
45
|
+
"productsList.bulkEdit.section.returnable": "Podlega zwrotowi",
|
|
46
|
+
"productsList.bulkEdit.returnable.yes": "Tak — podlega zwrotowi",
|
|
47
|
+
"productsList.bulkEdit.returnable.no": "Nie — nie podlega zwrotowi",
|
|
48
|
+
"productsList.bulkEdit.returnable.hint": "Produkty nie podlegają zwrotowi, dopóki ich nie oznaczysz — dotyczy to także wszystkich produktów istniejących przed wprowadzeniem tego ustawienia. Zaznacz produkty, które kupujący mogą odesłać, i oznacz je tutaj jako podlegające zwrotowi. Zamówienia złożone wcześniej zachowują ustawienie z chwili złożenia.",
|
|
45
49
|
"productsList.bulkEdit.attributeSet.none": "— Brak zestawu atrybutów —",
|
|
46
50
|
"productsList.bulkEdit.untouched": "(pozostaw bez zmian)",
|
|
47
51
|
"productsList.bulkEdit.mode.add": "Dodaj",
|
|
@@ -327,6 +331,7 @@
|
|
|
327
331
|
"inventoryTab.stockMgmt.backorderGloballyDisabled": "Najpierw włącz „Zezwól na zamawianie poniżej stanu” w module Settings (Magazyn).",
|
|
328
332
|
"inventoryTab.stockMgmt.backorderUnmanaged": "Nie dotyczy, gdy zarządzanie stanem jest wyłączone — dowolna ilość jest już dozwolona.",
|
|
329
333
|
"productEditor.loading": "Wczytywanie…",
|
|
334
|
+
"productEditor.tab.pricing": "Ceny",
|
|
330
335
|
"productEditor.scopeEditor.title": "Kontekst: Kanał sprzedaży + Język",
|
|
331
336
|
"productEditor.scopeEditor.help": "Podgląd jak ten produkt jest rozstrzygany dla danej pary (kanał, język) przez resolver platformy.",
|
|
332
337
|
"productEditor.scopeEditor.overridesCount": "{count} nadpis(ań|anie) zależnych od kanału.",
|
|
@@ -383,8 +388,6 @@
|
|
|
383
388
|
"productEditor.field.status.help": "Wybierz szkic, aktywny lub nieaktywny. Nieaktywny wycofuje produkt z oferty bez usuwania go z katalogu.",
|
|
384
389
|
"productEditor.action.delete": "Usuń",
|
|
385
390
|
"productEditor.deleteConfirm": "Trwale usunąć ten produkt z katalogu? W panelu admin nie będzie można tego cofnąć.",
|
|
386
|
-
"productEditor.field.defaultPrice": "Domyślna cena jednostkowa",
|
|
387
|
-
"productEditor.field.defaultPrice.help": "Nadpisania z cenników mają pierwszeństwo przy kasie.",
|
|
388
391
|
"productEditor.field.localizedName": "Nazwa [{locale}]",
|
|
389
392
|
"productEditor.field.localizedDescription": "Opis [{locale}]",
|
|
390
393
|
"productEditor.seo.title": "SEO per locale",
|
|
@@ -400,7 +403,6 @@
|
|
|
400
403
|
"productEditor.variants.deleteConfirm": "Usunąć wariant „{sku}”?",
|
|
401
404
|
"productEditor.variants.column.sku": "SKU",
|
|
402
405
|
"productEditor.variants.column.attributes": "Atrybuty",
|
|
403
|
-
"productEditor.variants.column.priceOverride": "Nadpisanie ceny",
|
|
404
406
|
"productEditor.variants.column.stock": "Stan",
|
|
405
407
|
"productEditor.variants.column.actions": "Akcje",
|
|
406
408
|
"productEditor.variants.action.delete": "Usuń",
|
|
@@ -409,7 +411,6 @@
|
|
|
409
411
|
"productEditor.variants.field.sku": "SKU",
|
|
410
412
|
"productEditor.variants.field.attributes": "Atrybuty",
|
|
411
413
|
"productEditor.variants.field.attributesPlaceholder": "color=red, size=M",
|
|
412
|
-
"productEditor.variants.field.priceOverride": "Nadpisanie ceny",
|
|
413
414
|
"productEditor.variants.field.stock": "Stan",
|
|
414
415
|
"productEditor.gallery.title": "Galeria",
|
|
415
416
|
"productEditor.gallery.productImages.title": "Zdjęcia produktu",
|
|
@@ -541,6 +542,7 @@
|
|
|
541
542
|
"errors.PRICE_RANGE_INVALID": "Cena minimalna nie może być wyższa niż maksymalna.",
|
|
542
543
|
"errors.PRODUCT_NOT_FOUND": "Błąd: product not found.",
|
|
543
544
|
"errors.PRODUCT_ARCHIVED": "Produkt jest nieaktywny.",
|
|
545
|
+
"errors.PRODUCT_SAVED_VIEW_NAME_TAKEN": "Masz już zapisany widok o tej nazwie na liście produktów. Wybierz inną nazwę.",
|
|
544
546
|
"errors.PRODUCT_DELETE_BLOCKED": "Nie można usunąć produktu — jest nadal powiązany z innymi rekordami.",
|
|
545
547
|
"errors.SKU_ALREADY_EXISTS": "Błąd: sku already exists.",
|
|
546
548
|
"errors.VARIANT_COMBINATION_EXISTS": "Błąd: variant combination exists.",
|
|
@@ -577,6 +579,9 @@
|
|
|
577
579
|
"errors.PRODUCT_NOT_IN_COMPARISON": "Błąd: product not in comparison.",
|
|
578
580
|
"errors.PRODUCT_UNMANAGED_STOCK": "Błąd: product unmanaged stock.",
|
|
579
581
|
"errors.SYSTEM_ATTRIBUTE_SET_IMMUTABLE": "Ten zestaw atrybutów należy do konfiguracji samej platformy. Jego kod jest stałym kluczem integracyjnym i nie można go zmienić, a samego zestawu nie można usunąć. Jeśli potrzebujesz innego, utwórz własny zestaw atrybutów i przenieś na niego produkty.",
|
|
582
|
+
"errors.PRODUCT_BELOW_MINIMUM_QUANTITY": "Minimalna ilość zamówienia produktu „{productName}” to {minimum} szt.",
|
|
583
|
+
"errors.PACKAGING_UNIT_BELOW_MINIMUM_QUANTITY": "Produkt „{productName}” należy zamówić w ilości co najmniej {minimum} × {packagingUnitName}.",
|
|
584
|
+
"errors.PACKAGING_UNIT_MISMATCH": "Jednostka opakowania w pozycji {lineNumber} („{productName}”) nie odpowiada jednostkom opakowania produktu.",
|
|
580
585
|
"auditLog.product.update": "Zaktualizowano produkt",
|
|
581
586
|
"auditLog.attribute_set.create": "Utworzono zestaw atrybutów",
|
|
582
587
|
"auditLog.attribute_set.update": "Zaktualizowano zestaw atrybutów",
|
|
@@ -621,6 +626,25 @@
|
|
|
621
626
|
"packagingUnits.error.load": "Nie udało się wczytać jednostek opakowaniowych.",
|
|
622
627
|
"packagingUnits.error.save": "Zapis nie powiódł się.",
|
|
623
628
|
"packagingUnits.error.invalid": "Podaj nazwę i całkowitą liczbę sztuk (co najmniej 1).",
|
|
629
|
+
"packagingUnits.col.minOrderUnits": "Minimum (w jednostkach)",
|
|
630
|
+
"packagingUnits.newMinimum": "Minimum (opcjonalnie)",
|
|
631
|
+
"packagingUnits.minOrderUnitsHelp": "Minimum: najmniejsza liczba tej jednostki, jaką kupujący może zamówić naraz. Zostaw puste, aby nie ustawiać minimum.",
|
|
632
|
+
"packagingUnits.error.invalidMinimum": "Minimum musi być liczbą całkowitą od 1 do {max} albo pozostać puste.",
|
|
633
|
+
"orderRules.title": "Zasady zamawiania",
|
|
634
|
+
"orderRules.loading": "Wczytywanie zasad zamawiania…",
|
|
635
|
+
"orderRules.error.load": "Nie udało się wczytać zasad zamawiania. Odśwież stronę, aby spróbować ponownie.",
|
|
636
|
+
"orderRules.error.save": "Nie udało się zapisać zasad zamawiania. Spróbuj ponownie.",
|
|
637
|
+
"orderRules.saving": "Zapisywanie…",
|
|
638
|
+
"orderRules.saved": "Zapisano zasady zamawiania.",
|
|
639
|
+
"orderRules.returnable.label": "Podlega zwrotowi",
|
|
640
|
+
"orderRules.returnable.help": "Kupujący mogą zgłosić ten produkt do zwrotu. Produkty nie podlegają zwrotowi, dopóki ich nie oznaczysz; aby oznaczyć wiele naraz, zaznacz je na liście produktów i użyj Edycji masowej → Podlega zwrotowi.",
|
|
641
|
+
"orderRules.minimum.label": "Minimalna ilość zamówienia (szt.)",
|
|
642
|
+
"orderRules.minimum.help": "Najmniejsza liczba sztuk, jaką kupujący może zamówić w jednym zamówieniu. Zostaw puste, aby nie ustawiać minimum.",
|
|
643
|
+
"orderRules.minimum.placeholder": "Brak minimum",
|
|
644
|
+
"orderRules.minimum.invalid": "Wpisz liczbę całkowitą od 1 do {max} albo zostaw pole puste.",
|
|
645
|
+
"orderRules.minimum.save": "Zapisz minimum",
|
|
646
|
+
"orderRules.minimum.clear": "Usuń minimum",
|
|
647
|
+
"orderRules.minimum.notApplicable": "Minimalna ilość zamówienia dotyczy tylko produktów prostych i konfigurowalnych.",
|
|
624
648
|
"bulkOperations.undo.action": "Cofnij",
|
|
625
649
|
"bulkOperations.undo.running": "Cofanie…",
|
|
626
650
|
"bulkOperations.undo.confirm": "Cofnąć tę edycję masową i przywrócić {count} produkt(ów) do poprzednich wartości?",
|
|
@@ -661,5 +685,17 @@
|
|
|
661
685
|
"blocks.emailCategoryGrid.label": "Siatka kategorii",
|
|
662
686
|
"blocks.emailCategoryGrid.description": "Siatka kategorii katalogu renderowana na potrzeby e-maila.",
|
|
663
687
|
"blocks.category.catalog": "Katalog",
|
|
664
|
-
"blocks.category.content": "Treść"
|
|
688
|
+
"blocks.category.content": "Treść",
|
|
689
|
+
"adminSearch.product.group.label": "Produkty",
|
|
690
|
+
"adminSearch.product.field.sku": "SKU",
|
|
691
|
+
"adminSearch.product.field.name": "Nazwa",
|
|
692
|
+
"adminSearch.product.field.slug": "Klucz URL (slug)",
|
|
693
|
+
"adminSearch.product.field.quickSearchAttributes": "Atrybuty szybkiego wyszukiwania",
|
|
694
|
+
"adminSearch.product.status.draft": "Roboczy",
|
|
695
|
+
"adminSearch.product.status.active": "Aktywny",
|
|
696
|
+
"adminSearch.product.status.inactive": "Nieaktywny",
|
|
697
|
+
"adminSearch.category.group.label": "Kategorie",
|
|
698
|
+
"adminSearch.category.field.name": "Nazwa",
|
|
699
|
+
"adminSearch.category.field.slug": "Klucz URL (slug)",
|
|
700
|
+
"errors.PRICE_SET_IN_PRICE_BOOKS": "Ceny ustala się w cennikach, a nie w produkcie."
|
|
665
701
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@endora-commerce/mod-catalog",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.108.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"sideEffects": false,
|
|
6
6
|
"description": "Products, variants, categories, attributes, attribute sets, gallery, attachments, links, and bundles.",
|
|
@@ -61,10 +61,10 @@
|
|
|
61
61
|
"react": "^19",
|
|
62
62
|
"react-router-dom": "^7",
|
|
63
63
|
"zod": "^4",
|
|
64
|
-
"@endora-commerce/admin-kit": "0.
|
|
65
|
-
"@endora-commerce/contracts": "0.
|
|
66
|
-
"@endora-commerce/mod-custom-fields": "0.
|
|
67
|
-
"@endora-commerce/platform": "0.
|
|
64
|
+
"@endora-commerce/admin-kit": "0.108.0",
|
|
65
|
+
"@endora-commerce/contracts": "0.108.0",
|
|
66
|
+
"@endora-commerce/mod-custom-fields": "0.108.0",
|
|
67
|
+
"@endora-commerce/platform": "0.108.0"
|
|
68
68
|
},
|
|
69
69
|
"peerDependenciesMeta": {
|
|
70
70
|
"@endora-commerce/admin-kit": {
|
|
@@ -95,10 +95,10 @@
|
|
|
95
95
|
"typescript": "^5.9.3",
|
|
96
96
|
"vitest": "^4.1.11",
|
|
97
97
|
"zod": "^4.2.0",
|
|
98
|
-
"@endora-commerce/admin-kit": "0.
|
|
99
|
-
"@endora-commerce/contracts": "0.
|
|
100
|
-
"@endora-commerce/mod-custom-fields": "0.
|
|
101
|
-
"@endora-commerce/platform": "0.
|
|
98
|
+
"@endora-commerce/admin-kit": "0.108.0",
|
|
99
|
+
"@endora-commerce/contracts": "0.108.0",
|
|
100
|
+
"@endora-commerce/mod-custom-fields": "0.108.0",
|
|
101
|
+
"@endora-commerce/platform": "0.108.0"
|
|
102
102
|
},
|
|
103
103
|
"scripts": {
|
|
104
104
|
"build": "tsc -p tsconfig.build.json && tsc -p tsconfig.ui.json",
|