Skip to content

CLAUDE.md

Latest commit

 

History

History
63 lines (46 loc) · 2.3 KB

CLAUDE.md

File metadata and controls

63 lines (46 loc) · 2.3 KB

LoL Pool Optimizer

Commands

npm run dev            # Next.js dev server (Turbopack)
npm test               # Jest test suite
npm run build          # Production build
npm run lint           # ESLint
npm run generate-data  # Regenerate matchup data from U.GG

Project

Champion pool optimizer — selecteer je role en champions, krijg een matchup matrix met winrates, coverage gaps en suggesties.

Stack

  • Framework: Next.js 16 (App Router, Turbopack)
  • Language: TypeScript (strict mode)
  • Styling: Tailwind CSS 4
  • Testing: Jest 30 + ts-jest + React Testing Library
  • Data: Statische JSON (U.GG Platinum+ World), DDragon CDN
  • Deployment: Vercel

Architecture

app/page.tsx              → Landing: role selectie + champion picker
app/pool/page.tsx         → Matrix view + quick pick + gaps + suggesties
app/api/matchups/[role]   → Serveert data/matchups/{role}.json
app/api/champions/[role]  → Serveert champions[] uit matchup JSON
app/api/champions         → DDragon champion proxy (24h cache)
lib/matchup-engine.ts     → Pure functions: findGaps, suggestChampions, rankPoolVsEnemy
lib/ddragon.ts            → DDragon fetch + MonkeyKing mapping
lib/constants.ts          → Gedeelde constanten (GAP_THRESHOLD)
data/matchups/*.json      → Statische matchup data per role
scripts/generate-matchup-data.ts → U.GG data scraper

Key Patterns

  • Bi-directionele matchup lookups: findMatchup() in matchup-engine.ts zoekt directe EN omgekeerde entries (A vs B = 42% → B vs A ≈ 58%)
  • DDragon ID mapping: OP.GG/U.GG gebruiken display namen, intern altijd DDragon IDs (PascalCase). MonkeyKing → Wukong mapping in ddragon.ts
  • Sparse data aware: UI toont alleen opponents waarvoor matchup data bestaat, geen lege cellen
  • Path alias: @/* → project root (tsconfig.json)

Testing

  • Unit tests in __tests__/ — mock next/server + fs voor route tests
  • Acceptance tests in __tests__/acceptance/ — source file analysis + contract verification
  • jest.config.ts met jsdom environment en @/ path alias

Project Context

Dashboard bestanden in .project/:

  • project.json — stack, features, endpoints
  • project-context.json — structure, routing, patterns, architecture, learnings

User Preferences

  • Language: Nederlands