Sobre el proyecto

Nucleus Cards es un MVP de seguimiento de mercado, gestión de cartera y análisis asistido para coleccionistas de tarjetas NBA de China continental y Hong Kong. El proyecto está construido con Next.js App Router, TypeScript, Supabase, Zod, Recharts, Vitest y Playwright, y puede ejecutarse completamente con datos demo deterministas sin necesidad de cuentas externas ni API Keys. La plataforma ya implementa la página de inicio del mercado (resumen del mercado, listas de subidas y bajadas, clases de novatos 2020-2026, puntos calientes generacionales de jugadores, riesgos y calidad de datos), búsqueda estandarizada de precios con filtros multidimensionales, y rutas públicas para los 30 equipos, jugadores y detalles de tarjetas. La página de detalles de tarjeta admite cambio entre CNY/HKD/USD, gráficos de 7D/30D/90D/1Y, muestras de transacciones, valores atípicos, evidencia de IA y etiquetas de riesgo. La herramienta de comparación de novatos entre clases compara por defecto las clases de 2023, 2024 y 2025, permite alternar entre 2020 y 2026 y muestra el ranking dentro de la misma clase y observaciones de valoración. La cartera local admite agregar, editar, eliminar, valorar, calcular pérdidas y ganancias no realizadas y la distribución generacional de jugadores; la privacidad está desactivada por defecto y los datos se guardan en el navegador actual. También hay colecciones públicas, alertas de transacciones/fichajes/generaciones, configuración de privacidad, inicio de sesión demo y un panel de administración con etiquetado por lotes. La capa de datos incluye migraciones PostgreSQL normalizadas, políticas RLS, datos semilla, plantillas CSV, interfaces de adaptadores y una implementación provisional de la API eBay Browse. El proveedor de IA determinista valida la salida estructurada mediante Zod y no inventa conclusiones aleatorias cuando no hay Key. El proyecto proporciona PWA Manifest y Service Worker, temas claro y oscuro, diseño responsivo para escritorio y móvil, foco de teclado, estados de carga/vacío/error, validación de entrada de API, endpoints con límite de frecuencia, protección de rutas de producción para administradores y diseño de interfaces de exportación/eliminación de cuentas. Todos los datos de mercado están claramente marcados como datos demo; no hay scraping de fuentes no autorizadas y los precios de venta publicados no se hacen pasar por transacciones reales. El inicio rápido requiere Node.js 22.13+ y pnpm 11+; ejecuta pnpm install, copia .env.example a .env.local y luego ejecuta pnpm dev. Por defecto NEXT_PUBLIC_DEMO_MODE=true, no es necesario registrar una cuenta; el panel de administración está en /admin y es directamente visible en modo demo. El proyecto es de código abierto bajo licencia MIT e incluye documentación sobre licencias de datos, API, arquitectura y análisis.