nucleus-cards

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、アーキテクチャ、分析などのドキュメントが付属しています。