vmall/openspec/changes/archive/2026-09-17-frontend-apps/proposal.md

Proposal: frontend-apps

Why

The API needs its three user-facing surfaces: customer storefront (mall), merchant console (shop-admin), and platform console (admin) — all Nuxt 3, all bilingual (en/zh), with the mall offering multi-currency display.

What changes

• Shared package @vmall/shared: API contract types, typed API client, en/zh locales, base stylesheet.
• mall (port 3000): product browsing w/ search+category, product detail, cart, checkout, orders, shipments, invoices, login/register, currency switcher (display conversion).
• shop-admin (3001): dashboard, product CRUD + publish/unpublish + SKU editing, order list, shipment creation/ship, invoice issue.
• admin (3002): user role assignment, shop creation/suspension, order oversight, currency management (rates).

Non-goals

• SSR SEO tuning, design-system polish beyond the shared stylesheet, e2e test suites (smoke-verified in browser).

Capabilities

• frontend-mall: shopper experience.
• frontend-shop-admin: merchant experience.
• frontend-admin: platform operator experience.