প্রকল্প সম্পর্কে

Nucleus Cards একটি MVP (ন্যূনতম কার্যকরী পণ্য) যা চীন ও হংকংয়ের NBA কার্ড সংগ্রাহকদের জন্য বাজার পর্যবেক্ষণ, পোর্টফোলিও ব্যবস্থাপনা এবং সহায়ক বিশ্লেষণ সরবরাহ করে। প্রকল্পটি Next.js App Router, TypeScript, Supabase, Zod, Recharts, Vitest ও Playwright প্রযুক্তি ব্যবহার করে নির্মিত। এটি বাইরের কোনো অ্যাকাউন্ট বা API কী ছাড়াই নির্ধারিত ডেমো ডেটা দিয়ে সম্পূর্ণরূপে চলে। প্ল্যাটফর্মে বাজার হোমপেজ (বাজার ওভারভিউ, লাভ-ক্ষতির তালিকা, ২০২০-২০২৬ রুকি ক্লাস, খেলোয়াড় জেনারেশন হটস্পট, ঝুঁকি ও ডেটা কোয়ালিটি), প্রমিত বাজার অনুসন্ধান ও বহুমাত্রিক ফিল্টারিং, ৩০টি দল ও খেলোয়াড় এবং কার্ডের বিস্তারিত তথ্যের জন্য পাবলিক রুট অন্তর্ভুক্ত রয়েছে। কার্ডের বিস্তারিত পৃষ্ঠায় CNY/HKD/USD মুদ্রা পরিবর্তন, ৭D/৩০D/৯০D/১Y চার্ট, ট্রেড নমুনা, অস্বাভাবিক মান, AI প্রমাণ ও ঝুঁকি ট্যাগ দেখা যায়। ক্রস-ক্লাস রুকি টুল ডিফল্টভাবে ২০২৩, ২০২৪ ও ২০২৫ ক্লাসের তুলনা করে, তবে ২০২০-২০২৬ পর্যন্ত পরিবর্তন করা যায় এবং একই ক্লাসের র্যাঙ্কিং ও মূল্যায়ন পর্যবেক্ষণ দেখায়। স্থানীয় পোর্টফোলিওতে কার্ড যোগ, সম্পাদনা, মুছে ফেলা, মূল্যায়ন, অবাস্তবায়িত লাভ-ক্ষতি ও খেলোয়াড় জেনারেশন ডিস্ট্রিবিউশন সমর্থিত। গোপনীয়তা ডিফল্টভাবে বন্ধ থাকে এবং ডেটা বর্তমান ব্রাউজারে সংরক্ষিত হয়। এছাড়াও পাবলিক কালেকশন, ট্রেড/সাইনিং/জেনারেশন অ্যালার্ট, গোপনীয়তা সেটিংস, ডেমো লগইন এবং ব্যাচ ট্যাগিং সমর্থিত অ্যাডমিন প্যানেল রয়েছে। ডেটা লেয়ারে নর্মালাইজড PostgreSQL মাইগ্রেশন, RLS পলিসি, সিড ডেটা, CSV টেমপ্লেট, অ্যাডাপ্টার ইন্টারফেস এবং eBay Browse API প্লেসহোল্ডার ইমপ্লিমেন্টেশন অন্তর্ভুক্ত। নির্ধারিত AI প্রোভাইডার Zod দিয়ে স্ট্রাকচার্ড আউটপুট যাচাই করে, কোনো কী ছাড়া এলোমেলো সিদ্ধান্ত নেয় না। প্রকল্পটিতে PWA ম্যানিফেস্ট ও সার্ভিস ওয়ার্কার, হালকা-গাঢ় থিম, ডেস্কটপ/মোবাইল রেসপন্সিভ লেআউট, কিবোর্ড ফোকাস, লোডিং/খালি/ভুল অবস্থা এবং API ইনপুট যাচাই, রেট লিমিটিং, অ্যাডমিন প্রোডাকশন রুট সুরক্ষা, অ্যাকাউন্ট এক্সপোর্ট/ডিলিট API ডিজাইন রয়েছে। সমস্ত বাজার ডেটা স্পষ্টভাবে ডেমো ডেটা হিসেবে চিহ্নিত, অননুমোদিত উৎস থেকে স্ক্র্যাপিং করা হয় না এবং বিক্রয়মূল্যকে প্রকৃত ট্রেড হিসেবে উপস্থাপন করা হয় না। দ্রুত শুরু করতে Node.js ২২.১৩+ ও pnpm ১১+ প্রয়োজন। pnpm install, .env.example কপি করে .env.local তৈরি করে pnpm dev চালালেই হয়। ডিফল্ট NEXT_PUBLIC_DEMO_MODE=true, তাই নিবন্ধন ছাড়াই ব্যবহার করা যায়; অ্যাডমিন প্যানেল /admin এ ডেমো মোডে সরাসরি দেখা যায়। প্রকল্পটি MIT লাইসেন্সে ওপেন সোর্স এবং ডেটা লাইসেন্স, API, আর্কিটেকচার ও বিশ্লেষণ ডকুমেন্টেশন সহ আসে।