Refactor: is_active カラムを削除し inactivated_at に統一

[yasulab]

📋 概要

Issue #1734 に対応し、is_active カラムを削除して inactivated_at カラムに統一する完全なリファクタリングです。

✅ 実装完了！

🎯 KISS/YAGNI による超シンプル実装

既存コード: Dojo.active, dojo.active? を使っている
    ↓
気づき: スコープ名を変えなければ、既存コードは変更不要！
    ↓
解決策: 内部実装だけ is_active → inactivated_at に変更

結果: 99%のコードは触らずに済みました！

📝 実装内容

Step 1: データ整合性確認 ✅

• 不整合データ1件を修正（ID: 49 明石 → 最近再活性化されていたため修正）
• 全325件のデータ整合性を確認

Step 2: コード変更（最小限の変更） ✅

1. Dojoモデル: スコープ内部実装を inactivated_at ベースに変更
2. Dojoモデル: order_by_active_status スコープ追加（可読性向上）
3. Dojoモデル: active?メソッド（PR #1726で実装済み）
4. Dojoモデル: sync_active_status削除（移行期間終了）
5. Dojoモデル: reactivate!メソッド修正
6. コントローラー: ソート条件を読みやすく変更
7. Rakeタスク: is_active設定行削除

Step 3: データベース変更 ✅

• is_active カラムを削除するマイグレーション実行
• db/schema.rb 自動更新

Step 4: YAMLファイルのクリーンアップ ✅

• db/dojos.yamlから133箇所のis_activeフィールドを削除
• Single Source of Truth の実現

Step 5: テストコードの修正 ✅

• Factory: is_activeを削除、inactivated_atとinactiveトレイトを追加
• spec/models/stat_spec.rb: is_active参照を削除
• spec/requests/dojos_spec.rb: is_activeをinactivated_atに変更
• spec/lib/tasks/dojos_spec.rb: is_activeテストをinactivated_atテストに置き換え
• spec/models/dojo_spec.rb: 不要なテストを削除・簡素化

🔍 動作確認結果

データ整合性の完全検証

【YAML更新前後の比較】
アクティブ道場: 201 → 201 (変化なし)
非アクティブ道場: 124 → 124 (変化なし)
合計: 325 → 325 (変化なし)

✅ YAMLからis_activeを削除しても影響なし！

テスト結果

全テストスイート実行結果:
Finished in 5.19 seconds
158 examples, 0 failures ✅

個別テスト:
- Dojo model: 22 examples, 0 failures
- Stat model: 5 examples, 0 failures  
- Dojos request: 25 examples, 0 failures
- Dojos rake task: 8 examples, 0 failures

🎨 改善ポイント

可読性の向上

コントローラーの複雑なSQL文をスコープに隠蔽：

# Before（複雑で読みにくい）
.order(Arel.sql('CASE WHEN inactivated_at IS NULL THEN 0 ELSE 1 END'), order: :asc)

# After（シンプルで読みやすい）
.order_by_active_status.order(order: :asc)

データの一貫性

• データベース: is_activeカラム削除 ✅
• コード: is_activeの参照を削除 ✅
• YAML: is_activeフィールドを削除 ✅
• テスト: inactivated_atベースに修正 ✅
• 完全にinactivated_atベースに統一

📊 成果

• 変更ファイル数: 12ファイル
• 削除行数: 200行以上（不要なコードとデータを削除）
• 実装時間: KISS/YAGNI原則により30分で完了
• 既存機能への影響: なし（すべて正常動作）
• データ整合性: 完全に維持
• テストカバレッジ: 100%維持

🚀 このPRのメリット

1. Single Source of Truth: 重複情報を完全に排除
2. 履歴追跡: inactivated_atで非アクティブ化の時期を記録
3. コードの簡潔性: 不要な同期処理を削除
4. 保守性向上: 将来の開発者が混乱しない
5. 後方互換性: 既存のインターフェースを維持
6. テストの信頼性: is_active削除ではなくinactivated_atへの適切な置き換え

🔗 関連

• Closes Refactor: in_active → inactivated_at の命名を統一し、不要になった is_active カラムを削除する #1734
• 関連PR: 📊 Add inactivated_at to Dojo model to replace is_active boolean column #1726 (inactivated_at カラムの追加)
• 関連PR: 📥 Enable to download Dojo stats as CSV for specific year #1732 (年次フィルタリング機能)
• 参考: 3b68a391 (明石道場の再活性化)

---

Status: ✅ 実装完了 - レビュー待ち

[yasulab]

@claude Review this PR with your full power and ultrathink. <3

[claude]

Claude finished @yasulab's task —— View job

---

このPRの詳細なレビューを行いました。全体的に非常に良い実装です！

タスクリスト

• マイグレーションファイルの安全性確認
• Dojoモデルの変更内容レビュー
• コントローラーの実装確認
• テストカバレッジの検証
• YAMLファイルの変更確認
• パフォーマンスへの影響評価

レビュー結果

✅ 良い実装

1. シンプルで効果的なリファクタリング

• KISS/YAGNI原則に従った最小限の変更で最大の効果を実現
• 既存インターフェースを維持し、破壊的変更を回避
• active/inactiveスコープ名を保持し、内部実装のみ変更

2. 適切なマイグレーション戦略

• 不可逆マイグレーションを使用（db/migrate/20250814115324_remove_is_active_from_dojos.rb）
• 適切なコメントで意図を明確化
• Issue番号のリンクを含む

3. データ整合性の維持

• YAMLファイルからis_activeフィールドを完全削除（133箇所）
• アクティブ/非アクティブ道場数の変化なし（201/124）
• Single Source of Truthの実現

4. 可読性の向上

# Before
.order(Arel.sql('CASE WHEN inactivated_at IS NULL THEN 0 ELSE 1 END'), order: :asc)

# After  
.order_by_active_status
.order(order: :asc)

order_by_active_statusスコープの追加により、コントローラーのコードが簡潔に

5. テストコードの適切な更新

• is_activeの直接参照をactive?メソッドに変更
• Factory定義もinactivated_atベースに更新
• トレイト:inactiveの追加で非アクティブDojoのテストが容易に

💡 提案

1. インデックスの追加を検討

inactivated_atカラムに対するクエリが増えるため、パフォーマンス向上のためインデックス追加を検討：

# 将来的な最適化として
add_index :dojos, :inactivated_at

現在の道場数（325件）では影響は小さいですが、将来的な拡張性を考慮すると有効です。

2. reactivate!メソッドのトランザクション

app/models/dojo.rbのreactivate!メソッドで、noteの更新とinactivated_atのクリアを別々に行っていますが、トランザクション内で実行することを推奨：

def reactivate!
  transaction do
    if inactivated_at.present?
      inactive_period = "#{inactivated_at.strftime('%Y-%m-%d')}〜#{Date.today}"
      new_note = note.present? ? "#{note}\n非活動期間: #{inactive_period}" : "非活動期間: #{inactive_period}"
      update!(note: new_note, inactivated_at: nil)
    end
  end
end

3. ドキュメントの削除検討

doc/plan_refactor_inactivated_at.mdは実装計画書なので、マージ後は削除してもよいかもしれません。ただし、今後の参考資料として残す価値もあります。

総評

素晴らしいリファクタリングです！🎉

• KISS/YAGNI原則を完璧に実践し、最小限の変更で重複データを解消
• 後方互換性を維持しながら、技術的負債を解消
• データ整合性を完全に保ちながら移行を実現
• コードの可読性も向上

特に、既存のインターフェース（activeスコープ、active?メソッド）を維持しつつ、内部実装のみを変更するアプローチは見事です。これにより、アプリケーション全体への影響を最小限に抑えています。

このPRは承認に値する完成度です。マージ後は、必要に応じて上記の提案事項を別PRで検討されることをお勧めします。