ISS-17: backfill idee → PBI/sprint uit ceremonie-logs (data-migratie) #373

Merged
janpeter merged 1 commit from fix/iss-17-backfill-idea-links into main 2026-10-14 20:03:58 +02:00
Owner

⚠ Live-DB-wijziging bij de eerstvolgende web-deploy. De merge zelf deployt niet: auto_deploy staat uit voor SCRUM4ME en de CI draait geen migrate deploy. De eerstvolgende update_scrum4me_web-deploy (prisma-operator.sh deploy) past de migratie toe op prod. Daarvoor is JP's expliciete akkoord nodig.

Wat

Eenmalige data-migratie voor ISS-17 (scrum4me-mcp, bronfix in scrum4me-mcp#227). Hij vult ideas.pbi_id en ideas.build_sprint_id uit de ceremoniebesluiten in idea_logs (metadata.pbi_id / metadata.sprint_id), zodat Workers (IDEA-260) het verbruik aan het idee kan toerekenen.

  • prisma/migrations/20261014180000_backfill_idea_ceremony_links/migration.sql
  • Dry-run-rapport: docs/runbooks/evidence/2026-10-14-iss-17-idea-link-backfill.md

Dry-run op prod (alleen lezen, 2026-10-14)

16 ideeën: 16× build_sprint_id, 15× pbi_id. IDEA-252 heeft geen PBI in zijn log. Alle doelen bestaan, horen bij het product van het idee en hangen niet aan een ander idee. De tabel per idee en de aansluiting op de telling "20 van 74" uit de issue staan in het rapport.

⚠ Beslissing nodig: IDEA-216 en IDEA-242

Beide hebben twee ceremonies (elk een PBI plus een sprint). De standaard in deze PR is de oudste ceremonie, met PBI en sprint als paar uit dezelfde logrij:

  • IDEA-216: PBI-1 + S-2026-09-23-1 (CLOSED), niet PBI-3 + S-2026-09-24-2 (OPEN)
  • IDEA-242: PBI-2 + S-2026-10-08-1 (increment 1), niet PBI-3 + S-2026-10-08-2 (increment 2)

Een andere keuze kost één regel per idee in de VALUES-lijst.

Veiligheid

  • De set is vastgezet op de 16 beoordeelde drietallen. Logs van na de meting glippen er niet in.
  • Alle bewakingen staan in de WHERE/CASE, dus de migratie kan niet falen op drift. Hij vult alleen lege kolommen. Elk doel moet bestaan en bij het product horen (primair of via idea_products), het drietal moet nog in een log staan, en de PBI mag niet al aan een ander idee hangen of door twee ideeën in de batch worden geclaimd.
  • Idempotent: een tweede run wijzigt 0 rijen. status, updated_at en build_sprint_run_id blijven onaangeroerd.

Test

Op een wegwerp-PostgreSQL op max2, met het prod-schema (pg_dump -s) en een fixture met de echte cuids. De migratie is letterlijk gedraaid, met 8 scenario's: basisrun UPDATE 16, tweede run UPDATE 0, bestaande waarde, verkeerd product, secundair product, PBI al gekoppeld, PBI-botsing binnen de batch, en ontbrekend doel of ontbrekende log. Alle 8 groen. docs:check-links is groen.

🤖 Generated with Claude Code

> ⚠ **Live-DB-wijziging bij de eerstvolgende web-deploy.** De merge zelf deployt niet: `auto_deploy` staat uit voor SCRUM4ME en de CI draait geen `migrate deploy`. De eerstvolgende `update_scrum4me_web`-deploy (`prisma-operator.sh deploy`) past de migratie toe op prod. Daarvoor is JP's expliciete akkoord nodig. ## Wat Eenmalige data-migratie voor ISS-17 (scrum4me-mcp, bronfix in scrum4me-mcp#227). Hij vult `ideas.pbi_id` en `ideas.build_sprint_id` uit de ceremoniebesluiten in `idea_logs` (`metadata.pbi_id` / `metadata.sprint_id`), zodat Workers (IDEA-260) het verbruik aan het idee kan toerekenen. - `prisma/migrations/20261014180000_backfill_idea_ceremony_links/migration.sql` - Dry-run-rapport: `docs/runbooks/evidence/2026-10-14-iss-17-idea-link-backfill.md` ## Dry-run op prod (alleen lezen, 2026-10-14) 16 ideeën: **16× `build_sprint_id`, 15× `pbi_id`**. IDEA-252 heeft geen PBI in zijn log. Alle doelen bestaan, horen bij het product van het idee en hangen niet aan een ander idee. De tabel per idee en de aansluiting op de telling "20 van 74" uit de issue staan in het rapport. ## ⚠ Beslissing nodig: IDEA-216 en IDEA-242 Beide hebben twee ceremonies (elk een PBI plus een sprint). De standaard in deze PR is de **oudste ceremonie**, met PBI en sprint als paar uit dezelfde logrij: - IDEA-216: PBI-1 + S-2026-09-23-1 (CLOSED), niet PBI-3 + S-2026-09-24-2 (OPEN) - IDEA-242: PBI-2 + S-2026-10-08-1 (increment 1), niet PBI-3 + S-2026-10-08-2 (increment 2) Een andere keuze kost één regel per idee in de `VALUES`-lijst. ## Veiligheid - De set is vastgezet op de 16 beoordeelde drietallen. Logs van na de meting glippen er niet in. - Alle bewakingen staan in de `WHERE`/`CASE`, dus de migratie kan niet falen op drift. Hij vult alleen lege kolommen. Elk doel moet bestaan en bij het product horen (primair of via `idea_products`), het drietal moet nog in een log staan, en de PBI mag niet al aan een ander idee hangen of door twee ideeën in de batch worden geclaimd. - Idempotent: een tweede run wijzigt 0 rijen. `status`, `updated_at` en `build_sprint_run_id` blijven onaangeroerd. ## Test Op een wegwerp-PostgreSQL op max2, met het prod-schema (`pg_dump -s`) en een fixture met de echte cuids. De migratie is letterlijk gedraaid, met 8 scenario's: basisrun `UPDATE 16`, tweede run `UPDATE 0`, bestaande waarde, verkeerd product, secundair product, PBI al gekoppeld, PBI-botsing binnen de batch, en ontbrekend doel of ontbrekende log. Alle 8 groen. `docs:check-links` is groen. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
feat(db): ISS-17 backfill idea → PBI/sprint from ceremony logs
All checks were successful
CI / DB Access Policy Gate (pull_request) Successful in 1m55s
CI / Queue Dispatch Guard Gate (pull_request) Successful in 2m7s
CI / DB Access Production Sentinel (pull_request) Successful in 17s
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 4m14s
62f41239b6
Interactive ceremonies could not pass idea_id to create_pbi/create_sprint, so
ideas.pbi_id and ideas.build_sprint_id stayed empty and the link only lived in
idea_logs metadata. Workers (IDEA-260) needs the columns to attribute usage.

One-off data migration over a pinned set of 16 reviewed (idea, pbi, sprint)
triples: fills only empty columns, checks existence, product membership
(primary or idea_products), log provenance and pbi uniqueness inside the
WHERE so it cannot fail on drift; a re-run changes 0 rows. Dry-run report and
max2 test results in docs/runbooks/evidence.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

APPROVED

Findings:

  • Geen blokkerende of overige concrete findings gevonden.

geen gekoppeld plan gevonden — beoordeeld op codekwaliteit + product-standaarden.

De vastgezette backfill past bij de beschreven scope van ISS-17. De SQL bewaart bestaande waarden, controleert productkoppelingen en logherkomst, en voorkomt PBI-conflicten binnen de batch en met bestaande koppelingen. Geen nieuwe databaseobjecten; de migratie sluit aan op de gedocumenteerde operatorroute.

Verificatie op commit 62f41239b677bb0cb9d2769536875ffb472fce66: de ongewijzigde migratie uitgevoerd op een lokale PostgreSQL 17 met een minimaal testschema met FK- en unique-constraints en synthetische fixtures voor alle 16 vastgezette drietallen. Basisrun: 15 PBI's en 16 sprints; herhaling: UPDATE 0; status en updated_at behouden. Ook bestaande waarden, verkeerd/secundair product, reeds gekoppelde PBI, ontbrekende doelen en ontbrekende log gecontroleerd. Documentatielinks (326 bestanden) en git diff --check geslaagd. Geen volledige applicatiebuild/testsuite uitgevoerd; de diff bevat uitsluitend SQL en documentatie. De productiegegevens en het eerdere dry-runrapport zijn niet onafhankelijk opnieuw gemeten.

De keuze voor de oudste ceremonie bij IDEA-216 en IDEA-242 is expliciet beschreven. Deze codegoedkeuring autoriseert geen productie-deploy; de afzonderlijke deploybeslissing blijft zoals in de PR gedocumenteerd.

# APPROVED Findings: - Geen blokkerende of overige concrete findings gevonden. geen gekoppeld plan gevonden — beoordeeld op codekwaliteit + product-standaarden. De vastgezette backfill past bij de beschreven scope van ISS-17. De SQL bewaart bestaande waarden, controleert productkoppelingen en logherkomst, en voorkomt PBI-conflicten binnen de batch en met bestaande koppelingen. Geen nieuwe databaseobjecten; de migratie sluit aan op de gedocumenteerde operatorroute. Verificatie op commit `62f41239b677bb0cb9d2769536875ffb472fce66`: de ongewijzigde migratie uitgevoerd op een lokale PostgreSQL 17 met een minimaal testschema met FK- en unique-constraints en synthetische fixtures voor alle 16 vastgezette drietallen. Basisrun: 15 PBI's en 16 sprints; herhaling: UPDATE 0; status en updated_at behouden. Ook bestaande waarden, verkeerd/secundair product, reeds gekoppelde PBI, ontbrekende doelen en ontbrekende log gecontroleerd. Documentatielinks (326 bestanden) en git diff --check geslaagd. Geen volledige applicatiebuild/testsuite uitgevoerd; de diff bevat uitsluitend SQL en documentatie. De productiegegevens en het eerdere dry-runrapport zijn niet onafhankelijk opnieuw gemeten. De keuze voor de oudste ceremonie bij IDEA-216 en IDEA-242 is expliciet beschreven. Deze codegoedkeuring autoriseert geen productie-deploy; de afzonderlijke deploybeslissing blijft zoals in de PR gedocumenteerd.
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
janpeter/Scrum4Me!373
No description provided.