عن المشروع

Nucleus Cards هو نموذج أولي MVP لمراقبة الأسعار وإدارة المحافظ والتحليل المساعد، موجه لمجمعي بطاقات NBA في الصين القارية وهونغ كونغ. تم بناء المشروع باستخدام Next.js App Router وTypeScript وSupabase وZod وRecharts وVitest وPlaywright، ويمكن تشغيله بالكامل باستخدام بيانات توضيحية حتمية دون الحاجة إلى حساب خارجي أو مفتاح API. تم تنفيذ الصفحة الرئيسية للسوق (نظرة عامة على السوق، قائمة الصعود والهبوط، مواسم اللاعبين الجدد 2020-2026، نقاط الاهتمام عبر الأجيال، المخاطر وجودة البيانات)، والبحث الموحد عن الأسعار مع التصفية متعددة الأبعاد، والمسارات العامة لتفاصيل الفرق الثلاثين واللاعبين والبطاقات. تدعم تفاصيل البطاقة التبديل بين CNY/HKD/USD، والرسوم البيانية لمدة 7D/30D/90D/1Y، وعينات الصفقات، والقيم الشاذة، والأدلة من الذكاء الاصطناعي، وعلامات المخاطر. تقارن أداة اللاعبين الجدد عبر المواسم افتراضيًا بين مواسم 2023 و2024 و2025، مع إمكانية التبديل بين 2020-2026 وعرض التصنيف داخل الموسم وملاحظات التقييم. تدعم المحفظة المحلية الإضافة والتحرير والحذف والتقييم والأرباح/الخسائر غير المحققة وتوزيع اللاعبين عبر الأجيال، مع إعدادات خصوصية مغلقة افتراضيًا، ويتم تخزين البيانات في المتصفح الحالي. تتضمن الميزات أيضًا المجموعات العامة، والتنبيهات (الصفقات/التوقيعات/الأجيال)، وإعدادات الخصوصية، وتسجيل الدخول التجريبي، ولوحة إدارة تدعم وضع العلامات الجماعية. تحتوي طبقة البيانات على ترحيل PostgreSQL طبيعي، وسياسات RLS، وبيانات بذور، وقوالب CSV، وواجهات محول، وتنفيذ وهمي لواجهة eBay Browse API. يوفر مزود الذكاء الاصطناعي الحتمي مخرجات منظمة عبر التحقق من Zod، ولا يختلق استنتاجات عشوائية عند عدم وجود مفتاح. يوفر المشروع بيان PWA وعامل الخدمة، وسمات الألوان الفاتحة/الداكنة، وتخطيطًا متجاوبًا للحواسيب/الأجهزة المحمولة، وتركيز لوحة المفاتيح، وحالات التحميل/الفارغة/الخطأ، بالإضافة إلى التحقق من صحة مدخلات API، وواجهات تحديد المعدل، وحماية مسار الإنتاج للمسؤولين، وتصميم واجهات تصدير/حذف الحسابات. جميع بيانات السوق محددة بوضوح كبيانات توضيحية، ولا توجد زواحف للمصادر غير المصرح بها، ولا يتم تمرير أسعار البيع المدرجة على أنها صفقات حقيقية. يتطلب التشغيل السريع Node.js 22.13+ وpnpm 11+، وتنفيذ pnpm install، ونسخ .env.example إلى .env.local، ثم تشغيل pnpm dev. الإعداد الافتراضي NEXT_PUBLIC_DEMO_MODE=true، ولا حاجة لتسجيل حساب؛ لوحة الإدارة في /admin، ويمكن رؤيتها مباشرة في وضع العرض التوضيحي. المشروع مرخص بموجب MIT License، ويحتوي على وثائق حول ترخيص البيانات وAPI والهندسة والتحليل.