Python-Holidays 项目中关于澳门行政区划代码的技术解析

在 Python-Holidays 项目中实现澳门节假日功能时，开发团队遇到了一个关于行政区划代码的技术问题。澳门历史上分为"澳门"和"海岛"两个市，这两个行政区拥有各自的特殊节假日，但在 ISO 3166-2 标准中目前没有提供官方的行政区划代码。

澳门行政区划背景

澳门作为中国的特别行政区，历史上曾划分为两个市：

1. 澳门市（Macau）
2. 海岛市（Ilhas）

这种划分在澳门本地法律中有明确规定，包括多项法令如《第4/82/M号法令》、《第38/87/M号法令》等，这些法律文件确立了各市拥有自己的特殊节假日。

技术实现方案

由于 ISO 3166-2 标准中缺少澳门内部的行政区划代码，开发团队考虑了以下解决方案：

1. 使用完整名称：类似于意大利城市的处理方式，直接使用"Macau"和"Ilhas"作为标识符
2. 采用HASC编码：从statoids网站获取的Hierarchical Administrative Subdivision Codes
   • MO.MA 代表澳门市
   • MO.IL 代表海岛市

未来兼容性考虑

针对项目v1版本计划中的ISO合规性要求，开发团队建议：

• 使用CN-MO-M和CN-MO-I作为未来标准代码
• 这种编码方式符合中国行政区划的层级结构
• 为将来可能的ISO标准更新预留空间

技术架构影响

这一案例引发了关于项目支持多级行政区划的讨论。开发团队认为，项目架构应该支持任意层级的行政区划嵌套，这将有利于：

• 支持意大利城市级别的节假日（如Barletta-Andria-Trani）
• 支持西班牙等国家的次级行政区划
• 保持系统的灵活性和扩展性

实施建议

对于类似情况的技术实现，建议：

1. 优先使用最接近ISO标准的编码方案
2. 为未来可能的ISO更新预留接口
3. 在文档中明确标注非标准编码的来源和依据
4. 考虑建立内部映射机制，便于未来标准更新时的平滑迁移

这一技术决策不仅解决了澳门节假日实现的具体问题，也为项目处理类似行政区划情况提供了参考模式。