इस प्रोजेक्ट के बारे में

Nucleus Cards चीन की मुख्य भूमि और हांगकांग के NBA स्टार कार्ड संग्राहकों के लिए बाज़ार निगरानी, होल्डिंग प्रबंधन और सहायक विश्लेषण MVP है। यह प्रोजेक्ट Next.js App Router, TypeScript, Supabase, Zod, Recharts, Vitest और Playwright पर आधारित है, और बिना किसी बाहरी खाते या API Key के भी निर्धारक डेमो डेटा के साथ पूर्ण रूप से चल सकता है। प्लेटफ़ॉर्म में बाज़ार होमपेज (बाज़ार अवलोकन, उतार-चढ़ाव सूची, 2020—2026 रूकी क्लास, खिलाड़ी पीढ़ी हॉटस्पॉट, जोखिम और डेटा गुणवत्ता), मानकीकृत बाज़ार खोज और बहु-आयामी फ़िल्टरिंग, 30 टीमों, खिलाड़ियों और कार्ड विवरण जैसे सार्वजनिक रूट लागू किए गए हैं। कार्ड विवरण पृष्ठ CNY/HKD/USD स्विचिंग, 7D/30D/90D/1Y चार्ट, लेन-देन नमूने, आउटलायर, AI साक्ष्य और जोखिम लेबल का समर्थन करता है। क्रॉस-क्लास रूकी टूल डिफ़ॉल्ट रूप से 2023, 2024, 2025 क्लास की तुलना करता है, 2020—2026 के बीच स्विच किया जा सकता है और समान क्लास रैंकिंग तथा मूल्यांकन अवलोकन दिखाता है। स्थानीय होल्डिंग में जोड़ना, संपादन, हटाना, मूल्यांकन, अप्राप्त लाभ-हानि और खिलाड़ी पीढ़ी वितरण समर्थित है, गोपनीयता डिफ़ॉल्ट रूप से बंद है, डेटा वर्तमान ब्राउज़र में सहेजा जाता है। इसके अलावा सार्वजनिक संग्रह, ट्रेड/साइनिंग/पीढ़ी अलर्ट, गोपनीयता सेटिंग्स, डेमो लॉगिन और बैच टैगिंग का समर्थन करने वाला प्रबंधन बैकएंड भी है। डेटा परत में सामान्यीकृत PostgreSQL माइग्रेशन, RLS नीतियाँ, सीड डेटा, CSV टेम्पलेट, एडाप्टर इंटरफ़ेस और eBay Browse API प्लेसहोल्डर कार्यान्वयन शामिल हैं। निर्धारक AI Provider Zod सत्यापन के माध्यम से संरचित आउटपुट की पुष्टि करता है, Key न होने पर यादृच्छिक निष्कर्ष नहीं बनाता। प्रोजेक्ट PWA Manifest और Service Worker, डार्क/लाइट थीम, डेस्कटॉप/मोबाइल रिस्पॉन्सिव लेआउट, कीबोर्ड फोकस, लोडिंग/खाली/त्रुटि स्थिति, साथ ही API इनपुट सत्यापन, रेट लिमिट इंटरफ़ेस, एडमिन प्रोडक्शन रूट सुरक्षा, खाता निर्यात/हटाने का इंटरफ़ेस डिज़ाइन प्रदान करता है। सभी बाज़ार डेटा स्पष्ट रूप से डेमो डेटा के रूप में चिह्नित हैं, अनधिकृत स्रोतों से कोई क्रॉलर नहीं है, और बिक्री मूल्य को वास्तविक लेन-देन के रूप में पेश नहीं किया जाता। त्वरित शुरुआत के लिए Node.js 22.13+ और pnpm 11+ आवश्यक है, pnpm install चलाएँ, .env.example को .env.local में कॉपी करें, फिर pnpm dev चलाएँ। डिफ़ॉल्ट NEXT_PUBLIC_DEMO_MODE=true है, खाता पंजीकरण की आवश्यकता नहीं है; प्रबंधन बैकएंड /admin पर है, डेमो मोड में सीधे दिखाई देता है। प्रोजेक्ट MIT License के तहत ओपन सोर्स है, और डेटा लाइसेंसिंग, API, आर्किटेक्चर, विश्लेषण आदि दस्तावेज़ शामिल हैं।