@core / catalog

1.0.0 ▾

1.0.0

인증됨MIT

GitHub

상품 카탈로그: 옵션 변형, 최소 단위 가격, 카테고리, 컬렉션, 번역, 안전한 재고 예약

코드파일 8개컨텍스트약 576토큰검사 통과

설치

$genpm add @core/catalog

포함 내용

src/lib/catalog/에 소스 코드, 파일 8개. (38.6kB)
src/lib/catalog/AGENTS.md에 AI 규칙, 그리고 IDE 규칙 파일.
.env.example에 추가되는 환경 변수: STORE_CURRENCY.
@core/contracts, @core/db, @core/money, @core/rich-text을(를) 자동으로 해결합니다.

README

이 패키지에는 README가 없습니다.

약 576토큰→ src/lib/catalog/AGENTS.md→ .cursor/rules/genpm-core-catalog.mdc

이것이 AI가 src/lib/catalog에서 작업할 때 읽는 내용 그대로입니다. 그 외에는 컨텍스트에 아무것도 추가되지 않습니다.

@core/catalog — rules for AI agents

Purpose

Products for a store: up to 3 options (Size, Color…) and their variants with SKU, price/compare-at/cost in minor units, stock with backorder rules, weight and image; categories (tree), manual ordered collections, tags, attributes, per-locale translations, media references (@core/media ids), sitemap/search sources and admin resources. reserveStock locks the variant row so two buyers can't get the last unit. No cart, prices rules or multi-warehouse.

Map

index.ts — public API: createProduct, updateProduct, getProduct, listProducts, reserveStock, releaseStock, upsertCategory, setCollection, categoryTree, lowStockVariants, catalogAdminResources.
products.ts — products, variants, listing, stock. taxonomy.ts — categories and collections.
sources.ts — productSitemapSource, productSearchSource. admin.ts — admin resources. schema.ts — tables.

Integration

Env: STORE_CURRENCY (ISO code, default EUR). Migrations as in src/lib/db/AGENTS.md.
Product page: const p = await getProduct(slug, { locale }) (404 when null); show p.variants with format(v.price, locale) (@core/money) and v.availability; render p.description with @core/rich-text.
Listing: listProducts({ category, tag, collection, sort, page, minPrice, maxPrice, inStock }).
Register productSitemapSource() (seo), productSearchSource() (search) and ...catalogAdminResources() (admin).
JSON-LD with jsonLd.product (@core/seo) using availability and the real price.
Verify: create a product with two variants in the admin and see it at /products/<slug>.

Conventions

Prices are integers in STORE_CURRENCY; the server price is the only valid price (carts recompute it).
Reserve stock only inside the order transaction (reserveStock(id, qty, tx)); release it on cancel/expiry.
Archive products instead of deleting them: orders keep references to their variants.
Permissions: products:read|create|update|delete.

Don't

Don't show a compare-at price that isn't real (the EU requires the lowest price of the last 30 days for discounts).
Don't decrement stock with plain updates outside reserveStock/releaseStock.
Don't expose costAmount in public pages or APIs.

# @core/catalog — rules for AI agents

## Purpose
Products for a store: up to 3 options (Size, Color…) and their variants with SKU, price/compare-at/cost in minor
units, stock with backorder rules, weight and image; categories (tree), manual ordered collections, tags, attributes,
per-locale translations, media references (@core/media ids), sitemap/search sources and admin resources.
`reserveStock` locks the variant row so two buyers can't get the last unit. No cart, prices rules or multi-warehouse.

## Map
- `index.ts` — public API: `createProduct`, `updateProduct`, `getProduct`, `listProducts`, `reserveStock`, `releaseStock`, `upsertCategory`, `setCollection`, `categoryTree`, `lowStockVariants`, `catalogAdminResources`.
- `products.ts` — products, variants, listing, stock. `taxonomy.ts` — categories and collections.
- `sources.ts` — `productSitemapSource`, `productSearchSource`. `admin.ts` — admin resources. `schema.ts` — tables.

## Integration
1. Env: `STORE_CURRENCY` (ISO code, default `EUR`). Migrations as in `src/lib/db/AGENTS.md`.
2. Product page: `const p = await getProduct(slug, { locale })` (404 when null); show `p.variants` with
   `format(v.price, locale)` (@core/money) and `v.availability`; render `p.description` with @core/rich-text.
3. Listing: `listProducts({ category, tag, collection, sort, page, minPrice, maxPrice, inStock })`.
4. Register `productSitemapSource()` (seo), `productSearchSource()` (search) and `...catalogAdminResources()` (admin).
5. JSON-LD with `jsonLd.product` (@core/seo) using `availability` and the real price.
6. Verify: create a product with two variants in the admin and see it at `/products/<slug>`.

## Conventions
- Prices are integers in `STORE_CURRENCY`; the server price is the only valid price (carts recompute it).
- Reserve stock only inside the order transaction (`reserveStock(id, qty, tx)`); release it on cancel/expiry.
- Archive products instead of deleting them: orders keep references to their variants.
- Permissions: `products:read|create|update|delete`.

## Don't
- Don't show a compare-at price that isn't real (the EU requires the lowest price of the last 30 days for discounts).
- Don't decrement `stock` with plain updates outside `reserveStock`/`releaseStock`.
- Don't expose `costAmount` in public pages or APIs.