Design reference (mockup) + map updated: sport-agnostic entity, per-tier record, additions
- specs/design-reference/vyndr-system.html + support.js (global visual reference) - D1 override (sport-agnostic athlete-id ingestion), D3 override (book SVGs in-wave) - Addition 1 (ingestion-time id resolve+store), Addition 2 (record by grade tier), Addition 3 (mockup is global reference; live wordmark kept) - revised 6-wave sequence Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@@ -79,7 +79,24 @@ Legend: **✅ wire-able now** (data already in the system) · **🔧 sourceable
|
||||
|
||||
---
|
||||
|
||||
## DECISIONS FOR THE FOUNDER (my honest defaults in **bold**)
|
||||
## FOUNDER DECISIONS (LOCKED — 2026-07-13)
|
||||
- **Global visual reference:** `specs/design-reference/vyndr-system.html` (the Claude Design "Vyndr System" mockup, + `support.js`). Build EVERY surface toward it — layouts, the missing surfaces, color treatments, component designs. Mockup surfaces confirmed present: edge board, hero grade reveal, VYNDR intelligence panel, player identity block, archetype glyphs (**74 marks · 8 sports** — an expansion target), pitcher identity (arsenal/whiff/velo), correlation builder + parlay slip, live grade-shift (grade-by-game-clock, history·last-24), public record /u (CLV-verified, portrait 1080×1350 + OG 1200×630), fighter tale-of-the-tape (FIGHTER A/VERDICT/FIGHTER B, moneyline/KO/decision, style archetypes), pricing tier, empty/error 404-bar. **ONE exception: keep the CURRENT live-site VYNDR wordmark/name, NOT the mockup's.** Live wordmark wins; everything else references the mockup.
|
||||
- **D1 — OVERRIDE → sport-agnostic entity layer NOW.** Don't defer NBA/WNBA to monograms. Capture a stable athlete id per player **at ingestion for every league** (ESPN cross-sport athlete id is the likely single key covering NBA/WNBA/NFL/NHL/soccer; MLB keeps its MLBAM thread-through). ONE headshot resolver keyed by `(league, id)`. Monograms remain the honest fallback ONLY where an id genuinely can't resolve. If a league needs a new ingestion step for the id, build it. Report any league with NO free id source.
|
||||
- **D2 — default:** /u house-mode reading the `user_id=NULL` public aggregate.
|
||||
- **D3 — OVERRIDE → bundle the ~8 real book SVGs in the SAME wave (Wave 2).** Text wordmarks are only the stopgap; the SVGs are the real fix and are cheap.
|
||||
- **D4 — default:** Baseball Savant adapter for pitcher arsenal (free).
|
||||
- **D5 — default:** author the combat spec + ship the honest free v1 (ESPN-MMA + odds-api ML/round-totals; method/round/props flagged data-limited); defer the full matchup-grade engine to its own sub-wave; confirm before any scraping dep.
|
||||
|
||||
### ADDITION 1 — ASSET STORAGE (ingestion-time resolve)
|
||||
Resolve id→URL **once at ingestion**; store the id + resolved-or-404 status in our data so we don't re-check per render. Browser caches the actual image via CDN cache headers (no per-load re-fetch, no per-render re-resolve). Self-hosting/proxying images is a LATER optimization — not now.
|
||||
|
||||
### ADDITION 2 — RECORD BY GRADE TIER (non-negotiable, core not cosmetic)
|
||||
The record must be tracked + displayed **PER GRADE TIER** (A+ went X-Y, A X-Y, B X-Y, C X-Y — each its own hit-rate), everywhere the record shows (dashboard, /u, ledger). A single blended "67%" hides the proof: higher grade wins more often — the tier calibration IS the credibility. Sport/bet-type slices are a plus; per-tier is required. Extend `ledgerService.getModelAggregate` (and any schema/query it needs) to return per-tier buckets; render them on every record surface. `A+` stands alone; then A/B/C/D/F by first letter (mirror the existing `outcomeService` bucketing).
|
||||
|
||||
### ADDITION 3 — DESIGN FILE IS THE GLOBAL REFERENCE
|
||||
Weave in essentially everything from the mockup across all surfaces (see reference note above). Wordmark is the sole exception.
|
||||
|
||||
## ORIGINAL DECISION DEFAULTS (superseded where noted above)
|
||||
|
||||
- **D1 — NBA/WNBA headshots:** no real id source in the data today, and those sports don't settle yet. **Default: ship MLB headshots now; keep honest branded monograms for NBA/WNBA until an id source is added.** (Alt: invest in sourcing cdn.nba.com/ESPN ids now.)
|
||||
- **D2 — /u real record:** the CLV-verified profile can't show a house record as a *user* profile (house = `user_id=NULL`). **Default: add a "house/model" profile mode that reads the public `user_id=NULL` aggregate** (the partner-pitch weapon shows the real 55-19), keeping user profiles gated at n≥20. (Alt: claim+publish a house account and let it accrue 20 settled reads — slower, but no code path added.)
|
||||
@@ -89,11 +106,12 @@ Legend: **✅ wire-able now** (data already in the system) · **🔧 sourceable
|
||||
|
||||
---
|
||||
|
||||
## PROPOSED WAVE SEQUENCE (ship on green, per step)
|
||||
1. **Wave 1 — Step 1 trust bugs** (billing date + Wood nameKey collision + join-invariant test). Quick, independent.
|
||||
2. **Wave 2 — Step 2 entity layer** (MLB headshot thread-through on 3 surfaces + ledger wordmark import + books.js keys). **Eyeball gate: report when this lands so real logos/headshots can be verified before the rest builds on it.**
|
||||
3. **Wave 3 — Step 3 outlook mode** (never-empty grid) + Step 4 wire-able-now surfaces (grade-shift timeline, consensus strip, Parlay Lab page).
|
||||
4. **Wave 4 — Step 4 new feed** (pitcher arsenal via Savant) + /u house-profile mode (pending D2).
|
||||
5. **Wave 5 — Step 5 combat** (spec first, then free v1 pending D5).
|
||||
## WAVE SEQUENCE (ship on green, per step; toward the mockup)
|
||||
1. **Wave 1 — Step 1 trust bugs** (billing renewal date + Wood nameKey-collision + streaks join-invariant test) + the quick DeskShowcase "A $1M terminal" → on-voice deadpan copy fix. Quick, independent, no mockup dep.
|
||||
2. **Wave 2 — Step 2 entity layer, SPORT-AGNOSTIC (the eyeball gate).** (a) ingestion-time athlete-id capture per league (ESPN cross-sport id + MLB MLBAM) with resolved-or-404 status stored (Addition 1); (b) ONE `(league,id)`→headshot resolver; (c) thread id → grade → strip → every surface (slate strips, scan search, hot list, grade cards); (d) ledger book wordmarks — import `BookWordmark` + add missing keys + **bundle the ~8 real book SVGs**; (e) team-logo coverage gaps. **STOP + REPORT for founder eyeball of real logos/headshots across ALL sports before the rest builds on it.** Report any league with no free id source.
|
||||
3. **Wave 3 — Record-by-grade-tier (Addition 2, core)** — extend `getModelAggregate` to per-tier buckets + render on dashboard, ledger, /u. Sets up /u + the credibility story.
|
||||
4. **Wave 4 — Step 3 outlook mode** (never-empty grid → receipts/tomorrow) + Step 4 wire-able-now surfaces toward the mockup: live grade-shift timeline (grade-by-game-clock, history·last-24), market-breadth/consensus strip, Correlation Builder / Parlay Lab page (parlay slip + correlation flag).
|
||||
5. **Wave 5 — /u house-mode profile** (D2, reads `user_id=NULL` aggregate; portrait + OG crops from the mockup) + **pitcher identity card** fed by the **Baseball Savant arsenal adapter** (D4, new free feed).
|
||||
6. **Wave 6 — Step 5 combat** (author the combat spec FIRST → free honest v1: ESPN-MMA + odds-api ML/round-totals + style-blend archetype set + tale-of-the-tape card from the mockup; method/round/props flagged data-limited; matchup-grade engine its own sub-wave; confirm before any scraping dep).
|
||||
|
||||
Also queued (from the work order preamble): remove the literal "A $1M terminal" DeskShowcase headline → on-voice deadpan (it claims premium instead of showing it).
|
||||
Global rule for every wave: build the surface toward `specs/design-reference/vyndr-system.html`; keep the live wordmark. Ship each wave on green (tests + `next build` exit 0); nothing to main without the founder's word.
|
||||
|
||||
Reference in New Issue
Block a user