منصوبے کے بارے میں

ECK (Ethereum Collective Korea) ایک غیر منافع بخش ٹیم ہے جو کورین ایتھریم ایکو سسٹم کے لیے عوامی اشیاء (public goods) بناتی ہے، اور یہ ریپوزٹوری ان کی آفیشل ویب سائٹ اور ریسرچ، نیوز اور ایونٹ حب ہے۔ 'The Ticker is ETH' اس ٹیم کی جانب سے چلائی جانے والی ٹیلی گرام چینل کی ایک پہل ہے۔ تکنیکی ڈھانچے میں React 19 + TypeScript + Vite, Tailwind CSS 3 + Framer Motion, Three.js/React Three Fiber (3D), React Router DOM 7، اور react-i18next (کورین/انگریزی تبدیلی) شامل ہیں۔ تصدیق کے لیے Privy (والٹ، گوگل، ٹویٹر لاگ ان اور ایمبیڈڈ والٹ) اور آن چین فنکشنز کے لیے thirdweb (ERC-1155 بیجز، Base اور Ethereum ملٹی چین) کا استعمال کیا گیا ہے۔ ٹیسٹنگ کے لیے Vitest + Testing Library، ان پٹ کی صفائی کے لیے DOMPurify (XSS سے بچاؤ)، نوٹیفیکیشنز کے لیے Sonner ٹوسٹ، اور تھیمز کے لیے CSS ویری ایبلز اور Tailwind dark: کلاسز کے ذریعے ڈارک/لائٹ موڈ فراہم کیا گیا ہے۔ اہم اسکرینز اور خصوصیات میں ممبر اوتار اینیمیشنز کے ساتھ Hero سیکشن، Core Team اور Contributors کے پروفائلز (سوشل لنکس، کنٹری بیوشن ہیٹ میپ، شماریاتی بینرز)، ایک ریسرچ بلاگ (پاس فریز تصدیق، ٹیلی گرام کیٹیگریز، ڈائنامک لوڈنگ اور Load More پیجینیشن، مصنف فلٹر اور ڈی باؤنسنگ سرچ)، RSS پر مبنی نیوز پیج (ایتھریم ہفتہ وار ریسرچ رپورٹ)، ایونٹس پیج، پروفائل پیج، 404 پیج اور ErrorBoundary شامل ہیں۔ ڈیسک ٹاپ پر ایتھریم ڈائمنڈ کسٹم کرسر اور ٹریل ایفیکٹ لاگو ہے، ساتھ ہی آن چین کنٹری بیوٹر بیج کلیم/منٹ فلو، کامیابی یا ناکامی کے ٹوسٹ فیڈ بیک، اور ریسرچ/نیوز تفصیلی صفحات پر سوشل شیئر بٹنز موجود ہیں۔ رسائی (accessibility) کے حوالے سے i18n اسکیپ نیویگیشن، فوکس ٹریپ، لیبل کنکشن اور aria-live کا ذکر کیا گیا ہے۔ روٹ پر مبنی کوڈ اسپلٹنگ (React.lazy + Suspense) کا استعمال کیا گیا ہے۔ ڈیٹا سنکرونائزیشن کے لیے GitHub Actions cron روزانہ KST 09:00 بجے ٹیلی گرام چینل کا ڈیٹا اکٹھا اور پراسیس کرتا ہے تاکہ انفرادی article .md فائلیں بنائی جا سکیں، اور پھر RSS نیوز فیڈز اکٹھا کر کے کمٹ کرتا ہے۔ اسے Actions ٹیب سے دستی طور پر بھی چلایا جا سکتا ہے، جس کے لیے TELEGRAM_API_ID, TELEGRAM_API_HASH اور TELEGRAM_SESSION سیکریٹس کی ضرورت ہوتی ہے۔ ٹیلی گرام چینل کے پیغامات کی بنیاد پر کنٹری بیوشن کا تجزیہ کیا جاتا ہے۔ ترقی کے طریقے میں npm install کے بعد .env.example کو .env.local میں کاپی کرنا، VITE_PRIVY_APP_ID سیٹ کرنا اور npm run dev کے ذریعے چلانا شامل ہے۔ یہ dev, build, preview, test, test:run, test:coverage, lint, analyze (بنڈل سائز تجزیہ), fetch:telegram, preprocess:telegram, اور fetch:news اسکرپٹس فراہم کرتا ہے۔ Vercel کے ذریعے main برانچ پر push کرنے پر خودکار طور پر تعینات (deploy) ہو جاتا ہے۔ انوائرمنٹ ویری ایبلز میں Privy ایپ ID، thirdweb کلائنٹ ID، اور Base اور Ethereum کے ERC-1155 بیج کنٹریکٹ ایڈریس استعمال ہوتے ہیں۔ موجودہ TODO میں چار قسم کے بیجز (Core Contributor, Translator, Event Attendee, Research Author) کے امیج ڈیزائن، Ethereum Mainnet ERC-1155 کنٹریکٹ کی تعیناتی، بیج کنٹریکٹ ایڈریس کے انوائرمنٹ ویری ایبلز کی علیحدگی، اور Vercel انوائرمنٹ ویری ایبلز کی سنکرونائزیشن باقی ہے۔ لائسنس MIT ہے اور CONTRIBUTING.md کے ساتھ بگ رپورٹ اور فیچر تجویز کے ایشو ٹیمپلیٹس فراہم کیے گئے ہیں۔