427 lines
33 KiB
Markdown
427 lines
33 KiB
Markdown
# Design Brief — Lumina (لومینا) · Verified Financial Creator Platform · MVP Phase 0
|
||
|
||
> Sources: PRD MVP Phase 0 v3.1 + ClickUp stories (23 tasks) + back-end codebase (`trading-platform` @ `3553719`).
|
||
> **Precedence:** ClickUp story > PRD for *behaviour*. The back end is used for *data shapes* and wherever a story is silent. Where a story and the back end conflict, **design to the story** and treat the conflict as an open decision (§9).
|
||
> Full acceptance criteria and exact Farsi copy for each story are in the `round-*.md` files. Attach the matching round file with this brief.
|
||
|
||
---
|
||
|
||
## 1. Product in one paragraph
|
||
|
||
Lumina is a platform for Iranian financial creators (analysts, signal providers) and the investors who follow them. Creators get a verified professional profile, a channel with free and premium posts, invite-only paid subscriptions, and **structured, immutable predictions** that the system tracks automatically. Investors can judge a creator by a **verifiable track record** before paying.
|
||
|
||
The core positioning is **performance proof over social proof**. The product must feel credible and professional, not like another Telegram channel. Because of this, follower counts are never shown publicly, and prediction outcomes are never hidden behind the paywall.
|
||
|
||
Phase 0 is a **closed beta**: 5–10 hand-picked creators and about 50 paying subscribers.
|
||
|
||
---
|
||
|
||
## 2. Platform and locale (confirmed)
|
||
|
||
| Topic | Decision |
|
||
|---|---|
|
||
| Stack | NX monorepo + Next.js, one responsive web app for **mobile and desktop** |
|
||
| Priority | **Mobile-first** for investor and creator surfaces; **desktop-first** for the admin panel (mobile = simplified card list) |
|
||
| Direction | **RTL** throughout. LTR exceptions: شبا field, URLs, usernames, tickers, signed amounts (§4.4) |
|
||
| Language | Persian. Persian digits (۰–۹) in UI, `٬` as thousands separator |
|
||
| Currency | تومان, whole numbers only |
|
||
| Dates | Shamsi (Jalali), e.g. `۱۵ خرداد ۱۴۰۴، ساعت ۱۴:۳۰`. Relative for recent items: همین الان · ۵ دقیقه پیش · ۲ ساعت پیش · دیروز. Timezone Asia/Tehran |
|
||
| Auth | Iranian mobile number (09XXXXXXXXX) + 5-digit SMS OTP. One entry screen for login and registration. Investor and creator accounts are separate (one number = one role) |
|
||
| Notifications | SMS + in-app only (push is deferred to Phase 1) |
|
||
| Payment | ZarinPal only |
|
||
| URLs | Channel `lumina.ir/@{username}`, post `lumina.ir/@{username}/posts/{post_id}`, finance `lumina.ir/dashboard/finance` |
|
||
|
||
---
|
||
|
||
## 3. Navigation and information architecture
|
||
|
||
### 3.1 Investor
|
||
- **Top bar:** notification bell with unread badge (99+). It opens a slide-in panel from the right on mobile.
|
||
- **Bottom nav:** خانه (feed + creator search) · داشبورد
|
||
- **داشبورد sub-sections:** اشتراکها · تراکنشها · دنبالشدهها
|
||
- **Reached from links:** creator channel, standalone post, checkout, track record page
|
||
- **Logged-out visitors** can browse channels and free posts via shared links. Every gated action leads to one CTA, **ورود/ثبتنام**, and the user returns to the same page after auth.
|
||
|
||
### 3.2 Creator
|
||
- **Top bar:** avatar opens **اطلاعات کاربری** (profile edit + verification status, C3). The notification bell is assumed to be shared with investors.
|
||
- **Bottom nav:** داشبورد · کانال, plus a center **FAB `+ انتشار`** that opens a mini menu with **پست جدید** and **پیشبینی جدید**.
|
||
- **داشبورد contents:** overview stats (C9, not yet specced) · **قیمتگذاری اشتراک** (C7) · **مالی** (C19 + C20).
|
||
- **First-run onboarding** (C1 then C2) is mandatory and can't be exited. There is no back button, and the Android back gesture is suppressed.
|
||
|
||
### 3.3 Admin (desktop)
|
||
- **Sidebar:** احراز هویت کریتورها (with a red pending-count badge) · مدیریت کریتورها · then the other sections from PRD Epic 3/11 (not yet specced).
|
||
|
||
---
|
||
|
||
## 4. Design system ("Stripe-inspired")
|
||
|
||
> Only the tokens referenced in the stories are listed here. **If you have the full design-system file, attach it.** It fills in the values marked "?".
|
||
|
||
### 4.1 Tokens
|
||
|
||
| Token | Value | Used for |
|
||
|---|---|---|
|
||
| `colors.primary` | `#533afd` | Primary CTA, verified, active, success, selected |
|
||
| `colors.primary-deep` | ? | Text on soft tags |
|
||
| `colors.primary-bg-subdued-hover` | `#b9b9f9` | Soft tag background, unread notification border |
|
||
| `colors.brand-dark-900` | `#1c1e54` | **پریمیوم** badge, primary financial figure |
|
||
| `colors.ink` | ? | Body text |
|
||
| `colors.ink-mute` | `#64748d` | Secondary text, pending, neutral and expired badges, icons |
|
||
| `colors.canvas` | `#ffffff` | Cards, sheets |
|
||
| `colors.canvas-soft` | `#f6f9fc` | Page backgrounds, locked placeholders, highlighted blocks |
|
||
| `colors.hairline` / `hairline-input` | ? | Borders, dividers, input borders |
|
||
| `colors.ruby` | `#ea2261` | Errors, critical/urgent, destructive, rejected, suspended, negative balance, **and the تخفیف badge** (its only affirmative use) |
|
||
| `colors.warning` | `#f59e0b` | Time-sensitive warnings, pending payment, non-blocking cautions, preview-mode banner |
|
||
| Typography | `heading-md`, `heading-sm`, `body-md`, `caption`, `micro` | Font **Yekan Bakh** for all Farsi |
|
||
| Radius | `rounded.md`, `rounded.lg`, `rounded.xl`, pill | |
|
||
| Shadow | Level 1 (cards), Level 2 (menus, popovers, sheets) | |
|
||
|
||
### 4.2 Components
|
||
`button-primary-pill` · `button-secondary` (outline, primary text; **ruby variant** for destructive admin actions) · `pill-tag-soft` · `card-feature-light` (canvas, hairline border, rounded.lg, Level 1) · `text-input` (focus border = primary) · `link-on-light` · snackbar/toast · modal · bottom sheet (mobile) / popover or side panel (desktop) · full-screen image lightbox (black background, swipe, pinch-zoom, `۱ / ۳` counter) · status badge · countdown.
|
||
|
||
### 4.3 Global rules
|
||
- **Tabular figures** (`font-feature-settings: "tnum"`) on every number: prices, dates, OTP, stats, reference numbers, countdowns. This is non-negotiable and part of the brand's financial look.
|
||
- **Frozen controls** stay visible at `opacity: 0.4` with `cursor: not-allowed`, and show an explanatory tooltip or message on tap. Controls are never hidden just because they're unavailable.
|
||
- **Dimmed or unavailable items** (for example a suspended creator) use `opacity: 0.5` with a lock icon. Any action that still works inside the item renders at full opacity.
|
||
- **Touch targets** are at least 44×44px.
|
||
- **Desktop column widths:** forms 560px · content and post pages 640px · checkout 480px.
|
||
- **Data safety:** on any network failure the entered data is kept. Errors appear inline under fields, and an error banner appears at the top for submit failures.
|
||
|
||
### 4.4 Numbers and RTL
|
||
- Signed amounts are wrapped in an LTR isolate, so the minus sign stays left of the digits: `−۱۲۰٬۰۰۰ تومان`. The word تومان sits outside the isolate.
|
||
- شبا renders LTR in groups of four: `IR62 0120 0000 0010 1234 5678 90`.
|
||
|
||
---
|
||
|
||
## 5. Cross-cutting patterns
|
||
|
||
### 5.1 Viewer states (channel, post page, feed)
|
||
|
||
| Viewer | Content | Follow | Subscribe |
|
||
|---|---|---|---|
|
||
| Logged-out | Free posts in full, premium as locked teasers | Shown; leads to auth | Shown; leads to auth |
|
||
| Logged in, not following | Same | دنبال کردن | اشتراک |
|
||
| Following, not subscribed | Same | دنبال نکردن | اشتراک |
|
||
| Waitlisted | Same | As applicable | **اشتراک stays live**, with a quiet note underneath and a لغو اطلاعرسانی link |
|
||
| Payment pending | Same | As applicable | Frozen indicator «پرداخت در حال بررسی» with a clock icon |
|
||
| Active subscriber | Everything unlocked, پریمیوم badge still shown | **Frozen** (can't unfollow while subscribed) | Replaced by the indicator «مشترک هستید ✓» |
|
||
| Creator (own channel) | Everything, plus share/edit/delete | Hidden | Hidden |
|
||
| Creator in "view as visitor" preview | Locked teaser, with an amber banner and «خروج از پیشنمایش» | n/a | n/a |
|
||
|
||
### 5.2 Locked premium post (one shared component everywhere: channel, post page, feed)
|
||
- The header row (avatar, username, timestamp, **پریمیوم** badge) is always visible.
|
||
- **Text:** only the first 2 lines are shown, fading into the canvas color with a centered lock icon. Two lines is a hard limit, so no analysis leaks.
|
||
- **Images:** never shown and never blurred. A generic lock placeholder on canvas-soft replaces them, with an optional «۳ تصویر» count badge.
|
||
- **Premium prediction:** asset, direction, entry, targets, stop loss and horizon are all hidden. Only the card frame, the پریمیوم badge and the status remain.
|
||
- **Data note:** the API sends `captionPreview` (first 140 characters) and `mediaPreview` with a `blurHash`. **Clamp the preview visually to 2 lines and never render the blurHash.** The rule against blurred images comes first.
|
||
- Below the locked content: one message and one CTA, depending on auth state. Logged-out users see «ورود/ثبتنام». Logged-in users see «اشتراک در کانال». The two are never shown together.
|
||
- There is no "you used to have access" variant after a subscription lapses.
|
||
|
||
### 5.3 Creator verification gating
|
||
- **States:** در انتظار احراز هویت (ink-mute, clock icon) · تأییدشده ✓ (primary, check icon) · رد شده (ruby, warning icon). Suspended is a separate admin state that can coexist with these.
|
||
- **For a creator who isn't yet Verified:**
|
||
- A persistent, non-dismissible banner sits on the کانال tab. It's informational when Pending. When Rejected, it shows the reason and is tappable to C3.
|
||
- A compact badge shows on داشبورد.
|
||
- The FAB and the channel share icon are frozen.
|
||
- Pricing and profile can still be edited.
|
||
- Payout details (شبا) are locked.
|
||
- **Identity fields** lock at first submission and reopen only on rejection. The username can never be changed. The national ID card image field is always empty when the form opens.
|
||
|
||
### 5.4 Time-based states
|
||
- **Post edit window:** 15 minutes after publishing. After that the edit icon is frozen and shows a tooltip. Edited posts show a «ویرایششده» label in micro type. Posts can be deleted at any time; predictions can't (per the PRD).
|
||
- **Subscription remaining time:**
|
||
|
||
| Remaining | Label | Color | Warning under card |
|
||
|---|---|---|---|
|
||
| More than 7 days | {n} روز مانده | ink-mute | — |
|
||
| 4–7 days | {n} روز مانده | warning | — |
|
||
| 3 days or less | کمتر از {n} روز مانده | ruby | Yes |
|
||
|
||
- **Promotion countdown:** a plain date when more than 48 hours remain, a live «{n} ساعت باقی مانده» in warning color at 48 hours or less, and nothing at all for an indefinite promotion. There is no fake urgency.
|
||
- **OTP:** a 2-minute countdown that turns ruby in the last 30 seconds. Resend is available only after expiry. After 3 failed attempts the user is blocked for 10 minutes.
|
||
|
||
### 5.5 Status vocabulary
|
||
|
||
| Domain | States (Farsi label · color) |
|
||
|---|---|
|
||
| Subscription | فعال · primary — منقضیشده · ink-mute (neutral, not an error) — suspended creator: card dimmed + «درخواست بازگشت وجه» action — refund requested: «درخواست بازگشت وجه در حال بررسی» |
|
||
| Transaction | موفق · primary — ناموفق · ruby (ruby start border on row) — در حال بررسی · warning (warning start border, pinned to top) |
|
||
| Transaction type | اشتراک جدید · تمدید اشتراک · فعالسازی مجدد |
|
||
| Tier | ماهانه · سهماهه · ششماهه · سالانه |
|
||
| Payout | در حال انجام · ink-mute pill — انجام شده · no pill — لغو شده · ruby pill + struck-through amount |
|
||
| Ledger entry | درآمد اشتراک (+) · واریز به حساب (−) · کسر بازگشت وجه (−) · اصلاحیه (±). Amounts in ink color; the sign carries the meaning |
|
||
| Creator account (admin) | Active · primary + check — Suspended · ruby + ban icon, row tinted `rgba(234,34,97,0.05)` |
|
||
|
||
### 5.6 Prediction card (no ClickUp story yet; fields from the back end, rules from the PRD)
|
||
|
||
**Fields as the API returns them:**
|
||
|
||
| Field | Shape | Display |
|
||
|---|---|---|
|
||
| `symbol` | free text, uppercased (`XAUUSD`, `BTCUSDT`, `TEDPIX`) | LTR, prominent |
|
||
| `market` | one of the market keys (§10.2) | soft tag with its Farsi label |
|
||
| `direction` | `long` / `short` | Labels خرید / فروش (Long / Short) with an arrow icon. Never rely on color alone |
|
||
| `entryPrice` | number | tabular |
|
||
| `targetPrices[]` | **1 or more** numbers | Design for 1–3 targets (T1, T2, T3) |
|
||
| `stopLoss` | number, optional | Show when present; hide the row when absent |
|
||
| `horizon` | free label, for example `2w`, `45d` | Shown as a label. Show time remaining only when `expiresAt` exists |
|
||
| `caption` | text | Acts as the creator's note / rationale |
|
||
| `publishedAt` | system timestamp | **Prominent**; it is the trust signal |
|
||
| `status` | `open` / `closed` | |
|
||
| `outcome` | `win` / `loss` / **`breakeven`** | Three closed states |
|
||
| `closedPrice`, `closedAt` | on close | Show with the outcome |
|
||
| ROI | computed: (closed − entry) / entry, reversed for short | Signed percent, LTR-isolated |
|
||
|
||
- **States to design:** open · closed-win · closed-loss · closed-breakeven · premium-locked (§5.2) · owner view (with a «بستن پیشبینی» action that asks for the closing price, since closing is currently done by the creator).
|
||
- **Immutability:** prediction fields can't be edited after publishing. Show a lock cue and the timestamp. The PRD's 15-minute window and edit history don't exist yet (§9).
|
||
- **Variants:** compact (feed, channel) and expanded (post page). It also appears on the track record page, the creator dashboard and admin screens.
|
||
- **No market snapshot image for now:** a prediction post can't carry media in the API.
|
||
|
||
**Creator stats block** (U6, channel header):
|
||
- **Metrics:** نرخ موفقیت (`winRate`, already a percent such as `62.86` → `۶۲٫۹٪`) · کل پیشبینیها · پیشبینیهای فعال · بازدهی (`avgRoiPercent`) · روند دقت · and a CTA «مشاهده کارنامه کامل».
|
||
- **روند دقت is the last 10 outcomes** (`["win","loss","win",…]`). Design it as a row of 10 small outcome markers (win / loss / breakeven), not a line chart. A wins / losses / breakeven split is also available.
|
||
- **When the block shows:** the U6 rule is all or nothing. It's absent until the activation threshold is met or when the creator hides it. No zeros, no placeholder.
|
||
|
||
---
|
||
|
||
## 6. Screen inventory
|
||
|
||
Status key: ✅ fully specced in ClickUp · 📄 PRD only (design at lower fidelity, expect changes).
|
||
|
||
### 6.1 Auth and onboarding
|
||
|
||
| # | Screen | Story | Key states |
|
||
|---|---|---|---|
|
||
| 1 | ورود یا ثبتنام (mobile number) | U1, C1 | Invalid format · number belongs to the other role · network error |
|
||
| 2 | OTP | U1, C1 | Countdown · wrong code · expired · blocked 10 min (full screen) · resend |
|
||
| 3 | Investor تکمیل پروفایل (first and last name in Persian, username) | U1 | Live username check (available ✓, taken, invalid) · immutability note · step indicator without a total count |
|
||
| 4 | Login success modal / suspended-account screen | U1, A2 | |
|
||
| 5 | Creator KYC form (username, first and last name, national ID, ID card image) | C1 | Field validation · upload errors · no exit |
|
||
| 6 | Creator تکمیل پروفایل (bio, avatar crop, links, market tags, T&C) | C2 | Toast on load · 8-link limit (frozen add button) · drag reorder · quick-add (Telegram, Instagram, X, YouTube) · success screen «پروفایل ذخیره شد» |
|
||
| 7 | اطلاعات کاربری (creator profile edit) | C3 | Verified/Pending (identity locked) · Rejected (banner + editable identity + «ارسال مجدد اطلاعات هویتی») · two independent save actions · unsaved-changes dialog |
|
||
|
||
### 6.2 Investor
|
||
|
||
| # | Screen | Story | Key states |
|
||
|---|---|---|---|
|
||
| 8 | **Creator channel** `/@username` (header + post list) | U6, C4 §12, U8 | All viewer states (§5.1) · stats present or absent · empty channel · suspended channel |
|
||
| 9 | **Standalone post page** | C4b | Free · locked · subscriber · owner · visitor preview · deleted (404) · channel suspended · desktop share popover / mobile native share |
|
||
| 10 | خانه feed + creator search | 📄 Epic 7, U7 | Empty state «follow someone» + CTA · locked cards inline in chronological order |
|
||
| 11 | **Checkout** «خرید اشتراک» (one screen) | U9 | Tier cards with total, per-month and strike-through · promotion badge and countdown · referral code (valid ✓ / invalid) · frozen CTA · no code · price-changed modal · waitlist offer modal · already-waitlisted modal · pay CTA pinned to the bottom · link to «شرایط اشتراک» |
|
||
| 12 | Payment return | U10 | Non-dismissible «در حال تأیید پرداخت...» · success toast on the channel · pending · failure (back to checkout with selections kept) |
|
||
| 13 | شرایط اشتراک (terms page) | U9 comment | Static long-form text |
|
||
| 14 | داشبورد → اشتراکها | U2, U3, A2 | Summary line «{n} اشتراک فعال» · active cards sorted by soonest expiry · expiry escalation · expired section · suspended-creator card with refund action · empty state |
|
||
| 15 | Renew / reactivate bottom sheet | U3 | Tier selector · date preview block (renew: from current expiry; reactivate: from today) · price-changed note · promotion · success checkmark animation · failure |
|
||
| 16 | داشبورد → تراکنشها + detail sheet | U4 | Filter chips (همه · موفق · ناموفق · در حال بررسی) · pending rows pinned · tap-to-copy reference number · support CTA · pagination of 20 |
|
||
| 17 | داشبورد → دنبالشدهها | U8 | Unfollow with confirmation · frozen unfollow for subscribed creators · suspended row · empty state |
|
||
| 18 | Notification center | U5 | Unread (start border) / read · CTA chips · relative timestamps · empty state |
|
||
| 19 | Track record page | 📄 Epic 10 | Public · not yet available · hidden |
|
||
| 20 | Refund request + status | 📄 U21 (only the suspension case is specced, in A2 §6) | |
|
||
|
||
### 6.3 Creator
|
||
|
||
| # | Screen | Story | Key states |
|
||
|---|---|---|---|
|
||
| 21 | کانال tab (own channel) | C4, C5 | Verification banner · post cards with share/edit/delete (+ preview icon on premium posts) · empty state |
|
||
| 22 | FAB + mini menu | C4 | Frozen when not Verified, with a blocking message per state |
|
||
| 23 | Post composer (full-screen modal) | C4, C5 | Free/premium toggle · 2,000-character counter · up to 4 images (thumbnail strip, frozen add button) · empty error · discard dialog · publishing state · failed image |
|
||
| 24 | Prediction composer | 📄 C12–C15 | Structured form · free/premium · preview · warning that it locks after 15 min |
|
||
| 25 | Share channel | C6 | Mobile bottom sheet / desktop popover · editable caption (150 characters, default «من را در لومینا دنبال کن 👇») · copy link |
|
||
| 26 | داشبورد overview | 📄 C9–C11, C16 | Subscribers · revenue (label gross or net) · prediction summary · open predictions · compact verification badge |
|
||
| 27 | **قیمتگذاری اشتراک** | C7 | 4 tier cards (monthly always on) · per-month equivalent · floors · suggestions · validation that per-month cost can't increase with duration · promotion section per tier · cooldown lock (standing prices dimmed, promotions still live) · confirmation dialog |
|
||
| 28 | **مالی** — schedule notice · balance · next payout · شبا · ledger | C19, C20 | See §7 |
|
||
|
||
### 6.4 Admin (desktop-first)
|
||
|
||
| # | Screen | Story |
|
||
|---|---|---|
|
||
| 29 | Verification queue (tabs: در انتظار بررسی · تأییدشده · رد شده, search, sort, pagination of 20) | A1 |
|
||
| 30 | Verification detail (ID image lightbox and download, previous/next request, submission history, audit log, approve, reject with reason templates) | A1 |
|
||
| 31 | Creator management list and detail (suspend dialog showing subscriber impact, reinstate dialog showing extension summary, audit log) | A2 |
|
||
| 32 | Users · subscriptions · transactions · reconciliation · refunds · payout run (amount + receipt upload) · predictions moderation · feature flags | 📄 Epic 3/11 |
|
||
|
||
---
|
||
|
||
## 7. Creator finance model (from C19/C20, which replace the PRD's Epic 11 numbers)
|
||
|
||
- **Payouts are weekly on Thursday** (`{payout_day}` is configurable). A static notice explains bank cycles and holidays.
|
||
- **There is no minimum payout threshold, and income is available immediately** on payment confirmation. There is no 7-day pending state.
|
||
- **Balance summary:**
|
||
- **قابل واریز** is the primary figure in brand-dark-900.
|
||
- **مجموع واریزشده** is a secondary line.
|
||
- **در حال واریز** appears only while a transfer is in flight.
|
||
- A negative balance shows in ruby with an explanation underneath.
|
||
- **Next payout line** has several states: date · «register شبا first» · «nothing to pay» · suspended/frozen.
|
||
- **شبا:**
|
||
- The field is LTR with a fixed `IR` prefix, auto-grouped into fours, and normalizes Persian/Arabic digits.
|
||
- The bank name is detected and shown underneath.
|
||
- It's checked with a mod-97 checksum.
|
||
- A responsibility checkbox is mandatory.
|
||
- A read-back confirmation dialog appears before saving.
|
||
- A duplicate شبا shows an amber warning; it doesn't block.
|
||
- **No admin approval.** Every edit sends an SMS alert.
|
||
- Saved state shows the شبا, bank and last-updated date, with an edit action.
|
||
- **Ledger «گردش حساب»:**
|
||
- Tabs همه · واریزها, 20 rows plus «نمایش بیشتر».
|
||
- Two-line rows.
|
||
- A detail view opens as a bottom sheet on mobile and a side panel on desktop. Income detail shows price → discount → amount paid → commission → «سهم شما». Payout detail shows a masked شبا and the receipt (view/download).
|
||
- **Subscriber privacy:** creators only ever see `@username`. Phone numbers and real names are never shown.
|
||
|
||
---
|
||
|
||
## 8. Sample data (for realistic mockups)
|
||
|
||
Keys follow the real API (§10). Raw dates are ISO UTC and money is Toman where shown. Display everything per §2 (Shamsi, Persian digits, `٬`).
|
||
|
||
```json
|
||
{
|
||
"creator": {
|
||
"username": "ali_gold",
|
||
"displayName": "تحلیلگر طلا",
|
||
"bio": "تحلیل تکنیکال طلا و دلار، ۸ سال سابقه",
|
||
"markets": ["gold", "forex", "crypto"],
|
||
"socialLinks": [{ "label": "کانال تلگرام", "url": "https://t.me/ali_gold" }, { "label": "اینستاگرام", "url": "https://instagram.com/ali_gold" }],
|
||
"stats": { "totalPredictions": 42, "activePredictions": 7, "pastPredictions": 35, "wins": 22, "losses": 12, "breakeven": 1,
|
||
"winRate": 62.86, "avgRoiPercent": 8.7,
|
||
"accuracyTrend": ["win", "loss", "win", "win", "breakeven", "win", "loss", "win", "win", "win"] },
|
||
"tiers": [
|
||
{ "billingPeriod": "monthly", "priceToman": 490000, "perMonthToman": 490000 },
|
||
{ "billingPeriod": "quarterly", "priceToman": 1161000, "standingPriceToman": 1290000, "perMonthToman": 387000,
|
||
"promotion": { "percent": 10, "endsAt": "2026-10-12T20:30:00Z" } },
|
||
{ "billingPeriod": "semi_annual", "priceToman": 2352000, "perMonthToman": 392000 },
|
||
{ "billingPeriod": "yearly", "priceToman": 4116000, "perMonthToman": 343000 }
|
||
]
|
||
},
|
||
"posts": [
|
||
{ "type": "text", "accessLevel": "free", "publishedAt": "2026-10-01T11:00:00Z", "caption": "دلار در محدوده حمایتی؛ منتظر تأیید باشید." },
|
||
{ "type": "image", "accessLevel": "premium", "locked": true, "captionPreview": "تحلیل هفتگی انس جهانی و دلار آزاد؛ سطوح کلیدی…", "mediaCount": 3 },
|
||
{ "type": "prediction", "accessLevel": "free", "caption": "شکست مقاومت ۲۴۰۰ دلار",
|
||
"prediction": { "symbol": "XAUUSD", "market": "gold", "direction": "long", "entryPrice": 2310, "targetPrices": [2400, 2450],
|
||
"stopLoss": 2280, "horizon": "2w", "status": "closed", "outcome": "win", "closedPrice": 2402 } },
|
||
{ "type": "prediction", "accessLevel": "free",
|
||
"prediction": { "symbol": "BTCUSDT", "market": "crypto", "direction": "short", "entryPrice": 68000, "targetPrices": [61000],
|
||
"horizon": "45d", "status": "open" } },
|
||
{ "type": "prediction", "accessLevel": "premium", "locked": true, "prediction": { "status": "open" } }
|
||
],
|
||
"investorSubscriptions": [
|
||
{ "creator": "ali_gold", "tier": "quarterly", "status": "active", "daysRemaining": 2 },
|
||
{ "creator": "gold_signal", "tier": "monthly", "status": "active", "daysRemaining": 5 },
|
||
{ "creator": "crypto_mina", "tier": "monthly", "status": "active", "creatorSuspended": true },
|
||
{ "creator": "bourse_pro", "tier": "yearly", "status": "expired", "expiryDate": "2026-09-21T08:00:00Z" }
|
||
],
|
||
"transactions": [
|
||
{ "type": "subscribe", "tier": "quarterly", "toman": 1161000, "status": "pending", "reference": "201234567" },
|
||
{ "type": "renew", "tier": "monthly", "toman": 490000, "status": "successful", "reference": "201230011" },
|
||
{ "type": "subscribe", "tier": "yearly", "toman": 4116000, "status": "failed", "reference": null }
|
||
],
|
||
"creatorFinance (C20 target shape; no API yet)": {
|
||
"available": 3420000, "inTransfer": 1250000, "totalPaidOut": 14300000,
|
||
"nextPayout": "پنجشنبه ۱۶ مهر ۱۴۰۵",
|
||
"sheba": "IR620120000000101234567890", "bank": "بانک ملت",
|
||
"ledger": [
|
||
{ "type": "income", "amount": 203150, "subscriber": "@reza_inv", "tier": "quarterly", "date": "2026-09-27" },
|
||
{ "type": "payout", "amount": -1250000, "status": "in_progress", "date": "2026-10-01" },
|
||
{ "type": "refund_deduction", "amount": -600000, "date": "2026-09-30" },
|
||
{ "type": "payout", "amount": -900000, "status": "cancelled", "date": "2026-09-19" }
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 9. Decisions and open points
|
||
|
||
**Story decisions that override the PRD**
|
||
- Subscriptions are **invite-only**. A referral code from the creator is required, and capacity is limited. When capacity is full, users with a valid code can join a waitlist (a notification subscription with opt-out). Following stays free.
|
||
- Creator payouts are weekly, with no threshold, no clearing period and no شبا approval (see §7).
|
||
- There is no public follower count anywhere.
|
||
- Prediction stats show in full or not at all.
|
||
- Pricing uses 4 fixed tiers with per-month floors (ماهانه ۲۹۹٬۰۰۰ · سهماهه ۲۶۵٬۰۰۰ · ششماهه ۲۳۰٬۰۰۰ · سالانه ۱۹۹٬۰۰۰ per month), promotions, and a 7-day cooldown.
|
||
- Suspension is a full blackout. Subscribers choose between a pro-rated refund and extension by the paused time.
|
||
|
||
**Inconsistencies to resolve (design with the first option until told otherwise)**
|
||
1. **Brand name:** «لومینا / lumina.ir» appears in C4, C6, C19 and C20, while other stories use the placeholder `[نام پلتفرم]`. Use **Lumina**.
|
||
2. **Pending label:** C1 uses «در انتظار تأیید», while C3 and the PRD use «در انتظار احراز هویت». Use the latter.
|
||
3. **Thousands separator:** C7 examples use `,`, while C20 specifies `٬`. Use `٬`.
|
||
4. **Push notifications:** C20 §8.1 mentions push, but push is deferred to Phase 1. Design for SMS + in-app.
|
||
5. **Prediction outcome:** the back end has `win` / `loss` / `breakeven`, closed by the creator. Design those three states.
|
||
|
||
**Story vs back-end conflicts (design to the story; the team must decide)**
|
||
|
||
| # | Topic | Story | Back end today |
|
||
|---|---|---|---|
|
||
| 6 | OTP | 5 digits, 2-minute expiry | 6 digits, 10-minute expiry, 60 s resend cooldown |
|
||
| 7 | National ID images | Front only | Front **and back** required |
|
||
| 8 | Public name | `@username` only (no nickname in C2) | Also a required `displayName` (max 80) |
|
||
| 9 | Post edit window | 15 minutes, then frozen; «ویرایششده» label | Caption/media/access editable forever; no edited flag; predictions frozen at publish |
|
||
| 10 | Drafts | None (local draft only) | Server drafts, soft delete, purge |
|
||
| 11 | Locked prediction teaser | Everything hidden | Leaks `symbol` + `direction` |
|
||
| 12 | Locked image teaser | Never blurred | Sends `blurHash` |
|
||
| 13 | Follower count | Never public | Public endpoint exists |
|
||
| 14 | Promotions | Apply to new, renew and reactivate | New subscriptions only |
|
||
| 15 | Pending payment | Stays «در حال بررسی» until resolved | Auto-expires after 30 min and shows as **failed** |
|
||
| 16 | Creator profile field | — | Extra `tradingStyle` (not in stories, don't design it) |
|
||
| 17 | Brand | Lumina | `OnlyT` in SMS and config |
|
||
|
||
---
|
||
|
||
## 10. Back-end data model (design-relevant summary)
|
||
|
||
> The full analysis is in `backend-context.md` (for engineering). This section only keeps what changes how a screen looks or what content it shows.
|
||
|
||
### 10.1 Formats
|
||
- **Money:** stored in Rial, but every response has a Toman field (`toman`, `priceToman`, `perMonthToman`). The UI always shows Toman.
|
||
- **Dates:** ISO UTC. Server-made Farsi labels look like `۱۴۰۵/۳/۶` (no zero padding, no time). Designs use the §2 format; the front end formats dates itself.
|
||
- **Percentages:** `winRate` and `avgRoiPercent` are already percentages (`62.86`), not fractions.
|
||
- **Server copy:** many subscription, pricing, checkout and notification responses carry ready Farsi strings (`*Fa`) and color hints that match the tokens in §4.1. They agree with the story copy, so the round files stay the copy source.
|
||
|
||
### 10.2 Enums (exact keys)
|
||
|
||
| Enum | Keys |
|
||
|---|---|
|
||
| Market | `crypto` کریپتو · `gold` طلا و سکه · `equities` بورس · `forex` فارکس · `funds` صندوقهای سرمایهگذاری · `real_estate` مسکن · `automotive` خودرو · `USDT` تتر |
|
||
| Billing period | `monthly` · `quarterly` · `semi_annual` · `yearly` |
|
||
| Post | type `text` / `image` / `prediction` · access `free` / `premium` |
|
||
| Prediction | status `open` / `closed` · outcome `win` / `loss` / `breakeven` · direction `long` / `short` |
|
||
| Subscription | `active` / `expired`. "Expiring" is computed: amber at 4–7 days, ruby with warning at ≤3 days |
|
||
| Payment (UI) | `successful` / `pending` / `failed` · type `subscribe` / `renew` / `reactivate` |
|
||
| Checkout CTA | `subscribe` · `active` (مشترک هستید ✓) · `pending_review` (frozen) · `own` (hidden) |
|
||
| Payment return | `processing` → `granted` (land on channel) / `pending_review` / `failed` (back to checkout) |
|
||
| Verification | `pending` / `approved` / `rejected` (+ account `suspended`) |
|
||
|
||
### 10.3 Limits that affect layouts
|
||
- Bio 300 characters, max 3 line breaks.
|
||
- Links: max 8, label max 30 characters.
|
||
- Display name max 80 characters (if used, §9 #8).
|
||
- Avatar and ID images: JPG/PNG, max 5 MB.
|
||
- Post text: the story limit of 2,000 applies (the API accepts 5,000). Max 4 images per post (the API has no limit).
|
||
- Pagination: 20 per page for feed, posts and transactions. Notifications: latest 100, no paging.
|
||
|
||
### 10.4 Back-end support by screen
|
||
Designs still follow the stories for every screen. This list only shows what can be built against real data now.
|
||
|
||
| Supported | Not implemented yet |
|
||
|---|---|
|
||
| Auth, investor registration, creator registration + profile setup/edit | Verification approve/reject, resubmit, rejection reason (creators stay `pending`) |
|
||
| Channel, posts, post page, follow/unfollow (frozen while subscribed, auto-follow on subscribe) | Creator search · track record gate/history/hide · prediction auto-tracking (manual close only) |
|
||
| Pricing (floors, suggestions, promotions, cooldown, validation) | Earnings ledger, شبا, payouts, receipts, commission (C19/C20) |
|
||
| Checkout with invite code, waitlist, price-change guard, ZarinPal return | Refunds · reconciliation · subscription cancel |
|
||
| اشتراکها, renew/reactivate, تراکنشها, notification center | Whole admin panel · audit log · feature flags |
|
||
| Creator dashboard: active subscribers, gross revenue, recent payments | Net revenue (only gross exists, so label it «درآمد ناخالص») |
|
||
|
||
---
|
||
|
||
## 11. Design rounds
|
||
|
||
| Round | File | Goal |
|
||
|---|---|---|
|
||
| 1 | `round-1-channel-and-posts.md` | **Visual language.** Channel header, post card (free / locked / subscriber / owner), standalone post page, composer, share, follow, prediction card (from §5.6) |
|
||
| 2 | `round-2-auth-and-onboarding.md` | Entry, OTP, investor profile, creator KYC, profile setup, اطلاعات کاربری |
|
||
| 3 | `round-3-investor-subscriptions.md` | Checkout, payment return, waitlist, اشتراکها, renew/reactivate, تراکنشها, notifications |
|
||
| 4 | `round-4-creator-money.md` | Pricing, مالی (شبا + ledger) |
|
||
| 5 | `round-5-admin.md` | Verification queue and detail, suspend/reinstate |
|
||
| 6 | (PRD only) | Feed + search, track record, creator dashboard overview, prediction composer, other admin screens |
|
||
|
||
**For each round:** mobile (390px) and desktop, RTL, real Farsi copy from the stories, and every listed state (loading, empty, error, success, frozen, edge).
|