Skip to content

feat(postcodes): 54 Caribbean postcodes β€” KY,BB,TT (#1039)#1534

Merged
dr5hn merged 1 commit into
masterfrom
feat/postcodes-caribbean-3
May 6, 2026
Merged

feat(postcodes): 54 Caribbean postcodes β€” KY,BB,TT (#1039)#1534
dr5hn merged 1 commit into
masterfrom
feat/postcodes-caribbean-3

Conversation

@dr5hn
Copy link
Copy Markdown
Owner

@dr5hn dr5hn commented May 6, 2026

Summary

Adds postcode coverage for three Caribbean territories that previously had no #1039 data. Bundle pattern follows the recently-merged singleton-territory PRs (#1526, #1527, #1530).

iso2 Country Records State FK
KY Cayman Islands 9 100%
BB Barbados 19 100%
TT Trinidad & Tobago 26 100%
Total 54 100%

Source

  • Repo: usama216/shipping-market β€” Laravel CaribbeanLocationSeeder.php, hand-curated parish/district + postcode data for 22 Caribbean territories.
  • Provenance: Postal codes themselves are factual data published by the national postal services (Cayman Post, Barbados Postal Service, TTPost) and are not copyrightable.
  • Per-row attribution: source: "shipping-market-caribbean-seeder".
  • License caveat: Upstream repo ships without a formal license. Per CSC's feedback_postcode_pipelines.md source-class taxonomy this is Tier 5 (free redistribution, flagged in PR description). Because we redistribute only the codes themselves (facts), not the seeder's structure or surrounding code, reuse is acceptable.

State FK resolution

  • KY: 3 islands matched directly by name (Grand Cayman, Cayman Brac, Little Cayman).
  • BB: 11 parishes matched directly by name (Saint Michael β†’ 08, Christ Church β†’ 01, etc.).
  • TT: 15 administrative areas matched by name (Port of Spain β†’ POS, Tobago β†’ TOB, etc.). One alias for Mayaro-Rio Claro (seeder) β†’ Rio Claro-Mayaro (CSC, MRC).

Importer

  • bin/scripts/sync/import_caribbean_postcodes.py β€” fetches the PHP seeder, walks parish anchors, scans 'city' => ['postal_code' => '...'] literals, idempotent merge by (code, locality_name).

Resolves a Tier-E gap from bin/scripts/sync/POSTCODES_1039_SOURCES_RESEARCH.md.

πŸ€– Generated with Claude Code

Cayman Islands (9), Barbados (19), Trinidad & Tobago (26) β€” main
settlements per parish/district. All 54 records carry state_id (100%
FK match). Source: usama216/shipping-market PHP seeder; postcodes are
factual data published by the respective national postal authorities
(Cayman Post, Barbados Postal Service, TTPost).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@dosubot dosubot Bot added the size:XS This PR changes 0-9 lines, ignoring generated files. label May 6, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 6, 2026

CSC Validation Report

PR Format

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

Labels applied: data:postcodes

Schema Validation (54 records)

βœ… All records passed validation

Cross-Reference Validation

βœ… 108 reference(s) verified

Source URL Verification

βœ… 2 source URL(s) accessible


βœ… All checks passed | Status: Ready for review

@dosubot dosubot Bot added the enhancement New feature or request label May 6, 2026
@dr5hn dr5hn merged commit 0affe71 into master May 6, 2026
1 check passed
@dr5hn dr5hn deleted the feat/postcodes-caribbean-3 branch May 6, 2026 13:01
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 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.

1 participant