عن المشروع

إن ECK (Ethereum Collective Korea) هو فريق غير ربحي يعمل على إنشاء سلع عامة للنظام البيئي لإيثيريوم في كوريا، وهذا المستودع هو الموقع الرسمي ومركز الأبحاث والأخبار والفعاليات الخاص بهم. 'The Ticker is ETH' هي مبادرة قناة Telegram التي يديرها هذا الفريق. تتكون البنية التقنية من React 19 + TypeScript + Vite، و Tailwind CSS 3 + Framer Motion، و Three.js/React Three Fiber (ثلاثي الأبعاد)، و React Router DOM 7، و react-i18next (للتبديل بين الكورية والإنجليزية). يتم استخدام Privy للمصادقة (تسجيل الدخول عبر المحفظة و Google و Twitter والمحافظ المدمجة)، بينما تُستخدم thirdweb للميزات الموجودة على الشبكة (شارات ERC-1155، ودعم متعدد السلاسل لـ Base و Ethereum). يتم الاختبار باستخدام Vitest + Testing Library، وتطهير المدخلات عبر DOMPurify (لمنع XSS)، والتنبيهات عبر Sonner toast، مع دعم الوضع الداكن/الفاتح باستخدام متغيرات CSS وفئات Tailwind dark:. تشمل الشاشات والميزات الرئيسية قسم Hero مع رسوم متحركة لأفاتار الأعضاء، وملفات تعريف Core Team و Contributors (روابط اجتماعية، خريطة حرارية للمساهمات، لافتات إحصائية)، ومدونة Research قابلة للكتابة والقراءة (مصادقة بكلمة مرور، فئات Telegram، تحميل ديناميكي مع تقسيم صفحات Load More، تصفية المؤلفين وبحث مع debouncing)، وصفحة News تعتمد على RSS (تقارير أبحاث إيثيريوم الأسبوعية)، وصفحة Events، وصفحة الملف الشخصي، وصفحة 404 و ErrorBoundary. في نسخة سطح المكتب، يتم تطبيق مؤشر مخصص على شكل ماسة إيثيريوم مع تأثير trail، وتدفقات المطالبة/صك شارات المساهمين على الشبكة مع تعليقات toast للنجاح أو الفشل، وأزرار مشاركة اجتماعية في صفحات تفاصيل Research/News. فيما يتعلق بإمكانية الوصول، يتم ذكر i18n skip navigation، و focus trap، وربط label، و aria-live. يتم استخدام تقسيم الكود بناءً على المسارات (React.lazy + Suspense). تتم مزامنة البيانات عبر GitHub Actions cron الذي يجمع بيانات قناة Telegram يومياً في الساعة 09:00 بتوقيت KST، ويعالجها لإنشاء ملفات article .md فردية، ثم يجمع خلاصات أخبار RSS ويقوم بعمل commit. يمكن التشغيل يدوياً من علامة تبويب Actions، ويتطلب ذلك أسرار TELEGRAM_API_ID و TELEGRAM_API_HASH و TELEGRAM_SESSION. يتم تحليل مستوى المساهمة بناءً على رسائل قناة Telegram. طريقة التطوير هي تشغيل 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. تُستخدم متغيرات البيئة لـ Privy app ID، و thirdweb client ID، وعناوين عقود شارات ERC-1155 لكل من Base و Ethereum. تتضمن قائمة TODO الحالية تصميم صور لـ 4 أنواع من الشارات (Core Contributor, Translator, Event Attendee, Research Author)، ونشر عقد ERC-1155 على Ethereum Mainnet، وفصل تطبيق عناوين عقود الشارات في متغيرات البيئة، ومزامنة متغيرات بيئة Vercel. الترخيص هو MIT، مع توفير CONTRIBUTING.md ونماذج قضايا للإبلاغ عن الأخطاء واقتراح الميزات.