pal-e-docs

Board Context Renderer

story-pal-e-docs-board-context-renderer User Story

active user-story
Project

story: Board Context Renderer

Role

Superuser (Lucas)

Key

board-context-renderer

Want

As the Superuser, I want to open a board and see the architecture diagrams and user stories it serves, above the kanban columns

So That

So that I can orient to a project in one view without navigating between project page, architecture notes, and board separately — the board becomes the primary navigation surface where what I'm building (architecture), why I'm building it (stories), and where we are (kanban) live together

Acceptance Criteria

  • [ ] Board page shows a collapsible context header above the kanban columns
  • [ ] Architecture section displays mermaid diagram thumbnails fetched from linked arch notes
  • [ ] User Stories section displays story cards with Role, Want, Key label, and AC completion progress
  • [ ] Slugs are extracted from the board note's Architecture and User Stories blocks — no schema changes
  • [ ] Missing or misspelled slugs degrade gracefully (placeholder card, not an error)
  • [ ] Click an architecture thumbnail to filter the kanban to matching arch: labeled tickets
  • [ ] Click a story card to filter the kanban to matching story: labeled tickets
  • [ ] Filters compose (arch + story = intersection)
  • [ ] Context header collapses to a toggle bar on viewports under 640px
  • [ ] Boards without User Stories / Architecture sections in their note render the kanban as today (no empty state, no error)
  • [ ] Dogfood: board-pal-e-docs displays arch-domain-pal-e-docs as a thumbnail and this story as a card

Success Metric

Lucas can open any board, see the architecture and stories it serves, and filter tickets by arch component or story — all without navigating away from the board page. Orientation time to a new project drops from "open 3-4 pages" to "open 1 board."
  • arch-domain-pal-e-docs — the blocks, notes, boards, and board_items entities this renderer queries
  • project-pal-e-docs — parent project
  • board-pal-e-docs — dogfood target board
  • template-board — the template that prescribes User Stories + Architecture sections
  • template-user-story — story note format rendered by StoryCard
  • template-architecture — arch note format rendered by ArchThumbnail