wealth/docs/round-1-channel-and-posts.md

945 lines
81 KiB
Markdown
Raw Normal View History

2026-10-02 13:57:42 +00:00
# Round 1 — Channel, posts & visual language
> Attach together with `design-brief.md`. The brief defines the design system, shared patterns and status vocabulary; this file holds the full acceptance criteria and exact Farsi copy.
> Establish the visual language that every later round reuses.
## Deliver in this round
- Creator channel page `/@username`: header (U6) with all viewer states (brief §5.1), stats block present and absent, empty channel, suspended channel
- Post card: free text, free image (1 and 3 images), locked premium, unlocked premium (subscriber), owner view with actions, edit window active vs frozen, «ویرایش‌شده» label
- Prediction card (brief §5.6, no story yet): compact and expanded, all states including premium-locked
- Standalone post page: free, locked (logged-out and logged-in), owner, visitor-preview banner, deleted, suspended
- Creator کانال tab: Pending and Rejected banners, FAB + mini menu (live and frozen)
- Post composer (full-screen modal): free/premium toggle, images, counter, errors, discard dialog
- Share: creator caption sheet (mobile) and popover (desktop); plain share for visitors
- Image lightbox
For every screen: mobile and desktop, RTL, real Farsi copy from below, and all listed states.
## Stories included
- **C4** — Creator Post Publishing (Free Content) _(ClickUp status: ready for development)_
- **C4b** — Standalone Post Page _(ClickUp status: ready for development)_
- **C5** — Premium Post Publishing _(ClickUp status: ready for development)_
- **U6** — Investor: Creator Profile Header _(ClickUp status: ready for development)_
- **U7** — Investor: Premium Content Lock Indication (Cross-Surface) _(ClickUp status: ready for development)_
- **U8** — Investor: Follow a Creator _(ClickUp status: ready for development)_
- **C6** — Creator Channel Sharing (External Promotion) _(ClickUp status: ready for development)_
---
## C4 — Creator Post Publishing (Free Content)
C4 — Creator Post Publishing (Free Content)
Story:
As a creator, I want to publish free text and image posts to my channel so that I can attract new followers with publicly visible content.
Note: This story covers free text and image posts only. Premium posts are covered in C5. Prediction posts are covered in C8. Posts in this story are always publicly visible to all users — logged in or not.
⚠️ Forward dependency note: The creator channel public URL structure (lumina.ir/@{username}) and post URL structure (lumina.ir/@{username}/posts/{post_id}) are introduced in this story. Standalone post page behaviour is covered in C4b.
⚠️ Phase 1 backlog item: Text truncation on long posts is intentionally not implemented in Phase 0 — full post text is always shown in every context.
Acceptance Criteria:
1. Access & Entry Point
Happy Path:
The post composer is accessed via the FAB (Floating Action Button) labeled + انتشار in the bottom navigation bar — visible to creators from all tabs at all times
Tapping + انتشار expands a mini menu with two options:
پست جدید → opens the post composer (this story)
پیشبینی جدید → opens the prediction composer (C8)
The creator's published posts are managed from the کانال tab in the bottom navigation bar — posts appear chronologically and share/edit/delete actions are accessible inline on each post card
Only Verified creators can publish posts
Edge Cases:
If a creator's account is Pending Verification, the FAB is visible but frozen (opacity: 0.4, cursor: not-allowed) — tapping it shows a context-appropriate blocking message
If a creator's account is Rejected, the FAB is also frozen — tapping it shows a message directing the creator to resubmit their identity verification via C3
If a creator's account is Suspended, the FAB is also frozen — tapping it shows a different context-appropriate blocking message. (In practice, per A2, a Suspended creator cannot log in at all, so this state is largely theoretical within the app itself — kept here for completeness/defense-in-depth)
Tapping anywhere outside the expanded FAB mini menu collapses it without any action
Error States:
Pending verification: blocking message shown on FAB tap
Rejected: blocking message shown on FAB tap
Suspended: blocking message shown on FAB tap
Farsi copy:
FAB label: + انتشار
FAB menu option 1: پست جدید
FAB menu option 2: پیشبینی جدید
Pending verification blocking message: برای انتشار پست، ابتدا باید احراز هویت شما تأیید شود.
Rejected blocking message: احراز هویت شما تأیید نشد. برای انتشار پست، ابتدا اطلاعات هویتی خود را اصلاح و ارسال مجدد کنید.
Suspended blocking message: حساب شما تعلیق شده است. امکان انتشار پست وجود ندارد.
2. Persistent Verification Status Banner (کانال tab)
⚠️ This section fulfills the forward reference established in C1 Section 7.
Happy Path:
A banner is shown at the top of the کانال tab, directly beneath the top navigation bar, for any creator who is Pending or Rejected
The banner does not appear for Verified creators — it disappears entirely and permanently once verification succeeds
Banner content and tap behavior differ by state:
State Message Tappable? Tap Destination
Pending حساب شما در انتظار تأیید است. پس از تأیید تیم پشتیبانی می‌توانید محتوا منتشر کنید. No — informational only —
Rejected احراز هویت شما تأیید نشد. دلیل: {admin_reason} Yes Navigates to C3 (اطلاعات کاربری), landing at the top of اطلاعات هویتی, per C1 Section 7
Edge Cases:
This banner is scoped to the creator's own view of their own کانال tab — entirely separate from what other users see on the creator's public channel page (Section 12)
The banner is non-dismissible — the creator cannot close or hide it; it remains until their verification state changes
If the creator has no posts yet (empty کانال), the banner still renders above the empty state
Error States: None specific — this is a display-only state, no user input involved
Farsi copy:
Pending banner message: حساب شما در انتظار تأیید است. پس از تأیید تیم پشتیبانی می‌توانید محتوا منتشر کنید.
Rejected banner message: احراز هویت شما تأیید نشد. دلیل: {admin_reason}
3. Post Composer
Happy Path:
The composer opens as a full-screen modal on mobile
The composer contains:
A free-text input area for the post body
An image attachment area supporting up to 4 images
A visibility toggle: Free (رایگان) / Premium (پریمیوم) — defaults to Free in C4; Premium behaviour is covered in C5
A Publish CTA button
A Discard option to cancel without publishing
Creator can write text only, attach images only, or combine both — the post cannot be empty (at least one of text or image must be present)
Edge Cases:
If the creator closes the composer with unsaved content, a confirmation dialog appears before discarding
Composer preserves draft content if the app is backgrounded or the device locks — content is not lost on accidental exit
If the creator switches the visibility toggle to Premium during composition, the flow transitions to C5 — text and images already entered are preserved
Error States:
If the post is empty (no text, no images) and the creator taps Publish, an inline error appears
If the network fails during publish, an error banner appears and the draft is preserved — creator can retry
Farsi copy:
Composer heading: پست جدید
Text input placeholder: تحلیل یا دیدگاه خود را بنویسید...
Visibility toggle — free: رایگان
Visibility toggle — premium: پریمیوم
Publish CTA: انتشار
Discard CTA: انصراف
Discard confirmation dialog: پست شما ذخیره نشده است. آیا می‌خواهید خارج شوید؟
Discard confirm CTA: خروج
Discard cancel CTA: ادامه ویرایش
Empty post error: پست نمی‌تواند خالی باشد. متن یا تصویر اضافه کنید.
Network error banner: انتشار پست ناموفق بود. اتصال اینترنت خود را بررسی کنید.
4. Text Content
Happy Path:
Creator enters post text of up to 2000 characters
Persian, English, or mixed text accepted
Line breaks accepted
A live character counter is shown as the creator types
Edge Cases:
Input stops accepting new characters at 2000
URLs typed into the text are displayed as plain text in Phase 0 — not hyperlinked
Hashtags and mentions typed into the text are displayed as plain text in Phase 0
Error States:
Counter turns {colors.ruby} (#ea2261) at 0 remaining characters
Farsi copy:
Character counter: {n}/۲۰۰۰
Counter at limit: به حداکثر تعداد کاراکتر رسیدید.
5. Image Attachments
Happy Path:
Creator can attach up to 4 images per post
Accepted formats: JPG, PNG, WebP
Maximum size per image: 5 MB
A helper text note is shown below the image upload area informing creators of the file specs
After selecting images, thumbnails are shown in a horizontal strip beneath the text input
Creator can remove any individual image before publishing by tapping a remove icon on the thumbnail
Images are displayed in the published post in the order they were attached
Images are displayed at their original aspect ratio — no cropping or forced ratio applied
A maximum height cap of 400px is applied in the feed — images taller than this are letterboxed; the full image is viewable in the lightbox
Edge Cases:
Creator can attach images without any text — image-only posts are valid
If the creator attempts to attach a 5th image, the add image button is frozen/disabled with a message
If an image fails to upload during publish, the entire post publish is blocked — the creator is shown which image failed and can remove or replace it
Image compression is deferred to Phase 1
Error States:
Wrong format: inline error shown, upload rejected
File too large: inline error shown, upload rejected
5th image attempted: add button frozen with message shown
Image upload failure on publish: specific error identifying the failed image
Farsi copy:
Add image CTA: افزودن تصویر
File specs helper text: فرمت‌های مجاز: JPG، PNG، WebP — حداکثر حجم هر تصویر: ۵ مگابایت
Remove image tooltip: حذف تصویر
Wrong format error: فقط فایل‌های JPG، PNG و WebP مجاز هستند.
Too large error: حجم هر تصویر نباید بیشتر از ۵ مگابایت باشد.
Max images reached (frozen button message): امکان افزودن بیش از ۴ تصویر وجود ندارد.
Image upload failure: آپلود تصویر {n} ناموفق بود. تصویر را حذف یا جایگزین کنید.
6. Publishing & Post State
Happy Path:
Creator taps انتشار
System validates content
Post is published immediately and appears at the top of the creator's channel feed
Post is visible to all users — logged in or logged out — immediately upon publishing
A success toast message appears briefly after publishing
Creator is returned to the کانال tab where the new post is visible at the top
Edge Cases:
Post publish timestamp is system-generated — not editable by the creator
If the creator is on a slow connection, a loading indicator is shown on the Publish button during upload — button is disabled to prevent double submission
Published post appears immediately on the خانه feed of all investors who follow the creator
Error States:
If publish fails due to network error, draft is preserved and error banner shown with retry option
Farsi copy:
Publishing loading state: در حال انتشار...
Publish success toast: پست شما با موفقیت منتشر شد.
7. Image Display in Feed & Channel
Happy Path:
Images are displayed at their original aspect ratio in the feed and channel
A maximum height cap of 400px is applied — images taller than this are letterboxed; full image viewable in lightbox
Multi-image display uses a swipe carousel:
1 image: Full width, original aspect ratio
2–4 images: Swipe carousel — each image displayed full width at its original ratio, with a dot indicator showing current position
Tapping any image opens the full-screen lightbox viewer
Full-Screen Lightbox:
Image fills the screen at full resolution
Swipe left/right to navigate between images in the same post
Swipe down to close the lightbox
A back button (←) in the top corner serves as a secondary close option
Image position indicator shown (e.g., ۱ / ۳)
Pinch to zoom supported
Edge Cases:
If the post has only 1 image, no dot indicator or swipe gesture is shown
If the creator attaches images of mixed aspect ratios, each displays at its own ratio within the carousel
Dot indicator uses filled/unfilled dots — maximum 4 dots
Farsi copy:
Image position indicator in lightbox: {current} / {total}
8. Post Display on Channel (Scrollable List)
Happy Path:
The کانال tab shows all published posts as a scrollable chronological list — most recent at the top
Each post card in the list displays:
Creator avatar and username
Post timestamp — Shamsi calendar, relative format for recent posts, absolute for older ones
Full post text — no truncation
Image carousel (if images attached) — as defined in Section 7
Visibility badge: shown only if the post is پریمیوم — free posts carry no badge
Three inline action icons below each post card: share, edit, delete — no labels
Tapping the post body or images navigates to the standalone post page (C4b)
Edge Cases:
If the post has no text, no text area is rendered on the card
If the post has no images, no carousel area is rendered
Action icons (share, edit, delete) are visible only to the creator on their own channel — investors see only the share icon
On the creator's own کانال tab, all of the creator's own posts (free and premium) are shown with full content — no lock or teaser applies
For premium posts specifically, a fourth action icon (مشاهده به عنوان کاربر) is also shown to the creator, alongside share/edit/delete — full behavior defined in C5 Section 6. This icon does not appear on free posts, since there is nothing to preview
The persistent verification banner (Section 2), when applicable, is shown above this list
Farsi copy:
Visibility badge (premium only): پریمیوم
Timestamp examples: همین الان · {n} دقیقه پیش · {n} ساعت پیش · دیروز · {date}
9. Share Action
Happy Path:
Creator or investor taps the share icon on a post card (in the list or on the standalone post page)
The native share sheet opens on mobile — shows whichever apps are already installed on the user's device, plus a copy link option
The shared link is the post's standalone permalink: lumina.ir/@{username}/posts/{post_id}
Copying the link via the share sheet shows a brief confirmation toast
Edge Cases:
Share is available to all users — creators and investors alike
Share is available on both the scrollable list and the standalone post page
If the post is deleted after a link is shared, the permalink returns a پست یافت نشد page
Farsi copy:
Copy link confirmation toast: لینک پست کپی شد.
Deleted post permalink page: این پست حذف شده یا وجود ندارد.
10. Edit Action
Happy Path:
Creator taps the edit icon on a post card within 15 minutes of publishing
Composer reopens with existing content pre-populated
Saving updates the post immediately; a subtle ویرایش‌شده label appears on the post
Post retains its original publish timestamp after editing
Edge Cases:
After 15 minutes, the edit icon remains visible but is frozen (opacity: 0.4) — tapping it shows a tooltip explaining editing is no longer possible
Edit is available on both the scrollable list and the standalone post page
If edit save fails due to network error, error banner shown and original content preserved
Error States:
Edit window expired: frozen icon with tooltip on tap
Network error on save: error banner shown
Farsi copy:
Edit icon tooltip (within window): ویرایش پست
Edit icon tooltip (frozen, after 15 min): مهلت ویرایش این پست به پایان رسیده است.
Edited label: ویرایش‌شده
Edit network error: خطا در ذخیره تغییرات. دوباره تلاش کنید.
11. Delete Action
Happy Path:
Creator taps the delete icon on a post card at any time
A confirmation dialog appears before permanent removal
On confirm, post is permanently removed from the channel and all feeds
Deleted posts disappear from investors' feeds on next refresh — no message shown to investors
Edge Cases:
Delete is available at any time — no time restriction
Delete is available on both the scrollable list and the standalone post page
Deleted posts are permanently removed — no soft delete or recovery in Phase 0
If delete fails due to network error, error banner shown and post remains
Farsi copy:
Delete icon tooltip: حذف پست
Delete confirmation dialog: آیا از حذف این پست اطمینان دارید؟ این عملیات غیرقابل بازگشت است.
Delete confirm CTA: بله، حذف کن
Delete cancel CTA: انصراف
Delete network error: خطا در حذف پست. دوباره تلاش کنید.
12. Channel Page & Creator Public URL
Creator's public channel is accessible at lumina.ir/@{username}
The channel page displays:
Creator profile header: avatar, username, bio, market specialization tags, social links, verified badge
Prediction stats summary — pulled from Epic 9; shown as placeholder zeros until prediction data exists
Follow / unfollow button — available to any investor regardless of subscription status; no referral code required to follow
Subscribe button — referral-code-gated (links to Epic 5 paid access flow)
Scrollable post list — as defined in Section 8, with locked-teaser rendering for premium posts as defined in C5
The channel URL is shareable externally — opens correctly for logged-out users
Share button on the channel page copies the channel URL to clipboard
This public-facing view is distinct from the creator's own کانال tab (Section 2 and Section 8) — external visitors never see the persistent verification banner
Edge Cases:
If a creator has no posts yet, a contextual empty state is shown
If the creator's account is suspended, the channel page shows a suspended message
If a logged-out user taps Follow or Subscribe, they are redirected to the unified auth entry flow with the channel URL preserved as the return destination
Following a creator never requires a referral code; only subscription is referral-gated
Farsi copy:
Channel empty state: این کریتور هنوز پستی منتشر نکرده است.
Suspended channel message: این کانال در حال حاضر در دسترس نیست.
Share channel CTA: اشتراک‌گذاری کانال
Channel URL copied toast: لینک کانال کپی شد.
Follow CTA: دنبال کردن
Unfollow CTA: دنبال نکردن
Subscribe CTA: اشتراک
13. UI / UX
Layout is RTL throughout; Yekan Bakh is the typeface for all Farsi text, per the Stripi-inspired design system
FAB uses button-primary-pill style (#533afd, pill radius); frozen state uses opacity: 0.4
FAB expanded mini menu uses card-feature-light style with {rounded.lg} radius and Level 2 shadow
Persistent verification banner spans full width, sits directly beneath the top nav bar on the کانال tab: Pending — {colors.ink-mute} (#64748d) background tint with clock icon; Rejected — {colors.ruby} (#ea2261) background tint with warning icon and chevron
Post composer opens as a full-screen modal with {colors.canvas} (#ffffff) background
Post cards use card-feature-light style
Only the پریمیوم badge is ever rendered — {colors.brand-dark-900} (#1c1e54) background with white text — free posts carry no badge
Character counter uses {colors.ink-mute} (#64748d), switches to {colors.ruby} (#ea2261) at 0 remaining
Carousel dot indicator uses {colors.primary} for active dot, {colors.hairline} for inactive dots
Full-screen lightbox uses a pure black (#000000) background
Action icons use {colors.ink-mute} (#64748d) — frozen edit icon uses opacity: 0.4
ویرایش‌شده label uses {colors.ink-mute} in {typography.micro} size
Minimum touch target for all interactive elements: 44×44px
Channel page and post composer are mobile-first
---
## C4b — Standalone Post Page
C4b — Standalone Post Page
Story: As a user, I want to view a post on its own dedicated page so that I can access it directly via a shared link and see its full content.
Note: The standalone post page is the canonical destination for any shared post link. It serves both internal navigation (tapping a post from the channel or feed) and external deep linking (shared permalink on Telegram, WhatsApp, etc.). This story applies to all post types — free text/image posts (C4), premium posts (C5), and prediction posts (C8) — with access rules per post type applying as defined in their respective stories.
⚠️ Forward reference: Creator referral code visibility and sharing (needed for the subscription-gated referral system defined in U1 Section 7) is addressed in C9 (Creator Dashboard) — not in this story.
Acceptance Criteria:
1. URL Structure & Access
Happy Path:
Every post has a unique, permanent permalink: lumina.ir/@{username}/posts/{post_id}
The standalone post page is accessible to:
Logged-out users — can view free content in full; premium content shown as locked teaser
Logged-in investors (non-subscribers) — can view free content in full; premium content shown as locked teaser with subscribe prompt
Logged-in subscribers — can view all content including premium
The creator themselves — can view all content plus edit/delete actions, and can toggle a visitor-view preview on their own premium posts (see Section 6)
The page loads correctly when accessed via external link — no login required to view free content
Edge Cases:
If the post has been deleted, the permalink returns a not found page — clean and informative, with a CTA to visit the creator's channel
If the creator's account has been suspended, the permalink returns a channel unavailable page — post content is not shown
If a logged-out user taps a locked premium content prompt, they are redirected to the unified auth entry flow with the post URL preserved as the return destination (as defined in U1 Section 5)
Farsi copy:
Deleted post page heading: این پست حذف شده است.
Deleted post page body: پست مورد نظر حذف شده یا وجود ندارد.
Deleted post page CTA: مشاهده کانال {username}
Suspended channel page: این کانال در حال حاضر در دسترس نیست.
2. Page Structure & Content
Happy Path:
The standalone post page displays the following sections in order from top to bottom:
Section A — Creator Mini Profile Header:
Creator avatar (circular)
Creator username (tappable — navigates to lumina.ir/@{username})
Verified badge (if applicable)
Follow / Unfollow button (for investors — no referral code required)
Subscribe button (for non-subscribers) — see Section 4 for exact CTA logic by auth state
Section B — Post Content:
Badge placement: The پریمیوم badge sits at the top of the content area, alongside the timestamp — same placement rule as C5
Post timestamp — Shamsi calendar, absolute format (e.g., ۱۵ خرداد ۱۴۰۴، ساعت ۱۴:۳۰) — shown prominently near the top, directly beneath the creator header. Deliberate placement: timestamp is a trust signal central to the platform's Proof-of-Performance positioning, not incidental metadata
ویرایش‌شده label if the post was edited within the 15-minute window
Full post text — no truncation, full content shown (for free posts; premium post teaser rules in Section 4)
Image carousel (if images attached) — same display rules as C4 Section 7 apply
For prediction posts: structured prediction fields — covered in C8
Section C — Action Bar:
Share, edit (creator only), delete (creator only) icons — same rules as C4 Sections 9, 10, 11 apply
مشاهده به عنوان کاربر (View as Visitor) icon — shown only to the creator, only on their own premium posts — see Section 6
No labels under any icon in this bar
Section D — Comments:
Not implemented in Phase 0 — this section is omitted entirely, no placeholder shown
Edge Cases:
If the post has no images, Section B renders text only — no empty carousel
If the post is text-only, the image area is not rendered at all
If the post is image-only, the text area is not rendered
The creator mini profile header is always shown — even if the post is premium and locked
Farsi copy:
Follow CTA: دنبال کردن
Unfollow CTA: دنبال نکردن
Subscribe CTA: اشتراک
Visibility badge (premium only): پریمیوم
3. Navigation & Back Behaviour
Happy Path:
If the user arrived at the standalone post page from within the app (tapping a post in the channel list or feed), the back button returns them to the previous screen they came from — channel tab, خانه tab, or search results
If the user arrived via an external link (shared permalink), the back button navigates to the creator's channel page (lumina.ir/@{username}) — not to a blank previous state
Edge Cases:
If the user arrived via external link and has no browsing history within the app, the back button always falls back to the creator's channel page
If the creator's channel is suspended when the user attempts to navigate back from a shared link, the back button navigates to the خانه tab instead
4. Locked Premium Content (Non-Subscribers)
Happy Path:
If the post is premium and the user is not a subscriber, the same locked teaser pattern defined in C5 Section 3 applies here — unified across every surface where a premium post can appear:
Text teaser: First 2 lines of the post text, then gradient blur fade with a lock icon overlay
Image teaser: Images not shown — generic locked placeholder with an optional count badge (e.g., ۳ تصویر)
The پریمیوم badge, timestamp, and creator mini profile header remain fully visible — only the content body is restricted
Directly beneath the locked content, a contextual message and a single CTA are shown, determined by auth state
Message & CTA Logic by Auth State (single message + single CTA — never both states shown simultaneously):
User State Message Shown CTA Shown
Logged-out برای دسترسی به این محتوا، ابتدا وارد شوید یا ثبت‌نام کنید. ورود/ثبت‌نام
Logged-in, not subscribed برای مشاهده این محتوا، نیاز به اشتراک در کانال آن دارید. اشتراک در کانال
Logged-in, subscribed — No lock — full content shown
The creator (own post) — No lock — full content always shown by default (see Section 6 for the visitor-preview toggle)
Edge Cases:
A logged-out user never sees a Subscribe CTA — authentication must happen first, subscription is a separate step after
If the user subscribes and returns to the same permalink, content is immediately accessible without needing to refresh
Arriving at a locked premium post via a shared link vs. tapping into it from a feed/channel list produces identical locked-teaser behavior — no distinction by entry path
Farsi copy:
Locked teaser image badge: {n} تصویر
Lock overlay small label (optional): محتوای پریمیوم
Message (logged-in, not subscribed): برای مشاهده این محتوا، نیاز به اشتراک در کانال آن دارید.
Subscribe CTA (logged-in, not subscribed): اشتراک در کانال
Message (logged-out): برای دسترسی به این محتوا، ابتدا وارد شوید یا ثبت‌نام کنید.
Unified auth CTA (logged-out): ورود/ثبت‌نام
5. Share Action on Standalone Post Page
Happy Path — Mobile:
Share icon is visible to all users on the standalone post page
Tapping share opens the native OS share sheet — shows whichever apps are already installed on the user's device, plus a copy link option
The platform does not construct or call any specific third-party share URL — it hands the permalink to the OS and lets the user's own device decide the available destinations
The shared link is the current page's permalink: lumina.ir/@{username}/posts/{post_id}
Happy Path — Desktop:
Clicking share opens a minimal popover containing a single action: کپی لینک (copy link)
No direct-share buttons to specific third-party platforms are included on desktop
Clicking outside the popover closes it without action
Edge Cases:
Share is available for both free and premium posts — sharing a premium post link will show the locked teaser (Section 4) to non-subscribers who open it, which is a deliberate conversion mechanic, not a gap
Copy link action shows a brief confirmation toast on both mobile and desktop
This is precisely the moment the "View as Visitor" preview (Section 6) is most useful — a creator preparing to share their own premium post externally can check exactly what a stranger clicking that link will see, without leaving this page
Farsi copy:
Copy link confirmation toast: لینک پست کپی شد.
Desktop popover — copy link option: کپی لینک
6. Creator Preview — "View as Visitor" (مشاهده به عنوان کاربر)
Happy Path:
On the standalone page of any premium post the creator owns, the مشاهده به عنوان کاربر icon appears in the Action Bar (Section 2, Section C), alongside share/edit/delete
Tapping it renders the exact same locked-teaser view defined in Section 4 — the identical component/template a non-subscriber would see, not a separate mock
This is the same feature introduced in C5 Section 6, scoped there to the کانال tab list view — this section extends its availability to the standalone post page as well, since a creator is often on this exact page (about to share the link, per Section 5) when the need to check the visitor's view is highest
A visible banner while active: شما در حال مشاهده این پست به شکلی هستید که کاربران غیر عضو می‌بینند.
A dismissible خروج از پیش‌نمایش action returns the creator to their normal full-access view
Edge Cases:
This action is not shown for free posts — there is nothing to preview, since free posts render identically for everyone
This action is not shown to anyone other than the post's owning creator — investors, subscribers, and logged-out users never see this icon
No actual impersonation or session-switching occurs — it is a conditional render of the visitor-facing template within the creator's own authenticated session
Toggling this preview does not affect what the URL shows to anyone else — it is a local, client-side view state for the creator only
Farsi copy:
Action icon label (tooltip): مشاهده به عنوان کاربر
Preview mode banner (shown while active): شما در حال مشاهده این پست به شکلی هستید که کاربران غیر عضو می‌بینند.
Exit preview CTA: خروج از پیش‌نمایش
7. Edit & Delete on Standalone Post Page
Edit and delete icons are visible only to the creator on the standalone post page
All edit/delete rules from C4 Sections 10 and 11 apply identically here
After a successful delete from the standalone post page, the creator is navigated back to their کانال tab — the deleted post is no longer visible
Farsi copy: Same as C4 Sections 10 and 11.
8. UI / UX
Layout is RTL throughout; Yekan Bakh is the typeface for all Farsi text, per the Stripi-inspired design system
Page background uses {colors.canvas-soft} (#f6f9fc) — slightly off-white to distinguish the page from the post card content area
Post content area uses card-feature-light style — {colors.canvas} background, {colors.hairline} border, {rounded.lg} radius, Level 1 shadow
Creator mini profile header is separated from post content by a {colors.hairline} divider
Timestamp rendered directly beneath the creator header in {colors.ink-mute} (#64748d), {typography.caption} size
پریمیوم badge uses {colors.brand-dark-900} (#1c1e54) background with white text, positioned at the top of the content area alongside the timestamp — shown only when applicable, no badge for free posts
Locked text teaser fade uses a linear gradient from transparent to {colors.canvas} (#ffffff), with the lock icon in {colors.ink-mute} (#64748d) centered on the fade
Locked image placeholder uses {colors.canvas-soft} background, lock icon in {colors.ink-mute}, image count badge in pill-tag-soft style
Contextual message (logged-out or not-subscribed) renders in {colors.ink-mute} (#64748d), {typography.body-md}, centered above the CTA
Subscribe CTA and auth CTA both use button-primary-pill style (#533afd, pill radius)
Action icons (share, edit, delete, view-as-visitor) use {colors.ink-mute} (#64748d) — consistent with C4
ویرایش‌شده label uses {colors.ink-mute} in {typography.micro} size
View-as-visitor preview banner uses {colors.warning} (#f59e0b) background with dark text — signals a temporary/altered viewing mode without implying an error, consistent with the same treatment in C5 Section 7
Desktop share popover is minimal — single row, card-feature-light style with Level 2 shadow, {rounded.md} radius
Image carousel and lightbox behaviour identical to C4 Section 7
Minimum touch target for all interactive elements: 44×44px
Page is mobile-first; on desktop, content is centered in a single column with max-width of 640px
---
## C5 — Premium Post Publishing
C5 — Premium Post Publishing
Story:
As a creator, I want to publish premium posts visible only to subscribers so that I can provide exclusive value that justifies the subscription price.
Note: This story extends the composer introduced in C4 — the visibility toggle (رایگان / پریمیوم) is shared infrastructure between both stories. C5 owns the premium-specific behavior: access control, locked teaser rendering, and the paywall logic. Standalone post page behavior is defined in C4b Section 4, using the identical teaser pattern specified here.
⚠️ Forward dependency note: Premium access in Phase 0 is gated purely by active channel subscription — there is no per-post pricing (PPV). One subscription unlocks all premium content on that creator's channel. PPV is explicitly deferred to Phase 1 per the PRD. Subscription itself is referral-code-gated (Epic 5); following a creator is free and requires no referral code.
Acceptance Criteria:
1. Marking a Post as Premium
Happy Path:
In the post composer (C4 Section 3), the creator switches the visibility toggle from رایگان to پریمیوم
All composition rules (text limit, image limits, formats) remain identical to C4 — only the visibility and access control differ
On publish, the post is immediately locked for all non-subscribers and fully visible to subscribers and the creator
Edge Cases:
A creator with zero subscribers can still publish premium posts — content accumulates for whenever their first subscriber joins
The visibility toggle (رایگان ⇄ پریمیوم) can be changed in either direction within the same 15-minute edit window established in C4 — consistent with all other post edits
After the 15-minute window closes, visibility is locked along with the rest of the post content — a creator cannot convert a free post to premium (or vice versa) after this window
Error States:
Same network/validation error states as C4 apply — no additional error states specific to the toggle itself
Farsi copy: Same visibility toggle copy as C4 Section 3 (رایگان / پریمیوم).
2. Access Control Logic
Viewer Access
The creator (post owner), viewing their own کانال tab Full content, always — no lock, no teaser
Active subscriber to this creator Full content
Logged-in investor, not subscribed Locked teaser (Section 3)
Logged-out user Locked teaser (Section 3)
Edge Cases:
If a subscriber's subscription expires, premium posts immediately revert to locked teaser state for that user on next load — no grace period
If a non-subscriber subscribes, previously locked posts become immediately accessible without needing to refresh the app
If the creator's account is suspended, all content (free and premium) becomes inaccessible per the suspension rules already defined in A2 and C4 — premium-specific access control is irrelevant in this state
Following a creator does not grant premium access — following is free and ungated; only an active, referral-code-originated subscription unlocks premium content
3. Locked Teaser Display (Investor-Facing Surfaces)
Scope clarification: This locked teaser applies exclusively to investor-facing surfaces — the public channel page (lumina.ir/@{username}) and the خانه feed (Epic 7). It does not apply to the creator's own کانال tab, where the creator always sees full content for their own posts (per Section 2).
Happy Path:
Badge placement: The پریمیوم badge sits at the top of the post card, in the header area alongside the creator avatar, username, and timestamp — identical placement whether the post is locked or unlocked
Text teaser: The first 2 lines of the post text are shown, then fade into a gradient blur with a lock icon overlay centered on the fade. Kept intentionally short — even a longer excerpt risks revealing directional analysis, which undermines the platform's core value proposition
Image teaser: Images are not shown at all — replaced with a generic locked placeholder (a branded lock icon on {colors.canvas-soft} background), not a blurred version of the actual image, to avoid any risk of leaking directional information. If multiple images, a count badge indicates richness (e.g., ۳ تصویر)
Directly beneath the locked content, a contextual message and a single CTA are shown, determined by auth state (see table below)
Tapping the card body (text or image placeholder area) navigates to the standalone post page (C4b), where the identical locked-teaser pattern is shown
Edge Cases:
If the premium post has no text (image-only), only the image placeholder is shown
If the premium post has no images (text-only), only the text teaser is shown
Post timestamp, creator info, and the پریمیوم badge remain fully visible on locked cards — only the content body is restricted
Message & CTA Logic by Auth State (single message + single CTA — never both states shown simultaneously):
User State Message Shown CTA Shown
Logged-out برای دسترسی به این محتوا، ابتدا وارد شوید یا ثبت‌نام کنید. ورود/ثبت‌نام
Logged-in, not subscribed برای مشاهده این محتوا، نیاز به اشتراک در کانال آن دارید. اشتراک در کانال
Logged-in, subscribed — No lock — full content shown
Error States: None specific — this is a display-only state, no user input involved
Farsi copy:
Locked teaser image badge: {n} تصویر
Lock overlay small label (optional): محتوای پریمیوم
Message (logged-in, not subscribed): برای مشاهده این محتوا، نیاز به اشتراک در کانال آن دارید.
Subscribe CTA (logged-in, not subscribed): اشتراک در کانال
Message (logged-out): برای دسترسی به این محتوا، ابتدا وارد شوید یا ثبت‌نام کنید.
Unified auth CTA (logged-out): ورود/ثبت‌نام
4. Standalone Post Page Behavior
Full lock behavior — including badge placement, the 2-line text teaser, image placeholder, contextual message, and auth-state CTA logic — is fully specified in C4b Section 4, using the exact same pattern defined in Section 3 above. No divergence between list/feed teasers and standalone page teasers
Arriving at a premium post's standalone page from a locked teaser tap vs. a direct shared link produces identical behavior — the lock does not differentiate by entry path
5. Subscriber View
Happy Path:
An active subscriber sees premium posts identically to free posts — full text, full image carousel, no visual distinction in content rendering
The پریمیوم badge remains visible at the top of the post, as a status indicator, even to subscribers who have full access — this reinforces the perceived value of their subscription
Edge Cases:
If a subscriber's subscription expires while they are actively viewing a premium post, the content does not disappear mid-session — the lock takes effect on the next page load or refresh, not retroactively within an open session
6. Creator Preview — "View as Visitor"
Happy Path:
On every premium post the creator owns (visible from their کانال tab), a "مشاهده به عنوان کاربر" action is available alongside the standard share/edit/delete icons
Tapping it opens a read-only preview rendering the exact locked-teaser view a non-subscriber would see — using the identical component/template defined in Section 3, not a separate mock
This gives creators direct visibility into what their non-subscribing audience actually sees, closing the trust gap of publishing premium content on faith
This same action is also available on the standalone post page for the identical premium post — fully specified in C4b Section 6. Both surfaces use the same underlying preview template; a creator can trigger it from wherever they happen to be reviewing that specific post
Edge Cases:
This preview is available only to the creator, only on their own premium posts
No actual impersonation or session-switching occurs — it is a conditional render of the visitor-facing template within the creator's own authenticated session
The preview is dismissible via a clear "خروج از پیش‌نمایش" action, returning the creator to their normal full-access view
Farsi copy:
Preview action label: مشاهده به عنوان کاربر
Preview mode banner (shown while active): شما در حال مشاهده این پست به شکلی هستید که کاربران غیر عضو می‌بینند.
Exit preview CTA: خروج از پیش‌نمایش
7. UI / UX
Layout is RTL throughout; Yekan Bakh is the typeface for all Farsi text, per the Stripi-inspired design system
Locked teaser text fade uses a linear gradient from transparent to {colors.canvas} (#ffffff), with the lock icon in {colors.ink-mute} (#64748d) centered on the fade
Image placeholder uses {colors.canvas-soft} (#f6f9fc) background, lock icon in {colors.ink-mute}, with the image count badge in pill-tag-soft style
پریمیوم badge uses {colors.brand-dark-900} (#1c1e54) background with white text, positioned at the top of the post card in the header row — consistent with C4/C4b; no badge is ever shown for free posts
Contextual message (logged-out or not-subscribed) renders in {colors.ink-mute} (#64748d), {typography.body-md}, centered above the CTA
Subscribe CTA and auth CTA both use button-primary-pill style (#533afd, pill radius) for visual consistency
"View as Visitor" preview banner uses {colors.warning} (#f59e0b) background with dark text — signals a temporary/altered viewing mode without implying an error
Minimum touch target for all interactive elements: 44×44px
Locked card layout is otherwise identical in structure to a free post card (avatar, username, timestamp, badge) — only the content body area differs
---
## U6 — Investor: Creator Profile Header
U6 — Investor: Creator Profile Header
Story: As an investor, I want to view a creator's public profile including their prediction stats (win rate, ROI, accuracy trend) so that I can evaluate a creator's credibility before subscribing.
Scope note: This story owns the investor-facing profile header on the public channel page (lumina.ir/@{username}) — the block above the post feed. The page itself, its URL structure, and the post list below are defined in C4 Section 12; the locked-teaser rendering of premium posts within that feed is defined in C5. U6 does not re-specify those.
⚠️ Forward dependency note: Prediction statistics originate from Epic 9 (Prediction Tracking Engine) and the visibility gate from Epic 10 (Public Track Record Page). Until Epic 9 exists, the entire statistics block is hidden per Section 3 — the header renders without it, not with placeholder values.
Acceptance Criteria:
1. Access & Context
Happy Path:
The profile header is the first block on a creator's public channel page (lumina.ir/@{username}), directly above the post feed
Accessible to all viewer types — logged-out visitors, logged-in non-subscribers, active subscribers, and the creator themselves
Reached by navigating from any surface where the creator's identity appears as a link — a shared channel link (external), a shared post permalink, tapping a creator's avatar or username on a post card (in the خانه feed or a channel's post list), or in-app creator search (Epic 7). The خانه feed itself never displays this header directly — it shows only posts from followed creators; it is simply one of several starting points an investor navigates from on their way to a creator's channel
Edge Cases:
If the creator's account is suspended, the header is not rendered at all — the page shows the channel-unavailable message instead (per C4 Section 12)
If the creator is Pending Verification or Rejected, their channel is not publicly discoverable and this header is not reachable by investors — the creator's own persistent status banner (C4 Section 2) is a separate, creator-only surface and never appears here
2. Header Content — Always Visible
Happy Path:
The header displays, in order:
Avatar — circular; falls back to the default placeholder (initials on {colors.primary} background) if the creator uploaded none (per C2 Section 3)
Username — @{username}, the creator's permanent public identifier
Verified badge — shown only for Verified creators
Bio — full text as entered in C2/C3; up to 300 characters
Market specialization tags — rendered as pill-tag-soft chips, in the order the creator selected them
Social & web links — as icons/labels, in the creator's saved order, opening in a new tab
Prediction statistics block — conditional, see Section 3
Follow / Unfollow button — see Section 4
Subscribe button — see Section 5
Edge Cases:
If the creator left bio empty (optional per C2), the bio area is not rendered — no empty placeholder
If the creator added no social links (optional per C2), that row is not rendered
Market specializations are always present — at least one tag is mandatory in C2, so this block always renders
Long bios render in full — no truncation, consistent with the no-truncation decision in C4
Farsi copy:
Verified badge label/tooltip: تأییدشده
3. Prediction Statistics Block (Conditional)
This block is governed by a strict two-state rule — it is either fully absent or fully present. There is no partial, placeholder, or zero-value rendering at any point.
Condition Rendering
Creator has not met the Epic 10 activation threshold (no predictions at all, or predictions exist but the threshold is unmet) Block entirely hidden. No heading, no empty state, no zeros, no "coming soon" text — the header renders as though the block does not exist
Creator has met the Epic 10 activation threshold Full summary displayed (see below)
Rationale (documented so this isn't later mistaken for an oversight): showing zeros would make a creator with no prediction history visually near-identical to one with a genuinely poor record — directly undermining the platform's credibility thesis. Showing partial activity counts below the threshold was considered and rejected in favour of a simpler two-state model: statistics appear only once they are aggregated enough to be meaningful.
Full summary contents (threshold met):
Win rate — wins ÷ total closed predictions, as a percentage
Total predictions — count of all predictions published
Active predictions — count currently open
ROI — average return across closed predictions
Accuracy trend — directional indicator over time
A CTA linking through to the creator's full public track record page (Epic 10 / U19)
Edge Cases:
The activation threshold itself is owned by Epic 10 — U6 only consumes the resulting boolean (threshold met: yes/no) and must not reimplement or hardcode the threshold logic. The exact minimum-closed-predictions value remains an Open Question in the PRD
If a creator has opted to hide their public track record page (C18), the statistics block is hidden here as well, and no CTA is shown — a creator's choice to stay private must be honoured consistently across surfaces, not just on the track record page itself
All statistics are read-only on this header — no filtering, sorting, or interaction beyond the CTA
Statistics reflect all of the creator's predictions, free and premium alike — the paywall governs access to prediction content and reasoning, never to their recorded outcomes. Hiding losing outcomes behind a paywall would defeat the entire proof-of-performance model
Farsi copy:
Section heading: عملکرد پیشبینی‌ها
Win rate label: نرخ موفقیت
Total predictions label: کل پیشبینی‌ها
Active predictions label: پیشبینی‌های فعال
ROI label: بازدهی
Accuracy trend label: روند دقت
Track record CTA: مشاهده کارنامه کامل
4. Follow / Unfollow
Happy Path:
Following is free and ungated — no referral code, no payment, no subscription required
Button reflects current state: دنبال کردن when not following, دنبال نکردن when already following
Tapping toggles the state immediately with optimistic UI update
Edge Cases:
Logged-out visitor tapping Follow → redirected to the unified auth entry flow, with the channel URL preserved as the return destination (U1 Sections 5–6). A single ورود/ثبت‌نام CTA is shown — never separate Register and Login options
Following does not grant access to premium content — that requires an active subscription (C5 Section 2)
Full follow-interaction mechanics (state persistence, effect on the خانه feed, notification behaviour) are owned by U8 — U6 owns only the button's presence and appearance within this header
Farsi copy:
Follow CTA: دنبال کردن
Unfollow CTA: دنبال نکردن
5. Subscribe
Happy Path:
Subscribe button is displayed in the header for any viewer who is not an active subscriber
Tapping initiates the subscription flow (Epic 5), which is referral-code-gated in Phase 0
Edge Cases:
Logged-out visitor tapping Subscribe → same unified auth redirect as Follow (Section 4), with the channel URL preserved. Authentication happens first; subscription is a separate subsequent step
Active subscriber → the Subscribe button is replaced with a subscription status indicator rather than shown as a redundant action
If the creator's referral code is at capacity, the investor enters the waitlist flow (specified in Epic 5, referenced in U1 Section 7) — U6 does not own that behaviour
Farsi copy:
Subscribe CTA: اشتراک
Active subscriber status indicator: مشترک هستید ✓
6. Viewer-State Summary
Viewer Header Content Follow Subscribe
Logged-out Full header (stats per Section 3) Shown — tap → auth flow Shown — tap → auth flow
Logged-in, not following, not subscribed Full header دنبال کردن اشتراک
Logged-in, following, not subscribed Full header دنبال نکردن اشتراک
Active subscriber Full header Follow state as applicable Replaced with مشترک هستید ✓
The creator themselves Full header Not shown Not shown
7. UI / UX
Layout is RTL throughout; Yekan Bakh is the typeface for all Farsi text, per the Stripi-inspired design system
Header sits on {colors.canvas} with a {colors.hairline} divider separating it from the post feed below
Avatar rendered circular; default placeholder uses {colors.primary} background with white initials
Username in {typography.heading-md}; bio in {typography.body-md}, {colors.ink}
Verified badge uses {colors.primary} (#533afd) with a checkmark icon, positioned inline beside the username
Market specialization tags use pill-tag-soft — {colors.primary-bg-subdued-hover} background, {colors.primary-deep} text
Social link icons use {colors.ink-mute} (#64748d), shifting to {colors.primary} on hover/press
All prediction statistics use font-feature-settings: "tnum" — non-negotiable per the design system's tabular-figures rule for any numeric or performance value, and is the brand's quiet financial-data signature
Statistics block sits within a card-feature-light container to visually distinguish it as a distinct credibility artifact rather than ordinary profile text
Track record CTA uses link-on-light style — {colors.primary} text, no underline by default
Subscribe CTA uses button-primary-pill (#533afd, pill radius); Follow uses button-secondary (outline, {colors.primary} text) so the paid action stays visually dominant
Active subscriber indicator uses {colors.primary} text with checkmark — not a button, no press state
Minimum touch target for all interactive elements: 44×44px
Header is mobile-first; on desktop it centers in a single column matching the post feed's max-width
---
## U7 — Investor: Premium Content Lock Indication (Cross-Surface)
Good — writing U7 as the cross-surface consistency spec. It owns the principle and the currently-orphaned feed case; C5 and C4b remain the source of truth for the pattern's visual details.
U7 — Investor: Premium Content Lock Indication (Cross-Surface)
Story: As an investor, I want to see a clear visual indicator when a post is premium and locked so that I understand what I'm missing and can decide whether to subscribe.
Scope note: This story owns the consistency principle for how locked premium content is presented to investors across every surface where it can appear, and fully specifies the one surface not yet owned by any other story: the خانه feed. The locked-teaser pattern itself (badge placement, 2-line text fade, image placeholder, message/CTA logic) is defined in C5 Section 3 and applied identically on the standalone post page in C4b Section 4 — U7 references that pattern rather than redefining it.
⚠️ Forward dependency note: The خانه feed as a container — its composition, ordering, empty states, pagination, and refresh behaviour — is owned by Epic 7 (User Feed), which is not yet written. U7 specifies only how a locked premium post renders and behaves once it appears within that feed. Epic 7 must not redefine locked-post rendering; it inherits it from here.
Acceptance Criteria:
1. The Consistency Principle
Happy Path:
A locked premium post presents identically to the investor on every surface where it can appear. There is exactly one locked-post pattern platform-wide, implemented as a single shared component — not re-created per surface
The pattern is defined in C5 Section 3 and consists of:
پریمیوم badge at the top of the card/content area, in the header row alongside avatar, username, and timestamp
Text teaser — first 2 lines only, fading into a gradient blur with a lock icon overlay
Image treatment — images are not shown at all; replaced by a generic locked placeholder (branded lock icon), never a blurred version of the real image. An optional count badge indicates how many images are behind the lock
Contextual message + single CTA, determined by the viewer's auth state (Section 3)
Creator identity, timestamp, and the پریمیوم badge always remain fully visible — only the content body is restricted
Surfaces this applies to:
Surface Owning Story Status
Public channel page (lumina.ir/@{username}) post list C5 Section 3 Specified
Standalone post page (lumina.ir/@{username}/posts/{post_id}) C4b Section 4 Specified
خانه feed U7 (this story), Section 2 Specified here
Edge Cases:
If any future surface renders posts (search results, discovery, notifications), it inherits this same pattern by default — new surfaces do not get to invent their own locked-post treatment
The pattern does not vary by how the investor arrived — tapping a locked card from the feed, opening a shared permalink, or browsing a channel all produce identical rendering
2. Locked Posts in the خانه Feed
Happy Path:
Premium posts from creators the investor follows but is not subscribed to appear in the خانه feed as locked cards, using the pattern from Section 1
They are not filtered out or hidden — an investor should see that a creator they follow is actively publishing premium analysis, since that awareness is the primary conversion trigger
Locked cards sit inline in normal chronological order alongside free posts — no separate section, no grouping, no reordering
The اشتراک در کانال CTA appears directly on the locked card, allowing subscription to be initiated without leaving the feed
Edge Cases:
If an investor follows a creator and is subscribed to them, that creator's premium posts appear fully unlocked in the feed — identical to free posts apart from the retained پریمیوم badge
If an investor's subscription expires, previously unlocked posts already in their feed revert to locked cards on next feed load or refresh — no grace period, consistent with C5 Section 2
If a creator is suspended, none of their posts (free or premium) appear in the feed at all — suspension is a full blackout per A2, and takes precedence over any locked/unlocked logic
A locked card is fully tappable — tapping the card body navigates to the standalone post page (C4b), where the same locked pattern is shown with its own CTA
Locked and free posts are counted identically for feed pagination purposes — locking affects presentation only, never feed composition or ordering
Error States:
No error states specific to locking — this is a display state derived from subscription status, involving no user input
3. Message & CTA Logic by Auth State
Identical across all three surfaces. A single message and a single CTA are shown — never two competing calls to action.
Viewer State Message CTA
Logged-out برای دسترسی به این محتوا، ابتدا وارد شوید یا ثبت‌نام کنید. ورود/ثبت‌نام
Logged-in, not subscribed برای مشاهده این محتوا، نیاز به اشتراک در کانال آن دارید. اشتراک در کانال
Logged-in, subscribed — No lock — full content shown
Edge Cases:
A logged-out visitor never sees a Subscribe CTA — authentication must complete first; subscription is a separate subsequent step (consistent with U1 Section 6)
Tapping the logged-out CTA preserves the current page as the post-auth return destination (U1 Section 5)
On successful subscription, locked content unlocks immediately without requiring a manual refresh
The logged-out message deliberately reads "وارد شوید یا ثبت‌نام کنید" — never assuming the visitor is a new user, since the platform's auth entry screen silently handles both cases
4. What the Lock Must Never Reveal
Happy Path:
The 2-line text limit is a hard ceiling, not a guideline. It exists because a longer excerpt risks revealing the directional substance of an analysis — which would let a non-subscriber extract the value without subscribing, defeating the entire monetization model
Images are never blurred versions of the real image. A blurred chart can still leak directional information (e.g. red vs. green candle patterns, an obvious trend line), so a generic placeholder is used instead — this is a deliberate content-security decision, not a visual style choice
Edge Cases:
For prediction posts (C8) marked premium, the structured prediction fields (asset, direction, entry, target, horizon) are treated as locked content and are not shown in the teaser — direction and target are precisely the values a non-subscriber must not obtain for free
The prediction's recorded outcome, however, is never hidden — aggregate statistics on the creator's profile header (U6 Section 3) and public track record page (Epic 10) reflect all predictions regardless of their free/premium status. The paywall governs access to reasoning and calls, never to results
5. Creator-Side Verification
A creator can confirm exactly what an investor sees on a locked post via مشاهده به عنوان کاربر, available on their own premium posts — specified in C5 Section 6 (کانال tab) and C4b Section 6 (standalone post page)
Because U7 mandates a single shared component, this preview is accurate for every surface — what the creator previews is what an investor sees in the feed, on the channel page, and on the standalone page alike
6. UI / UX
Layout is RTL throughout; Yekan Bakh is the typeface for all Farsi text, per the Stripi-inspired design system
پریمیوم badge: {colors.brand-dark-900} (#1c1e54) background with white text, pill-tag-soft style — positioned at the top of the card in the header row. No badge is ever rendered for free posts; only the exception is marked
Locked text fade: linear gradient from transparent to {colors.canvas} (#ffffff), with the lock icon in {colors.ink-mute} (#64748d) centered on the fade
Locked image placeholder: {colors.canvas-soft} (#f6f9fc) background, lock icon in {colors.ink-mute}, optional image count badge in pill-tag-soft style
Contextual message: {colors.ink-mute} (#64748d), {typography.body-md}, centered above the CTA
Both the subscribe CTA and the logged-out auth CTA use button-primary-pill (#533afd, pill radius) — visually consistent, since both are the primary conversion action in their respective states
Locked card structure is otherwise identical to a free post card (avatar, username, timestamp, badge row) — only the content body area differs, so locking never disrupts the feed's visual rhythm
Minimum touch target for all interactive elements: 44×44px
All surfaces are mobile-first
---
## U8 — Investor: Follow a Creator
U8 — Investor: Follow a Creator
Story:
As an investor, I want to follow a creator for free to see their public content so that I can track their quality before committing to a paid subscription.
Scope note: This story owns the follow mechanic end-to-end — the action itself, what it does, and the دنبال‌شده‌ها management surface. The Follow button's presence and appearance within the creator profile header is defined in U6 Section 4; this story defines what happens when it's tapped.
⚠️ Forward dependency note: The خانه feed as a container is owned by Epic 7 (User Feed). U8 defines only that following is what populates it — feed composition, ordering, and pagination belong to Epic 7.
Acceptance Criteria:
1. What Following Is (and Isn't)
Happy Path:
Following is free and completely ungated — no referral code, no payment, no subscription, no capacity limit. Any registered investor can follow any Verified creator
Following a creator causes that creator's posts to appear in the investor's خانه feed
There is no limit on how many creators an investor can follow
What following explicitly does NOT do:
Does not grant access to premium content — that requires an active, referral-code-originated subscription (C5 Section 2). A follower sees premium posts as locked cards in their feed (U7 Section 2)
Does not notify the creator (Section 6)
Does not affect the creator's public profile in any visible way (Section 6)
Edge Cases:
Follow and subscription are related but distinct states — see Section 2 for how they interact
Follow state is per-account, not per-device — it syncs across any device the investor logs into
2. Follow ↔ Subscription Relationship
Subscription is treated as a strict superset of following. An investor who pays for a creator's premium content necessarily wants that creator's posts in their feed.
Happy Path:
Subscribing auto-follows. On successful subscription, if the investor is not already following that creator, the follow relationship is created automatically as part of the same transaction — no separate action required
While a subscription is active, the investor cannot unfollow that creator — the unfollow control is frozen everywhere it appears (profile header, post page mini-header, دنبال‌شده‌ها list), with a tooltip explaining why
When the subscription expires, the follow relationship persists but becomes a normal, unfollowable follow — the control unfreezes automatically with no action needed from the investor
Rationale: without auto-follow, the fastest-converting investors — those who land via a shared link and subscribe immediately without following first — would pay for content and then see none of it in their feed, and reasonably conclude the product is broken. Freezing unfollow while subscribed prevents that same nonsensical state from being reached deliberately.
Edge Cases:
If the investor was already following before subscribing, nothing changes on subscribe except that the unfollow control freezes
Unfollowing does not cancel a subscription — but since unfollow is unavailable while subscribed, this combination cannot arise in Phase 0
Reactivating an expired subscription (U3) re-freezes the unfollow control; if the investor unfollowed during the expired window, reactivation re-applies the auto-follow
Auto-follow applies to new subscriptions, renewals, and reactivations alike
Phase 1+ consideration: allowing subscribers to unfollow (treating follow purely as a feed-delivery preference, useful for an investor subscribed to many creators who wants to mute one) was considered and deliberately deferred. Phase 0 prioritizes eliminating a confusing state over granting that flexibility.
Farsi copy:
Frozen unfollow tooltip: تا زمانی که اشتراک این کانال فعال است، امکان لغو دنبال‌کردن وجود ندارد.
3. Following — Entry Points & Behaviour
Happy Path:
Follow/Unfollow is available from:
The creator profile header on the public channel page (U6 Section 4)
The creator mini profile header on a standalone post page (C4b Section 2)
The دنبال‌شده‌ها list in داشبورد — unfollow only (Section 5)
Tapping دنبال کردن applies immediately with an optimistic UI update — the button switches to دنبال نکردن without waiting for server confirmation
The creator's subsequent posts begin appearing in the investor's خانه feed
Edge Cases:
Logged-out visitor tapping Follow → redirected to the unified auth entry flow with the current page preserved as the return destination (U1 Sections 5–6). A single ورود/ثبت‌نام CTA is shown. The follow action is not auto-applied on return — the investor lands back on the channel page with the Follow button in its normal untapped state and taps it deliberately. Silently performing an action the user initiated before authenticating is surprising; the redirect exists to enable the action, not to complete it on their behalf
If the creator is suspended after being followed, their posts disappear from the investor's feed (full blackout per A2) but the follow relationship is preserved — if the creator is reinstated, their posts reappear without the investor needing to re-follow
Error States:
If the follow action fails server-side after the optimistic update, the button reverts to its previous state and a brief error toast is shown
Network unavailable: same revert-and-notify behaviour
Farsi copy:
Follow CTA: دنبال کردن
Unfollow CTA: دنبال نکردن
Follow failure toast: عملیات ناموفق بود. دوباره تلاش کنید.
4. Unfollowing from a Channel or Post Page
Happy Path:
Tapping دنبال نکردن from the profile header or post page mini-header unfollows immediately, with no confirmation dialog
The creator's posts stop appearing in the investor's خانه feed
The button reverts to دنبال کردن — re-following is a single tap away
Edge Cases:
No confirmation is required here because the creator's identity is directly visible on screen, making an accidental unfollow immediately obvious and trivially reversible. This deliberately differs from the list-based unfollow in Section 5
If the investor has an active subscription, the unfollow control is frozen here per Section 2 — tapping it shows the explanatory tooltip and takes no action
Unfollowing does not delete any history — transaction records (U4) and subscription records (U2/U3) are unaffected
5. دنبال‌شده‌ها — Followed Creators List
Happy Path:
A third sub-section is added to the داشبورد tab, alongside اشتراک‌ها and تراکنش‌ها:
داشبورد
├── اشتراک‌ها
├── تراکنش‌ها
└── دنبال‌شده‌ها
Displays a simple list of every creator the investor currently follows
Each row shows: creator avatar, username, verified badge, and an inline unfollow action
Tapping a row (anywhere except the unfollow action) navigates to that creator's channel page
Sorted by most recently followed first — no sorting controls, no search, no filters. Deliberately minimal for Phase 0
Unfollowing from the list — with confirmation:
Tapping the unfollow action opens a confirmation dialog naming the specific creator
On confirm: creator unfollowed, row removed, posts stop appearing in خانه
On cancel: dialog closes, nothing changes
Confirmation is required only here — a list of avatars makes mistaps easy and less immediately noticeable than on a channel page, so the friction is placed where the actual risk is
Edge Cases:
If the investor follows no one, an empty state is shown with a CTA to the خانه tab
If a followed creator is suspended, their row is visually dimmed and non-navigable (tapping the row body does nothing, since the channel is unavailable) — but the unfollow action remains fully functional, with the same confirmation dialog. A creator being suspended is a plausible moment for an investor to want to clean up their list, so the action must stay available
If the investor has an active subscription to a listed creator, the unfollow action on that row is frozen per Section 2, with the explanatory tooltip
The list has no pagination in Phase 0 — with 5–10 creators platform-wide, the maximum possible list length is trivially short
Error States:
If the list fails to load, an error message is shown with a retry option
If the unfollow fails, the row remains in the list and an error toast is shown
Farsi copy:
Sub-section label: دنبال‌شده‌ها
Empty state message: هنوز کریتوری را دنبال نکرده‌اید.
Empty state CTA: رفتن به خانه
Suspended creator note: کانال این کریتور موقتاً در دسترس نیست.
Unfollow action tooltip: دنبال نکردن
Confirmation dialog heading: دنبال نکردن {username}
Confirmation dialog body: با این کار، پست‌های این کریتور دیگر در خانه شما نمایش داده نمی‌شود. آیا مطمئن هستید؟
Confirm CTA: بله، دنبال نکن
Cancel CTA: انصراف
List load error: خطا در بارگذاری لیست. دوباره تلاش کنید.
Unfollow failure toast: عملیات ناموفق بود. دوباره تلاش کنید.
6. Follower Visibility — Deliberate Omissions
Two decisions here are intentional and should not be mistaken for oversights:
No follow notification to the creator.
Creators receive no notification when someone follows them. Notifications are reserved for events that carry real signal — chiefly paid subscriptions
Rationale: a founding creator driving their existing Telegram or Instagram audience onto the platform could receive dozens of follow events in a single day. That is noise, and it would train creators to ignore notifications entirely — devaluing the subscription notifications that actually matter
The creator's own follower count is available privately on their dashboard (C9), which serves the same informational need without the interruption
No public follower count on the creator profile.
The follower count is not displayed to investors anywhere — not on the profile header (U6), not on post cards, not in search results
Rationale: the platform's entire positioning is credibility earned through verified performance, not follower counts — performance proof over social proof. Displaying a follower count would partially reimport the vanity metric the product is built to replace
This matters acutely in Phase 0: every founding creator would display a number close to zero, which reads as "nobody trusts this person" when the actual situation is "the platform launched last week." The absence of the metric is more honest than the presence of a misleading one
Revisit in Phase 1+, once counts are meaningful and the reputation layer exists to contextualize them
7. UI / UX
Layout is RTL throughout; Yekan Bakh is the typeface for all Farsi text, per the Stripi-inspired design system
Follow button uses button-secondary style (outline, {colors.primary} text) so the paid Subscribe action remains visually dominant — consistent with U6 Section 7
Followed state (دنبال نکردن) uses the same button-secondary geometry with {colors.ink-mute} text, signalling an already-completed action rather than a call to action
Frozen unfollow control (active subscriber) uses opacity: 0.4 with cursor: not-allowed, consistent with the frozen-control pattern established for the FAB in C4 and the edit icon in C4 Section 10 — visible but non-interactive, with an explanatory tooltip on tap
دنبال‌شده‌ها list rows use card-feature-light style — {colors.canvas} background, {colors.hairline} border, {rounded.lg} radius, Level 1 shadow
Creator avatar in list rows rendered circular, falling back to the default initials placeholder on {colors.primary} where no avatar was uploaded
Verified badge in list rows uses {colors.primary} (#533afd) with a checkmark icon
Inline unfollow action uses {colors.ink-mute} (#64748d) — deliberately understated, not a {colors.ruby} destructive treatment, since unfollowing is low-stakes and fully reversible
Suspended creator rows use opacity: 0.5 with a lock icon (consistent with U2 Section 7) — but the unfollow action within the row renders at full opacity, since it remains functional
Confirmation dialog uses the standard modal pattern; confirm CTA uses button-primary-pill
Minimum touch target for all interactive elements: 44×44px
All surfaces mobile-first; دنبال‌شده‌ها list stacks in a single column
---
## C6 — Creator Channel Sharing (External Promotion)
C6 — Creator Channel Sharing (External Promotion)
Story: As a creator, I want to share my channel link externally (Telegram, Instagram, X, etc.) so that I can drive my existing audience to the platform.
Note: This story defines the enhanced, creator-specific share behavior — a pre-filled, editable promotional caption combined with the channel link. It extends the same share icon already defined in C4 Section 12, which remains unchanged for non-creator viewers (investors, logged-out visitors get a plain link-only share with no caption). The icon is one control; its behavior branches by who is viewing. There is only one entry point for the enhanced flow — the کانال tab is the creator's own rendering of their channel page, not a separate screen.
Acceptance Criteria:
1. Access & Entry Point
Happy Path:
The enhanced share action is available to the creator (channel owner) via a dedicated share icon in the header of the creator's own کانال tab
Tapping/clicking the icon opens the enhanced share flow (Sections 2–3)
Only Verified creators can access this enhanced flow
Edge Cases:
If the creator's account is Pending Verification, the share icon is frozen (opacity: 0.4) — tapping shows a contextual blocking message, consistent with the FAB pattern in C4 Section 1
If the creator's account is Suspended, the share icon is also frozen with a different contextual message
For any user other than the channel owner (investors, logged-out visitors) viewing the same channel page, tapping the share icon triggers the simple share behavior already defined in C4 Section 12 — unchanged, no caption
Error States:
Pending verification: blocking message shown on tap
Suspended: blocking message shown on tap
Farsi copy:
Share icon tooltip (creator, own channel): اشتراک‌گذاری کانال
Pending verification blocking message: برای اشتراک‌گذاری کانال، ابتدا باید احراز هویت شما تأیید شود.
Suspended blocking message: حساب شما تعلیق شده است. امکان اشتراک‌گذاری کانال وجود ندارد.
2. Caption Composition
Happy Path:
On first use, a default suggested caption is pre-filled: من را در لومینا دنبال کن 👇
The caption is fully editable — the creator can rewrite it entirely or adjust the default
Maximum caption length: 150 characters — a live counter is shown
On subsequent uses, the field is pre-filled with the creator's last-used caption (not the default) — the system remembers their most recent edit
The channel link (lumina.ir/@{username}) is appended automatically below the caption when shared — the creator does not type or edit the link itself
Edge Cases:
If the creator clears the caption field entirely (empty string), sharing proceeds with link only — this is a valid state, not an error
If saving the "last-used caption" fails due to a network error, this fails silently — it does not block the share action itself; the next attempt simply falls back to the default suggestion
The default suggested caption is a fixed, hardcoded string in Phase 0 — not admin-configurable (flagged as a potential Phase 1 enhancement)
Error States:
Input stops accepting new characters at 150 — counter turning {colors.ruby} (#ea2261) communicates the limit
Farsi copy:
Default suggested caption: من را در لومینا دنبال کن 👇
Caption field label: پیام اشتراک‌گذاری کانال
Character counter: {n}/۱۵۰
Counter at limit: به حداکثر تعداد کاراکتر رسیدید.
3. Sharing Mechanics — Mobile
Happy Path:
Tapping the share icon opens a bottom sheet containing:
The editable caption field (Section 2)
A primary CTA: اشتراک‌گذاری — closes the bottom sheet immediately, then invokes the native OS share sheet, passing the caption and link combined as the shared text (caption on one line, link below it)
A secondary action: کپی لینک — copies the bare channel link only (bypassing the caption), shows a confirmation toast, and closes the bottom sheet
Tapping the dimmed overlay behind the bottom sheet dismisses it without action — consistent with other dismissible overlays in the product (e.g., the FAB mini-menu in C4)
Edge Cases:
The native OS share sheet shows whichever apps are installed on the creator's device — the platform does not construct or call any specific third-party URL directly, consistent with the approach in C4/C4b
If the creator dismisses the native share sheet without selecting an app, no caption is saved as "last-used" — only a confirmed share (an app was actually selected) updates the remembered caption
Tapping کپی لینک does not update the "last-used caption" — since no caption was actually used in that action
Error States:
None specific to this mechanism — native share sheet failures are handled at the OS level, outside the platform's control
Farsi copy:
Bottom sheet heading: اشتراک‌گذاری کانال
Primary CTA: اشتراک‌گذاری
Secondary CTA: کپی لینک
Copy link confirmation toast: لینک کانال کپی شد.
4. Sharing Mechanics — Desktop
Happy Path:
Clicking the share icon opens a popover containing:
The editable caption field (Section 2)
A primary CTA: کپی همه — copies the caption and link together as a single combined text block, shows a confirmation toast, and closes the popover
A secondary CTA: کپی لینک — copies the bare channel link only, shows a confirmation toast, and closes the popover
Clicking outside the popover closes it without action
Edge Cases:
Only a successful کپی همه action updates the "last-used caption" for next time — کپی لینک does not, consistent with the mobile behavior in Section 3
Error States:
If the clipboard write fails (rare browser permission issue), an inline error is shown with a retry option — the popover remains open in this case so the creator can retry
Farsi copy:
Popover heading: اشتراک‌گذاری کانال
Primary CTA: کپی همه
Secondary CTA: کپی لینک
Copy all confirmation toast: متن و لینک کپی شد.
Copy link confirmation toast: لینک کانال کپی شد.
Clipboard error: کپی ناموفق بود. دوباره تلاش کنید.
5. UI / UX
Layout is RTL throughout; Yekan Bakh is the typeface for all Farsi text, per the Stripi-inspired design system
Mobile bottom sheet uses {colors.canvas} (#ffffff) background, {rounded.xl} radius on top corners, Level 2 shadow, with a dimmed scrim overlay behind it
Desktop popover uses card-feature-light style with Level 2 shadow, {rounded.md} radius
Caption input field uses standard text-input style — {colors.hairline-input} border, focus state swaps to {colors.primary}
Character counter uses {colors.ink-mute} (#64748d), switches to {colors.ruby} (#ea2261) at 0 remaining
Primary CTA (اشتراک‌گذاری / کپی همه) uses button-primary-pill style (#533afd, pill radius)
Secondary CTA (کپی لینک) uses button-secondary style — outline, {colors.primary} text
Frozen share icon (Pending/Suspended states) uses opacity: 0.4, consistent with the FAB pattern in C4
Minimum touch target for all interactive elements: 44×44px
Mobile bottom sheet and desktop popover are both compact, single-purpose, no unnecessary scrolling