9.8 KiB
9.8 KiB
Decisions
Design (DDR)
- 0002 Render every tag through island
Element, flex layouts throughFlexBox, grid layouts throughGridBox; never native JSX tags orflex/gridclasses, island included. - 0011 Serve Yekan Bakh FaNum (
font-sans, all UI text) and Yekan Bakh (font-latin, شبا and bank codes only) frompublic/fonts/under fixed names declared in islandfonts.css; no version, never hashed, nevernext/font; a changed font gets a new name. - 0019 Close every toast by itself: success and info after 4 s (6 with an action), errors after 8 s (10 with an action); hovering, focus or a hidden tab pauses it; callers never pass
duration: Infinity. - 0056 Set
maximum-scale=1in bull's root viewport so iPhones never zoom into fields under 16px; bear keeps the default viewport.
Architecture (ADR)
- 0001 Share one platform,
platforms/market, betweenapps/bullandapps/bear; tag all threescope:market. - 0012 Wrap each app's
next.configin island'swithIconSpriteandwithFontCopy; they writesymbol-defs.svgand the fonts intopublic/unhashed, served immutable; link the sprite as?v=<ICON_SPRITE_VERSION>. - 0013 Render every
(auth)page's steps only in the browser behindGuestGuard: the server sends the frame, a same-size skeleton andnoindex; flow state stays in memory, never in the URL or storage. - 0026 Prerender the landing (
/) withforce-staticandrevalidate = 600; every other route keepsforce-dynamicin its route group's layout, never the root's. - 0027 Serve خانه at
/feedand the landing at/; send a signed-in visitor of/tohomeRoutein the browser withLandingRedirect, never in a proxy. - 0051 Serve
/_next/static/JS and CSS cache first in the service worker;strategy(default stale-while-revalidate) applies to fonts and the sprite only. - 0052 Evict the service worker's least recently used entry first, with the key order kept in memory and older-half hits stored again.
- 0053 Ship bull and bear with the same worker options and
NEXT_PUBLIC_SERVICE_WORKER_ENABLED; both serve the manifest fromplatforms/market/src/app/manifest. - 0054 Set
htmlLimitedBots: /.*/in both apps'next.config.ts, so every visitor gets metadata in<head>. - 0057 Back links to
parentHrefand traverses history only when that is the previous entry;backToPreviouspages (and pages withoutparentHref) accept any previous page. - 0058 Opening notifications records "seen" and clears the bell; a row stays unread until tapped; creators filter one list by «همه · پیشبینیها · مالی · حساب».
- 0059 Checkout and the channel save
?code=into the per-creator checkout draft on arrival; checkout then strips it from the URL. - 0060 Composers send a creator who can't publish to their own channel with the locked dialog; every publish carries a stable
Idempotency-Key. - 0061 Build the admin panel as
apps/wall-street-plazawithplatforms/garden-roof, taggedscope:admin; it calls only the back end'sadmin-api. - 0064 Serve a channel at
/channels/username, built only throughROUTES; both apps 308-redirect/@username/…there, and no other code reads «@» in a path. - 0066 Give every app
INTERNAL_END_POINT(server calls) andNEXT_PUBLIC_CLIENT_END_POINT(the API's public origin, called directly by the browser with credentials), both set in the bootstraps; nonext.config.tsrewrite. - 0067 Run each app as one container publishing
HTTP_PORT, with no per-app nginx;tools/deploy.shchecks the new release's/healthzoff to the side, then replaces the old release. - 0068 Keep the previous release as a stopped
<app>-<UTC time>container with its env folder;tools/rollback.sh <app>starts it in place of the serving one. - 0070 Render every page except the landing in the browser: the server reads no data and sends the frame, a skeleton and metadata; channel and post are
noindex, their metadata from params only. - 0071 Index only the landing in bull and bear; every other page is
noindexwith no canonical or JSON-LD, new pages included. - 0072 Make
/dashboard/overviewthe analyst's default tab, «نمای کلی» · «طرحهای اشتراک» · «سیگنالها» · «مالی»; the plans tab lists subscribers instead of audience counts, and/dashboard/subscriberslists them all.
Proposed
- 0003 design: Only semantic tokens, named as in the Lumina Design System, produce Tailwind utilities (
@theme inline); primitives stay plain:rootvariables and Tailwind's defaults are removed. - 0005 design: Island holds Lumina's product components and status-to-tone map; they take every text as props (
childrenorlabels) and never import i18next or platform code. - 0006 architecture: Make every non-app project a pnpm workspace package
@lumina/<name>with subpathexports; third-party dependencies stay in the root package.json. - 0014 architecture: Serve registration step 5 under
(onboarding)behindAuthGuard; a creator's profile autosaves as a server draft (PATCH) and completes only throughPOST …/profile/complete. - 0015 architecture: Serve a login or onboarding view whose frame differs from its step on its own route (
/auth/login/suspended,/onboarding/creator-profile/done); browser-only data stays in memory. - 0016 architecture: Keep a creator who hasn't finished step 5 out of publishing and pricing through the session's
needsProfile, withOnboardingGuardin those routes' layouts andGuestGuard. - 0017 architecture: Give every auth and onboarding route its own
loading.tsxmatching its frame; an index route with nested steps sits in its own route group. - 0020 architecture: Server-rendered platform organisms take their text as
labelsbuilt by the app's template from its server i18n; client organisms useuseTranslation. - 0022 architecture: The API enforces post rules (2000 characters, four JPG/PNG/WebP images of 5 MB, 15-minute edit window, approved creators only); the composer mirrors them in
POST_LIMITS. - 0023 architecture: On desktop «پست جدید», post edit and «پیشبینی جدید» are dialogs over the page through bear's
@modalintercepts; slots are emptied by explicit null pages, never a catch-all, and a hard load gets the full page. - 0025 architecture: The investor's داشبورد is a tabbed section, one route per tab in
dashboard/(investor), whose layout holds the top bar or heading andDashboardTabs; each tab has its own loading. - 0028 design: Landing-only island tokens:
tablet(720px, the landing's grids only),heroandsectiontype,container-pageandimage-shade. - 0029 architecture: End every payment on
/payment/result/[paymentId]; the API's bank callback returns to/payment/return, which polls the payment until settled (30 s at most) and replaces itself. - 0030 architecture: Keep the last checkout's period, invite code and bank payment in the persisted
session.checkout-draftstore from payment start until success, and restore them on the same creator's checkout. - 0031 design: List renew and reactivate periods as island
TierOptioncards, as checkout does, instead of R3's chip grid. - 0033 architecture: Keep the payment sent to the bank in the checkout draft and settle it through
POST /subscriptions/payments/:id/abandononly on the page that came back from the bank (bfcache or a history load), triggered by the app shell and awaited by checkout's screen read. - 0034 architecture: Serve the creator's داشبورد from
dashboard/(creator)as/dashboard/plans,/dashboard/predictionsand/dashboard/finance(0072 adds the default,/dashboard/overview), and C7 at/dashboard/pricingin(flow); the شبا form and ledger details open in place. - 0035 design: Pick a promotion's Shamsi date and time with island
Selects in a sheet or modal, not a drawn wheel. - 0036 architecture: During the 7-day lock the save button reads «ذخیره تخفیف» and saves promotion changes; standing prices and period switches stay read-only.
- 0037 architecture: Open payout receipts from the API's session-authorized
/payouts/me/payouts/:id/receiptthrough/api, not signed expiring URLs. - 0039 design: Place toasts above whatever draws the bottom edge, declared by that part (nav 80, pinned footer 152, desktop 32, low in sheets).
- 0040 architecture: Render the connection bar under the sticky bars, inside their sticky box, never above or over content.
- 0041 architecture: Confirm sign-out, call
auth.logout, then reload to the landing. - 0042 architecture: When a session ends mid-use, show the session-ended state and keep drafts; only an explicit sign-out clears drafts and
session.*keys. - 0043 architecture: Freeze every network action offline with island
useOfflineFreeze, showing the reason. - 0046 architecture: Serve
/account/profilein(flow)for both roles, switching investor form and creator profile edit in the browser. - 0047 architecture: The pwa lib keeps the browser's install offer; offer install at
/account/installand once on bull's خانه with a 30-day snooze; the manifest starts at/feed. - 0049 design: A page error keeps the page's own bar, derived from the path; route groups without a frame pass
standalone. - 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 andnoindex; 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.