Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.6.1] - 2026-05-06

郵便番号データを 2026 年 5 月版に更新（KEN_ALL.CSV）。
- 石狩市の合併特例法に基づく地域自治区「厚田区」「浜益区」が 2026/3/31 に設置期限を迎え、4/1 から「区」を抜いた表記に変更されたことを反映。
- 関連: 北海道・東京・長野・山梨・岐阜・大阪・奈良・石川・福島・宮城の一部町域名の整理。

basho_postal のマッピングオプション指定時の住所自動解決を before_save から before_validation に変更。validation の前に住所が解決されるため、validation や他の before_validation callback から解決済みの住所を参照できる。既存ユーザーで before_save のタイミングに依存していた場合は要見直し。

with_basho スコープ — city・prefectureをeager loadしN+1クエリを防止（メモリモードではno-op）
has_one :basho_prefecture — prefecture直接プリロード対応（DBモード）
Basho::DB::City に廃止・合併管理機能（deprecated_at, successor_code, #current, .active, .deprecated）
Basho::City（メモリモード）にも同等の廃止・合併API（#deprecated?, #active?, #successor, #current）
Basho::DB.seed_fresh? — DBデータの鮮度チェック（Rails起動時に自動警告）
rails generate basho:upgrade_deprecation — 既存テーブルに廃止管理カラムを追加するマイグレーションジェネレータ
MAX_SUCCESSOR_DEPTH — 合併チェーン探索の深度制限（ループ検出に加えた安全弁）

Basho::DB.seed! を delete_all + insert_all! から upsert_all に変更（手動設定の successor_code / deprecated_at を保持）
gemデータから消えた市区町村を物理削除ではなく論理削除（deprecated_at を設定）に変更
basho マクロのリファクタリング（DB/メモリモードの分離、メソッド分割）

BREAKING: PostalCode.find() が配列ではなく単一の PostalCode または nil を返すように変更
BREAKING: PostalCode.where() がキーワード引数 where(code:) に変更
BREAKING: カスケードセレクト機能を削除（Stimulusコントローラー、都道府県/市区町村JSON API、フォームヘルパー）
BREAKING: 郵便番号JSONのキー名 city → city_name、都道府県JSONのキー名 region → region_name に統一
auto_fill_controller.js をTurboイベント駆動にシンプル化（デバウンス削除）
PostalAutoResolve をシンプルなcase文ベースに簡素化
市区町村データソースを jp_local_gov gem から KEN_ALL.CSV に変更（外部gem依存を撤廃）
districts.rb のロジックを cities.rb に統合