Files
vmall/docs/code_index/mall.md
T
james 9904696e76 feat: wave 2 migration (P3, P5, P7 openspec changes)
Implements, verifies, and archives the three remaining Wave 2 changes from
openspec/MIGRATION-PLAN.md.

- add-wallet-settlement (P3): demo recharge, guarded withdrawal freeze and
  one-time admin review, paginated own fund entries, idempotent per-shop
  weekly/monthly settlement statements with commission rate and one-time
  payout confirmation.
- add-merchant-onboarding (P5): personal/enterprise applications with one live
  application per user, guarded review with mandatory rejection reason, and
  transactional shop + owner provisioning returning one-time credentials;
  mall onboarding/status pages and an admin review console.
- add-membership-messaging (P7): platform member levels, append-only growth
  accrual on order completion with guarded one-way leveling, order/shipment/
  refund system messages with unread/read state and soft deletion, plus the
  mall header unread badge.

Backend: migrations 0019-0023, new wallet, settlement, merchant_onboarding,
membership and messaging modules, event hooks in order/fulfillment/aftersale,
and integration suites for each. Shared contract extended and all three
frontends updated; code indexes, domain docs, backend guidelines and the
migration tracker synced.

Verification: cargo test -p vmall-api green twice consecutively; mall, admin
and shop-admin builds pass; browser smoke on every new surface; openspec
validate --all --strict green (33 passed).

The three changes share the @vmall/shared contract, the mall mock adapter and
per-app locale/nav files, so they are committed together to keep every commit
buildable.
2026-09-25 15:25:29 +00:00

2.2 KiB

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)
pages/seckill.vue, collective.vue, integral.vue flash sale, group buying, points mall
app.vue + components/shell/* header/footer shell; SiteHeader.vue carries the unread-message badge
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.