How heykelh/pokewatch works
PokéWatch is a Pokémon TCG market-surveillance product: its daily workflow collects official price and card-reference data, applies deterministic anomaly rules, and presents documented signals as investigation candidates rather than verdicts. The dashboard also exposes market summaries, pipeline health, methodology, investigations, and a 30th-anniversary card study. README-described SQL and reporting subsystems are represented where the tree supports them; the SQL implementation itself is not present in the supplied tree, so its source path is unknown.
Main entry points: pokewatch.ts Dashboard data access · generate_report.py Daily report builder · ingest_priceguide.py Price ingestion · ingest_tcgdex.py Catalog ingestion
Components 21
Collection and reference data
- Price ingestion
scripts/ingest_priceguide.py - Catalog ingestion
scripts/ingest_tcgdex.py
Detection and investigation
- Deterministic rules
- Targeted investigation
scripts/ebay_investigate.py - Daily report builder
scripts/generate_report.py
Shared data services
- Supabase market data
- Market anomalies
Dashboard and reporting
- Dashboard data access
web/src/lib/pokewatch.ts - Market dashboard
web/src/app/(dashboard)/page.tsx - Anomaly view
web/src/app/(dashboard)/anomalies/page.tsx - Case investigations
web/src/app/(dashboard)/investigations/page.tsx - Methodology and limits
web/src/app/(dashboard)/methodologie/page.tsx - 30th anniversary study
web/src/app/(dashboard)/30-ans/page.tsx - Market verdict
web/src/components/chart-blocks/charts/pokewatch-verdict/index.tsx - Market scan
web/src/components/chart-blocks/charts/pokewatch-market/index.tsx - Pipeline health
web/src/components/chart-blocks/charts/pokewatch-pipeline/index.tsx
Other components
- Dashboard visitor
- Cardmarket guide
- TCGdex API
- eBay Browse API
- Groq LLM
Connections 22
- Cardmarket guide → Price ingestion: supplies prices
- Price ingestion → Supabase market data: ingests snapshots
- TCGdex API → Catalog ingestion: supplies catalog
- Catalog ingestion → Supabase market data: ingests references
- Supabase market data → Deterministic rules: provides history
- Deterministic rules → Market anomalies: stores signals
- Supabase market data → Targeted investigation: provides evidence
- Targeted investigation → eBay Browse API: queries listings
- Supabase market data → Daily report builder: provides metrics
- Daily report builder → Groq LLM: requests prose
- Daily report builder → Supabase market data: stores report
- Dashboard visitor → Market dashboard: views
- Market dashboard → Dashboard data access: requests metrics
- Anomaly view → Dashboard data access: requests signals
- Case investigations → Dashboard data access: reads market data
- 30th anniversary study → Dashboard data access: requests card data
- Market verdict → Dashboard data access: fetches verdict
- Market scan → Dashboard data access: fetches market
- Pipeline health → Dashboard data access: fetches health
- Dashboard data access → Supabase market data: reads dashboard data
- Dashboard data access → Market anomalies: reads signals
- Methodology and limits → Dashboard visitor: explains limits