Skip to content

Add Brain Map tab: radial SVG concept graph with production context#1

Open
warfield2016 wants to merge 1 commit into
mainfrom
feat/brain-map
Open

Add Brain Map tab: radial SVG concept graph with production context#1
warfield2016 wants to merge 1 commit into
mainfrom
feat/brain-map

Conversation

@warfield2016

@warfield2016 warfield2016 commented Apr 6, 2026

Copy link
Copy Markdown
Owner

Summary

  • New Brain Map tab with interactive radial SVG showing all 30 concepts across 5 CCA-F domains
  • 47 cross-domain connection arcs rendered as Bezier curves, highlighted on hover/selection
  • Click any concept to open a detail panel with 7 sections: why it matters, production examples, cross-domain links, curated resources, failure modes, exam signals
  • Enriched data model for all 30 concepts with production context authored from exam research
  • Pure SVG with polar-coordinate layout (no d3, zero new dependencies)
  • WCAG AA contrast fix: brighter label colors for D1 and D5 in the brain map
  • Keyboard accessible (Tab/Enter/Escape), works at mobile (375px) and desktop widths

Test plan

  • Click Brain Map tab — SVG renders with root + 5 domain nodes + 30 concept nodes
  • D1 node visually larger than D5 (weight-proportional sizing)
  • Hover a concept — its arcs highlight, unrelated nodes dim
  • Click a concept — detail panel opens below with all 7 sections
  • Click a "Connects to" chip — navigates to that concept, panel updates
  • Click a resource link — opens in new tab
  • Press Escape — detail panel closes
  • Tab-key navigation between nodes, Enter opens panel
  • Mark a concept mastered — state persists on reload (localStorage)
  • Existing 5 tabs (Plan, Concepts, Projects, Rules, Cheat) still work
  • npm run build succeeds, bundle size ~225KB JS

A new sixth tab that visualizes all 30 concepts across the 5 CCA-F domains
as an interactive radial graph, with cross-domain connection arcs showing
how concepts relate across exam scenarios.

Click any concept to open a detail panel with six sections per concept:
- Why it matters (production impact, 1-2 sentences)
- Used in (concrete production apps)
- Connects to (clickable links to related concepts across domains)
- Learn more (curated Skilljar + docs links)
- Watch for (common failure modes and anti-patterns)
- Exam signals (distractor-trap phrases that point to this concept)

Implementation notes:
- Pure SVG with polar-coordinate layout (no d3, keeps zero external UI
  deps per project convention)
- 3-ring design: root at center, 5 domain nodes sized by weight, 30 concept
  nodes clustered by domain with angular spread proportional to domain size
- 47 cross-domain arcs rendered as quadratic Bezier curves, highlighted on
  hover/selection, dimmed otherwise
- Brighter label colors for D1 (#e74c3c) and D5 (#a569bd) to fix WCAG AA
  contrast failures against the #0c0c10 background
- Detail panel expands below the SVG (no modal overlay), closes on Escape
- Mastery toggle persisted to localStorage with bm-{id} key format
- Keyboard accessible (Tab focus, Enter opens panel, Esc closes)
- Renders cleanly at both mobile (375px) and desktop widths
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant