From ba748d7a6b37e1546fb032971fe90bc8d9c161b4 Mon Sep 17 00:00:00 2001 From: Tim Froehlich Date: Wed, 16 Sep 2026 08:41:20 -0500 Subject: [PATCH] docs(spec): lock iScored Top Scores card design and cut the iScored tab (PP-h2bu) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Design lock from the 2026-09-16 canvas session: the Top Scores card moves to the Info tab's right rail under Details as top-three ranked rows with the iScored logo in the header; both the logo and "View all on iScored" open the game's iScored page. §5 machine iScored tab removed — iScored's own page already renders the full leaderboard. Adds the static mockup and the cleaned logo SVG for the implementer. Co-Authored-By: Claude Opus 5 --- docs/feature-specs/iscored-logo.svg | 346 ++++++++++++++++++ .../iscored-top-scores-mockup.html | 315 ++++++++++++++++ docs/feature-specs/iscored.md | 19 +- 3 files changed, 670 insertions(+), 10 deletions(-) create mode 100644 docs/feature-specs/iscored-logo.svg create mode 100644 docs/feature-specs/iscored-top-scores-mockup.html diff --git a/docs/feature-specs/iscored-logo.svg b/docs/feature-specs/iscored-logo.svg new file mode 100644 index 000000000..68cce0706 --- /dev/null +++ b/docs/feature-specs/iscored-logo.svg @@ -0,0 +1,346 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + iSc + + + red + + + + + + + + + + + + + + + + diff --git a/docs/feature-specs/iscored-top-scores-mockup.html b/docs/feature-specs/iscored-top-scores-mockup.html new file mode 100644 index 000000000..90f194e87 --- /dev/null +++ b/docs/feature-specs/iscored-top-scores-mockup.html @@ -0,0 +1,315 @@ + + + + + +iScored Top Scores card — mockup + + + + +

iScored Top Scores card — Info tab

+

Spec: docs/feature-specs/iscored.md §4. The card sits in the Info tab's reference rail directly under Details (folds inline after Details on mobile). Header: TOP SCORES label + iScored logo (links to the game's iScored page). Rows: rank badge (primary / secondary / outline), bold name with score date, mono score (#1 larger and tinted). Footer: outline "Add score" button (score entry page) + "View all on iScored" link (game page). Both external links open in a new tab. The former §5 iScored tab was cut.

+

Info tab — desktop (1200)

+
+
+
+ DOM +
+

Domino

+

Gottlieb · 1968

+
+
+ +
+
+
+
+
+
+ Operational + On the floor +
+ Report a problem +
+
+

No open issues — this machine is healthy.

+
+
+
+
+

Recent activity

+ View all +
+ +
+
+
+ TF +
+

Tim Froehlich · 2d ago

+

Replaced the right flipper coil

+
+
+
+ NW +
+

NAW · 5d ago

+

Reported #DOM-14 · Left drop target stuck

+
+
+
+ SY +
+

System · 2w ago

+

Presence set to On the floor

+
+
+
+
+
+ +
+
+
+

Info tab — mobile (390)

+
+
+
+ DOM +
+

Domino

+

Gottlieb · 1968

+
+
+ +
+
+
+
+
+ Operational + On the floor +
+ Report a problem +
+
+

No open issues — this machine is healthy.

+
+
+

Details

+

Single-player EM with a drop-target bank. Plays fast for its age.

+
+

Model Domino

+

Manufacturer Gottlieb

+

Year 1968

+

View on Pinball Map

+
+
+

Owner Tim Froehlich

+

Added Mar 12, 2025

+
+
+

Top scores

iScored
+
    +
  1. + 1 +
    + JSW + Jul 19, 2025 +
    + 609,799,780 +
  2. +
  3. + 2 +
    + VTX + Sep 11, 2025 +
    + 578,421,330 +
  4. +
  5. + 3 +
    + RAB + Jun 28, 2025 +
    + 478,481,630 +
  6. +
+ +
+

Tags

+

Coming soon!

+
+
+
+

Recent activity

+ View all +
+ +
+
+
+ TF +
+

Tim Froehlich · 2d ago

+

Replaced the right flipper coil

+
+
+
+ NW +
+

NAW · 5d ago

+

Reported #DOM-14 · Left drop target stuck

+
+
+
+ SY +
+

System · 2w ago

+

Presence set to On the floor

+
+
+
+
+
+
+
+

Card — linked, scores

+
+
+

Top scores

iScored
+
    +
  1. + 1 +
    + JSW + Jul 19, 2025 +
    + 609,799,780 +
  2. +
  3. + 2 +
    + VTX + Sep 11, 2025 +
    + 578,421,330 +
  4. +
  5. + 3 +
    + RAB + Jun 28, 2025 +
    + 478,481,630 +
  6. +
+ +
+
+

Card — linked, no scores

+
+
+

Top scores

iScored
+

No scores recorded yet

+ +
+
+

Card — unlinked, viewer can open Manage

+
+
+

Top scores

iScored
+

Not linked to iScored.

+ Link it on Manage +
+
+

Card — unlinked, guest

+
+
+

Top scores

iScored
+

Not linked to iScored.

+
+
+ + diff --git a/docs/feature-specs/iscored.md b/docs/feature-specs/iscored.md index 8197e5e9f..62fcadbd3 100644 --- a/docs/feature-specs/iscored.md +++ b/docs/feature-specs/iscored.md @@ -38,19 +38,18 @@ ## 4. Machine Info tab ("Top Scores" card) -- **4.1** A Top Scores card renders on the machine's Info tab (`/m/[initials]`) in the main column below the hero. -- **4.2** For a linked machine with scores, the card displays the top three scores (rank, player name/initials, formatted score), an "Add score" button linking to the score entry page in a new tab, and a link to the machine's iScored tab. -- **4.3** For a linked machine with zero recorded scores, the card displays a quiet empty state ("No scores recorded yet") and an "Add score" button. -- **4.4** For an unlinked machine, the card displays a quiet empty state indicating no iScored link is configured. +- **4.1** A Top Scores card renders on the machine's Info tab (`/m/[initials]`) in the reference rail, directly below the Details card. On mobile it folds inline with the rail, after Details. +- **4.2** For a linked machine with scores, the card displays the top three scores as ranked rows (rank badge, player name, score date, formatted score), an "Add score" button linking to the score entry page in a new tab, and a "View all on iScored" link to the game's public iScored page in a new tab. +- **4.3** The card header carries the "Top scores" label and the iScored logo; the logo links to the game's public iScored page in a new tab. The logo renders in every card state so the card stays recognisable when empty or unlinked. +- **4.4** For a linked machine with zero recorded scores, the card displays a quiet empty state ("No scores recorded yet"), an "Add score" button, and the "View all on iScored" link. +- **4.5** For an unlinked machine, the card displays a quiet empty state indicating no iScored link is configured, with a link to the Manage tab for viewers who can open it. Guests see the sentence only. +- **4.6** Mockup: `docs/feature-specs/iscored-top-scores-mockup.html` (desktop and mobile Info tab, plus the four card states). Logo asset: `docs/feature-specs/iscored-logo.svg` (supplied by iScored; white background removed, viewBox cropped to the artwork). --- ## 5. Machine iScored tab -- **5.1** A dedicated "iScored" tab on the machine page (`/m/[initials]/iscored`) renders the machine's leaderboard, styled to echo iScored's presentation within PinPoint's native theme. In the machine tab strip, it is positioned immediately after the "Info" tab (between Info and Settings). -- **5.2** The tab strip renders the tab using the iScored brand label and logo. -- **5.3** For a linked machine, the tab lists all available high scores and includes an "Add score" button linking to the score entry page in a new tab. -- **5.4** For an unlinked machine, the tab displays a helpful empty state with a link to the location's public iScored gameroom URL (`https://www.iscored.info/{user}`) and instructions for linking the game in the Manage tab. +Removed 2026-09-16. The Info tab card's "View all on iScored" link replaces it: iScored's own game page already renders the full leaderboard with game art, and a PinPoint tab showing more rows of the same list added nothing members could not get one tap away. Revisit only if a tab would show something iScored's page does not (a signed-in member's own scores, score history, a per-machine reset). Section number retained so later citations stay stable. --- @@ -67,8 +66,7 @@ | §2.1–§2.2 machine linking in Manage tab | No form field in Manage tab | PP-h2bu.4 | | §2.3 MCP linking tool | No `set_machine_iscored` MCP tool | PP-h2bu.6 | | §3.1–§3.5 iScored API client & cache | No client module | PP-h2bu.3 | -| §4.1–§4.4 Info tab top scores card | Not yet rendered | PP-h2bu.4 | -| §5.1–§5.4 Machine iScored tab | Not yet rendered | PP-h2bu.4 | +| §4.1–§4.5 Info tab top scores card | Not yet rendered | PP-h2bu.4 | | §6.1 Fleet overview column | Not yet rendered | PP-h2bu.5 | --- @@ -77,4 +75,5 @@ | Date | Change | | :-- | :-- | +| 2026-09-16 | Design lock: Top Scores card moves to the rail under Details as top-three ranked rows with the iScored logo and an external "View all on iScored" link; §5 machine iScored tab removed; mockup added. Canvas: https://claude.ai/artifact/Rb7AXgxUVFwW8bEWFhhUgv | | 2026-09-15 | Initial draft: machine linking, batch read with 15s non-blocking throttle & privacy contracts, Info tab top-3 card, machine iScored tab, MCP tooling, and fleet column. |