مفاهیم دامنه

پرتو یک کتابخانه عمومی نیست. کامپوننت‌های آن دانش خاص دامنه سوشال لیسنینگ را کدگذاری می‌کنند. این صفحه این مفاهیم را توضیح می‌دهد.

دسته‌بندی اینفلوئنسرها

اینفلوئنسرها بر اساس تعداد دنبال‌کننده به پنج دسته تقسیم می‌شوند. کلید ستون اول همان مقداری است که در کد می‌نویسید (تایپ FollowerGroup):

هر دسته آستانه‌های نرخ تعامل مخصوص خودش را دارد — نرخ ۳٪ برای یک حساب نانو «متوسط» است و برای یک حساب مگا «عالی». آستانه‌ها در FOLLOWER_GROUP_RANGES تعریف شده‌اند و getFollowerGroup(followers) دسته را از تعداد دنبال‌کننده استخراج می‌کند.

این دسته‌بندی در کامپوننت‌هایی مانند ProfileCard، EngagementRate، و EngagementRateBar به کار می‌رود.

نمونه بصری

import { ProfileCard } from '@partodata/ui'
;<ProfileCard category="micro" followerCount={45000} username="@username" />

سطوح نرخ تعامل (Engagement Tiers)

نرخ تعامل (Engagement Rate) — نسبت تعاملات (لایک، کامنت، ذخیره) به دنبال‌کننده‌ها — به شش سطح رنگ‌کدشده تقسیم می‌شود:

نمونه بصری — نرخ تعامل

آستانه‌های متفاوت به دسته

هر دسته اینفلوئنسر آستانه‌های متفاوتی برای هر سطح دارد. نرخ تعامل ۳٪ برای یک مگا اینفلوئنسر «عالی» است، اما برای یک نانو اینفلوئنسر «متوسط».

import { EngagementRate } from '@partodata/ui'

// نرخ ۳٪ برای مگا → سطح "عالی"
<EngagementRate value={3.2} category="mega" />

// نرخ ۳٪ برای نانو → سطح "متوسط"
<EngagementRate value={3.2} category="nano" />

تحلیل احساسات (Sentiment Analysis)

محتوای شبکه‌های اجتماعی به سه نوع احساس تقسیم می‌شود:

نمونه بصری

import { SentimentBadge, SentimentDistribution } from '@partodata/ui'

// نشان احساس یک آیتم
<SentimentBadge sentiment="positive" />
<SentimentBadge sentiment="neutral" />
<SentimentBadge sentiment="negative" />

// توزیع احساسات (درصدی)
<SentimentDistribution
  positive={65}
  neutral={25}
  negative={10}
/>

پلتفرم‌های اجتماعی

پلتفرم‌های متعددی با رنگ‌های برند اختصاصی پشتیبانی می‌شوند. پرکاربردترین شبکه‌های اجتماعی:

علاوه بر این‌ها، پلتفرم‌های دیگری مانند فیس‌بوک و رسانه‌های پخش (تلویزیون، رادیو، مطبوعات) نیز توکن رنگ برند اختصاصی دارند.

نمونه بصری

import { SocialPlatformBadge } from '@partodata/ui'

<SocialPlatformBadge platform="instagram" />
<SocialPlatformBadge platform="telegram" />
<SocialPlatformBadge platform="youtube" />

کامپوننت PostCard

کامپوننت PostCard برای نمایش پست از تمام پلتفرم‌های سوشال‌لیسنینگ (اینستاگرام، توییتر، تلگرام، یوتیوب، تیک‌تاک، لینکدین، ترِدز) با ساختار یکپارچه استفاده می‌شود. بدنه پست بر اساس نوع محتوا (متن، تصویر، گالری، ویدیو) رندر می‌شود و همه نسبت‌های ابعادی (1:1، 4:5، 9:16، 16:9) با بک‌دراپ بلور خودکار letterbox می‌شن.

import { PostCard, type PostData } from '@partodata/ui'

const post: PostData = {
  id: 'p1',
  source: 'instagram',
  author: { name: 'علی محمدی', handle: 'ali.m' },
  timestamp: Date.now() - 60_000 * 23,
  body: { type: 'text', text: 'متن پست نمونه #دیجی‌کالا' },
  sentiment: 'positive',
  metrics: { views: 12500, likes: 820, comments: 42 },
}

;<PostCard post={post} view="comfortable" />

توکن‌های رنگی دامنه

توکن‌های CSS اختصاصی دامنه در globals.css تعریف شده‌اند و در هر دو تم کار می‌کنند:

/* سطوح تعامل */
--engagement-excellent
--engagement-very-good
--engagement-good
--engagement-average
--engagement-low
--engagement-poor

/* احساسات */
--sentiment-positive
--sentiment-neutral
--sentiment-negative

این توکن‌ها مانند سایر توکن‌های سیستم در تم‌های روشن و تاریک به درستی کار می‌کنند.