SIMSBIOHUB-1059: Store Taxonomic Hierarchy

[dylanrogowsky-oxd]

Links to Jira Tickets

• SIMSBIOHUB-1059

Description of Changes

• Adds parent_itis_tsn and parent_taxon_id (self-referencing FK) to taxon, with an index on each.
• Migration backfills existing rows: parent_itis_tsn from the stored ITIS payload, parent_taxon_id by matching the parent's itis_tsn.
• Derives parent-child links from the ITIS Solr hierarchyTSN lineage instead of the flat parentTSN (a TSN's parent is the previous TSN in the ordered lineage).
• Uncached TSNs now fetch their full ITIS hierarchy and insert-or-reuse every taxon in the lineage, storing parent links for each.
• Submission ingestion ensures missing taxa and their hierarchy exist before resolving taxon properties, so a valid-but-uncached TSN no longer fails ingestion with UNRESOLVED_TAXON.
• Taxon search filters (ChildOf/ParentOf/AscendsFrom/DescendsFrom) now walk the indexed parent_taxon_id column instead of parsing parentTSN out of itis_data.

Testing Notes

• Run the migration and confirm taxon has parent_itis_tsn/parent_taxon_id plus the two indexes, and that existing rows are backfilled.
• Call GET /api/taxonomy/taxon?tsn=<tsn> for a taxon whose ancestors aren't cached; the full lineage should be stored with parent links set.
• Import a submission referencing a TSN that isn't cached locally — it should resolve and store the taxon property instead of failing ingestion.
• Check taxon child/parent/ancestor/descendant filtering in search still returns the expected results.

[github-actions]

OpenShift URLs for the PR Deployment:

• App Route: https://biohub-platform-app-505-a0ec71-dev.apps.silver.devops.gov.bc.ca/
• API Route: https://biohub-platform-api-505-a0ec71-dev.apps.silver.devops.gov.bc.ca/
• Pods: https://console.apps.silver.devops.gov.bc.ca/k8s/ns/a0ec71-dev/pods?name=505
• Helm Release: https://console.apps.silver.devops.gov.bc.ca/helm-releases/ns/a0ec71-dev/release/pr-505

[mauberti-bc]

Very nice using submission_upload_staging_taxon_candidate!

[github-actions]

OpenShift URLs for the PR Deployment:

• App Route: https://biohub-platform-app-505-a0ec71-dev.apps.silver.devops.gov.bc.ca/
• API Route: https://biohub-platform-api-505-a0ec71-dev.apps.silver.devops.gov.bc.ca/
• Pods: https://console.apps.silver.devops.gov.bc.ca/k8s/ns/a0ec71-dev/pods?name=505
• Helm Release: https://console.apps.silver.devops.gov.bc.ca/helm-releases/ns/a0ec71-dev/release/pr-505

[sonarqubecloud]

Quality Gate passed

Issues
2 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud