# Index: Mall storefront app (`apps/mall`) Guidelines: `docs/frontend-guidelines.md`. | Path | Holds | |---|---| | `plugins/api.ts` | `$api` composition: mock base + per-domain live picks (`LiveDomain`, `LIVE_PICKS`, `DEFAULT_LIVE_DOMAINS`) | | `mock/api.ts` | deterministic fixed-data adapter; versioned persisted state (`STORAGE_KEY`) | | `mock/data.ts` | seed fixtures for the mock adapter | | `nuxt.config.ts` | `liveDomains` runtime default (JSON array env `NUXT_PUBLIC_LIVE_DOMAINS` overrides) | | `pages/index.vue` | home: banners/promos/quick links/category floors | | `pages/search.vue`, `pages/goods/[id].vue` | catalog browsing; goods detail has reviews tab | | `pages/cart.vue`, `pages/checkout/*` | cart and checkout (address → quote → submit → pay → success) | | `pages/stores/*` | store directory + store detail | | `pages/user/*` | buyer center: orders, aftersales, reviews, coupons, addresses, invoices, favorites, wallet | | `pages/user/wallet.vue` | wallet balances, paginated ledger entries, demo recharge, withdrawal request/history | | `pages/user/membership.vue` | level/benefits, growth total, progress to the next threshold, growth history | | `pages/user/messages.vue` | system message center: unread filter, mark read, mark-all-read, soft delete | | `pages/merchant/join.vue` | 商家入驻 multi-step application form (anonymous fill, sign-in gate, draft return) | | `pages/merchant/status.vue` | applicant's own application status, rejection reason, re-apply | | `locales/.ts` + `locales-extra.ts` | app-local bilingual strings deep-merged over the shared locales (mall namespaces: shell/home/search/product/cart/checkout/auth/user/stores/marketing/wallet/merchant/membership/messaging/services) | | `pages/seckill.vue`, `collective.vue`, `integral.vue` | flash sale, group buying, points mall | | `app.vue` + `layouts/default.vue` + `components/shell/*` | `app.vue` only mounts ``; the store header/footer shell lives in `layouts/default.vue`; `SiteHeader.vue` carries the unread-message badge | | `pages/chatty/index.vue` + `layouts/chatty.vue` + `components/chatty/*` | Chatty product landing (`/chatty`): hero, capabilities, SaaS vs independent comparison, pricing cards, enquiry form, FAQ; own header/footer | | `pages/chatty/buy.vue` + `middleware/chatty-buyer.ts` | plan option picker (term / users / storage, kept in the URL) → cart → existing `/checkout`; signed-out buyers go to `/register?redirect=…` | | `config/chatty.ts` | Chatty plan definitions (catalog slugs, SKU attribute names, provisional examples), capabilities, FAQ, enquiry options | | `composables/useChattyPlans.ts` | resolves each plan's option SKUs from the `chatty` shop, plus option picking helpers; plans with no options stay provisional (not purchasable) | | `locales/chatty.ts` | `chatty.*` en/zh strings | | `components/QuoteBreakdown.vue` | configured-price breakdown (option-group labels, right-aligned monthly amounts, monthly subtotal × term, discount, total) used on the product page and direct checkout | | `composables/` | session/cart stores, `usePrice` (currency conversion display), `useUnreadMessages` (header badge count) | Remember: mall is the only app with a mock adapter; every new live domain needs mock parity so `NUXT_PUBLIC_LIVE_DOMAINS` rollback keeps working.