feat(postcodes/DO): bulk-import 2,320 Dominican Republic postcodes via INPOSDOM (#1039)

[dr5hn]

Summary

Adds 2,320 Dominican Republic postcodes spanning all 32 INPOSDOM
provinces, sourced from the manuelpgs/localidades-postales-rd
CSVs.

• Coverage: 100% province resolution (32/32 in states.json).
• Granularity: locality (sector/barrio) level — one record per
  (5-digit code, locality) pair.

How it works

• Pre-builds a source-prov-id -> CSC iso2 map from
  provincias.csv (ASCII-fold name match, parenthetical-suffix
  strip).
• 2-entry STATE_ALIASES bridge for BAHORUCO -> Baoruco
  (source spelling differs by one h) and
  SAN JUAN DE LA MAGUANA -> San Juan (CSC drops the suffix).
• Walks localidades.csv; emits one row per
  (postcode, locality) pair.

Source & licence

• Source URLs:
  • https://raw.githubusercontent.com/manuelpgs/localidades-postales-rd/master/csv/provincias.csv
  • https://raw.githubusercontent.com/manuelpgs/localidades-postales-rd/master/csv/localidades.csv
• Origin: INPOSDOM publicly published catalogue.
• Each row: "source": "inposdom-via-manuelpgs"

Validation

• python3 -m py_compile clean.
• 100% of 2,320 codes match country.postal_code_regex (^(\d{5})$).
• 100% of records resolve a valid state_id whose country_id == 62
  and whose iso2 matches state_code.
• No auto-managed fields (id, created_at, updated_at, flag).

Test plan

• Importer compiles and runs on a clean checkout.
• Cross-reference validator passes (regex + FK + state_code agreement).
• Idempotent merge verified.
• CI pipeline green.

Refs #1039.

🤖 Generated with Claude Code

[Copilot]

Copilot wasn't able to review any files in this pull request.

[github-actions]

CSC Validation Report

PR Format

• ✅ Description provided
• ✅ Data source linked
• ✅ Issue linked (recommended for data changes)
• ✅ Justification / context provided

Labels applied: data:postcodes, large-contribution

⚠️ Large Contribution

This PR contains 2320 records. Large contributions require manual review.

Schema Validation (2320 records)

✅ All records passed validation

Cross-Reference Validation

✅ 4640 reference(s) verified

Source URL Verification

✅ 3 source URL(s) accessible

---

✅ All checks passed | Status: Ready for review