5.8 KiB
5.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.
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. - 0018 Call the API from the browser only on the app's own origin under
/api, rewritten bynext.config.tstoAPI_INTERNAL_ORIGIN; media URLs use the same path, and the server render calls the gateway directly. - 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.
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. - 0021 architecture: A channel's feed and post page start from the server's read as query
initialData, re-read in the browser for the creator or a subscriber, and update in place after mutations. - 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 «پست جدید» is a dialog over the page through bear's
@modalintercept of /compose/post; 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. - 0032 architecture: Serve the notification centre at
/notificationson mobile and as a lazily loaded side panel from bear's header bell; opening it marks all read. - 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(default) and/dashboard/finance, 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: Keep «ذخیره قیمتگذاری» live during the 7-day lock so promotion changes save; 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.