Skip to content

feat(postcodes/CO): bulk-import 3,676 Colombia postcodes via 4-72 (#1039)#1448

Merged
dr5hn merged 1 commit into
masterfrom
feat/postcodes-colombia
Apr 27, 2026
Merged

feat(postcodes/CO): bulk-import 3,676 Colombia postcodes via 4-72 (#1039)#1448
dr5hn merged 1 commit into
masterfrom
feat/postcodes-colombia

Conversation

@dr5hn
Copy link
Copy Markdown
Owner

@dr5hn dr5hn commented Apr 27, 2026

Summary

Adds 3,676 Colombia postcodes spanning all 33 DANE departments,
sourced from the official 4-72 (Servicios Postales Nacionales)
catalogue distributed via the JohaAlarcon/Load_postal_code mirror.

  • Coverage: 100% department resolution (33/33 in states.json).
  • Format: Canonical 6-digit national code (matches
    ^(\d{6})$); a handful of source rows ship with a missing or
    spurious leading zero and are normalised on import.

Source & licence

How it works

  • DANE department code (2-digit) is mapped to CSC's 3-letter iso2
    via a hand-curated 33-entry table (e.g. 05 -> ANT, 11 -> DC, 88 -> SAP).
  • The free-text limite column carries street-level boundary
    descriptions (and arrives mojibake-encoded); intentionally not used
    as locality_name.

Validation

  • python3 -m py_compile clean.
  • 100% of 3,676 codes match country.postal_code_regex.
  • 100% of records resolve a valid state_id whose
    country_id == 48 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

)

Source: 4-72 / Servicios Postales Nacionales catalogue distributed via
the JohaAlarcon/Load_postal_code mirror. All 33 DANE departments
resolve (100% state FK) via a hand-curated DANE 2-digit code -> CSC
3-letter iso2 map. The 12 source codes shipped with stripped/extra
leading zeros are normalised to the canonical 6-digit form.

Refs #1039.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 27, 2026 12:36
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

@dosubot dosubot Bot added size:XS This PR changes 0-9 lines, ignoring generated files. enhancement New feature or request labels Apr 27, 2026
@github-actions
Copy link
Copy Markdown
Contributor

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

Schema Validation (3676 records)

✅ All records passed validation

Cross-Reference Validation

✅ 7352 reference(s) verified

Source URL Verification

✅ 2 source URL(s) accessible


All checks passed | Status: Ready for review

@dr5hn dr5hn merged commit 8c23e7e into master Apr 27, 2026
1 check passed
@dr5hn dr5hn deleted the feat/postcodes-colombia branch April 27, 2026 12:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

data:postcodes enhancement New feature or request large-contribution ready-for-review size:XS This PR changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants