kobotoolbox / kpi / 24671455478

82%

master: 76%

Build Type

push

github

Committed by web-flow

Commit Message

feat(subsequences): batch-migrate legacy NLP supplements on deploy, guard exports DEV-1961 (#6937)

### 📣 Summary

Exports on assets with NLP data were silently failing with an
`InvalidAction` error because `SubmissionSupplement` records were stored
in a legacy schema (no `_version` key). This PR adds a management
command and a LRM job to batch-migrate those records on deploy, and
shows a clear error during the transition window.

### 👷 Description for instance maintainers

Three complementary changes ship together:

**1. Management command `migrate_submission_supplements`:** Iterates
over all `SubmissionSupplement` records still in the legacy format and
converts them to the current schema (`_version: '20250820'`). Can also
be run manually from the shell.

**2. Long-running migration (job `0023`):** Runs the management command
automatically on deploy via the existing Beat-scheduled LRM framework —
no manual intervention required.

**3. Export guard:** While the LRM is running, any async export for an
asset that still has unmigrated supplements fails with a clear message
(`Supplement data migration in progress, please retry later`) instead of
the previous cryptic `{"error": "", "error_type": "InvalidAction"}`.

Coverage Stats

7779 of 11972 branches covered (64.98%)

5 of 30 new or added lines in 4 files covered. (16.67%)

402 existing lines in 17 files now uncovered.

29579 of 36023 relevant lines covered (82.11%)

5.78 hits per line