docs / familias / cat

cat — Product catalogue entries

Catalogue rows with price, currency, stock, tags and optional rating.

Dominio
e-commerce
Versión
1
Padre
— (raíz)
Clave de registros
products
Separador de lista
,
Archivo
forks/cat/contract.json

Campos por posición

#TipoDescripciónParte
skustr (unique: True)núcleo
namestrnúcleo
categorystrnúcleo
pricefloatnúcleo
currencyenum (valores: USD, PEN, EUR)núcleo
stockintnúcleo
tagslist (max: 10)núcleo
ratingfloat (max: 5 · optional: True)núcleo

Ejemplo válido

cat|n=12|d=20260603|store=campus-shop|cur=USD
SKU-1001|Wireless headset|audio|89.9|USD|120|bluetooth,noise-cancelling|4.5
SKU-1002|USB-C hub 7-in-1|accessories|39.99|USD|300|usb-c,hdmi|4.2
SKU-1003|Mechanical keyboard|input|129|USD|45|mechanical,rgb,wired|4.7
SKU-1004|27" 4K monitor|display|349|USD|18|4k,ips|4.6
SKU-1005|Laptop stand|accessories|25.5|USD|500|aluminium|4.1
SKU-1006|Webcam 1080p|video|59|USD|80|1080p,autofocus|3.9
SKU-1007|Micrófono condensador|audio|249|PEN|22|usb,cardioide|4.4
SKU-1008|Mouse ergonómico|input|119|PEN|64|ergonómico,inalámbrico|4.3
SKU-1009|SSD NVMe 1 TB|storage|99|USD|150|nvme,pcie4|4.8
SKU-1010|Router Wi-Fi 6|network|79|USD|33|wifi6,mesh|4
SKU-1011|Cable HDMI 2.1 2 m|accessories|15.9|USD|900|hdmi,8k|
SKU-1012|Silla de oficina|furniture|899|PEN|7|ergonómica,malla|4.2

Cárgalo en el playground o valida con mini validate forks/cat/fixtures/valid.mini.

Notas de la familia

.mini-cat — Product catalogue entries#

Prefix: cat Version: 1 Parent:Domain: e-commerce

Catalogue rows with price, currency, stock, tags and optional rating.

Record layout#

sku:str | name:str | category:str | price:float[0..] | currency:enum{USD|PEN|EUR} | stock:int[0..] | tags:list<str>[0..10] | rating:float[0..5]?
# field type notes
1 sku str core
2 name str core
3 category str core
4 price float[0..] core
5 currency enum{USD|PEN|EUR} core
6 stock int[0..] core
7 tags list<str>[0..10] core
8 rating float[0..5]? core; optional

Header keys#

key type required description
d str no generation date YYYYMMDD
store str no
cur str no default currency
n int yes number of records
v int no contract version

Example#

cat|n=12|d=20260603|store=campus-shop|cur=USD
SKU-1001|Wireless headset|audio|89.9|USD|120|bluetooth,noise-cancelling|4.5
SKU-1002|USB-C hub 7-in-1|accessories|39.99|USD|300|usb-c,hdmi|4.2
…

Fixtures#

fixtures/valid.minifixtures/canonical.json (round-trip), fixtures/escaping.minifixtures/escaping.json, and the negative cases bad_count.mini, bad_arity.mini, bad_type.mini.

Prompt block#

Generate the transferable specification with mini prompt cat.