kobotoolbox / kpi / 24671455478 / 10

82%

master: 76%

push

github

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"}`.

5598 of 11958 branches covered (46.81%)

24564 of 36023 relevant lines covered (68.19%)

0.68 hits per line