프로젝트 소개

Nucleus Cards는 중국 본토와 홍콩의 NBA 스타 카드 수집가를 위한 시세 모니터링, 포트폴리오 관리 및 보조 분석 MVP입니다. 이 프로젝트는 Next.js App Router, TypeScript, Supabase, Zod, Recharts, Vitest 및 Playwright를 기반으로 구축되었으며, 외부 계정이나 API 키 없이도 결정론적 데모 데이터로 완전히 실행할 수 있습니다. 플랫폼은 시장 홈페이지(시장 개요, 상승/하락 순위, 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 검증을 통해 구조화된 출력을 제공하며, 키가 없을 때 무작위로 결론을 조작하지 않습니다. 프로젝트는 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, 아키텍처, 분석 등의 문서가 포함되어 있습니다.