feat: render patterns
This commit is contained in:
parent
6b8269900d
commit
3e908ab0b7
|
|
@ -0,0 +1,22 @@
|
|||
# 0069 One rendering doc per market route
|
||||
|
||||
Status: Proposed · Area: architecture · Date: 2026-10-21 · Decided by: agent
|
||||
|
||||
## Context
|
||||
|
||||
Every page needs a rendering doc in `docs/pages/<app>/`. bull (mobile) and bear (desktop) serve the same route tree from `platforms/market` (0001), and an edge in front of them picks the app by device. Googlebot Smartphone reads bull's HTML and desktop crawlers read bear's, so the "both templates" checks in a rendering doc compare the two apps.
|
||||
|
||||
## Decision
|
||||
|
||||
- Document each bull and bear route once, in `docs/pages/market/<page>.md`. bull is the doc's mobile template and bear its desktop template; the Sections table follows bull's document order.
|
||||
- A row only one app renders ends with `(bull)` or `(bear)` and is Index `no`. Notes give each app's difference as `bull: …; bear: …`.
|
||||
- Admin routes keep their own folder, `docs/pages/wall-street-plaza/`, with the `desktop:` breakpoint as the desktop template (0063).
|
||||
|
||||
## Alternatives
|
||||
|
||||
- One doc per app (`docs/pages/bull/`, `docs/pages/bear/`): twice the docs for the same sections, which drift apart, and no single place to check that both apps put primary content in the first flush.
|
||||
|
||||
## Consequences
|
||||
|
||||
- A change to a page in one app updates the shared doc, and the reviewer checks the other app still matches it.
|
||||
- The index file groups the docs under `market` and `wall-street-plaza`, not under bull and bear.
|
||||
|
|
@ -64,3 +64,4 @@
|
|||
- 0050 design: A post being read shows an info toast when the reader's access ends mid-read (J05-4f), the one toast not tied to the reader's own action.
|
||||
- 0062 architecture: Render every admin page in the browser behind `AdminGuard`; the server sends the frame, a same-size skeleton and `noindex`; no service worker, manifest, JSON-LD or caches.
|
||||
- 0063 design: Serve the admin's desktop and phone layouts from one app, switched at 1024px with Tailwind breakpoints; boards without a phone version scroll sideways.
|
||||
- 0069 architecture: Document each bull and bear route once, in `docs/pages/market/`, with bull as its mobile template and bear as its desktop template.
|
||||
|
|
|
|||
|
|
@ -0,0 +1,87 @@
|
|||
# Page rendering docs
|
||||
|
||||
One line per route: route · doc · robots · JSON-LD · browser-only sections.
|
||||
|
||||
bull (mobile) and bear (desktop) share one doc per route under `market/`, with bull as the mobile template and bear as the desktop template (0069). wall-street-plaza is one responsive app (0063).
|
||||
|
||||
## market
|
||||
|
||||
Layouts and error pages:
|
||||
|
||||
- root layout · [layout.md](market/layout.md) · — · — · browser: NetworkStatus, Toaster, ToastPlacementMarker (bear)
|
||||
- `(main)` layout · [layout-main.md](market/layout-main.md) · — · — · browser: bear header nav, search field, publish menu, notification bell, notification panel, login button or account menu, `@modal` slot; bull BottomNav
|
||||
- `(flow)/terms` layout · [layout-terms.md](market/layout-terms.md) · — · — · browser: MobileTopBar title (bull), DesktopHeader viewer parts (bear)
|
||||
- `(main)/dashboard/(creator)` layout · [layout-dashboard-creator.md](market/layout-dashboard-creator.md) · — · — · browser: OnboardingGuard redirect, notification bell and account avatar (bull)
|
||||
- `(main)/dashboard/(investor)` layout · [layout-dashboard-investor.md](market/layout-dashboard-investor.md) · — · — · browser: notification bell and account avatar (bull)
|
||||
- not-found and error · [not-found.md](market/not-found.md) · noindex · none · browser: not-found top bar, every group `error.tsx`, `global-error.tsx`
|
||||
|
||||
Indexable:
|
||||
|
||||
- `/` · [home.md](market/home.md) · index · FAQPage · browser: LandingRedirect
|
||||
- `/channels/[username]` · [channels-username.md](market/channels-username.md) · index; noindex when invalid, missing or suspended · none · browser: MobileTopBar (bull), ApprovedWelcome, ChannelActions, FollowNotice, locked post gate, Load more, PostLightbox
|
||||
- `/channels/[username]/posts/[id]` · [channels-username-posts-id.md](market/channels-username-posts-id.md) · index; noindex when the post is missing, belongs to another channel, or the channel is suspended · none · browser: MobileTopBar (bull), ChannelActions, locked post gate, PreviewBanner, PostLightbox, access-ended toast
|
||||
- `/terms` · [terms.md](market/terms.md) · index · none · browser: none
|
||||
- `/terms/subscription` · [terms-subscription.md](market/terms-subscription.md) · index · none · browser: none
|
||||
|
||||
`(main)`:
|
||||
|
||||
- `/feed` · [feed.md](market/feed.md) · noindex · none · browser: top-bar bell/avatar/login, HomeGuard, HomeFeed (featured row, post cards, empty state), PostLightbox, InstallPrompt (bull)
|
||||
- `/search` · [search.md](market/search.md) · noindex · none · browser: top-bar bell/avatar/login, SearchPanel (field, recent searches, featured, results)
|
||||
- `/analysts` · [analysts.md](market/analysts.md) · noindex · none · browser: top-bar title/brand/login, AnalystFollowButton, GuestSignupCard
|
||||
- `/notifications` · [notifications.md](market/notifications.md) · noindex · none · browser: top-bar title/login, NotificationCentre (filter chips, rows)
|
||||
- `/account` · [account.md](market/account.md) · noindex · none · browser: top-bar title/login, AccountOverview (identity, lists, sign-out), SupportDialog, SignOutConfirm
|
||||
- `/account/install` · [account-install.md](market/account-install.md) · noindex · none · browser: top-bar title/login, InstallApp
|
||||
- `/account/notifications` · [account-notifications.md](market/account-notifications.md) · noindex · none · browser: top-bar title/login, NotificationSettings, offline banner
|
||||
- `/dashboard/plans` · [dashboard-plans.md](market/dashboard-plans.md) · noindex · none · browser: PricingCard, InviteCodeCard, InviteShareSheet, CapacityRequestDialog, AudienceStats
|
||||
- `/dashboard/predictions` · [dashboard-predictions.md](market/dashboard-predictions.md) · noindex · none · browser: PredictionsTab, TrackRecord, open and recently closed PredictionSections, ClosePredictionSheet
|
||||
- `/dashboard/finance` · [dashboard-finance.md](market/dashboard-finance.md) · noindex · none · browser: BalanceSummary, PayoutAccount, ReadBackDialog, Ledger, LedgerDetail, receipt Lightbox
|
||||
- `/dashboard/predictions/all` · [dashboard-predictions-all.md](market/dashboard-predictions-all.md) · noindex · none · browser: page name (bull), PredictionList, ClosePredictionSheet
|
||||
- `/dashboard/subscriptions` · [dashboard-subscriptions.md](market/dashboard-subscriptions.md) · noindex · none · browser: SubscriptionList, RenewalSheet, SupportDialog
|
||||
- `/dashboard/transactions` · [dashboard-transactions.md](market/dashboard-transactions.md) · noindex · none · browser: TransactionList, TransactionDetail
|
||||
- `/dashboard/following` · [dashboard-following.md](market/dashboard-following.md) · noindex · none · browser: FollowingList, UnfollowConfirm
|
||||
|
||||
`(flow)`:
|
||||
|
||||
- `/account/profile` · [account-profile.md](market/account-profile.md) · noindex · none · browser: AccountProfile (investor form or creator profile edit), LeaveDialog
|
||||
- `/checkout/[username]` · [checkout-username.md](market/checkout-username.md) · noindex · none · browser: CheckoutPanel, CheckoutForm (tiers, code, pay footer), CheckoutHalts, NoCodeSheet
|
||||
- `/compose/post` · [compose-post.md](market/compose-post.md) · noindex · none · browser: PostComposer, ComposerForm, LeaveConfirm, PostComposerDialog (bear `@modal`)
|
||||
- `/compose/post/[id]` · [compose-post-id.md](market/compose-post-id.md) · noindex · none · browser: PostComposer, EditComposer, LeaveConfirm, PostComposerDialog (bear `@modal`)
|
||||
- `/compose/prediction` · [compose-prediction.md](market/compose-prediction.md) · noindex · none · browser: PredictionComposer, ComposerPage, SymbolPicker, ConfirmPublish, LeaveConfirm, PredictionComposerDialog (bear `@modal`)
|
||||
- `/dashboard/pricing` · [dashboard-pricing.md](market/dashboard-pricing.md) · noindex · none · browser: PricingForm, DateTimeDialog, ConfirmDialog, leave sheet
|
||||
- `/payment/result/[paymentId]` · [payment-result-paymentId.md](market/payment-result-paymentId.md) · noindex · none · browser: PaymentResult, ResultActions
|
||||
- `/payment/return` · [payment-return.md](market/payment-return.md) · noindex · none · browser: PaymentReturn (renders nothing; polls and replaces the page)
|
||||
|
||||
`(auth)` and `(onboarding)`, browser-only behind their guards (0013):
|
||||
|
||||
- `/auth/login` · [auth-login.md](market/auth-login.md) · noindex · none · browser: LoginStep, SupportDialog, NetworkBar
|
||||
- `/auth/login/verify` · [auth-login-verify.md](market/auth-login-verify.md) · noindex · none · browser: LoginVerifyStep, ResendCode wait, NetworkBar
|
||||
- `/auth/login/suspended` · [auth-login-suspended.md](market/auth-login-suspended.md) · noindex · none · browser: LoginSuspendedStep, actions, NetworkBar
|
||||
- `/auth/register` · [auth-register.md](market/auth-register.md) · noindex · none · browser: RegisterTypeStep, NetworkBar
|
||||
- `/auth/register/phone` · [auth-register-phone.md](market/auth-register-phone.md) · noindex · none · browser: RegisterPhoneStep, NetworkBar
|
||||
- `/auth/register/verify` · [auth-register-verify.md](market/auth-register-verify.md) · noindex · none · browser: RegisterVerifyStep, ResendCode wait, NetworkBar
|
||||
- `/auth/register/details` · [auth-register-details.md](market/auth-register-details.md) · noindex · none · browser: RegisterDetailsStep, ExpiryWarning, ExpiryHalt, LeaveRegistrationDialog, RulesSheet, NetworkBar
|
||||
- `/onboarding/creator-profile` · [onboarding-creator-profile.md](market/onboarding-creator-profile.md) · noindex · none · browser: CreatorProfileStep, ProfileForm, SaveStatus, ProfilePreview, NetworkBar
|
||||
- `/onboarding/creator-profile/done` · [onboarding-creator-profile-done.md](market/onboarding-creator-profile-done.md) · noindex · none · browser: CreatorProfileDoneStep, actions, NetworkBar
|
||||
- `/onboarding/investor-profile` · [onboarding-investor-profile.md](market/onboarding-investor-profile.md) · noindex · none · browser: InvestorProfileStep, NetworkBar
|
||||
|
||||
## wall-street-plaza
|
||||
|
||||
Every page renders in the browser behind `AdminGuard` or `GuestGuard` (0062).
|
||||
|
||||
- root layout · [layout.md](wall-street-plaza/layout.md) · — · — · browser: app shell session, toast placement, toaster
|
||||
- `(panel)` layout · [layout-panel.md](wall-street-plaza/layout-panel.md) · — · — · browser: section counts, admin identity, menu sheet, sign-out dialog
|
||||
- `invite-codes` layout · [layout-invite-codes.md](wall-street-plaza/layout-invite-codes.md) · — · — · browser: pending count
|
||||
- not-found and error · [not-found.md](wall-street-plaza/not-found.md) · noindex · none · browser: every in-page error and empty state (PartBoundary, SessionEnded, group `error.tsx`)
|
||||
- `/login` · [login.md](wall-street-plaza/login.md) · noindex · none · browser: GuestGuard form (number step), code step, resend countdown
|
||||
- `/health` · [health.md](wall-street-plaza/health.md) · noindex · none · browser: beta subtitle, updated-at, BetaHealth (exit metrics, investor funnel, beta analysts)
|
||||
- `/health/secondary` · [health-secondary.md](wall-street-plaza/health-secondary.md) · noindex · none · browser: beta subtitle, updated-at, BetaHealth (secondary metrics, analyst funnel)
|
||||
- `/analysts` · [analysts.md](wall-street-plaza/analysts.md) · noindex · none · browser: search, analyst rows, account dialogs
|
||||
- `/analysts/[id]` · [analysts-id.md](wall-street-plaza/analysts-id.md) · noindex · none · browser: header with name, badges and action, facts, audit log, account dialogs
|
||||
- `/featured` · [featured.md](wall-street-plaza/featured.md) · noindex · none · browser: fewer banner, featured table, page visibility, preview, audit log, add and remove dialogs
|
||||
- `/invite-codes` · [invite-codes.md](wall-street-plaza/invite-codes.md) · noindex · none · browser: code rows, code detail sheet, code dialogs
|
||||
- `/invite-codes/requests` · [invite-codes-requests.md](wall-street-plaza/invite-codes-requests.md) · noindex · none · browser: request rows, code dialogs
|
||||
- `/payouts` · [payouts.md](wall-street-plaza/payouts.md) · noindex · none · browser: tabs, payout rows, payout detail sheet, create, mark-paid and cancel dialogs
|
||||
- `/predictions` · [predictions.md](wall-street-plaza/predictions.md) · noindex · none · browser: quote health, queue tabs, queue rows, prediction sheet, prediction dialogs
|
||||
- `/subscriptions` · [subscriptions.md](wall-street-plaza/subscriptions.md) · noindex · none · browser: filter chips, subscription rows, detail sheet, grant dialog
|
||||
- `/verifications` · [verifications.md](wall-street-plaza/verifications.md) · noindex · none · browser: status tabs, search and sort, verification rows
|
||||
- `/verifications/[id]` · [verifications-id.md](wall-street-plaza/verifications-id.md) · noindex · none · browser: queue nav, banner, facts, decisions, past submissions, ID image, audit log, decision dialogs
|
||||
|
|
@ -0,0 +1,30 @@
|
|||
# نصب اپلیکیشن (install the app)
|
||||
|
||||
`/account/install` · `apps/{bull,bear}/src/app/(main)/account/install/page.tsx` · Type: account · Layout: [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | -------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; a guest is sent to login in the browser |
|
||||
| loading.tsx | `(main)/account/install/loading.tsx` |
|
||||
| First flush | none: what the device can do is known only in the browser |
|
||||
| Canonical | none |
|
||||
| H1 | bull: the `ResultPanel` title inside `InstallApp`, browser only; bear: `DesktopPageTitle` «نصب اپلیکیشن» |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------------------------- | ------ | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| MobileTopBar (bull) | config | first flush | hydrate | no | back to `/account` when nothing of this site is behind the page (`backToPrevious`, 0057) |
|
||||
| ↳ Title or login link (bull) | viewer | skeleton | hydrate | no | |
|
||||
| DesktopPageTitle (bear) | config | first flush | hydrate | no | «بازگشت» to `/account` and the H1 |
|
||||
| InstallApp | viewer | skeleton | hydrate | no | `AuthGuard` with `InstallAppSkeleton`, then the view from `useInstallApp`: the browser's install offer, the menu fallback, the iOS Safari steps, or installed |
|
||||
| ↳ InstallBenefits, InstallSteps | config | skeleton | hydrate | no | bull: the menu caption; bear: the two steps |
|
||||
|
||||
## Notes
|
||||
|
||||
- No `PartBoundary`: the part reads nothing over the network; the pwa lib keeps the browser's install offer (0047).
|
||||
|
|
@ -0,0 +1,31 @@
|
|||
# تنظیمات اعلانها (notification settings)
|
||||
|
||||
`/account/notifications` · `apps/{bull,bear}/src/app/(main)/account/notifications/page.tsx` · Type: account · Layout: [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------ |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; a guest is sent to login in the browser |
|
||||
| loading.tsx | `(main)/account/notifications/loading.tsx` |
|
||||
| First flush | none: the settings are read in the browser with the session |
|
||||
| Canonical | none |
|
||||
| H1 | bull: none, the top bar's title is a `<span>`; bear: `DesktopPageTitle` «تنظیمات اعلانها» |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ---------------------------- | ------------- | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------ |
|
||||
| MobileTopBar (bull) | config | first flush | hydrate | no | back to `/account` when opened on its own |
|
||||
| ↳ Title or login link (bull) | viewer | skeleton | hydrate | no | |
|
||||
| DesktopPageTitle (bear) | config | first flush | hydrate | no | «بازگشت» to `/account` and the H1 |
|
||||
| NotificationSettings | viewer, query | skeleton | hydrate | no | `AuthGuard`, then `<Suspense>` and `PartBoundary name="notification-settings"`; `useSuspenseQuery`; bear: `framed` |
|
||||
| ↳ SettingsSection cards | query | skeleton | hydrate | no | «اعلان در لومینا» and «پیامک» switches for the member's role; each switch saves as it flips, with a toast |
|
||||
| ↳ Offline banner | — | none | hydrate | no | `useOfflineFreeze` freezes every switch and says why (0043) |
|
||||
|
||||
## Notes
|
||||
|
||||
- Debt: bull has no H1 while bear has one. Give bull an `sr-only` H1 with the same text.
|
||||
|
|
@ -0,0 +1,31 @@
|
|||
# Account profile
|
||||
|
||||
`/account/profile` · `apps/{bull,bear}/src/app/(flow)/account/profile/page.tsx` · Type: account · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200` for every viewer: `AuthGuard` sends a guest to login in the browser, with a return path |
|
||||
| loading.tsx | `account/profile/loading.tsx`: bull: the bar and the investor's form skeleton; bear: the header, the title and the same skeleton; `delayed` |
|
||||
| First flush | none |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | bull: none (the bar's name isn't a heading); bear: `DesktopPageTitle`, `account:profile.title` from i18n |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order. One route for both roles (0046): the server sends the investor's frame and skeleton, because most members are investors.
|
||||
|
||||
| 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) |
|
||||
| AuthGuard fallback: MobileTopBar (bull) or DesktopPageTitle (bear) | config | first flush | hydrate | no | `account:profile.title`; back to `/account` |
|
||||
| AccountProfile | viewer | skeleton | hydrate | no | server HTML: `InvestorProfileFormSkeleton`; once the viewer is known, `CreatorProfileEdit` (J03-1, bear's 640 column) or `InvestorProfileForm` (J12-2, bear's 560 column), each with its own bar or title that replaces the fallback's |
|
||||
| ↳ LeaveDialog | — | none | hydrate | no | mounts when back or a link would drop unsaved changes |
|
||||
|
||||
## Notes
|
||||
|
||||
- `AccountProfile` imports both role forms statically, so every member downloads both. Split them with `next/dynamic` only if this route's first-load JS runs over its target.
|
||||
- A session that ends on the page shows `SessionEnded` in place and keeps the draft (0042).
|
||||
- Debt: different H1 per app. bull has no `h1`; add a screen-reader `h1` to the forms' mobile branch, as `SubscriptionTerms` does (`platforms/market/src/app/screens/(flow)/terms/subscription/organisms/subscription-terms/SubscriptionTerms.tsx:24`).
|
||||
|
|
@ -0,0 +1,34 @@
|
|||
# حساب کاربری (account)
|
||||
|
||||
`/account` · `apps/{bull,bear}/src/app/(main)/account/page.tsx` · Type: account · Layout: [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; a guest is sent to login in the browser |
|
||||
| loading.tsx | `(main)/account/loading.tsx`: the bar or title, then the overview skeleton |
|
||||
| First flush | none: the identity comes from the session in the browser |
|
||||
| Canonical | none |
|
||||
| H1 | bull: none, the top bar's title is a `<span>`; bear: `DesktopPageTitle` «حساب کاربری» |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------------------------- | ------------- | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| MobileTopBar (bull) | config | first flush | hydrate | no | a pushed page's bar: back and support |
|
||||
| ↳ Title or login link (bull) | viewer | skeleton | hydrate | no | |
|
||||
| DesktopPageTitle (bear) | config | first flush | hydrate | no | «بازگشت» and the H1 |
|
||||
| AccountOverview | viewer | skeleton | hydrate | no | `AuthGuard` with `AccountOverviewSkeleton`, in `PartBoundary name="account-overview"`; bear: `framed` |
|
||||
| ↳ IdentityCard, CreatorFacts | viewer, query | skeleton | hydrate | no | creators also get the review badge, followers and subscribers: browser `useQuery`s that never throw and leave out what fails |
|
||||
| ↳ PrivacyNote | config | skeleton | hydrate | no | investors only |
|
||||
| ↳ Settings and help lists | viewer | skeleton | hydrate | no | `ListRow` links to `/account/profile`, `/dashboard/finance#…` (creators), `/account/notifications`, `/account/install` (not in the installed app), `/terms`; پشتیبانی opens `SupportDialog` |
|
||||
| ↳ Sign-out button | — | skeleton | hydrate | no | `SignOutConfirm` asks first (0041) |
|
||||
| ↳ SupportDialog, SignOutConfirm | — | none | hydrate | no | rendered with `open`; statically imported |
|
||||
|
||||
## Notes
|
||||
|
||||
- Debt: bull has no H1 while bear has one. Give bull an `sr-only` H1 with the same text.
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
# تحلیلگران منتخب (featured analysts)
|
||||
|
||||
`/analysts` · `apps/{bull,bear}/src/app/(main)/analysts/page.tsx` · Type: category and brand listing · Layout: [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; a failed read shows `(main)/error.tsx` with 200; a 404 or 403 read shows the empty state |
|
||||
| loading.tsx | `(main)/analysts/loading.tsx`: the frame and three analyst cards |
|
||||
| First flush | none: the page entry awaits `getFeaturedCreators()` through `readOnServer`, under `loading.tsx`, so the list streams |
|
||||
| Canonical | none |
|
||||
| H1 | `home:analysts.title` in `PageHeader`; bull: inside `AnalystsDirectory`, shown while the viewer is unknown or a guest, and removed for a member, whose top bar names the page |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------------------------- | ----------------------- | ----------- | ------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| MobileTopBar (bull) | config | first flush | hydrate | no | a pushed page's bar: back and support |
|
||||
| ↳ Title, brand or login link (bull) | viewer | skeleton | hydrate | no | member: the title; guest: the brand and «ورود/ثبتنام» |
|
||||
| DeskBack, PageHeader (bear) | config | first flush | hydrate | no | «بازگشت» to خانه, or to the landing for a guest |
|
||||
| AnalystsDirectory heading and note | `getFeaturedCreators()` | streamed | hydrate | no | bull's H1 and the «chosen by Lumina, not a ranking» note |
|
||||
| AnalystList | `getFeaturedCreators()` | streamed | hydrate | no | every featured analyst in the admin's order, each card an `<a href>` to `/channels/username`; bull: one column; bear: three; empty: an `EmptyState` card |
|
||||
| ↳ AnalystFollowButton | viewer | none | hydrate | no | investors only, once their follows are known; unfollow asks first |
|
||||
| GuestSignupCard | viewer | none | hydrate | no | guests only: register and login links |
|
||||
|
||||
## Notes
|
||||
|
||||
- The page is `noindex`, but its channel links are server HTML, so crawlers that fetch it can follow them to the indexable channel pages.
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
# Login: suspended account
|
||||
|
||||
`/auth/login/suspended` · `apps/{bull,bear}/src/app/(auth)/auth/login/suspended/page.tsx` · Type: login · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; without a suspension in the auth-flow store (a reload), the step sends the visitor to `/auth/login` in the browser |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(auth)/auth/login/suspended/loading.tsx` |
|
||||
| First flush | `none` |
|
||||
| Canonical | none set |
|
||||
| H1 | `auth:suspended.title`, `ResultPanel`'s title; browser only |
|
||||
| JSON-LD | `none` |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------- | ------ | ----------- | ------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| AuthTopBar (bull) | config | first flush | none | no | brand `<a href="/">` and support; no way back into login |
|
||||
| AuthTemplate header (bear) | config | first flush | none | no | brand `<a href="/">` |
|
||||
| SupportEntry | — | first flush | hydrate | no | in the bar; the dialog mounts only when open |
|
||||
| NetworkBar | — | none | hydrate | no | under the bar, only while offline or reconnecting |
|
||||
| LoginSuspendedStep | viewer | skeleton | hydrate | no | `GuestGuard` fallback `SkeletonPreset preset="state"`; amber `ResultPanel`; a creator sees the admin's reason and the SMS note; an investor suspended mid-session learns they were signed out |
|
||||
| ↳ Actions | config | skeleton | hydrate | no | support button and `<a href="/">`; bull: `PinnedFooter`; bear: inside the card |
|
||||
|
||||
## Notes
|
||||
|
||||
- Reached after a valid code for a suspended account (J01-3) or from `AppShell`'s `useSuspendedHalt` mid-session (J01-3d). The suspension lives only in memory (0013, 0015).
|
||||
- Focus moves to the heading when the screen opens.
|
||||
|
|
@ -0,0 +1,34 @@
|
|||
# Login: code
|
||||
|
||||
`/auth/login/verify` · `apps/{bull,bear}/src/app/(auth)/auth/login/verify/page.tsx` · Type: login · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | -------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; without a number in the auth-flow store (a reload), the step sends the visitor back to `/auth/login` in the browser |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(auth)/auth/login/verify/loading.tsx` |
|
||||
| First flush | `none` |
|
||||
| Canonical | none set |
|
||||
| H1 | `CodeStep`'s heading; browser only |
|
||||
| JSON-LD | `none` |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------- | ------ | ----------- | ------- | ----- | -------------------------------------------------------------------------------------------------------------------- |
|
||||
| AuthTopBar (bull) | config | first flush | none | no | back button and `auth:login.header` |
|
||||
| ↳ BackButton (bull) | URL | first flush | hydrate | no | `<a href>` to `/auth/login`, keeping `?redirect=` |
|
||||
| AuthTemplate header (bear) | config | first flush | none | no | brand `<a href="/">` |
|
||||
| StepBack (bear) | URL | first flush | hydrate | no | «بازگشت» above the card to `/auth/login`, keeping `?redirect=` |
|
||||
| SupportEntry | — | first flush | hydrate | no | bull: bottom sheet; bear: popover; the dialog mounts only when open |
|
||||
| NetworkBar | — | none | hydrate | no | under the bar, only while offline or reconnecting |
|
||||
| LoginVerifyStep | viewer | skeleton | hydrate | no | `GuestGuard` fallback `SkeletonPreset preset="form"`; guest with a number: the number, 6 code cells, resend, support |
|
||||
| ↳ ResendCode wait | clock | skeleton | hydrate | no | island `ResendCode` with `endsAt` from the flow store |
|
||||
|
||||
## Notes
|
||||
|
||||
- Decision 0013: the step renders only in the browser; the phone number lives in memory, never in the URL or storage, so a reload returns to the number step.
|
||||
- Wrong codes are counted in the flow store; the third blocks the number for the server's block time (`use-code-step.ts`, event handlers only).
|
||||
|
|
@ -0,0 +1,34 @@
|
|||
# Login
|
||||
|
||||
`/auth/login` · `apps/{bull,bear}/src/app/(auth)/auth/login/(number)/page.tsx` · Type: login · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ---------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200` for every visitor; a signed-in visitor is sent on in the browser by `GuestGuard`, never by the server |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(auth)/auth/login/(number)/loading.tsx`: the same frame and a `delayed` form skeleton |
|
||||
| First flush | `none` |
|
||||
| Canonical | none set |
|
||||
| H1 | `auth:login.title`, or `auth:login.subscribe.title` when the visitor came from «اشتراک»; inside `LoginStep`, so browser only |
|
||||
| JSON-LD | `none` |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------- | ------ | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| AuthTopBar (bull) | config | first flush | none | no | back button, no title; sticky, with the connection bar in its box |
|
||||
| ↳ BackButton (bull) | URL | first flush | hydrate | no | `<a href="/">`, or straight to `?redirect=` (`leavesFlow`, J01-1e) |
|
||||
| AuthTemplate header (bear) | config | first flush | none | no | brand `<a href="/">`; the step sits in the 560 card below |
|
||||
| SupportEntry | — | first flush | hydrate | no | headset icon in the bar; bull: bottom sheet; bear: popover |
|
||||
| ↳ SupportDialog | config | none | hydrate | no | island `Dialog` mounts its content only while open |
|
||||
| NetworkBar | — | none | hydrate | no | under the bar, only while offline or reconnecting |
|
||||
| LoginStep | viewer | skeleton | hydrate | no | `GuestGuard` shows `SkeletonPreset preset="form"` until the viewer is known; guest: H1, phone form, register link, support; member: replaced to `?redirect=`, home, or step 5 when `needsProfile` |
|
||||
|
||||
## Notes
|
||||
|
||||
- Decision 0013 overrides the skill's login map (H1 and phone form in the first flush): every `(auth)` step renders only in the browser behind `GuestGuard`, and flow state stays in memory.
|
||||
- The `(auth)` layout renders nothing; it only sets `dynamic = 'force-dynamic'`. `(auth)/error.tsx` shows `PageError` with `standalone`.
|
||||
- bull: `size="lg"`, support at the bottom; bear: `size="md"`, support as a popover.
|
||||
|
|
@ -0,0 +1,37 @@
|
|||
# Register: details
|
||||
|
||||
`/auth/register/details` · `apps/{bull,bear}/src/app/(auth)/auth/register/details/page.tsx` · Type: login · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; without a role, number, or registration token in the auth-flow store (a reload), the step sends the visitor to `/auth/register/phone` in the browser |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(auth)/auth/register/details/loading.tsx` |
|
||||
| First flush | `none`; the rules text comes from server i18n, not a read |
|
||||
| Canonical | none set |
|
||||
| H1 | the investor details or creator identity heading; browser only |
|
||||
| JSON-LD | `none` |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------- | ------ | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| AuthTopBar (bull) | config | first flush | none | no | back button and `auth:register.header` |
|
||||
| ↳ BackButton (bull) | URL | first flush | hydrate | no | `<a href="/">`, keeping `?redirect=` |
|
||||
| AuthTemplate header (bear) | config | first flush | none | no | brand `<a href="/">` |
|
||||
| StepBack (bear) | URL | first flush | hydrate | no | «بازگشت» above the card to `/` |
|
||||
| SupportEntry | — | first flush | hydrate | no | in the bar; the dialog mounts only when open |
|
||||
| NetworkBar | — | none | hydrate | no | under the bar, only while offline or reconnecting |
|
||||
| RegisterDetailsStep | viewer | skeleton | hydrate | no | `GuestGuard` fallback `SkeletonPreset preset="form" count={3}`; investor: `InvestorDetailsForm`; creator: `CreatorIdentityForm`, both in `DetailsFrame` |
|
||||
| ↳ ExpiryWarning | clock | none | hydrate | no | two minutes before the token ends; `Countdown kind="otp"` and «تمدید زمان» |
|
||||
| ↳ ExpiryHalt | viewer | none | hydrate | no | when the token ends; bull: sheet; bear: modal |
|
||||
| ↳ LeaveRegistrationDialog | — | none | hydrate | no | back asks whether to leave and resume later (J02-3f) |
|
||||
| ↳ RulesSheet | config | none | hydrate | no | «قوانین لومینا» in `TermsLine`; `GeneralRules` rendered on the server and passed as `rules`; bull: sheet; bear: modal; mounts when opened |
|
||||
|
||||
## Notes
|
||||
|
||||
- Decision 0013: the step renders only in the browser on the 15-minute token, held in memory.
|
||||
- `GeneralRules` is a Server Component passed into the client step, so its text is in the RSC payload of every response, though it reaches the DOM only when the sheet opens.
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
# Register: phone number
|
||||
|
||||
`/auth/register/phone` · `apps/{bull,bear}/src/app/(auth)/auth/register/phone/page.tsx` · Type: login · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | -------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200` for every visitor; a signed-in visitor is sent on in the browser by `GuestGuard` |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(auth)/auth/register/phone/loading.tsx` |
|
||||
| First flush | `none` |
|
||||
| Canonical | none set |
|
||||
| H1 | the phone step's heading in `RegisterPhoneStep`; browser only |
|
||||
| JSON-LD | `none` |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------- | ------ | ----------- | ------- | ----- | -------------------------------------------------------------------------------------------------------- |
|
||||
| AuthTopBar (bull) | config | first flush | none | no | back button and `auth:register.header` |
|
||||
| ↳ BackButton (bull) | URL | first flush | hydrate | no | `<a href>` to `/auth/register`, keeping `?redirect=` |
|
||||
| AuthTemplate header (bear) | config | first flush | none | no | brand `<a href="/">` |
|
||||
| StepBack (bear) | URL | first flush | hydrate | no | «بازگشت» above the card to `/auth/register` |
|
||||
| SupportEntry | — | first flush | hydrate | no | in the bar; the dialog mounts only when open |
|
||||
| NetworkBar | — | none | hydrate | no | under the bar, only while offline or reconnecting |
|
||||
| RegisterPhoneStep | viewer | skeleton | hydrate | no | `GuestGuard` fallback `SkeletonPreset preset="form" count={1}`; guest: progress, H1, phone form, support |
|
||||
|
||||
## Notes
|
||||
|
||||
- Decision 0013: the step renders only in the browser; the number stays in the auth-flow store.
|
||||
|
|
@ -0,0 +1,33 @@
|
|||
# Register: code
|
||||
|
||||
`/auth/register/verify` · `apps/{bull,bear}/src/app/(auth)/auth/register/verify/page.tsx` · Type: login · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; without a number in the auth-flow store (a reload), the step sends the visitor back to `/auth/register/phone` in the browser |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(auth)/auth/register/verify/loading.tsx` |
|
||||
| First flush | `none` |
|
||||
| Canonical | none set |
|
||||
| H1 | `CodeStep`'s heading; browser only |
|
||||
| JSON-LD | `none` |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------- | ------ | ----------- | ------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| AuthTopBar (bull) | config | first flush | none | no | back button and `auth:register.header` |
|
||||
| ↳ BackButton (bull) | URL | first flush | hydrate | no | `<a href>` to `/auth/register/phone`, keeping `?redirect=` |
|
||||
| AuthTemplate header (bear) | config | first flush | none | no | brand `<a href="/">` |
|
||||
| StepBack (bear) | URL | first flush | hydrate | no | «بازگشت» above the card to `/auth/register/phone` |
|
||||
| SupportEntry | — | first flush | hydrate | no | in the bar; the dialog mounts only when open |
|
||||
| NetworkBar | — | none | hydrate | no | under the bar, only while offline or reconnecting |
|
||||
| RegisterVerifyStep | viewer | skeleton | hydrate | no | `GuestGuard` fallback `SkeletonPreset preset="form" count={1}`; guest with a number: `RegisterProgress`, the shared `CodeStep`, «تأیید و ادامه» |
|
||||
| ↳ ResendCode wait | clock | skeleton | hydrate | no | island `ResendCode` with `endsAt` from the flow store |
|
||||
|
||||
## Notes
|
||||
|
||||
- Decision 0013: the step renders only in the browser. A verified code opens step 4 on the 15-minute registration token, held in memory.
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
# Register: account type
|
||||
|
||||
`/auth/register` · `apps/{bull,bear}/src/app/(auth)/auth/register/(type)/page.tsx` · Type: login · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | -------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200` for every visitor; a signed-in visitor is sent on in the browser by `GuestGuard` |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(auth)/auth/register/(type)/loading.tsx` |
|
||||
| First flush | `none` |
|
||||
| Canonical | none set; `?role=` preselects a card |
|
||||
| H1 | `auth:register.type.title`; browser only |
|
||||
| JSON-LD | `none` |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------- | ------ | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| AuthTopBar (bull) | config | first flush | none | no | back button, no title |
|
||||
| ↳ BackButton (bull) | URL | first flush | hydrate | no | `<a href>` to `/auth/login`, keeping `?redirect=` |
|
||||
| AuthTemplate header (bear) | config | first flush | none | no | brand `<a href="/">` |
|
||||
| SupportEntry | — | first flush | hydrate | no | in the bar; the dialog mounts only when open |
|
||||
| NetworkBar | — | none | hydrate | no | under the bar, only while offline or reconnecting |
|
||||
| RegisterTypeStep | viewer | skeleton | hydrate | no | `GuestGuard` fallback `SkeletonPreset preset="form" count={2}`; guest: `RegisterProgress`, H1, two `ChoiceCard`s (investor, creator) in a fieldset, the note that the type can't change, «ادامه» |
|
||||
|
||||
## Notes
|
||||
|
||||
- Decision 0013: the step renders only in the browser; the chosen role goes to the auth-flow store, never the URL.
|
||||
- bull: `size="lg"`, support at the bottom; bear: `size="md"`, support as a popover.
|
||||
|
|
@ -0,0 +1,40 @@
|
|||
# Post
|
||||
|
||||
`/channels/[username]/posts/[id]` · `apps/{bull,bear}/src/app/(main)/channels/[username]/posts/[id]/page.tsx` · Type: blog article · Layout: [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `index; noindex when` the post is missing, belongs to another channel, or the channel is suspended (`generateMetadata`) |
|
||||
| Status | `200`; `308` when the username segment isn't the stored spelling (`ROUTES.post`), and from `/@username/…` (0064); `200` with `not-found.tsx` when the username is invalid or the channel is missing, because `loading.tsx` wraps the page; `200` with `noindex` and `PostMissing` when the post is missing (debt) |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(main)/channels/[username]/posts/[id]/loading.tsx` (debt, Notes) |
|
||||
| First flush | `getChannel(username)` and `getPost(id)` in one `Promise.all` through `readOnServer`, which the page entry and `generateMetadata` await (0055) |
|
||||
| Canonical | `/channels/username/posts/id`, from `postMetadata`; drops `?preview=` |
|
||||
| H1 | none (debt) |
|
||||
| JSON-LD | none (debt, Notes) |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------- | ---------------------- | ----------- | ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| MobileTopBar (bull) | viewer | skeleton | hydrate | no | back to the channel (`parentHref`, `backToPrevious`, 0057); the title waits for the viewer |
|
||||
| DeskBack (bear) | — | first flush | hydrate | no | «بازگشت» to the channel |
|
||||
| PostChannelBar | `getChannel(username)` | first flush | none | primary | `<a href>` to the channel: avatar, name, `@username` |
|
||||
| ↳ ChannelActions | viewer | skeleton | hydrate | no | follow and subscribe; own `PartBoundary` |
|
||||
| PostView | `getPost(id)` | first flush | hydrate | primary | a free post's caption and images; a premium post's `captionPreview` and media count only; re-read in the browser for the creator or a subscriber (0021) |
|
||||
| ↳ Locked post gate | viewer | skeleton | hydrate | no | guest: login back here; investor: checkout |
|
||||
| ↳ PreviewBanner | viewer | none | hydrate | no | the creator's `?preview=` of their own premium post |
|
||||
| ↳ PostLightbox | — | none | interaction | no | `next/dynamic`, mounted on the first image tap |
|
||||
| ↳ Access-ended toast | viewer | none | hydrate | no | the info toast when access ends mid-read (0050) |
|
||||
| PostMissing | `getChannel(username)` | first flush | hydrate | no | instead of `PostView` when the post is missing; a link back to the channel |
|
||||
| ChannelUnavailable | `getChannel(username)` | first flush | hydrate | no | replaces the bar and post when the channel is suspended |
|
||||
|
||||
## Notes
|
||||
|
||||
- bull: under `MobileTopBar`, a padded column; bear: the 640px column under «بازگشت». Both hold the same primary rows.
|
||||
- Debt: `loading.tsx` wraps an indexable entity page: a missing channel answers 200, and past 12,800 bytes the post follows the skeleton. Delete it.
|
||||
- Debt: a missing post answers 200 with `PostMissing` (`PostTemplate.tsx:67`), a soft 404. Call `notFound()` in the page entry and move `PostMissing` into a route `not-found.tsx`.
|
||||
- Debt: no H1. Make the post's first line, the text `postMetadata` titles it with, the H1 in both apps.
|
||||
- Debt: no JSON-LD; an article-type page gets `BreadcrumbList`. The repo has no json-ld lib yet.
|
||||
|
|
@ -0,0 +1,45 @@
|
|||
# Channel
|
||||
|
||||
`/channels/[username]` · `apps/{bull,bear}/src/app/(main)/channels/[username]/page.tsx` · Type: seller · Layout: [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| Robots | `index; noindex when` the username is invalid, the channel is missing, or it is suspended (`generateMetadata`; `not-found.tsx` `metadata`) |
|
||||
| Status | `200`; `308` when the segment isn't the stored spelling (`toChannelUsername`), keeping the query for `?code=` (0059), and from `/@username/…` (`next.config.ts` redirect, 0064); `200` with `not-found.tsx` and `noindex` when invalid or missing, because `loading.tsx` wraps the page (debt); `200` with `noindex` and `ChannelUnavailable` when suspended |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(main)/channels/[username]/loading.tsx` (debt, Notes) |
|
||||
| First flush | `getChannel(username)` through `readOnServer`, which the page entry and `generateMetadata` await (0055) |
|
||||
| Canonical | `/channels/username`, from `channelMetadata`; drops `?code=` and every other parameter |
|
||||
| H1 | the display name, in `ChannelHeader` |
|
||||
| JSON-LD | none (debt, Notes) |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------- | ------------------------------- | ----------- | ----------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| MobileTopBar (bull) | viewer | skeleton | hydrate | no | `tabOwnerId`: back and title wait for the viewer; the creator on their own channel gets the tab bar |
|
||||
| ChannelDeskBack (bear) | viewer | first flush | hydrate | no | «بازگشت»; removed for the owner |
|
||||
| ApprovedWelcome | viewer | none | hydrate | no | once, on the creator's first visit after approval; bull: sheet; bear: modal |
|
||||
| ChannelHeader, with the H1 | `getChannel(username)` | first flush | none | primary | avatar, name, `@username`, bio, markets, social links; bear: in a card |
|
||||
| ↳ ChannelShare | — | first flush | hydrate | no | the owner's share sheet opens on click |
|
||||
| ↳ ChannelCounts | `getChannel(username)`, query | first flush | hydrate | no | follower count from the server read as `initialData`, kept live (0045); the owner's «مشترک فعال» is browser-only |
|
||||
| ↳ ChannelActions | viewer | skeleton | hydrate | no | guest prompt, follow, subscribe, sale and invite notes; own `PartBoundary` |
|
||||
| FollowNotice | viewer | none | hydrate | no | after the first follow |
|
||||
| ChannelStats | `getPredictionStats(creatorId)` | streamed | none | secondary | own `<Suspense>` and `PartBoundary`; `CreatorStats`, empty when the record isn't public |
|
||||
| ChannelFeed | `getCreatorPosts(creatorId)` | streamed | hydrate | primary | own `<Suspense>` and `PartBoundary`; an `<a href>` per post, the only links to post pages; re-read in the browser for the creator or a subscriber (0021) |
|
||||
| ↳ Locked post gate | viewer | skeleton | hydrate | no | guest: login back here; investor: checkout |
|
||||
| ↳ Load more | query | none | hydrate | no | a `<button>` that reads the next page |
|
||||
| ↳ PostLightbox | — | none | interaction | no | `next/dynamic`, mounted on the first image tap |
|
||||
|
||||
## Notes
|
||||
|
||||
- bull: under `MobileTopBar`, a padded column; bear: one 640px column under «بازگشت», header in a card. Both hold the same primary and secondary rows.
|
||||
- A channel under review (`verificationPending`) is public and indexable, but `PendingChannelGate` renders the header skeleton for every visitor until the viewer is known, so its server HTML holds no primary content.
|
||||
- bear's `@modal/channels/[username]/page.tsx` returns `null`: it empties the `@modal` slot after publishing lands here (0023).
|
||||
- Debt: `loading.tsx` wraps an indexable entity page: a missing channel answers 200, and past 12,800 bytes the content follows the skeleton. Delete it; the channel's links are `NavLink`s.
|
||||
- Debt: `ChannelFeed` is primary but sits in `<Suspense>` (`ChannelTemplate.tsx`: bull line 110, bear line 113). Await `getCreatorPosts` in the page entry beside `getChannel`.
|
||||
- Debt: older posts are reachable only through «Load more» (`ChannelFeedList.tsx:109`). Add `?page=` pagination with `<a href>` links.
|
||||
- Debt: `PendingChannelGate` (`ChannelTemplate.tsx`: bull line 134, bear line 133) keeps a public channel's primary content out of the server HTML. Render the public channel on the server and swap only for the owner, or set `noindex` while pending.
|
||||
- Debt: no JSON-LD; a seller-type page gets `BreadcrumbList`. The repo has no json-ld lib yet.
|
||||
|
|
@ -0,0 +1,35 @@
|
|||
# Checkout
|
||||
|
||||
`/checkout/[username]` · `apps/{bull,bear}/src/app/(flow)/checkout/[username]/page.tsx` · Type: cart and checkout · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`, because `loading.tsx` streams the page: an invalid or unknown username renders the not-found UI in the stream; another spelling of the username redirects in the stream to the stored one, with `?code=` kept (0059), not a 308; a suspended channel redirects in the stream to the channel |
|
||||
| loading.tsx | `checkout/[username]/loading.tsx`: bull: the bar; bear: the header and title; then `CheckoutSkeleton` with `CheckoutCreatorSkeleton`, `delayed` |
|
||||
| First flush | none: the page entry awaits `getChannel(username)` through `readOnServer` under `loading.tsx`, so the page streams behind the skeleton |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | bull: none (the bar's name isn't a heading); bear: `DesktopPageTitle`, `payment:checkout.title` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------------------------------------------------- | ---------------------- | -------- | ------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| MobileTopBar (bull) | config | streamed | hydrate | no | back to the channel; no bottom nav |
|
||||
| DesktopHeader (bear) | viewer | streamed | hydrate | no | rows as in [layout-main.md](layout-main.md) |
|
||||
| DesktopPageTitle (bear) | config | streamed | hydrate | no | back to the channel, beside the title |
|
||||
| CheckoutCreator | `getChannel(username)` | streamed | none | no | avatar, name and @username; a Server Component passed into the client panel, so the skeleton shows it too |
|
||||
| CheckoutPanel | viewer | skeleton | hydrate | no | `AuthGuard role="investor"`: a guest goes to login and back, a creator gets no-access; `useInviteLink` keeps `?code=` for this creator on arrival (0059, 0030); its own `PartBoundary` |
|
||||
| ↳ CheckoutForm: tiers, invite note and code, pay footer | query | skeleton | hydrate | no | `useCheckoutPage`'s browser read; the skeleton stays while a payment left at the bank settles (0033); a reactivation shows the start-today note instead of the code (U11) |
|
||||
| ↳ CheckoutHalts | query | none | hydrate | no | dialogs when the investor can't pay here |
|
||||
| ↳ NoCodeSheet | `getChannel(username)` | none | hydrate | no | «کد ندارم»: where to get a code, from the creator's links; mounts when opened |
|
||||
|
||||
## Notes
|
||||
|
||||
- bull pins the pay block to the bottom of the screen; bear sticks it to the bottom of the window in a 480 column. Same sections otherwise.
|
||||
- The redirect and not-found cases run after the skeleton is sent, so they never set the status line. That is fine for a `noindex` page reached only from the channel's «اشتراک».
|
||||
- Debt: different H1 per app. bull has no `h1`; add a screen-reader `h1` to `CheckoutTemplate` in bull (`apps/bull/src/app/(flow)/checkout/[username]/templates/checkout-template/CheckoutTemplate.tsx:19`).
|
||||
|
|
@ -0,0 +1,31 @@
|
|||
# Edit post
|
||||
|
||||
`/compose/post/[id]` · `apps/{bull,bear}/src/app/(flow)/compose/post/[id]/page.tsx`; bear's dialog: `apps/bear/src/app/(main)/@modal/(.)compose/post/[id]/page.tsx` · Type: account · Layout: [layout.md](layout.md); the dialog: [layout-main.md](layout-main.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`: under `loading.tsx`, a malformed id (`POST_ID_PATTERN`) renders the not-found UI in the stream; the check exists because the API answers such an id with a 500 |
|
||||
| loading.tsx | `compose/post/[id]/loading.tsx`: bull: the form skeleton only; bear: the header and the form skeleton; `delayed`. The dialog has none |
|
||||
| First flush | none: the page entry awaits only `params` |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | bull: none (the composer's bar names it, in the browser); bear: the composer card's header, `content:composer.edit-title`, in the browser |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order. `compose/layout.tsx` is only `OnboardingGuard` (0016): it renders nothing, and sends a creator who hasn't finished step 5 to the creator profile.
|
||||
|
||||
| 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) |
|
||||
| PostComposer | viewer | skeleton | hydrate | no | `AuthGuard role="creator"`, fallback `SkeletonPreset form`; `usePublishAccess`: pending keeps the skeleton, blocked sends the creator to their channel (0060) |
|
||||
| ↳ EditComposer | query | skeleton | hydrate | no | `useEditablePost(postId)` in the browser; past the 15-minute window or not the creator's own, an `EmptyState` says why (0022); else `ComposerForm` filled with the post |
|
||||
| ↳ LeaveConfirm | — | none | hydrate | no | mounts when leaving with changes |
|
||||
| PostComposerDialog (bear) | viewer | none | interaction | no | the `@modal` intercept (J08-4-D, 0023), on a soft navigation from a main page: «ویرایش پست» as a 640 dialog over that page; fallback `PostComposerDialogSkeleton edit`; the same id check calls `notFound()` |
|
||||
|
||||
## Notes
|
||||
|
||||
- A hard load of the URL gets the full page; a soft navigation from a `(main)` page gets the dialog over it (see [compose-post.md](compose-post.md)).
|
||||
- Debt: different H1 per app. bull has no `h1`; add a screen-reader `h1` to `ComposerForm`'s mobile branch (`platforms/market/src/app/screens/(flow)/compose/post/organisms/post-composer/components/ComposerForm.tsx:64`).
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
# New post
|
||||
|
||||
`/compose/post` · `apps/{bull,bear}/src/app/(flow)/compose/post/page.tsx`; bear's dialog: `apps/bear/src/app/(main)/@modal/(.)compose/post/page.tsx` · Type: account · Layout: [layout.md](layout.md); the dialog: [layout-main.md](layout-main.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 page-size no-access state |
|
||||
| loading.tsx | `compose/post/loading.tsx`: bull: the form skeleton only; bear: the header and the form skeleton; `delayed`. The dialog has none |
|
||||
| First flush | none |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | bull: none (the composer's bar names it, in the browser); bear: the composer card's header, `content:composer.new-title`, in the browser |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order. `compose/layout.tsx` is only `OnboardingGuard` (0016): it renders nothing, and sends a creator who hasn't finished step 5 to the creator profile.
|
||||
|
||||
| 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) |
|
||||
| PostComposer | viewer | skeleton | hydrate | no | `AuthGuard role="creator"`, fallback `SkeletonPreset form`; then `usePublishAccess`: pending keeps the skeleton, blocked sends the creator to their channel (`ComposerLockedRedirect`, 0060) |
|
||||
| ↳ ComposerForm | viewer | skeleton | hydrate | no | bull: `MobileTopBar`, the «انصراف» row, the body, and a pinned footer with add image, count and submit; bear: a 640 card with its `h1` header; the draft lives in the persisted post-draft store; rules from `POST_LIMITS` (0022); publish sends an `Idempotency-Key` (0060) |
|
||||
| ↳ LeaveConfirm | — | none | hydrate | no | mounts when leaving with something to lose |
|
||||
| PostComposerDialog (bear) | viewer | none | interaction | no | the `@modal` intercept (0023), on a soft navigation from a main page: the composer as a 640 dialog over that page; fallback `PostComposerDialogSkeleton`; anyone but a creator gets no-access inside the dialog; its route chunk loads with the navigation |
|
||||
|
||||
## Notes
|
||||
|
||||
- A hard load or refresh of `/compose/post` gets the full page; a soft navigation from a `(main)` page gets the dialog over it. When nothing in `(main)` is under the dialog, `(main)/default.tsx` loads the URL again, so the full page takes over. `@modal/feed` and `@modal/channels/[username]` are null pages that empty the slot after publishing (0023).
|
||||
- bull's server HTML holds only the form skeleton: no top bar until the browser knows the viewer.
|
||||
- Debt: different H1 per app. bull has no `h1`; add a screen-reader `h1` to `ComposerForm`'s mobile branch (`platforms/market/src/app/screens/(flow)/compose/post/organisms/post-composer/components/ComposerForm.tsx:64`).
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
# New prediction
|
||||
|
||||
`/compose/prediction` · `apps/{bull,bear}/src/app/(flow)/compose/prediction/page.tsx`; bear's dialog: `apps/bear/src/app/(main)/@modal/(.)compose/prediction/page.tsx` · Type: account · Layout: [layout.md](layout.md); the dialog: [layout-main.md](layout-main.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 page-size no-access state |
|
||||
| loading.tsx | `compose/prediction/loading.tsx`: bull: the form skeleton only; bear: the header and the form skeleton; `delayed`. The dialog has none |
|
||||
| First flush | none |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | bull: none (the composer's bar names it, in the browser); bear: the 960 card's header, `predictions:composer.title`, in the browser |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order. `compose/layout.tsx` is only `OnboardingGuard` (0016): it renders nothing, and sends a creator who hasn't finished step 5 to the creator profile.
|
||||
|
||||
| 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) |
|
||||
| PredictionComposer | viewer | skeleton | hydrate | no | `AuthGuard role="creator"`, fallback `SkeletonPreset form`; `usePublishAccess`: pending keeps the skeleton, blocked sends the creator to their channel (J09-1e, 0060) |
|
||||
| ↳ ComposerPage | viewer | skeleton | hydrate | no | bull: `MobileTopBar`, the «انصراف» row, the fields, the preview, and «انتشار پیشبینی» pinned; bear: a 960 card drawn as the dialog, with its `h1`, the fields beside the preview; published, it replaces itself with the creator's channel |
|
||||
| ↳ SymbolPicker | query | none | hydrate | no | «انتخاب نماد»: bull: a sheet; bear: a modal; mounts on open, then searches symbols in the browser |
|
||||
| ↳ ConfirmPublish, LeaveConfirm | — | none | hydrate | no | mount on publish and on leaving with something to lose |
|
||||
| PredictionComposerDialog (bear) | viewer | none | interaction | no | the `@modal` intercept (J09-1-D, 0023), on a soft navigation from a main page: the 960 dialog over that page; fallback `PredictionComposerDialogSkeleton`; anyone but a creator gets no-access inside the dialog |
|
||||
|
||||
## Notes
|
||||
|
||||
- A hard load or refresh gets the full page; a soft navigation from a `(main)` page gets the dialog over it (see [compose-post.md](compose-post.md)).
|
||||
- Debt: different H1 per app. bull has no `h1`; add a screen-reader `h1` to `ComposerPage`'s mobile branch (`platforms/market/src/app/screens/(flow)/compose/prediction/organisms/prediction-composer/components/ComposerPage.tsx:57`).
|
||||
|
|
@ -0,0 +1,33 @@
|
|||
# Dashboard: finance
|
||||
|
||||
`/dashboard/finance` · `apps/{bull,bear}/src/app/(main)/dashboard/(creator)/finance/page.tsx` · Type: account · Layout: [layout-dashboard-creator.md](layout-dashboard-creator.md), [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200` for every viewer: a guest is sent to login in the browser, an investor sees `AuthGuard`'s no-access state under the payout notice |
|
||||
| loading.tsx | `(creator)/finance/loading.tsx`: the payout notice in place, then the three skeletons, `delayed` |
|
||||
| First flush | none |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | bull: none (see the layout doc); bear: «داشبورد» in the layout |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------- | ------ | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| PayoutScheduleNotice | config | first flush | none | no | the payout weekday from `PAYOUT_WEEKDAY`; the same for every creator, outside `AuthGuard` |
|
||||
| BalanceSummary | viewer | skeleton | hydrate | no | in `AuthGuard role="creator"`; `BalanceSummaryBoundary` outside its `<Suspense>`, so a failed balance never hides the ledger (J10-6f) |
|
||||
| PayoutAccount | viewer | skeleton | hydrate | no | the شبا form or the saved account; own `PartBoundary` and `<Suspense>`; the account menu links here with `#payout-account` |
|
||||
| ↳ ReadBackDialog | viewer | none | hydrate | no | mounts when the creator confirms a شبا |
|
||||
| Ledger | viewer | skeleton | hydrate | no | گردش حساب: filter tabs in `?ledger=`, «بیشتر» loads the next page; own `PartBoundary` and `<Suspense>` |
|
||||
| ↳ LedgerDetail | viewer | none | hydrate | no | opened from a row, or by `?entry=` or `?payout=`; bull: a bottom sheet; bear: a side sheet, with the open row marked selected |
|
||||
| ↳ Receipt Lightbox | viewer | none | hydrate | no | mounts when a payout receipt opens (0037) |
|
||||
|
||||
## Notes
|
||||
|
||||
- bull and bear differ only in `layout` for `PayoutAccount`, `Ledger` and their skeletons.
|
||||
- The three parts read only in the browser: `AuthGuard` returns its skeletons on the server.
|
||||
|
|
@ -0,0 +1,27 @@
|
|||
# Dashboard: following
|
||||
|
||||
`/dashboard/following` · `apps/{bull,bear}/src/app/(main)/dashboard/(investor)/following/page.tsx` · Type: account · Layout: [layout-dashboard-investor.md](layout-dashboard-investor.md), [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ----------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200` for every viewer: a guest is sent to login in the browser, a creator sees `AuthGuard`'s page-size no-access state |
|
||||
| loading.tsx | `(investor)/following/loading.tsx`: `SkeletonPreset` list rows, `delayed` |
|
||||
| First flush | none |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | bull: none (see the layout doc); bear: «داشبورد» in the layout |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------- | ------ | -------- | ------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| FollowingList | viewer | skeleton | hydrate | no | in `PartBoundary` (framed) › `AuthGuard role="investor"` › `<Suspense>`; each row links to its channel; «بیشتر» loads the next page (`useSuspenseInfiniteQuery`), or `FollowingEmpty`; unfollow freezes offline (0043) |
|
||||
| ↳ UnfollowConfirm | viewer | none | hydrate | no | mounts when unfollow is tapped |
|
||||
|
||||
## Notes
|
||||
|
||||
- bull and bear differ only in `layout`.
|
||||
|
|
@ -0,0 +1,30 @@
|
|||
# Dashboard: plans
|
||||
|
||||
`/dashboard/plans` · `apps/{bull,bear}/src/app/(main)/dashboard/(creator)/plans/page.tsx` · Type: account · Layout: [layout-dashboard-creator.md](layout-dashboard-creator.md), [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200` for every viewer: a guest is sent to login in the browser, an investor sees `AuthGuard`'s page-size no-access state |
|
||||
| loading.tsx | `(creator)/plans/loading.tsx`: the three cards' skeletons, `delayed` |
|
||||
| First flush | none |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | bull: none (see the layout doc); bear: «داشبورد» in the layout |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order. Everything sits in `AuthGuard role="creator"`, whose fallback is the three skeletons, so the server HTML is only skeletons.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------------------------------- | ------ | -------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| PricingCard | viewer | skeleton | hydrate | no | «قیمت طرحها»: its own `PartBoundary` and `<Suspense>` (`useSuspenseQuery` in the browser); links to `/dashboard/pricing` |
|
||||
| InviteCodeCard | viewer | skeleton | hydrate | no | «کد دعوت»: renders nothing until the creator is approved (J10-1e); the invite link is built from `NEXT_PUBLIC_SITE_URL`; own `PartBoundary` and `<Suspense>` |
|
||||
| ↳ InviteShareSheet, CapacityRequestDialog | viewer | none | hydrate | no | mount when opened; bull: share opens a bottom sheet; bear: a popover beside the link field |
|
||||
| AudienceStats | viewer | skeleton | hydrate | no | «مخاطبان»: follower count and active subscriptions, two browser reads; either failing fails the part |
|
||||
|
||||
## Notes
|
||||
|
||||
- bull: cards 12px apart; bear: 16px apart, desktop card layouts. Same sections in both apps.
|
||||
- The cards' queries run only in the browser: `AuthGuard` returns its fallback on the server, so no `useSuspenseQuery` sends a request from the server.
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
# Dashboard: all predictions
|
||||
|
||||
`/dashboard/predictions/all` · `apps/{bull,bear}/src/app/(main)/dashboard/predictions/all/page.tsx` · Type: account · Layout: [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200` for every viewer: a guest is sent to login in the browser, an investor sees `AuthGuard`'s no-access state |
|
||||
| loading.tsx | `dashboard/predictions/all/loading.tsx`: the real top bar (bull) or page title (bear) over `PredictionListSkeleton`, `delayed` |
|
||||
| First flush | none |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | bull: none, the bar's «همه پیشبینیها» is a `<span>`; bear: «همه پیشبینیها» in `DesktopPageTitle` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------------- | ------ | ----------- | ----------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| MobileTopBar (bull) | config | first flush | hydrate | no | a pushed page's bar: back to `/dashboard/predictions` (0057) and support |
|
||||
| ↳ Page name (bull) | viewer | skeleton | hydrate | no | the bar shows the name only to a member, so the server HTML holds a skeleton in its place |
|
||||
| DesktopPageTitle (bear) | config | first flush | hydrate | no | «بازگشت» (`DeskBack`) to `/dashboard/predictions`, then the `<h1>` |
|
||||
| PredictionList | viewer | skeleton | hydrate | no | in `PartBoundary` › `AuthGuard role="creator"` › `<Suspense>`; status chips in `?status=` (open by default), «بیشتر» loads the next page (`useSuspenseInfiniteQuery`) |
|
||||
| ↳ ClosePredictionSheet | viewer | none | interaction | no | `next/dynamic`, rendered on the first «بستن زودهنگام» tap of an open card |
|
||||
|
||||
## Notes
|
||||
|
||||
- Not in the `(creator)` group, so it has neither the tabs nor the dashboard heading. Its own `layout.tsx` is only `OnboardingGuard`, which sends a creator who hasn't finished step 5 to onboarding once the browser knows the viewer (0016), and renders nothing itself.
|
||||
- bear's `PartBoundary` is `framed`; bull's isn't.
|
||||
- Debt: bull has no `<h1>` and its page name is a skeleton until the viewer is known, while bear's `<h1>` is server HTML, `apps/bull/src/app/(main)/dashboard/predictions/all/page.tsx:30`. Render the pushed page's name in the bar's server HTML as an `<h1>`, as bear does.
|
||||
|
|
@ -0,0 +1,31 @@
|
|||
# Dashboard: predictions
|
||||
|
||||
`/dashboard/predictions` · `apps/{bull,bear}/src/app/(main)/dashboard/(creator)/predictions/page.tsx` · Type: account · Layout: [layout-dashboard-creator.md](layout-dashboard-creator.md), [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200` for every viewer: a guest is sent to login in the browser, an investor sees `AuthGuard`'s page-size no-access state |
|
||||
| loading.tsx | `(creator)/predictions/loading.tsx`: `PredictionsTabSkeleton`, `delayed` |
|
||||
| First flush | none |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | bull: none (see the layout doc); bear: «داشبورد» in the layout |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order. Everything sits in `AuthGuard role="creator"`, whose fallback is `PredictionsTabSkeleton`.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| --------------------------------------- | ------ | -------- | ----------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| PredictionsTab | viewer | skeleton | hydrate | no | `useQuery` for open and closed; before the first prediction, only the empty state with «پیشبینی جدید» to `/compose/prediction` (J10-3c) |
|
||||
| ↳ TrackRecord | viewer | skeleton | hydrate | no | the record or its progress to public; own `PartBoundary` and `<Suspense>` |
|
||||
| ↳ PredictionSection «باز» | viewer | skeleton | hydrate | no | every open prediction as `OwnPredictionCard`; not drawn when empty; loads and fails on its own |
|
||||
| ↳↳ ClosePredictionSheet | viewer | none | interaction | no | `next/dynamic`, rendered on the first «بستن زودهنگام» tap; its price poll loads with it |
|
||||
| ↳ PredictionSection «بستهشدههای اخیر» | viewer | skeleton | hydrate | no | the two closed most recently; then «همه پیشبینیها», an `<a href>` to `/dashboard/predictions/all` |
|
||||
|
||||
## Notes
|
||||
|
||||
- bull and bear differ only in `layout` (card and sheet placement). A card's tap opens its post.
|
||||
- `/dashboard/predictions/all` is a separate page outside the `(creator)` group, under its own `OnboardingGuard` layout: [dashboard-predictions-all.md](dashboard-predictions-all.md).
|
||||
|
|
@ -0,0 +1,31 @@
|
|||
# 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).
|
||||
|
|
@ -0,0 +1,29 @@
|
|||
# Dashboard: subscriptions
|
||||
|
||||
`/dashboard/subscriptions` · `apps/{bull,bear}/src/app/(main)/dashboard/(investor)/subscriptions/page.tsx` · Type: account · Layout: [layout-dashboard-investor.md](layout-dashboard-investor.md), [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ----------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200` for every viewer: a guest is sent to login in the browser, a creator sees `AuthGuard`'s page-size no-access state |
|
||||
| loading.tsx | `(investor)/subscriptions/loading.tsx`: `SkeletonPreset` list of cards, `delayed` |
|
||||
| First flush | none |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | bull: none (see the layout doc); bear: «داشبورد» in the layout |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ---------------- | ------ | -------- | ------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| SubscriptionList | viewer | skeleton | hydrate | no | in `PartBoundary size="page"` › `AuthGuard role="investor"` › `<Suspense>`; active and expired subscriptions from two browser reads (`useSuspenseQueries`), or `SubscriptionsEmpty` |
|
||||
| ↳ RenewalSheet | viewer | none | hydrate | no | mounts when renew or reactivate opens, also from `?reactivate=<id>`; its form has its own `PartBoundary` and `<Suspense>`; bull: a bottom sheet; bear: a modal |
|
||||
| ↳ SupportDialog | — | none | hydrate | no | mounts when a subscription's support entry opens |
|
||||
|
||||
## Notes
|
||||
|
||||
- bull's skeleton cards are `md`, bear's `lg`; the list differs only in `layout`.
|
||||
- A failed read replaces the list with the page-size error; the tabs stay (U2 ۳.۴).
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
# Dashboard: transactions
|
||||
|
||||
`/dashboard/transactions` · `apps/{bull,bear}/src/app/(main)/dashboard/(investor)/transactions/page.tsx` · Type: account · Layout: [layout-dashboard-investor.md](layout-dashboard-investor.md), [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ----------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200` for every viewer: a guest is sent to login in the browser, a creator sees `AuthGuard`'s page-size no-access state |
|
||||
| loading.tsx | `(investor)/transactions/loading.tsx`: `SkeletonPreset` list rows without avatars, `delayed` |
|
||||
| First flush | none |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | bull: none (see the layout doc); bear: «داشبورد» in the layout |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------------- | ------ | -------- | ------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| TransactionList | viewer | skeleton | hydrate | no | in `PartBoundary size="page"` › `AuthGuard role="investor"` › `<Suspense>`; status chips in `?status=`, «بیشتر» loads the next page (`useSuspenseInfiniteQuery`), or `TransactionsEmpty` |
|
||||
| ↳ TransactionDetail | viewer | none | hydrate | no | mounts when a row opens |
|
||||
|
||||
## Notes
|
||||
|
||||
- bull and bear differ only in `layout`.
|
||||
- A failed read replaces the list, without the chips; the tabs stay (U4 ۴.۳).
|
||||
|
|
@ -0,0 +1,35 @@
|
|||
# خانه (home feed)
|
||||
|
||||
`/feed` · `apps/{bull,bear}/src/app/(main)/feed/page.tsx` · Type: account · Layout: [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------ |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; a guest is sent to login and a creator to their channel, in the browser |
|
||||
| loading.tsx | `(main)/feed/loading.tsx`: the frame and three post skeletons |
|
||||
| First flush | none: the page entry reads nothing; the feed is read in the browser with the session |
|
||||
| Canonical | none |
|
||||
| H1 | none in either app: bull's tab bar has no title, bear's column has no heading |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------------------------------------- | ------ | ----------- | ----------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| MobileTopBar (bull) | config | first flush | hydrate | no | the tab bar (`isTab`): brand and support |
|
||||
| ↳ Bell, account avatar or login link (bull) | viewer | skeleton | hydrate | no | an invisible «ورود/ثبتنام» holds the place until the viewer is known |
|
||||
| HomeGuard | viewer | skeleton | hydrate | no | `HomeFeedSkeleton` until the viewer is known; a creator is replaced to `homeRoute`, a guest goes to login via `AuthGuard role="investor"` |
|
||||
| HomeFeed | query | skeleton | hydrate | no | `useSuspenseInfiniteQuery(feedKeys.home())` inside `<Suspense>` and `PartBoundary name="home-feed"`; bear: `framed` |
|
||||
| ↳ FeaturedRow | query | skeleton | hydrate | no | `useFeaturedCreatorsPart`, prefetched beside the feed; links to `/analysts` |
|
||||
| ↳ ChannelPostCard list | query | skeleton | hydrate | no | each card links its post and channel; «بیشتر» loads the next page on click |
|
||||
| ↳ HomeFeedEmpty, FeaturedMore | query | skeleton | hydrate | no | the featured analysts to follow while the viewer follows nobody |
|
||||
| ↳ PostLightbox | — | none | interaction | no | `next/dynamic`, rendered on the first image tap |
|
||||
| InstallPrompt (bull) | viewer | none | hydrate | no | the install sheet once for a signed-in investor, 30-day snooze (0047) |
|
||||
|
||||
## Notes
|
||||
|
||||
- bear: `@modal/feed/page.tsx` renders null, so a «پست جدید» dialog closes when a navigation lands on خانه (0023).
|
||||
- Debt: no H1 in either app. Give the page an `sr-only` H1, as `GeneralRules` does.
|
||||
|
|
@ -0,0 +1,43 @@
|
|||
# Landing
|
||||
|
||||
`/` · `apps/{bull,bear}/src/app/(landing)/page.tsx` · Type: home · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `index` |
|
||||
| Status | `200`; prerendered with `force-static` and `revalidate = 600` (0026), so a failed revalidation keeps serving the last good page |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(landing)/loading.tsx` (debt, Notes) |
|
||||
| First flush | `loadLandingPage()` → `getFeaturedCreators()`, awaited by the page entry at build and at each revalidation; the metadata is fixed, in the `metadata` export (`landingMetadata`) |
|
||||
| Canonical | `/`, from `landingMetadata` |
|
||||
| H1 | `landing:hero.title` from i18n, in `LandingHero` |
|
||||
| JSON-LD | `faqJsonLd(faqEntries(labels.faq))`: `FAQPage`, a raw `<script type="application/ld+json">` after the template |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order. The header and footer belong to `LandingTemplate`, not a layout.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------------------ | ----------------------- | ----------- | ------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| LandingHeader | config | first flush | none | no | brand `<a href="#top">`, login `<a href>` to `/auth/login` |
|
||||
| ↳ Section links (bear) | config | first flush | none | no | in-page `#fragment` links to the bands |
|
||||
| ↳ SupportEntry | config | first flush | hydrate | no | the icon trigger; its `SupportDialog` mounts closed, bull: bottom sheet, bear: popover |
|
||||
| LandingHero, with the H1 | config | first flush | none | primary | register `<a href>` (investor) and `#how` |
|
||||
| LandingTrust | config | first flush | none | secondary | |
|
||||
| LandingMarkets | config | first flush | hydrate | secondary | `MarketTabs`: every panel in the DOM, closed ones `hidden`; sample data at the fixed `SAMPLE_NOW` |
|
||||
| FeaturedAnalysts | `getFeaturedCreators()` | first flush | hydrate | primary | an `AnalystCard` `<a href>` per channel, the landing's only links to channels; `AnalystCarousel` only scrolls; left out, with its header link, below `FEATURED_MIN_COUNT` |
|
||||
| LandingRecord | config | first flush | none | secondary | sample track record at `SAMPLE_NOW` |
|
||||
| LandingSteps | config | first flush | none | secondary | |
|
||||
| LandingPlans | config | first flush | hydrate | secondary | a sample locked `PostCard` as a guest sees it; its share popover is the client leaf |
|
||||
| LandingForAnalysts | config | first flush | none | secondary | apply `<a href>` to creator registration |
|
||||
| LandingFaq | config | first flush | hydrate | primary | `<details>`, every answer in the DOM, the first open; the support link is the client leaf |
|
||||
| LandingClosing | config | first flush | none | secondary | register and login `<a href>` |
|
||||
| LandingFooter | config | first flush | none | primary | `#fragment` links, `/terms/subscription`, Bale and Telegram chats |
|
||||
| LandingRedirect | viewer | none | hydrate | no | renders nothing; sends a member to `homeRoute` with `router.replace` (0027) |
|
||||
|
||||
## Notes
|
||||
|
||||
- bull: `layout="mobile"`; bear: `layout="desktop"`, which adds the header's section links and opens support as a popover. Both apps hold the same primary and secondary sections.
|
||||
- `force-static` contradicts the skill's "never static rendering"; accepted decision 0026 overrides it. The page reads no session, so the prerender is the same for every visitor.
|
||||
- Debt: `apps/{bull,bear}/src/app/(landing)/loading.tsx` wraps an indexable page. Once the prerendered HTML passes 12,800 bytes, the whole landing follows the skeleton in a hidden `<div>`. Delete it; links to `/` are `NavLink`s.
|
||||
- Debt: `FAQPage` markup (`platforms/market/src/app/seo/landing.ts:31`), which Google no longer shows; the home page gets `Organization` and `WebSite` from config instead. The graph is a raw `Element` script after the template (`apps/{bull,bear}/src/app/(landing)/page.tsx:58`), not one `<JsonLd>` before it: the repo has no json-ld lib or island `JsonLd` yet.
|
||||
|
|
@ -0,0 +1,19 @@
|
|||
# Layout: dashboard (creator)
|
||||
|
||||
`apps/{bull,bear}/src/app/(main)/dashboard/(creator)/layout.tsx` · wraps `/dashboard/plans`, `/dashboard/predictions` and `/dashboard/finance` · it awaits no read, so it adds nothing to any page's first flush; it sits outside each tab's `loading.tsx`, so the bar and the tabs stay while a tab loads
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------------------------- | ------ | ----------- | ------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| OnboardingGuard | viewer | none | hydrate | no | renders its children unchanged; once the browser knows the viewer, a creator who hasn't finished step 5 is sent to `/onboarding/creator-profile` with a return path (0016) |
|
||||
| MobileTopBar (bull) | config | first flush | hydrate | no | `isTab`: the brand and «داشبورد» centred, in a `<span>`; support entry; the connection bar under it (0040) |
|
||||
| ↳ NotificationBell and account avatar (bull) | viewer | none | hydrate | no | member only; while the viewer is unknown, the guest's «ورود/ثبتنام» holds the end of the bar, invisible |
|
||||
| «داشبورد» `<h1>` (bear) | config | first flush | none | no | at the top of the 640 column |
|
||||
| DashboardTabs | config | first flush | hydrate | no | `role="creator"`: island `TabLinks`, an `<a href>` per tab «طرحهای اشتراک» · «پیشبینیها» · «مالی» (0034); the active tab comes from `usePathname`, so the server HTML already marks it |
|
||||
|
||||
Scripts: none beyond the root layout's.
|
||||
|
||||
## Notes
|
||||
|
||||
- The tabs' URLs don't overlap the investor group's: `(creator)` owns `plans`, `predictions` and `finance`, `(investor)` owns `subscriptions`, `transactions` and `following`. There is no `/dashboard` page, so `/dashboard` answers the root not-found. The bottom nav (bull) and the header (bear) link a creator to `/dashboard/plans` and an investor to `/dashboard/subscriptions`.
|
||||
- The layout doesn't check the role: each page's `AuthGuard role="creator"` shows an investor the page-size no-access state, under these tabs.
|
||||
- Debt: bull has no `<h1>` (the bar's «داشبورد» is a `<span>`), bear has one, `apps/bull/src/app/(main)/dashboard/(creator)/layout.tsx:22`. Make the bar's tab title an `<h1>` on tab screens, or add a visually hidden `<h1>` in the bull layout.
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
# Layout: dashboard (investor)
|
||||
|
||||
`apps/{bull,bear}/src/app/(main)/dashboard/(investor)/layout.tsx` · wraps `/dashboard/subscriptions`, `/dashboard/transactions` and `/dashboard/following` · it awaits no read, so it adds nothing to any page's first flush; it sits outside each section's `loading.tsx`, so the bar and the tabs stay while a section loads
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------------------------- | ------ | ----------- | ------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| MobileTopBar (bull) | config | first flush | hydrate | no | `isTab`: the brand and «داشبورد» centred, in a `<span>`; support entry; the connection bar under it (0040) |
|
||||
| ↳ NotificationBell and account avatar (bull) | viewer | none | hydrate | no | member only; while the viewer is unknown, the guest's «ورود/ثبتنام» holds the end of the bar, invisible |
|
||||
| «داشبورد» `<h1>` (bear) | config | first flush | none | no | at the top of the 640 column |
|
||||
| DashboardTabs | config | first flush | hydrate | no | island `TabLinks`, an `<a href>` per section «اشتراکها» · «تراکنشها» · «دنبالشدهها» (0025); the active one comes from `usePathname`, so the server HTML already marks it |
|
||||
|
||||
Scripts: none beyond the root layout's.
|
||||
|
||||
## Notes
|
||||
|
||||
- No guard in the layout: each page's `AuthGuard role="investor"` sends a guest to login and shows a creator the page-size no-access state, under these tabs. A creator's داشبورد is [layout-dashboard-creator.md](layout-dashboard-creator.md); the two groups' URLs don't overlap.
|
||||
- Debt: bull has no `<h1>` (the bar's «داشبورد» is a `<span>`), bear has one, `apps/bull/src/app/(main)/dashboard/(investor)/layout.tsx:21`. Same fix as the creator layout.
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
# Layout: main
|
||||
|
||||
`apps/{bull,bear}/src/app/(main)/layout.tsx` · wraps every page in `(main)` · it reads nothing on the server, so it holds no page's first byte; `force-dynamic` (0026) · inside [layout.md](layout.md)
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------------------------------ | ------ | ----------- | ----------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| DesktopHeader (bear) | config | first flush | hydrate | no | sticky; holds the NetworkBar under it in the same sticky box |
|
||||
| ↳ Brand link (bear) | viewer | first flush | hydrate | no | `useHomeHref`: `/feed` while the viewer is unknown (so in the server HTML), `/` for a guest, `homeRoute` for a member |
|
||||
| ↳ Nav: خانه or کانال, داشبورد (bear) | viewer | none | hydrate | no | members only; `HeaderNavLink` is `next/link` |
|
||||
| ↳ SearchField (bear) | viewer | none | hydrate | no | investors only, not on `/search`; Enter calls `router.push('/search?q=…')` |
|
||||
| ↳ PublishMenu (bear) | viewer | none | hydrate | no | creators only; «پست جدید» and «پیشبینی جدید» open the `@modal` intercepts (0023) |
|
||||
| ↳ SupportEntry (bear) | config | first flush | hydrate | no | the icon trigger; its `SupportDialog` popover renders only while open |
|
||||
| ↳ NotificationBell (bear) | viewer | none | hydrate | no | members only; the unread count is a browser `useQuery` |
|
||||
| ↳ NotificationPanel (bear) | query | none | interaction | no | the bell's side panel: `next/dynamic` with `ssr: false`, mounted on the bell's first click |
|
||||
| ↳ Login button or AccountMenu (bear) | viewer | skeleton | hydrate | no | while the viewer is unknown, an invisible «ورود/ثبتنام» holds the place; a guest gets the login link, a member the account menu |
|
||||
| `@modal` slot (bear) | — | none | interaction | no | `@modal/default.tsx` renders null; the `(.)compose/*` intercepts load with a soft navigation to `/compose/*`; `@modal/feed` and `@modal/channels/[username]` are null pages that empty the slot |
|
||||
| BottomNav (bull) | viewer | none | hydrate | no | members only, not in a creator's preview; nothing renders until the viewer is known, and the bar is fixed, so nothing moves; a creator's middle tab is PublishMenu |
|
||||
|
||||
Scripts: none.
|
||||
|
||||
## Notes
|
||||
|
||||
- Each page brings its own top bar: bull's `MobileTopBar`, bear's `DeskBack`, `DesktopPageTitle` or `PageHeader`. They are rows of the page docs.
|
||||
- bull and bear build separately, so a client component that one app renders never ships to the other.
|
||||
- `apps/bear/src/app/(main)/default.tsx` is the `children` default: when a soft navigation lands on a `@modal` intercept with no main page under it, it reloads the URL so the full `/compose/*` page renders.
|
||||
- A failed page shows `(main)/error.tsx`: `PageError` with the page's own bar (0049); bull keeps the BottomNav under it.
|
||||
- Debt: the server HTML links the brand to `/feed`, a `noindex` page behind `AuthGuard`, on every main page, including the indexable channel and post pages (`platforms/market/src/app/navigation/hooks/use-home-href.ts:18`). Link `/` while the viewer is unknown; `LandingRedirect` sends a member on (0027).
|
||||
- Debt: the header search is not a `GET` form to `/search`, so it does nothing before hydration (`platforms/market/src/app/navigation/components/desktop-header/DesktopHeader.tsx:46`). It is member-only, so the cost is low.
|
||||
|
|
@ -0,0 +1,16 @@
|
|||
# Layout: terms
|
||||
|
||||
`apps/{bull,bear}/src/app/(flow)/terms/layout.tsx` · wraps `/terms` and `/terms/subscription` · it awaits no read: its text is server i18n (`rules`), so it adds nothing to the first byte
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------------------------------ | ------ | ----------- | ------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| MobileTopBar (bull) | viewer | skeleton | hydrate | no | back to where the rules were opened, and support, in the first flush; the title «قوانین لومینا» waits for the viewer |
|
||||
| DesktopHeader (bear) | viewer | skeleton | hydrate | no | brand `<a href>` and support in the first flush; nav, bell, account menu and login wait for the viewer ([layout-main.md](layout-main.md)) |
|
||||
| DesktopPageTitle, with the H1 (bear) | config | first flush | hydrate | no | «بازگشت» and the H1 `rules:title`; bull puts its H1 in each page instead |
|
||||
| RulesTabs | config | first flush | hydrate | primary | `TabLinks`: `<a href>` to `/terms` and `/terms/subscription`; `usePathname` marks the current tab |
|
||||
|
||||
Scripts: none.
|
||||
|
||||
- (flow) adds `force-dynamic` and no UI. The layout's static `metadata` gives `rules:meta-title` and `rules:meta-description`; each page overrides them.
|
||||
- bull: a white page with no bottom nav; bear: `DesktopHeader` over the 640px column, since (flow) has no header of its own.
|
||||
- Debt: bear's H1 lives here, so `/terms/subscription` gets «قوانین لومینا» on bear and «شرایط اشتراک» on bull (`apps/bear/src/app/(flow)/terms/layout.tsx:40`). Pass each page's own title to `DesktopPageTitle`, or render the H1 in the page as bull does.
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
# Layout: root
|
||||
|
||||
`apps/{bull,bear}/src/app/layout.tsx` · wraps every page of both apps · it awaits no read, so it adds nothing to any page's first flush and can't answer 500 on its own
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------------------------------------- | ------ | ----------- | ------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `<html lang dir>` and the critical font preload | config | first flush | none | no | `lang` and `dir` from the app's server i18n; only `CRITICAL_FONT_URL` is preloaded (0011) |
|
||||
| AppProviders › AppShell | — | first flush | hydrate | no | the client bootstrap, query client, i18n, and the browser-only hooks: `useSession` (the viewer is read once per load, so every auth-dependent part waits in its skeleton), `useSuspendedHalt`, `useSettleAbandonedPayment` (0033), `usePwa` (0047), and the persisted drafts' rehydrate |
|
||||
| ↳ NetworkBoundary › NetworkStatus | — | none | hydrate | no | renders only offline, reconnecting, or after a slow first read; a page's own top bar or header draws it through `NetworkBar` (0040), and this one draws only when no bar registered |
|
||||
| ToastPlacementMarker (bear) | config | none | hydrate | no | desktop toasts 32px from the bottom (0039) |
|
||||
| ↳ Toaster | — | none | hydrate | no | sonner's region; empty until an action toasts (0019) |
|
||||
|
||||
Scripts: none. No `next/script` in either app or `packages/integrations`.
|
||||
|
||||
## Notes
|
||||
|
||||
- Metadata: `rootMetadata()` from `apps/*/src/configs/seo.ts` gives `metadataBase`, the title template `%s · <brand>`, and the description; pages add their own title and robots. `htmlLimitedBots: /.*/` keeps all of it in `<head>` (0054).
|
||||
- Viewport: bull sets `maximumScale: 1` (0056); bear keeps Next.js's default viewport.
|
||||
- The manifest (`app/manifest.ts`, the same for both apps, 0053) and `/sw.js` (pwa lib) are linked from here. `next.config.ts` 308-redirects `/@username/…` to `/channels/username/…` before any render (0064).
|
||||
- The `(flow)`, `(auth)` and `(onboarding)` layouts render nothing; they only set `dynamic = 'force-dynamic'` (0026). The `(main)` layout is [layout-main.md](layout-main.md).
|
||||
- AppShell is a client component around every page, but it adds no `<Suspense>` around `children`, so it doesn't stream any page.
|
||||
|
|
@ -0,0 +1,29 @@
|
|||
# Not-found and error
|
||||
|
||||
`apps/{bull,bear}/src/app/not-found.tsx`, `global-error.tsx`, and each route group's `error.tsx` · Layout: [layout.md](layout.md)
|
||||
|
||||
Every case below is `noindex`. No page answers 410, and the repo sets up no reverse proxy, so 503 under overload comes from whatever sits in front of the app's port.
|
||||
|
||||
| Case | Status | The server HTML holds |
|
||||
| ----------------------------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| A URL no route matches | 404 | the root `not-found.tsx`: `noindex` from its `metadata`, `StatusEmptyState` (not-found, page size) in the first flush; bull: the `MobileTopBar` behind a same-size frame; bear: the `DesktopHeader` behind one (both read the address in the browser) |
|
||||
| `/@username/…` | 308 to `/channels/username/…` | nothing; `redirects()` in `next.config.ts` answers before any render (0064) |
|
||||
| A channel or post that doesn't exist | 200 | `noindex` and the route's `loading.tsx` skeleton: both routes keep a `loading.tsx`, so `notFound()` runs after the status is sent; the channel's `not-found.tsx` renders in the browser. See [channels-username.md](channels-username.md) and [channels-username-posts-id.md](channels-username-posts-id.md) |
|
||||
| `notFound()` on any other page, all under a `loading.tsx` | 200 | the skeleton and `noindex`; the not-found UI renders in the browser |
|
||||
| A failed read on a page under its `loading.tsx` | 200 | the skeleton and the page's `noindex`; the group's `error.tsx` renders `PageError` in the browser, with its own `noindex` |
|
||||
| A failed read on a page with no `loading.tsx` above it | 500 | `noindex` and an empty `<body>`; the group's `error.tsx` renders in the browser. No page is in this case today: every route keeps a `loading.tsx`. The channel and post pages join it once theirs goes (Notes) |
|
||||
| An error the group boundaries don't catch (root layout, AppShell) | 500 | `global-error.tsx`: its own document with `AppCrash` and `<meta name="robots" content="noindex">`, rendered in the browser |
|
||||
|
||||
## Boundaries
|
||||
|
||||
| File | Renders |
|
||||
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `(main)/error.tsx` | `PageError` with the page's own bar, derived from the path (0049); bull: `layout="mobile"`, the layout keeps the bottom nav; bear: `layout="desktop"` under the header |
|
||||
| `(flow)`, `(auth)`, `(onboarding)` `error.tsx` | `PageError` with `standalone`, a full-height page with its own top bar (0049) |
|
||||
| `(landing)/error.tsx` | `PageError` with `standalone` |
|
||||
| `global-error.tsx` | `AppCrash`: the brand and the way back, in its own `<html>` with the client bootstrap, styles, and i18n |
|
||||
|
||||
## Notes
|
||||
|
||||
- `PageError` and `global-error.tsx` render `<meta name="robots" content="noindex">`; the root `not-found.tsx` sets it in `metadata`.
|
||||
- Debt: the channel and post pages are indexable but keep a `loading.tsx`, so a missing channel or post answers 200 instead of a real 404. See those docs.
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
# اعلانها (notification centre)
|
||||
|
||||
`/notifications` · `apps/{bull,bear}/src/app/(main)/notifications/page.tsx` · Type: account · Layout: [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; a guest is sent to login in the browser |
|
||||
| loading.tsx | `(main)/notifications/loading.tsx`: the bar or title, then list rows |
|
||||
| First flush | none: the page entry reads nothing; the inbox is read in the browser with the session |
|
||||
| Canonical | none |
|
||||
| H1 | bull: none, the top bar's title is a `<span>`; bear: `DesktopPageTitle` «اعلانها» |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ---------------------------- | ------------- | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| MobileTopBar (bull) | config | first flush | hydrate | no | a pushed page's bar: back and support |
|
||||
| ↳ Title or login link (bull) | viewer | skeleton | hydrate | no | |
|
||||
| DesktopPageTitle (bear) | config | first flush | hydrate | no | «بازگشت» and the H1 |
|
||||
| NotificationCentre | viewer, query | skeleton | hydrate | no | `AuthGuard`, then `<Suspense>` and `PartBoundary name="notification-centre"`; `useSuspenseQuery` of the inbox; opening clears the bell (0058); bear: `framed` |
|
||||
| ↳ FilterChips | viewer | skeleton | hydrate | no | creators only: «همه · پیشبینیها · مالی · حساب», filtered in place (0058) |
|
||||
| ↳ NotificationItem list | query | skeleton | hydrate | no | each row leads to its target; a row stays unread until tapped |
|
||||
|
||||
## Notes
|
||||
|
||||
- bear's header bell opens the same centre as a side panel; this page serves a direct load or a link.
|
||||
- Debt: bull has no H1 while bear has one. Give bull an `sr-only` H1 with the same text.
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
# Onboarding: creator profile done
|
||||
|
||||
`/onboarding/creator-profile/done` · `apps/{bull,bear}/src/app/(onboarding)/onboarding/creator-profile/done/page.tsx` · Type: account · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; a guest is replaced to login and an investor sees the no-access state, in the browser (`AuthGuard role="creator"`); an incomplete profile goes back to `/onboarding/creator-profile` in the browser |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(onboarding)/onboarding/creator-profile/done/loading.tsx` |
|
||||
| First flush | `none` |
|
||||
| Canonical | none set |
|
||||
| H1 | `auth:register.profile.done.title`, `ResultPanel`'s title; browser only |
|
||||
| JSON-LD | `none` |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------- | ------------- | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| AuthTopBar (bull) | config | first flush | none | no | brand `<a href="/feed">` and support |
|
||||
| AuthTemplate header (bear) | config | first flush | none | no | brand `<a href="/feed">`; the step in the 560 card |
|
||||
| SupportEntry | — | first flush | hydrate | no | in the bar; the dialog mounts only when open |
|
||||
| NetworkBar | — | none | hydrate | no | under the bar, only while offline or reconnecting |
|
||||
| CreatorProfileDoneStep | viewer, query | skeleton | hydrate | no | `AuthGuard` fallback, then `<Suspense>` with `CreatorProfileDoneStepSkeleton` while `useSuspenseQuery(profileKeys.mine())` loads in the browser; result panel with the pending verification badge, next-steps list |
|
||||
| ↳ Actions | query | skeleton | hydrate | no | `<a href>` to the channel or `?redirect=`, and to `/dashboard/pricing`; support link |
|
||||
|
||||
## Notes
|
||||
|
||||
- Decision 0015 (proposed): the end of registration has its own route because its frame differs from the form's.
|
||||
- The `<Suspense>` sits inside `AuthGuard`, so the query runs only in the browser. Focus moves to the heading.
|
||||
|
|
@ -0,0 +1,36 @@
|
|||
# Onboarding: creator profile
|
||||
|
||||
`/onboarding/creator-profile` · `apps/{bull,bear}/src/app/(onboarding)/onboarding/creator-profile/(form)/page.tsx` · Type: account · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; a guest is replaced to `/auth/login?redirect=` and an investor sees the page-size no-access state, both in the browser (`AuthGuard role="creator"`) |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(onboarding)/onboarding/creator-profile/(form)/loading.tsx` |
|
||||
| First flush | `none` |
|
||||
| Canonical | none set |
|
||||
| H1 | `auth:register.profile.creator.title` in `ProfileForm`; browser only |
|
||||
| JSON-LD | `none` |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------- | ------------- | ----------- | ------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| AuthTopBar (bull) | config | first flush | none | no | `auth:register.header` only: no back, no brand |
|
||||
| AuthTemplate header (bear) | config | first flush | none | no | brand `<a href="/feed">`; `framed={false}`, so form and preview sit side by side |
|
||||
| SupportEntry | — | first flush | hydrate | no | in the bar; the dialog mounts only when open |
|
||||
| NetworkBar | — | none | hydrate | no | under the bar, only while offline or reconnecting |
|
||||
| CreatorProfileStep | viewer, query | skeleton | hydrate | no | `AuthGuard` fallback, then `<Suspense>` with the same `CreatorProfileStepSkeleton` while `useSuspenseQuery(profileKeys.mine())` loads the draft in the browser |
|
||||
| ↳ ProfileForm | query | skeleton | hydrate | no | resume banner, `RegisterProgress`, H1, photo, fields; autosaves the draft (`PATCH`, proposed 0014); «تکمیل ثبتنام» opens `/onboarding/creator-profile/done` |
|
||||
| ↳ SaveStatus | query | skeleton | hydrate | no | the autosave state beside the submit button |
|
||||
| ↳ ProfilePreview (bull) | query | none | hydrate | no | in a `Sheet` opened by «پیشنمایش»; mounts when open |
|
||||
| ↳ ProfilePreview (bear) | query | skeleton | hydrate | no | live preview card in the aside, beside the form |
|
||||
|
||||
## Notes
|
||||
|
||||
- The `(onboarding)` layout renders nothing; it only sets `dynamic = 'force-dynamic'`.
|
||||
- The `<Suspense>` sits inside `AuthGuard`, a client component that returns its fallback on the server, so the query never runs on the server.
|
||||
- A creator who already finished goes on to their channel or `?redirect=` behind the skeleton.
|
||||
|
|
@ -0,0 +1,31 @@
|
|||
# Onboarding: investor profile
|
||||
|
||||
`/onboarding/investor-profile` · `apps/{bull,bear}/src/app/(onboarding)/onboarding/investor-profile/page.tsx` · Type: account · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------------------------ |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; a guest is replaced to login and a creator sees the no-access state, in the browser (`AuthGuard role="investor"`) |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(onboarding)/onboarding/investor-profile/loading.tsx` |
|
||||
| First flush | `none` |
|
||||
| Canonical | none set |
|
||||
| H1 | `auth:register.profile.investor.title`; browser only |
|
||||
| JSON-LD | `none` |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------- | ------ | ----------- | ------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| AuthTopBar (bull) | config | first flush | none | no | `auth:register.header` only: no back, no brand |
|
||||
| AuthTemplate header (bear) | config | first flush | none | no | brand `<a href="/feed">`; the step in the 560 card |
|
||||
| SupportEntry | — | first flush | hydrate | no | in the bar; the dialog mounts only when open |
|
||||
| NetworkBar | — | none | hydrate | no | under the bar, only while offline or reconnecting |
|
||||
| InvestorProfileStep | viewer | skeleton | hydrate | no | `AuthGuard` fallback `InvestorProfileStepSkeleton`; optional step: `RegisterProgress`, H1, photo, market chips, «ذخیره و ورود» and «بعداً», both to `?redirect=` or `/feed` |
|
||||
|
||||
## Notes
|
||||
|
||||
- No read: the step starts from the auth store's account, so it has no `<Suspense>`.
|
||||
- The `(onboarding)` layout renders nothing; it only sets `dynamic = 'force-dynamic'`.
|
||||
|
|
@ -0,0 +1,30 @@
|
|||
# Payment result
|
||||
|
||||
`/payment/result/[paymentId]` · `apps/{bull,bear}/src/app/(flow)/payment/result/[paymentId]/page.tsx` · Type: cart and checkout · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | -------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200` for every viewer and every id: a failed first read (an unknown payment, another account's) shows the part's `PartBoundary` |
|
||||
| loading.tsx | `payment/result/[paymentId]/loading.tsx`: bull: the bar; bear: the header and «بازگشت»; then `PaymentResultSkeleton`, `delayed` |
|
||||
| First flush | none: the page entry awaits only `params` |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | none in either app: `ResultHead` is an `h2` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order. Every payment ends here (0029).
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------- | ------ | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| MobileTopBar (bull) | config | first flush | hydrate | no | `payment:result.title`; back to `/dashboard/subscriptions` until the payment loads, then to the channel paid for (`useBackTarget`, R14), never to the bank |
|
||||
| DesktopHeader (bear) | viewer | first flush | hydrate | no | rows as in [layout-main.md](layout-main.md) |
|
||||
| DeskBack (bear) | config | first flush | hydrate | no | the same targets as bull's back |
|
||||
| PaymentResult | viewer | skeleton | hydrate | no | `PartBoundary`, then `AuthGuard role="investor"` with `PaymentResultSkeleton`; `usePaymentResultPage` reads the payment in the browser; while the bank settles it reads again every 2 s, up to 30 s with the return page's reads; success, failed or in review, with the receipt, the bank's reference to copy, the note, and support on a failure or review |
|
||||
| ↳ ResultActions | viewer | skeleton | hydrate | no | the two ways on; bull: pinned to the bottom; bear: in the 480 panel |
|
||||
|
||||
## Notes
|
||||
|
||||
- Debt: no `h1` in either app. Make `ResultHead`'s heading the `h1` (`platforms/market/src/app/screens/(flow)/payment/result/[paymentId]/organisms/payment-result/components/ResultHead.tsx:30`).
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
# Payment return
|
||||
|
||||
`/payment/return` · `apps/{bull,bear}/src/app/(flow)/payment/return/page.tsx` · Type: cart and checkout · Layout: [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | --------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (page `metadata`) |
|
||||
| Status | `200`; without `?paymentId=`, the browser replaces the page with `/dashboard/transactions` |
|
||||
| loading.tsx | `payment/return/loading.tsx`: the confirming screen itself, so nothing else shows on the way back from the bank |
|
||||
| First flush | none: the page entry awaits only `searchParams` |
|
||||
| Canonical | none: `noindex` |
|
||||
| H1 | `PaymentConfirming`, `payment:confirm.title`, in both apps |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order. Where the API's bank callback returns the browser (0029).
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------- | ------ | ----------- | ------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| PaymentConfirming | config | first flush | none | no | «در حال تأیید پرداخت...»: full screen and centred, a spinner, the `h1` and the description; no bar, header or link (U10 ۱.۱); the same screen is `AuthGuard`'s fallback and `PaymentReturn`'s children, so nothing changes while the viewer and the payment load |
|
||||
| PaymentReturn | viewer | none | hydrate | no | renders nothing of its own: `usePaymentReturnPage` polls the payment in the browser until it settles, for 30 s at most, then replaces this page with `/payment/result/[paymentId]`; a failed read keeps polling; its own `PartBoundary` |
|
||||
|
||||
## Notes
|
||||
|
||||
- bear has no `DesktopHeader` here: both apps show only the confirming screen.
|
||||
- `AuthGuard role="investor"` sends a guest to login with a return path, so the payment is still read after sign-in.
|
||||
|
|
@ -0,0 +1,34 @@
|
|||
# جستجو (analyst search)
|
||||
|
||||
`/search?q=` · `apps/{bull,bear}/src/app/(main)/search/page.tsx` · Type: search results · Layout: [layout-main.md](layout-main.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------ |
|
||||
| Robots | `noindex` (page `metadata`); not blocked, since no app has `robots.ts` |
|
||||
| Status | `200` for every query; a guest is sent to login and a creator gets the no-access state, in the browser |
|
||||
| loading.tsx | `(main)/search/loading.tsx`: the frame, the field and featured-analyst cards |
|
||||
| First flush | none: the page entry reads nothing; the search runs in the browser |
|
||||
| Canonical | none |
|
||||
| H1 | bull: none, the tab bar's «جستجو» is a `<span>`; bear: `PageHeader` «جستجو» |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none beyond the layout's |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------------------------------------- | ------------- | ----------- | ------- | ----- | -------------------------------------------------------------------------------------------------------------- |
|
||||
| MobileTopBar (bull) | config | first flush | hydrate | no | the tab bar with «جستجو» centred, no back |
|
||||
| ↳ Bell, account avatar or login link (bull) | viewer | skeleton | hydrate | no | |
|
||||
| DeskBack, PageHeader (bear) | config | first flush | hydrate | no | «بازگشت» then the H1; the header's search field opened the page, so it is pushed |
|
||||
| SearchPanel | viewer, query | skeleton | hydrate | no | `AuthGuard role="investor"`, then `<Suspense>` and `PartBoundary name="search"`; bear: `framed` |
|
||||
| ↳ SearchField | — | skeleton | hydrate | no | the query lives in `?q=` (`useSearchPage`), so back from a channel restores the results |
|
||||
| ↳ RecentSearches | viewer | skeleton | hydrate | no | under 2 characters; the persisted `recent-searches` store |
|
||||
| ↳ SearchFeatured | query | skeleton | hydrate | no | under 2 characters; the featured analysts |
|
||||
| ↳ SearchResults, SearchNoResults | query | skeleton | hydrate | no | `useCreatorSearchPart`; each card links its channel; a failed search is a part-size `ErrorFallback` with retry |
|
||||
|
||||
## Notes
|
||||
|
||||
- Search is for signed-in investors, not crawlers: every analyst's channel is reachable from `/analysts` and from post pages.
|
||||
- Debt: bull has no H1 while bear has one. Render the `PageHeader` title as an `sr-only` H1 in bull too.
|
||||
|
|
@ -0,0 +1,30 @@
|
|||
# Subscription terms
|
||||
|
||||
`/terms/subscription` · `apps/{bull,bear}/src/app/(flow)/terms/subscription/page.tsx` · Type: static and policy · Layout: [layout-terms.md](layout-terms.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| Robots | `index` |
|
||||
| Status | `200` |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(flow)/terms/subscription/loading.tsx` (debt, Notes) |
|
||||
| First flush | none: config, server i18n (`terms`, `auth`) and `getEnv().supportHours` |
|
||||
| Canonical | none set (debt, Notes) |
|
||||
| H1 | bull: `terms:title` «شرایط اشتراک», screen-reader-only, in `SubscriptionTerms`; bear: `rules:title` «قوانین لومینا» from the layout (debt) |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------------------- | ------ | ----------- | ---- | --------- | ---------------------------------------------------------------------------------------------- |
|
||||
| SubscriptionTerms | config | first flush | none | primary | one `<section>` per term with its heading; bear: in a `Card` |
|
||||
| ↳ Support hours and chats | config | first flush | none | secondary | island `SupportSheet` rows: `<a href>` to the Bale and Telegram chats, inside the last section |
|
||||
|
||||
## Notes
|
||||
|
||||
- The landing footer links here; checkout, a suspended card and the support sheet open it too.
|
||||
- Debt: `loading.tsx` wraps an indexable page. Delete it.
|
||||
- Debt: no canonical. Add `alternates: { canonical: ROUTES.rules.subscription }` to the page's `metadata`.
|
||||
- Debt: the H1 differs between the apps ([layout-terms.md](layout-terms.md)).
|
||||
|
|
@ -0,0 +1,27 @@
|
|||
# General rules
|
||||
|
||||
`/terms` · `apps/{bull,bear}/src/app/(flow)/terms/page.tsx` · Type: static and policy · Layout: [layout-terms.md](layout-terms.md), [layout.md](layout.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------ |
|
||||
| Robots | `index` |
|
||||
| Status | `200` |
|
||||
| loading.tsx | `apps/{bull,bear}/src/app/(flow)/terms/loading.tsx` (debt, Notes) |
|
||||
| First flush | none: config and server i18n (`rules`) |
|
||||
| Canonical | none set (debt, Notes) |
|
||||
| H1 | `rules:title`; bull: a screen-reader-only H1 in `GeneralRules`; bear: `DesktopPageTitle` in the layout |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
In bull's document order.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------ | ------ | ----------- | ---- | ------- | ---------------------------------------------------------------------------------------- |
|
||||
| GeneralRules | config | first flush | none | primary | one `<section>` per rule with its heading, then the last-updated line; bear: in a `Card` |
|
||||
|
||||
## Notes
|
||||
|
||||
- Debt: `loading.tsx` wraps an indexable page. Delete it; the tab links are `<a href>` and need no pending skeleton for crawlers.
|
||||
- Debt: no canonical. Add `alternates: { canonical: ROUTES.rules.general }` to the page's `metadata`.
|
||||
|
|
@ -0,0 +1,26 @@
|
|||
# Analyst
|
||||
|
||||
`/analysts/[id]` · `apps/wall-street-plaza/src/app/(panel)/analysts/[id]/page.tsx` · Type: account (back office) · Layout: [layout-panel.md](layout-panel.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------------------ |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200`, also for an unknown id: the browser read's 404 shows the not-found state in the page's `PartBoundary` |
|
||||
| loading.tsx | `(panel)/analysts/[id]/loading.tsx` |
|
||||
| First flush | none; the page entry awaits only `params` |
|
||||
| Canonical | none |
|
||||
| H1 | in the browser, the analyst's `fullName` (`AnalystDetail`); the server HTML's skeleton has `analysts:detail.title` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
One read, `useAnalystDetailPage(id)` with `useSuspenseQuery`, fills every row. `AdminGuard` › `PartBoundary` › `<Suspense>`, all with `DetailSkeleton`: a `PageHeader` with the generic title and the back link, over two card skeletons.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ---------------------------------------------- | ----- | -------- | ------- | ----- | ---------------------------------------------------------------------------------------------------------------------- |
|
||||
| PageHeader, with the H1 | query | skeleton | hydrate | no | the name, `@username`, the back link to `/analysts`; desktop: the account states and the one account action at its end |
|
||||
| AccountBadges and AccountActionButton (mobile) | query | skeleton | hydrate | no | `desktop:hidden`; full width under the title |
|
||||
| AnalystFacts | query | skeleton | hydrate | no | the 432px column on desktop |
|
||||
| AuditLog | query | skeleton | hydrate | no | garden-roof `screens/AuditLog`, beside the facts on desktop |
|
||||
| AccountDialogs | query | none | hydrate | no | suspend and reinstate, mounted only while open; the page updates in place |
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
# Analysts
|
||||
|
||||
`/analysts` · `apps/wall-street-plaza/src/app/(panel)/analysts/page.tsx` · Type: account (back office) · Layout: [layout-panel.md](layout-panel.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | -------------------------------------------------------------- |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200`; a search with no match shows the empty state with `200` |
|
||||
| loading.tsx | `(panel)/analysts/loading.tsx` |
|
||||
| First flush | none |
|
||||
| Canonical | none |
|
||||
| H1 | `analysts:list.title` from i18n, in `PageHeader` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------------- | ------ | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| PageHeader, with the H1 | config | first flush | none | no | |
|
||||
| AnalystsList | — | skeleton | hydrate | no | `AdminGuard` › `<Suspense>`; both fallbacks are `ListSkeleton` (the table preset) |
|
||||
| ↳ SearchField | — | skeleton | hydrate | no | the search in the URL |
|
||||
| ↳ AnalystRows | query | skeleton | hydrate | no | `useSuspenseQuery` behind its own `<Suspense>` and a `PartBoundary` keyed by search and page; each row an `<a href>` to `/analysts/[id]`, and the row activates on click |
|
||||
| ↳ AccountDialogs | query | none | hydrate | no | suspend and reinstate, mounted only while open; the rows reload under them |
|
||||
|
||||
## Notes
|
||||
|
||||
- Debt: the guard's fallback (`analysts/page.tsx:16`, `ListSkeleton`) has no box for the search field that `AnalystsList` draws above the table, so the table moves down when the admin is known. Give the fallback the search field's box.
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
# Featured analysts
|
||||
|
||||
`/featured` · `apps/wall-street-plaza/src/app/(panel)/featured/page.tsx` · Type: account (back office) · Layout: [layout-panel.md](layout-panel.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------ |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200`; no featured analysts shows the empty state with `200` |
|
||||
| loading.tsx | `(panel)/featured/loading.tsx` |
|
||||
| First flush | none |
|
||||
| Canonical | none |
|
||||
| H1 | `featured:page.title` from i18n, in `PageHeader` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| --------------------------------------- | ------ | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| PageHeader, with the H1 | config | first flush | none | no | the title and what the order drives |
|
||||
| ↳ AddFeaturedButton | config | first flush | hydrate | no | a link to `/featured?add=1`, so a reload keeps the dialog open |
|
||||
| FeaturedList | query | skeleton | hydrate | no | `AdminGuard` › `PartBoundary` › `<Suspense>`, all with `FeaturedSkeleton` (the table and three cards); `useFeaturedPage` with `useSuspenseQuery` |
|
||||
| ↳ FewerBanner | query | skeleton | hydrate | no | only while fewer than three analysts are visible |
|
||||
| ↳ FeaturedTable, or EmptyState | query | skeleton | hydrate | no | reorder by drag, keyboard or the row menu, saved on drop, with no drag library |
|
||||
| ↳ PageVisibility | query | skeleton | hydrate | no | only while fewer than three are visible |
|
||||
| ↳ FeaturedPreview | query | skeleton | hydrate | no | the first three visible cards, drawn by island's `AnalystCard` as the public pages draw them |
|
||||
| ↳ AuditLog | query | skeleton | hydrate | no | folded |
|
||||
| RemoveFeaturedDialog, AddFeaturedDialog | query | none | hydrate | no | mounted only while open; the add dialog loads its candidates inside, on its own |
|
||||
|
||||
## Notes
|
||||
|
||||
- Debt: `featured/loading.tsx:10` draws the header without «افزودن تحلیلگر», so the header can change height when the page arrives. Draw the button, or a same-size box, in the loading frame.
|
||||
|
|
@ -0,0 +1,26 @@
|
|||
# Beta health: secondary
|
||||
|
||||
`/health/secondary` · `apps/wall-street-plaza/src/app/(panel)/health/secondary/page.tsx` · Type: account (back office) · Layout: [layout-panel.md](layout-panel.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ---------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200`; before the first day, the pre-launch state; with no start date, the not-scheduled state; both `200` |
|
||||
| loading.tsx | `(panel)/health/secondary/loading.tsx` |
|
||||
| First flush | none |
|
||||
| Canonical | none |
|
||||
| H1 | `health:title` from i18n, in `PageHeader` (the same as `/health`; the tab names the view) |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------------- | ------ | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------- |
|
||||
| PageHeader, with the H1 | config | first flush | none | no | |
|
||||
| ↳ BetaSubtitle | query | skeleton | hydrate | no | as on [health.md](health.md) |
|
||||
| ↳ BetaUpdatedAt | query | skeleton | hydrate | no | as on [health.md](health.md) |
|
||||
| HealthTabs | config | first flush | hydrate | no | «شاخصهای ثانویه» active; drawn by the guard's skeleton too |
|
||||
| BetaHealth | query | skeleton | hydrate | no | `AdminGuard` › page-size `PartBoundary` › `<Suspense>`; the overview picks the parts, `PreLaunch` or `NotScheduled` |
|
||||
| ↳ SecondaryMetrics | query | skeleton | hydrate | no | its own `<Suspense>` and framed `PartBoundary`; fails alone |
|
||||
| ↳ AnalystFunnel | query | skeleton | hydrate | no | the same |
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
# Beta health: main
|
||||
|
||||
`/health` · `apps/wall-street-plaza/src/app/(panel)/health/page.tsx` · Type: account (back office) · Layout: [layout-panel.md](layout-panel.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ---------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200`; before the first day, the pre-launch state; with no start date, the not-scheduled state; both `200` |
|
||||
| loading.tsx | `(panel)/health/loading.tsx` |
|
||||
| First flush | none |
|
||||
| Canonical | none |
|
||||
| H1 | `health:title` from i18n, in `PageHeader` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------------------------- | ------ | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| PageHeader, with the H1 | config | first flush | none | no | |
|
||||
| ↳ BetaSubtitle | query | skeleton | hydrate | no | «روز ۱۸ از ۳۰ · …» from `useBetaHeader`, enabled once the admin is known and refetched every `HEALTH_REFRESH_MS`; the start date before the beta |
|
||||
| ↳ BetaUpdatedAt | query | skeleton | hydrate | no | when the API last computed the metrics; nothing before the beta |
|
||||
| HealthTabs | config | first flush | hydrate | no | `TabLinks` to `/health` and `/health/secondary`; the guard's skeleton draws them too, so they work before the admin is known |
|
||||
| BetaHealth | query | skeleton | hydrate | no | `AdminGuard` › page-size `PartBoundary` › `<Suspense>`; `useBetaHealthPage` reads the overview with `useSuspenseQuery` and picks the parts, `PreLaunch` or `NotScheduled` |
|
||||
| ↳ ExitMetrics | query | skeleton | hydrate | no | its own `<Suspense>` and framed `PartBoundary`; fails alone |
|
||||
| ↳ InvestorFunnel, with BetaTimeline | query | skeleton | hydrate | no | the same |
|
||||
| ↳ BetaAnalysts | query | skeleton | hydrate | no | the same |
|
||||
|
||||
## Notes
|
||||
|
||||
- The header line and the page share the overview's query key, so the overview is read once. The header line stays empty when that read fails, since the page's boundary already says what failed.
|
||||
- `/health` is `HOME_ROUTE`: where a signed-in admin lands and where the brand links.
|
||||
|
|
@ -0,0 +1,23 @@
|
|||
# Invite codes: capacity requests
|
||||
|
||||
`/invite-codes/requests` · `apps/wall-street-plaza/src/app/(panel)/invite-codes/requests/page.tsx` · Type: account (back office) · Layout: [layout-panel.md](layout-panel.md), [layout-invite-codes.md](layout-invite-codes.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ---------------------------------------------------------- |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200`; no pending request shows the empty state with `200` |
|
||||
| loading.tsx | `(panel)/invite-codes/requests/loading.tsx` |
|
||||
| First flush | none |
|
||||
| Canonical | none |
|
||||
| H1 | in the layout's `PageHeader`: `codes:header.title` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
The layout's header, search and tabs come first ([layout-invite-codes.md](layout-invite-codes.md)).
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------------------------ | ----- | -------- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| CapacityRequests › RequestRows | query | skeleton | hydrate | no | `AdminGuard` › `<Suspense>` with `TableSkeleton`; the pending requests read with `useSuspenseQuery` behind their own `<Suspense>` and a `PartBoundary` keyed by search and page |
|
||||
| CodeDialogs | query | none | hydrate | no | approve and reject, mounted only while open; a decision drops the row and lowers the tab's and the sidebar's counts together |
|
||||
|
|
@ -0,0 +1,24 @@
|
|||
# Invite codes
|
||||
|
||||
`/invite-codes` · `apps/wall-street-plaza/src/app/(panel)/invite-codes/page.tsx` · Type: account (back office) · Layout: [layout-panel.md](layout-panel.md), [layout-invite-codes.md](layout-invite-codes.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | -------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200`; an unknown `?code=` shows the not-found state inside the side sheet, with `200` |
|
||||
| loading.tsx | `(panel)/invite-codes/loading.tsx` |
|
||||
| First flush | none |
|
||||
| Canonical | none |
|
||||
| H1 | in the layout's `PageHeader`: `codes:header.title` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
The layout's header, search and tabs come first ([layout-invite-codes.md](layout-invite-codes.md)).
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ---------------------- | ----- | -------- | ------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| InviteCodes › CodeRows | query | skeleton | hydrate | no | `AdminGuard` › `<Suspense>` with `TableSkeleton`; the rows read with `useSuspenseQuery` behind their own `<Suspense>` and a `PartBoundary` keyed by search and page; `ListPager`; a code's link opens its detail through `?code=` (`replace`); a link to `/invite-codes/requests` |
|
||||
| CodeDetailSheet | query | none | hydrate | no | a side `Sheet` while the URL has `?code=`; the code loads inside, behind its own skeleton and boundary |
|
||||
| CodeDialogs | query | none | hydrate | no | `CapacityDialog` and `CodeReasonDialog`, mounted only while open |
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
# Layout: invite-codes
|
||||
|
||||
`apps/wall-street-plaza/src/app/(panel)/invite-codes/layout.tsx` · wraps `/invite-codes` and `/invite-codes/requests`, inside [layout-panel.md](layout-panel.md) · it reads nothing on the server
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------------- | ------ | ----------- | ------- | ----- | ----------------------------------------------------------------------------------------------------- |
|
||||
| PageHeader, with the H1 | config | first flush | none | no | `codes:header.title` and its subtitle |
|
||||
| ↳ CodesSearch | — | first flush | hydrate | no | `SearchField` with the URL's `q`, written to the URL once typing pauses; both tabs filter by it |
|
||||
| CodesTabs | config | first flush | hydrate | no | `TabLinks` to «همه کدها» and «درخواستهای افزایش», each keeping `q` |
|
||||
| ↳ Pending count | query | none | hydrate | no | the sidebar's `usePanelCounts` read; the badge shows once the admin is known and the count is above 0 |
|
||||
|
||||
Scripts: none.
|
||||
|
||||
## Notes
|
||||
|
||||
- Both tabs keep this frame, so the search keeps its value and position between them.
|
||||
- The header and tabs sit outside the page's `AdminGuard`: a guest sees them until the redirect.
|
||||
|
|
@ -0,0 +1,22 @@
|
|||
# Layout: panel
|
||||
|
||||
`apps/wall-street-plaza/src/app/(panel)/layout.tsx` · wraps every page in `(panel)`, inside [layout.md](layout.md) · it reads nothing on the server; `dynamic = 'force-dynamic'`
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ---------------------- | ------------- | ----------- | ------- | ----- | --------------------------------------------------------------------------------------------------------------------------- |
|
||||
| AdminSidebar (desktop) | config | first flush | hydrate | no | `hidden desktop:flex`, so it is in the DOM on phones too; the brand links to `/health` |
|
||||
| ↳ NavList | config | first flush | hydrate | no | a `next/link` per section, `aria-current` from the path; «بهزودی» items as plain text |
|
||||
| ↳ Section counts | query | none | hydrate | no | `usePanelCounts`, enabled once the admin is known and refetched on an interval; a `CountBadge` only when a count is above 0 |
|
||||
| ↳ AdminIdentity | viewer | skeleton | hydrate | no | avatar, name, `@username` and sign-out once the admin is known |
|
||||
| AdminTopBar (mobile) | config | first flush | hydrate | no | `desktop:hidden`, sticky; the brand and the menu button |
|
||||
| ↳ Menu sheet | config, query | none | hydrate | no | island `Sheet` mounts the `NavList` and sign-out only while open |
|
||||
| SignOutDialog | — | none | hydrate | no | one in each bar; mounted only while open |
|
||||
| Page column `<main>` | — | first flush | none | no | each page renders its own `AdminGuard` and skeleton |
|
||||
|
||||
Scripts: none.
|
||||
|
||||
## Notes
|
||||
|
||||
- The frame is not guarded: a guest sees the sidebar or top bar, with an identity skeleton, until the page's `AdminGuard` sends them to `/login?returnTo=<path>`. When the session ends on a page, the guard shows `SessionEnded` in the page's place.
|
||||
- Both bars hydrate on every device, because one DOM holds both templates.
|
||||
- Debt: the `AdminGuard` comment says the `(panel)` layout renders it (`platforms/garden-roof/src/app/guards/admin-guard/AdminGuard.tsx:13`), but every page renders its own guard. Fix the comment.
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
# Layout: root
|
||||
|
||||
`apps/wall-street-plaza/src/app/layout.tsx` · wraps every page of the admin app · it reads nothing on the server; its `metadata` (`rootMetadata()` in `src/configs/seo.ts`) sets `robots: { index: false, follow: false }`, which every page inherits
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------------- | ------ | ---- | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| AppProviders › AppShell | viewer | none | hydrate | no | garden-roof `app/app-shell`: the query client and i18n; `useSession` reads the admin once per load in the browser, so the auth store is `unknown` on the server and in the first browser render; `useCrossSectionRefresh` refetches the sections an admin action touches |
|
||||
| ToastPlacementMarker | config | none | hydrate | no | toasts centred, 32px from the bottom, in both templates |
|
||||
| Toaster | — | none | hydrate | no | the one toast region; a toast shows only after an action |
|
||||
|
||||
Scripts: none.
|
||||
|
||||
## Notes
|
||||
|
||||
- One app serves both templates (proposed 0063): the mobile template is the layout under 1024px, the desktop template is the `desktop:` variants, in one DOM. Every admin doc lists its rows in that one document order.
|
||||
- No service worker, manifest, JSON-LD or server caches (proposed 0062); `src/server.ts` exports nothing.
|
||||
- `lang` and `dir` come from server i18n; the critical font is preloaded; the viewport is `ROOT_VIEWPORT` with `maximumScale: 1`.
|
||||
|
|
@ -0,0 +1,30 @@
|
|||
# Login
|
||||
|
||||
`/login` · `apps/wall-street-plaza/src/app/(auth)/login/page.tsx` · Type: login · Layout: [layout.md](layout.md) (the `(auth)` layout renders nothing)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200` |
|
||||
| loading.tsx | `(auth)/login/loading.tsx` |
|
||||
| First flush | none |
|
||||
| Canonical | none |
|
||||
| H1 | in the browser only: `auth:login.title` on the number step, `auth:login.code-title` on the code step, in `LoginTemplate`; the brand line is a `<p>` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ---------------------------- | ------ | ----------- | ------- | ----- | --------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Brand line | config | first flush | none | no | «لومینا · پنل ادمین» as text, not a link |
|
||||
| GuestGuard | viewer | skeleton | hydrate | no | the form skeleton in the card until the viewer is known; a signed-in admin goes to `returnTo` (same-site paths only) or `/health` |
|
||||
| ↳ LoginTemplate: number step | — | skeleton | hydrate | no | the H1, the phone field (autofocus) and «ارسال کد»; a `<Suspense>` covers `useSearchParams` |
|
||||
| ↳ Code step | — | none | hydrate | no | replaces the number step in memory; `OtpInput` without WebOTP; «ویرایش شماره» goes back |
|
||||
| ↳ Resend countdown | clock | none | hydrate | no | `useSecondsLeft` in the template |
|
||||
|
||||
## Notes
|
||||
|
||||
- The form is the same for every visitor, but it renders only in the browser behind `GuestGuard`, as 0013 does for the public apps (proposed 0062). The skill's login map puts the H1 and the phone form in the first flush; this page keeps them a skeleton by that decision.
|
||||
- Debt: `LoginTemplate.tsx:24-27` reads `Date.now()` in a state initializer and runs its own `setInterval` per component. Move the resend countdown to a shared clock hook; neither island nor garden-roof has one yet.
|
||||
- Debt: `(auth)/login/loading.tsx:16` lacks the brand line that the page draws over the card, so the card moves down when the page arrives. Draw the brand line in the loading frame too.
|
||||
|
|
@ -0,0 +1,20 @@
|
|||
# Not-found and error
|
||||
|
||||
`apps/wall-street-plaza/src/app/not-found.tsx`, `global-error.tsx`, `(auth)/error.tsx`, `(panel)/error.tsx` · Type: not-found and error · Layout: [layout.md](layout.md)
|
||||
|
||||
Every case is `noindex`: the root layout's `metadata`, `not-found.tsx`'s own `metadata`, and `global-error.tsx`'s `<meta name="robots">`. No case has JSON-LD. The panel reads nothing on the server (proposed 0062), so almost every failure happens in the browser and the response is already `200`.
|
||||
|
||||
| Case | Status | Server HTML | In the browser |
|
||||
| -------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| A URL that matches no route | `404` | `not-found.tsx`: `StatusEmptyState variant="not-found"` in the first flush, inside the root layout only (no panel frame) | it hydrates; its action leads back to the panel |
|
||||
| An unknown id: `/analysts/[id]`, `/verifications/[id]`, or `?code=` / `?id=` in a side sheet | `200` | the page's skeleton | the read's 404 renders `ErrorFallback` › `StatusEmptyState` in the page's or the sheet's `PartBoundary` |
|
||||
| A 403 read | `200` | the page's skeleton | the no-access empty state in the part's `PartBoundary` |
|
||||
| A failed browser read (5xx, network, timeout) | `200` | the page's skeleton | `ErrorFallback` with the reference ID in the part's `PartBoundary`: Try again for a network cause, Reload page for a bug; offline, it retries by itself when the device is back |
|
||||
| A 401 (the session ended on the page) | `200` | the page's skeleton | silent; `AdminGuard` shows `SessionEnded` with «ورود دوباره» to `/login?returnTo=<path>` |
|
||||
| A render error in a `(panel)` page | `200` | the route's `loading.tsx` skeleton | `(panel)/error.tsx`: page-size `ErrorFallback` in the page column; the panel frame stays |
|
||||
| A render error on `/login` | `200` | `(auth)/login/loading.tsx` | `(auth)/error.tsx`: page-size `ErrorFallback` in the form column |
|
||||
| The root layout fails | `500` | `global-error.tsx`: its own `<html>`, `AppCrash` | «بارگذاری دوباره» reloads; a second action is a full load of `/health` |
|
||||
|
||||
## Notes
|
||||
|
||||
- Debt: no boundary recognizes a chunk that failed to load after a deploy (`platforms/garden-roof/src/app/error-boundaries/error-fallback/utils.ts:10` has no case for it): it is reported as a bug and offers Reload page, instead of reloading the page once without a report. The same gap exists in `platforms/market`.
|
||||
|
|
@ -0,0 +1,31 @@
|
|||
# Payouts
|
||||
|
||||
`/payouts` · `apps/wall-street-plaza/src/app/(panel)/payouts/page.tsx` · Type: account (back office) · Layout: [layout-panel.md](layout-panel.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------ |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200`; an unknown `?id=` shows the not-found state inside the side sheet, with `200` |
|
||||
| loading.tsx | `(panel)/payouts/loading.tsx` |
|
||||
| First flush | none |
|
||||
| Canonical | none |
|
||||
| H1 | `payouts:page.title` from i18n, in `PageHeader` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ------------------------------------------------------ | ------------- | ----------- | ------- | ----- | ------------------------------------------------------------------------------------------------- |
|
||||
| PageHeader, with the H1 | config | first flush | none | no | the title and the weekly rule |
|
||||
| ↳ PayoutsSearch | — | first flush | hydrate | no | the analyst search in the URL; it searches whichever tab is open |
|
||||
| PayoutsBoard | — | skeleton | hydrate | no | `AdminGuard` › `<Suspense>`; both fallbacks are `PayoutsSkeleton` (the table preset) |
|
||||
| ↳ TabLinks | config, query | skeleton | hydrate | no | four tabs in the URL, `replace`; «آماده» shows the sidebar's ready count; mobile: the row scrolls |
|
||||
| ↳ ReadyRows or PayoutRows | query | skeleton | hydrate | no | `useSuspenseQuery` behind its own `<Suspense>` and a `PartBoundary` keyed by tab, search and page |
|
||||
| PayoutDetailSheet | query | none | hydrate | no | a side `Sheet` while the URL has `?id=`; the payout loads inside; a link to its receipt |
|
||||
| CreatePayoutDialog, MarkPaidDialog, CancelPayoutDialog | query | none | hydrate | no | mounted only while open |
|
||||
|
||||
## Notes
|
||||
|
||||
- Debt: the guard's fallback (`payouts/page.tsx:20`, `PayoutsSkeleton`) has no row for the tabs that `PayoutsBoard` draws, so the table moves down when the admin is known. Draw `TabLinks` in the fallback, as `BetaHealthSkeleton` does.
|
||||
- Debt: `payouts/loading.tsx:10` draws the header without `PayoutsSearch`, so the header can change height when the page arrives.
|
||||
|
|
@ -0,0 +1,30 @@
|
|||
# Predictions
|
||||
|
||||
`/predictions` · `apps/wall-street-plaza/src/app/(panel)/predictions/page.tsx` · Type: account (back office) · Layout: [layout-panel.md](layout-panel.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------ |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200`; an unknown `?id=` shows the not-found state inside the side sheet, with `200` |
|
||||
| loading.tsx | `(panel)/predictions/loading.tsx` |
|
||||
| First flush | none |
|
||||
| Canonical | none |
|
||||
| H1 | `predictions:page.title` from i18n, in `PageHeader` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------------- | ------------- | ----------- | ------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| PageHeader, with the H1 | config | first flush | none | no | the title and the rule that nothing closes without ops |
|
||||
| PredictionQueues | — | skeleton | hydrate | no | `AdminGuard` › `<Suspense>`; both fallbacks are `QueuesSkeleton` (the health strip and the table) |
|
||||
| ↳ QuoteHealth | query | skeleton | hydrate | no | the quote sources' health, refetched every minute; its own `<Suspense>` and `PartBoundary` |
|
||||
| ↳ Queue TabLinks | config, query | skeleton | hydrate | no | the queue in the URL, `replace`; «نیاز به تأیید» with its count |
|
||||
| ↳ QueueRows | query | skeleton | hydrate | no | one table per queue; `useSuspenseQuery` behind its own `<Suspense>` and a `PartBoundary` keyed by the args; each row opens the detail through `?id=` |
|
||||
| PredictionSheet | query | none | hydrate | no | a side `Sheet` while the URL has `?id=`; the prediction loads inside; a link to the analyst's page |
|
||||
| PredictionDialogs | query | none | hydrate | no | confirm close, override, flag and reject proposal, mounted only while open |
|
||||
|
||||
## Notes
|
||||
|
||||
- Debt: the guard's fallback (`predictions/page.tsx:21`, `QueuesSkeleton`) has no row for the queue tabs, so the table moves down when the admin is known. Add the tabs' row to `QueuesSkeleton`.
|
||||
|
|
@ -0,0 +1,31 @@
|
|||
# Subscriptions
|
||||
|
||||
`/subscriptions` · `apps/wall-street-plaza/src/app/(panel)/subscriptions/page.tsx` · Type: account (back office) · Layout: [layout-panel.md](layout-panel.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ----------------------------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200`; an unknown subscription in the URL shows the not-found state inside the side sheet, with `200` |
|
||||
| loading.tsx | `(panel)/subscriptions/loading.tsx` |
|
||||
| First flush | none |
|
||||
| Canonical | none |
|
||||
| H1 | `subscriptions:list.title` from i18n, in `PageHeader` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------------- | ------ | ----------- | ------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| PageHeader, with the H1 | config | first flush | none | no | |
|
||||
| ↳ SubscriptionsToolbar | — | first flush | hydrate | no | the search by username, phone or tracking number in the URL, and «اعطای دسترسی», a link that opens the grant dialog through the URL; in a `<Suspense>` with no fallback |
|
||||
| SubscriptionList | — | skeleton | hydrate | no | `AdminGuard` › `<Suspense>`; both fallbacks are `ListSkeleton` (the table preset) |
|
||||
| ↳ Filter ChipGroup | — | skeleton | hydrate | no | the filters in the URL |
|
||||
| ↳ SubscriptionRows | query | skeleton | hydrate | no | `useSuspenseQuery` behind its own `<Suspense>` and a `PartBoundary` keyed by search, filters and page; a row's link opens the detail through the URL |
|
||||
| SubscriptionDetailSheet | query | none | hydrate | no | a side `Sheet` with the subscription; extend and refund dialogs inside |
|
||||
| GrantAccessDialog | query | none | hydrate | no | mounted only while open; the subscriber and the channel are looked up as they're typed (`useQuery`) |
|
||||
|
||||
## Notes
|
||||
|
||||
- Debt: the guard's fallback (`subscriptions/page.tsx:19`, `ListSkeleton`) has no row for the filter chips, so the table moves down when the admin is known; and `subscriptions/loading.tsx:10` draws the header without the toolbar.
|
||||
- Debt: `use-grant-access-dialog.ts:96` reads `Date.now()` in a state initializer during render, and the detail mapper computes the days left from `Date.now()` (`repositories/subscriptions/mappers.ts:81`), so a cached detail can show a stale count. Read the time from a shared clock in the part that shows it.
|
||||
|
|
@ -0,0 +1,33 @@
|
|||
# Verification review
|
||||
|
||||
`/verifications/[id]` · `apps/wall-street-plaza/src/app/(panel)/verifications/[id]/page.tsx` · Type: account (back office) · Layout: [layout-panel.md](layout-panel.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | ------------------------------------------------------------------------------------------------------------ |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200`, also for an unknown id: the browser read's 404 shows the not-found state in the page's `PartBoundary` |
|
||||
| loading.tsx | `(panel)/verifications/[id]/loading.tsx` |
|
||||
| First flush | none; the page entry awaits only `params` |
|
||||
| Canonical | none |
|
||||
| H1 | `verification:review.title` from i18n, in `PageHeader` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
In document order; on a phone, CSS `order` puts the ID image before the facts.
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| ----------------------- | ------ | ----------- | ------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| PageHeader, with the H1 | config | first flush | none | no | the back link to `/verifications` |
|
||||
| VerificationReview | query | skeleton | hydrate | no | `AdminGuard` › `PartBoundary` › `<Suspense>`, all with `ReviewSkeleton`; `useVerificationReviewPage` with `useSuspenseQuery` fills every row below |
|
||||
| ↳ QueueNav | query | skeleton | hydrate | no | the previous and next pending requests as `<a href>`, keeping `?sort=` |
|
||||
| ↳ Suspended Banner | query | skeleton | hydrate | no | only for a suspended account |
|
||||
| ↳ RequestFacts | query | skeleton | hydrate | no | |
|
||||
| ↳ Decisions (desktop) | query | skeleton | hydrate | no | `hidden desktop:grid`, under the facts; they wait for the ID image |
|
||||
| ↳ PastSubmissions | query | skeleton | hydrate | no | |
|
||||
| ↳ IdImageCard | query | skeleton | hydrate | no | the image behind its own skeleton until it loads; its `Lightbox` mounts only while open |
|
||||
| ↳ AuditLog (desktop) | query | skeleton | hydrate | no | `hidden desktop:block`, under the image |
|
||||
| ↳ AuditLog (mobile) | query | skeleton | hydrate | no | `desktop:hidden`, collapsible, at the end |
|
||||
| ↳ Decisions (mobile) | query | skeleton | hydrate | no | `PinnedFooter`, `desktop:hidden` |
|
||||
| DecisionDialogs | query | none | hydrate | no | mounted only while open; after a decision the next pending request replaces the URL, and after the last one the queue does |
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
# Verifications
|
||||
|
||||
`/verifications` · `apps/wall-street-plaza/src/app/(panel)/verifications/page.tsx` · Type: account (back office) · Layout: [layout-panel.md](layout-panel.md)
|
||||
|
||||
| Field | Value |
|
||||
| ----------- | -------------------------------------------------------------------------------- |
|
||||
| Robots | `noindex` (root layout `metadata`, `src/configs/seo.ts`) |
|
||||
| Status | `200`; an empty queue or a search with no match shows the empty state with `200` |
|
||||
| loading.tsx | `(panel)/verifications/loading.tsx` |
|
||||
| First flush | none |
|
||||
| Canonical | none |
|
||||
| H1 | `verification:queue.title` from i18n, in `PageHeader` |
|
||||
| JSON-LD | none |
|
||||
| Scripts | none |
|
||||
|
||||
## Sections
|
||||
|
||||
| Section | Data | HTML | JS | Index | Notes |
|
||||
| -------------------------- | ------ | ----------- | ------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| PageHeader, with the H1 | config | first flush | none | no | |
|
||||
| VerificationQueue | — | skeleton | hydrate | no | `AdminGuard` › `<Suspense>`; both fallbacks are `QueueSkeleton` (the table preset) |
|
||||
| ↳ Status TabLinks | config | skeleton | hydrate | no | the status in the URL, `replace` |
|
||||
| ↳ SearchField and SortMenu | — | skeleton | hydrate | no | in the URL; desktop: one row |
|
||||
| ↳ VerificationRows | query | skeleton | hydrate | no | `useSuspenseQuery` behind its own `<Suspense>` and a `PartBoundary` keyed by the args; each row an `<a href>` to `/verifications/[id]`, keeping `?sort=`, and the row activates on click |
|
||||
|
||||
## Notes
|
||||
|
||||
- Debt: the guard's fallback (`verifications/page.tsx:21`, `QueueSkeleton`) has no boxes for the tabs, the search and the sort, so the table moves down when the admin is known. Give the fallback those rows.
|
||||
Loading…
Reference in New Issue