Files
vmall/docs/code_index/shared.md
T
Chengdong ZhangandCursor a46148adcf Add Chatty landing page with SaaS plan option selection
- /chatty landing with catalog-backed SaaS plans and an independent
  deployment enquiry form (sales_enquiries table, rate-limited
  POST /api/enquiries, admin review page)
- /chatty/buy lets buyers pick term, users and storage from the plan's
  catalog SKUs (plan/term_months/users/storage_gb attributes); the
  selection is kept in the URL and only the chosen SKU goes to the cart
- Recognise Chatty orders by shop on payment and success pages
- Clear the checkout idempotency key after success or a 409
- Demo seed grid of option SKUs, docs and OpenSpec specs

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-30 16:19:55 +08:00

29 lines
1.3 KiB
Markdown

# Index: Shared contract & UI
The single API contract. Every frontend change starts here when an endpoint
is added or a payload shape changes.
## packages/shared
| File | Holds |
|---|---|
| `src/types.ts` | every DTO shared across API and frontends (money as `number` minor units, `{en, zh}` as `LocalizedText`); includes `SalesEnquiry*` enquiry types |
| `src/api.ts` | `ApiClient` interface + `createApi()` live client; input-body types (`ProductUpsertBody`, `SkuUpsertBody`, …) |
| `src/locales/en.ts`, `zh.ts` | shared copy; app-specific keys go to the app's `locales-extra.ts`, never here from app work |
| `src/theme.css` | Tailwind v4 `@theme` tokens + `html[data-accent]` presets |
| `src/money.ts` | `formatMoney(minor, code, exponent, locale)` |
## packages/ui
`src/components/`: `VBtn`, `VBadge`, `VCard`, `VField`, `VInput`, `VPage`,
`VPanel`, `VTable`, `VAccentSwatch`; `useAccent()`. Auto-registered as a Nuxt
module in all three apps.
## Rules of engagement
- Adding an API method: declare in the interface, implement in `createApi`,
implement the mock in `apps/mall/mock/api.ts` (mall-facing) or
`unsupported()` (console-only), and add exact picks to
`apps/mall/plugins/api.ts` `LIVE_PICKS` when mall-facing.
- Build all three apps after any change here.