Przejdź do głównej zawartości

Zestawy atrybutów

Zestawy atrybutów grupują definicje ProductAttribute w schematy wielokrotnego użytku. Każdy produkt jest przypisany do dokładnie jednego zestawu; system dostarcza zestaw default, używany, gdy administrator nie wybierze innego.

Po co są​

Bez zestawów każdy produkt miałby w attributeValues pełny zestaw atrybutów. Różne rodzaje produktów (elektronika, odzież, chemia) potrzebują różnych atrybutów, a podstawowy schemat traktował każdy klucz jako globalny. Zestawy pozwalają administratorom przygotować dla każdej kategorii formularz z tylko potrzebnymi polami, a storefrontowi — wyświetlić krótszą tabelę atrybutów.

API publiczne​

Metoda i ścieżkaKtoPrzeznaczenie
GET /api/v1/admin/catalog/attribute-setsadministratorLista wszystkich zestawów, łącznie z default
GET /api/v1/admin/catalog/attribute-sets/:idadministratorSzczegóły zestawu z przypisanymi atrybutami
POST /api/v1/admin/catalog/attribute-setsadministratorUtworzenie własnego zestawu (code w snake_case, unikalny)
PATCH /api/v1/admin/catalog/attribute-sets/:idadministratorZmiana nazwy; systemowego zestawu Default nie można zmieniać
DELETE /api/v1/admin/catalog/attribute-sets/:idadministratorUsunięcie; odrzucane z 409, gdy zestawu używa jakikolwiek produkt
POST /api/v1/admin/catalog/attribute-sets/:id/attributesadministratorPrzypisanie atrybutów do zestawu
DELETE /api/v1/admin/catalog/attribute-sets/:id/attributes/:keyadministratorOdłączenie atrybutu

Treść żądania tworzenia i aktualizacji produktu przyjmuje attributeSetId. Gdy go nie podano, używany jest systemowy zestaw Default.

Błędy​

KodStatusKiedy
ATTRIBUTE_SET_CODE_TAKEN409code już istnieje
ATTRIBUTE_SET_IN_USE409Usunięcie zablokowane: zestawu używa co najmniej jeden produkt
SYSTEM_ATTRIBUTE_SET_IMMUTABLE409Próba zmiany zestawu Default utworzonego przy instalacji
ATTRIBUTE_VALUES_REQUIRED400Zapis produktu zostawia bez wartości atrybuty wymagane przez zestaw (details.attributeKeys, połączone)
ATTRIBUTE_SET_NOT_FOUND404Brak :id
ATTRIBUTE_NOT_FOUND404Brak :key przy przypisaniu

Storefront​

productDetail.attributeSet zawiera {id, code, name}, aby motywy mogły wyświetlić nazwę zestawu nad tabelą atrybutów. Motyw wzorcowy wyświetla przetłumaczoną nazwę zestawu jako niewielki podtytuł.

Przechowywanie​

attribute_sets (id, unikalny code, name jsonb, is_system bool) i attribute_set_attributes (złożony klucz główny (set_id, attribute_id)). Systemowy wiersz Default tworzy migracja 20260429T064146_catalog_attribute_sets_init.ts ze stałym UUID defa0017-0000-4000-8000-000000000000, aby dane początkowe i testy mogły się do niego niezmiennie odwoływać.

Dziennik audytu​

Każda zmiana zestawu atrybutów zapisuje jeden AuditLogEntry ze stateBefore i stateAfter, aby strona audytu pokazywała, kto co zmienił.