wealth/docs/pages/market/dashboard-pricing.md

37 lines
5.0 KiB
Markdown

# Pricing editor
`/dashboard/pricing` · `apps/{bull,bear}/src/app/(flow)/dashboard/pricing/page.tsx` · Type: account · Layout: [layout.md](layout.md)
| Field | Value |
| ----------- | ----------------------------------------------------------------------------------------------------------------- |
| Robots | `noindex` (page `metadata`) |
| Status | `200` for every viewer: a guest goes to login in the browser, an investor sees `AuthGuard`'s no-access state |
| loading.tsx | `dashboard/pricing/loading.tsx`: bull: the bar; bear: the header and title; then `PricingFormSkeleton`, `delayed` |
| First flush | none |
| Canonical | none: `noindex` |
| H1 | bull: none (the bar's name isn't a heading); bear: `DesktopPageTitle`, `pricing:title` |
| JSON-LD | none |
| Scripts | none beyond the layout's |
## Sections
In bull's document order. `dashboard/pricing/layout.tsx` is only `OnboardingGuard` (0016): it renders nothing, and sends a creator who hasn't finished step 5 to the creator profile (C7 sits in `(flow)`, 0034).
| Section | Data | HTML | JS | Index | Notes |
| ------------------------------------------------------------------- | ------ | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| DesktopHeader (bear) | viewer | first flush | hydrate | no | the page renders it itself; rows as in [layout-main.md](layout-main.md) |
| PricingEditor's bar: MobileTopBar (bull) or DesktopPageTitle (bear) | config | first flush | hydrate | no | back to `/dashboard/plans` (R14); with unsaved changes, back and any in-app link open the leave sheet (`useLeaveGuard`, J10-4n) |
| PricingForm | viewer | skeleton | hydrate | no | `PartBoundary`, then `AuthGuard role="creator"` and `<Suspense>`, both with `PricingFormSkeleton`; `usePricingPage`'s `useSuspenseQuery` runs only in the browser; tier cards, the promotion block and save; the 7-day lock keeps standing prices read-only (0036) |
| ↳ DateTimeDialog | — | none | hydrate | no | the promotion's Shamsi date and time with island `Select`s (0035); mounts on open |
| ↳ ConfirmDialog, leave sheet | — | none | hydrate | no | mount on save and on leaving with changes |
## Notes
- bull: the form pads itself and pins save to the bottom; bear: the form in the 560 column.
- Debt: different H1 per app. bull has no `h1`; add a screen-reader `h1` to `PricingEditor`'s mobile branch (`platforms/market/src/app/screens/(flow)/dashboard/pricing/organisms/pricing-editor/PricingEditor.tsx`, the `MobileTopBar` return).
## Price floor
- The floor comes from `GET /subscriptions/pricing` (`floorTomanPerMonth`), on the final price after any discount; the browser compares exact totals as the API does.
- During the 7-day lock a tier the floor took off sale (`offSale`) stays editable and shows «خارج از فروش»; the other tiers stay read-only, and the save reads «ذخیره قیمت‌گذاری» instead of «ذخیره تخفیف».