Files
familienarchiv/frontend/src/lib/person
Marcel e259908d6a
All checks were successful
CI / Unit & Component Tests (push) Successful in 3m21s
CI / OCR Service Tests (push) Successful in 23s
CI / Backend Unit Tests (push) Successful in 3m40s
CI / fail2ban Regex (push) Successful in 43s
CI / Semgrep Security Scan (push) Successful in 22s
CI / Compose Bucket Idempotency (push) Successful in 1m5s
fix(stammbaum): order keyboard tab stops by visual layout, not DB order (#718)
Person nodes rendered in `nodes` array order (backend/DB row order), so
Tab focus hopped between nodes unrelated to their on-screen position,
failing WCAG 2.4.3 Focus Order (Level A).

Render the node loop in reading order instead: sort by layout y (top
generation first) then x (left-to-right within a row), via a
`nodesInReadingOrder` derived. Nodes without a layout position sort last
(mirroring the `{#if pos}` guard); node.id is the final tie-break for a
total, deterministic comparator. Shift+Tab and reload-stability fall out
for free (reversed render order; x/y independent of backend order).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-03 07:55:47 +02:00
..

person (frontend)

UI for historical family members: typeahead selection, chip display, hover cards, genealogy graph, relationship management.

What this domain owns

Components: PersonTypeahead.svelte, PersonMultiSelect.svelte, PersonChip.svelte, PersonChipRow.svelte, PersonHoverCard.svelte, PersonTypeBadge.svelte, PersonTypeSelector.svelte. Utilities: personFormat.ts (full-name formatting), personLifeDates.ts (birth/death display), person-validation.ts (form validation), personHoverCard.ts (hover-card controller). Sub-folders: genealogy/ (Stammbaum view components), relationship/ (relationship graph components).

What this domain does NOT own

  • Document content — displayed in document/
  • AppUser accounts — managed in user/

Key components

Component Used in Notes
PersonTypeahead.svelte document edit, geschichte, search filters Single-person selector with debounced typeahead. Exported for use by other domains.
PersonMultiSelect.svelte document edit (receivers) Chip-based multi-person selector
PersonChip.svelte document rows, conversation view Compact display chip with link and hover card
PersonHoverCard.svelte person chips Floating card with person summary on hover

Cross-domain imports

  • shared/primitives/ — generic UI primitives
  • shared/hooks/useTypeahead.svelte.ts — typeahead keyboard/focus logic

Accessibility notes

  • PersonChip focus ring: focus-visible:ring-2 focus-visible:ring-brand-navy
  • PersonTypeahead dropdown navigable via keyboard (↑↓ Enter Escape)

Backend counterpart

backend/src/main/java/org/raddatz/familienarchiv/person/README.md