feat(timeline): derive person life-events (Geburt/Tod/Heirat) — issue #776 #825

Merged

marcel merged 6 commits from worktree-feat-issue-776-derived-person-life-events into main 2026-06-13 15:13:29 +02:00

Conversation 7 Commits 6 Files Changed 10 +659 -8

6 Commits

Author	SHA1	Message	Date
Marcel	6b593a7bc6	docs(timeline): add derived-event glossary entries and update C4 diagram ... Add GLOSSARY.md entries for derived event, DerivedEventType, derivedType, and assembleDerivedEvents() to cover the vocabulary introduced by #776. Update l3-backend-timeline.puml: remove stale "planned, #775" labels, add Rel from TimelineEventService to personDomain for assembleDerivedEvents batch-fetch calls, document the on-read strategy in the component notes. Refs #776 Co-Authored-By: claude-sonnet-4-6 <noreply@anthropic.com>	2026-06-13 14:53:50 +02:00
Marcel	033001559d	docs(timeline): update RTM and CLAUDE.md for issue #776 ... RTM: add REQ-001–REQ-016 rows with Done status, implementation files, and test IDs. CLAUDE.md: expand timeline package entry with TimelineEntryDTO, DerivedEventType, and assembleDerivedEvents(); add TimelineEntryDTO to domain model table. Refs #776 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 14:37:19 +02:00
Marcel	c66d83cfc6	feat(timeline): implement assembleDerivedEvents() with TDD (REQ-001–REQ-016) ... Adds RelationshipService dependency to TimelineEventService and implements: - assembleDerivedEvents() — public @Transactional(readOnly=true) orchestrator - buildBirthEvents() — Person.birthDate → BIRTH events with precision pass-through - buildDeathEvents() — Person.deathDate → DEATH events with precision pass-through - buildMarriageEvents() — SPOUSE_OF edges → MARRIAGE events, dedup on row id Synthetic prefixed ids (birth:/death:/marriage:) are structurally non-UUID. Null fromYear marriages are emitted with eventDate=null + precision=UNKNOWN (REQ-006). Non-family-member persons excluded from birth/death; SPOUSE_OF edges always emit (REQ-013). All 16 tests in DerivedEventsAssemblyTest pass. Refs #776 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 14:35:50 +02:00
Marcel	7810ca7dd7	feat(relationship): add findAllSpouseEdges() for timeline assembly ... Returns all SPOUSE_OF edges with JOIN FETCH on both person sides, preventing N+1 in TimelineService.assembleDerivedEvents() (REQ-011). Reuses existing findAllByRelationTypeIn query which already JOIN FETCHes. Refs #776 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 14:30:30 +02:00
Marcel	4245b821b9	feat(timeline): add DerivedEventType enum and TimelineEntryDTO record ... DerivedEventType: BIRTH / DEATH / MARRIAGE discriminator for derived events. TimelineEntryDTO: unified String-id DTO for both curated and derived events; id is String (not UUID) to accommodate synthetic prefixed ids (birth:/death:/marriage:). Refs #776 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 14:29:36 +02:00
Marcel	663ffad49b	docs(adr): add ADR-043 — derived person life-events on-read strategy (Proposed) ... Covers three pre-implementation decisions for issue #776: 1. On-read assembly, never persisted (no migration) 2. Synthetic prefixed String ids (birth:/death:/marriage:) 3. assembleDerivedEvents() as the public cross-issue contract on TimelineService Refs #776 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 14:28:48 +02:00