vmall/openspec/changes/archive/2026-09-17-catalog-i18n-currency/proposal.md

Proposal: catalog-i18n-currency

Why

Merchants must manage products (create, edit, publish/unpublish) and shoppers must browse a localized, multi-currency storefront. This phase delivers the catalog core plus the currency infrastructure every price display depends on.

What changes

• Schema: categories, products (JSONB i18n name/description), skus (price minor units + currency + stock), currencies (rate_to_base).
• Public APIs: product list (paged, filter by category/q/shop), product detail by id/slug, category list, currency list + conversion endpoint.
• Shop-admin APIs: product CRUD, SKU upsert, publish/unpublish transitions.
• Seed: base currency USD, plus CNY/EUR/JPY; demo categories.

Non-goals

• Inventory reservations/warehouses, product variants matrix UI, image upload (URLs only).
• Full-text search engines; ILIKE search is sufficient for MVP.

Capabilities

• catalog: categories, products, SKUs, publish lifecycle.
• currency: currency registry and conversion.