Files
vmall/docs/code_index/mall.md
T
Chengdong ZhangandCursor d121ac7e73 feat(mall): show a reconciled price breakdown for configured services
Option labels and right-aligned amounts now add up through the monthly subtotal, term, and discount to the total on the product page and direct checkout.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-11-18 16:52:27 +08:00

34 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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/<domain>.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 `<NuxtLayout>`; 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.