Handling Postal Code Exemptions for International Addresses
- Dominant language
- JavaScript
- Stars
- 23
- Forks
- 62
- Avg merge
- 24m
- Merged PRs (30d)
- 1
Description
**Problem Statement:**
- In mid year 2025, as part of the Data Migration work, it was observed that there were records coming from COLIN that were missing the Postal Code value.
- It was determined that there is a list of countries for which the Postal Code should be optional.
**To Do List for this Epic:**
- [ ] Identify all the filings affected by this work.
- [ ] Create all the tickets required.
- [ ] Complete these tickets.
**Requirements:**
- [ ] Where an international Director address is for a country included in an exception list, postal code field becomes optional.
- [ ] See work done previously here https://github.com/bcgov/entity/issues/28496
- [ ] List of exemptions:
- [ ] NO_POSTAL_CODE_COUNTRY_CODES = {
"AO", "AG", "AW", "BS", "BZ", "BJ", "BM", "BO", "BQ", "BW", "BF", "BI",
"CM", "CF", "TD", "KM", "CG", "CD", "CK", "CI", "CW", "DJ", "DM", "GQ",
"ER", "FJ", "TF", "GA", "GM", "GH", "GD", "GY", "HM", "HK",
"KI", "KP", "LY", "MO", "MW", "ML", "MR", "NR",
"AN", "NU", "QA", "RW", "KN", "ST", "SC", "SL", "SX", "SB", "SO", "SR", "SY",
"TL", "TG", "TK", "TO", "TT", "TV", "UG", "AE", "VU", "YE", "ZW"}
- [ ] Impacts: Corps and Coops
**Investigation:**
- Annual Report - Affected - ticket below
- Director Change - Affected - ticket below
- Alteration - Not affected
- Address Change - Not Affected - Addresses need to be in BC
- Bootstrap Filings - Incorporation - Tested - Affected by Directors' addresses
- Bootstrap Filings - Amalgamation - Tested - Affected by Directors' addresses
- Bootstrap Filings - Continuation In - Tested - Affected by Directors' addresses
- Restorations - - Affected by Directors' addresses
- Correction - Affected
- Continuation Out (two filings) - TBD
- Amalgamation Out (two filings) - TBD
Contributor guide
No contributing guide indexed for this repository
Research direction
Start by reviewing issue #28496 and the affected filing categories listed here, especially Annual Report, Director Change, bootstrap filings, Restorations, and Correction. Trace how director international addresses validate postal codes, then verify that the listed country codes permit a missing postal code while other countries retain the requirement. Confirm the unresolved Continuation Out and Amalgamation Out cases before considering the work done.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript
- Domain
- backend
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 30/100