docs(14-03): complete Discogs routes plan

This commit is contained in:
Jakub Zych
2026-10-03 22:25:35 +02:00
parent 5101ecb49c
commit f519261da6
6 changed files with 231 additions and 13 deletions

View File

@@ -4,16 +4,16 @@ milestone: v1.0
current_phase: 14
current_phase_name: Domain jobs and external integrations
status: executing
stopped_at: Completed 14-02-PLAN.md
last_updated: "2026-10-03T19:26:16.437Z"
stopped_at: Completed 14-03-PLAN.md
last_updated: "2026-10-03T20:25:22.551Z"
last_activity: 2026-10-03
last_activity_desc: Phase 14 execution started
state_head: f22c9144e67b54b5b16275430f47ea46392581e4
state_head: 5101ecb49cae4e1bcceecc91491c198175ce71c1
progress:
total_phases: 22
completed_phases: 11
total_plans: 118
completed_plans: 114
completed_plans: 115
milestone_name: milestone
---
@@ -29,7 +29,7 @@ See: .planning/PROJECT.md (updated 2026-09-16)
## Current Position
Phase: 14 (Domain jobs and external integrations) — EXECUTING
Plan: 3 of 6
Plan: 4 of 6
Status: Ready to execute
Last activity: 2026-10-03 — Phase 14 execution started
@@ -168,6 +168,7 @@ Progress: [██████░░░░] 60%
| Phase 13 P06 | 70 min | 3 tasks | 59 files |
| Phase 14 P01 | 25min | 5 tasks | 42 files |
| Phase 14 P02 | 80 min | 4 tasks | 81 files |
| Phase 14 P03 | 54min | 3 tasks | 122 files |
## Accumulated Context
@@ -514,6 +515,10 @@ Recent decisions affecting current work:
- [Phase 14]: 14-02: digest worker mails only when its DELETE removed the queue row (once per window under races)
- [Phase 14]: 14-02: reindex prefixes both the album and the legacy items index with search.prefix
- [Phase 14]: 14-02: INTG-01 stays Pending until 14-03 mounts the Discogs routes
- [Phase 14]: Parity over plan wording: a second identical apply re-imports covers and dry_run writes the covers and non-draft catalog fields, as PHP does
- [Phase 14]: apply-release runs without an enclosing transaction, as PHP, so cover downloads never hold the album row lock
- [Phase 14]: Discogs-route covers go through classes.NewGuardedCoverImporter (fetchguard.Client, GuzzleHttp/7 UA) so the replay answers them; Phase 12 cover imports deferred
- [Phase 14]: discogs is an additive parity seed extra; A Love Supreme carries discogs_id 2002 with the album state
### Pending Todos
@@ -562,6 +567,6 @@ Items acknowledged and carried forward from previous milestone close:
## Session Continuity
Last session: 2026-10-03T19:26:15.839Z
Stopped at: Completed 14-02-PLAN.md
Last session: 2026-10-03T20:25:22.043Z
Stopped at: Completed 14-03-PLAN.md
Resume file: None