81 KiB
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:
- 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: حساب شما تعلیق شده است. امکان انتشار پست وجود ندارد.
- 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:
- 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: این کانال در حال حاضر در دسترس نیست.
- 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): پریمیوم
- 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
- 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:
- 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 (رایگان / پریمیوم).
- 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:
- 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
- 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: تأییدشده
- 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:
- 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:
- 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
- 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: تا زمانی که اشتراک این کانال فعال است، امکان لغو دنبالکردن وجود ندارد.
- 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: عملیات ناموفق بود. دوباره تلاش کنید.
- 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
- دنبالشدهها — 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:
- 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: حساب شما تعلیق شده است. امکان اشتراکگذاری کانال وجود ندارد.
- 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: به حداکثر تعداد کاراکتر رسیدید.
- 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: لینک کانال کپی شد.
- 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: کپی ناموفق بود. دوباره تلاش کنید.
- 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