feat(postcodes/AR): bulk-import 23,184 Argentina postcodes via Correo Argentino (#1039)

[dr5hn]

Summary

Adds 23,184 Argentina postcodes spanning all 24 provinces, sourced from
Correo Argentino's free CPA consultation feed via the community
androdron/localidades_AR mirror.

• Coverage: 100% of provinces (all 24 in states.json) resolve.
• Format: Legacy 4-digit Correo postal codes; matches the country's
  ^[A-Z]?\d{4}[A-Z]{0,3}$ regex (which also accepts the modern
  CPA-Argentino B1234ABC form).
• Idempotent merge: Re-running the importer never overwrites
  curated rows; new (code, locality) pairs are appended.

Source & licence

• Source URL: https://raw.githubusercontent.com/androdron/localidades_AR/master/localidades_cp_maestro.csv
• Origin: scraped from Correo Argentino's free public CPA consultation
  endpoint. Repository ships without a formal licence file but the
  upstream data is published by the postal operator for free public
  lookup; attribution recorded in the source column of every row.
• Each row: "source": "correo-argentino-via-androdron"

How it works

• ASCII-fold (NFKD strip combining marks) the source provincia
  column to join with states.json (handles Cordoba/Córdoba,
  Tucuman/Tucumán, Rio Negro/Río Negro, etc.).
• Single STATE_ALIASES entry maps "Ciudad Autonoma de Buenos
  Aires" -> CSC's "Autonomous City of Buenos Aires".
• Per-row state_id + state_code populated against the
  single-letter ISO 3166-2 codes used in states.json (B/C/J/K/...).

Validation

• python3 -m py_compile clean.
• 100% of 23,184 codes match country.postal_code_regex.
• 100% of records resolve a valid state_id whose
  country_id == 11 (Argentina) and whose iso2 matches the
  emitted state_code.
• No auto-managed fields (id, created_at, updated_at,
  flag) in any row.

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 23184 records. Large contributions require manual review.

Schema Validation (23184 records)

✅ All records passed validation

Cross-Reference Validation

✅ 46368 reference(s) verified

Source URL Verification

✅ 2 source URL(s) accessible

---

✅ All checks passed | Status: Ready for review