À propos du projet

Nucleus Cards est un MVP de suivi de marché, de gestion de portefeuille et d'analyse d'assistance destiné aux collectionneurs de cartes NBA de Chine continentale et de Hong Kong. Le projet est construit avec Next.js App Router, TypeScript, Supabase, Zod, Recharts, Vitest et Playwright, et peut fonctionner entièrement avec des données de démonstration déterministes en l'absence de comptes externes ou de clés API. La plateforme propose déjà une page d'accueil marché (aperçu du marché, classements des hausses et baisses, promotions de recrues 2020—2026, points chauds par génération de joueurs, risques et qualité des données), une recherche standardisée de cotations avec filtres multidimensionnels, ainsi que des routes publiques pour les 30 équipes, les joueurs et les détails des cartes. La page de détail d'une carte prend en charge le basculement CNY/HKD/USD, les graphiques 7D/30D/90D/1Y, les échantillons de transactions, les valeurs aberrantes, les preuves IA et les étiquettes de risque. L'outil de comparaison de recrues entre promotions compare par défaut les promotions 2023, 2024 et 2025, permet de basculer entre 2020 et 2026 et affiche le classement au sein de la même promotion ainsi que des observations de valorisation. Le portefeuille local prend en charge l'ajout, la modification, la suppression, la valorisation, les plus-values latentes et la répartition par génération de joueurs ; la confidentialité est désactivée par défaut et les données sont conservées dans le navigateur actuel. Il existe également des collections publiques, des alertes transactions/signatures/générations, des paramètres de confidentialité, une connexion de démonstration, ainsi qu'un back-office d'administration prenant en charge l'étiquetage par lots. La couche de données comprend des migrations PostgreSQL normalisées, des politiques RLS, des données de départ, des modèles CSV, des interfaces d'adaptateur et une implémentation de remplacement de l'API eBay Browse. Le fournisseur IA déterministe valide les sorties structurées via Zod et n'invente pas de conclusions aléatoires en l'absence de clé. Le projet fournit un manifeste PWA et un Service Worker, des thèmes clair et sombre, une mise en page responsive bureau/mobile, le focus clavier, des états de chargement/vide/erreur, ainsi que la validation des entrées API, des interfaces de limitation de débit, la protection des routes de production administrateur et la conception d'interfaces d'export/suppression de compte. Toutes les données de marché sont explicitement marquées comme données de démonstration ; aucune source non autorisée n'est crawler, et les prix affichés à la vente ne sont pas présentés comme des transactions réelles. Le démarrage rapide nécessite Node.js 22.13+ et pnpm 11+ ; il suffit d'exécuter pnpm install, de copier .env.example vers .env.local puis de lancer pnpm dev. Par défaut, NEXT_PUBLIC_DEMO_MODE=true, aucune inscription de compte n'est nécessaire ; le back-office d'administration est accessible à /admin et directement visible en mode démo. Le projet est open source sous licence MIT et est accompagné de documents sur l'autorisation des données, l'API, l'architecture et l'analyse.