📝 はじめに

こんにちは、piyovateです。
これまでフォロワー数の可視化や音による通知など、様々な機能を追加してきました。

今回はちょっと趣向を変えて、「コードの整理と保守性向上のためのリファクタリング」に取り組んだ内容を紹介します！
プロジェクトが大きくなってきた今こそ、土台の整備が重要ですね💡

また今回は、Anthropic社のAI「Claude」からもコード改善のアドバイスをもらいながら進めました。
自分一人では見落としていた視点にも気づけて、非常に実りあるリファクタリングになりました。

🎯 今回の概要

ディレクトリ構成の整理とパッケージ化
ログ機能の追加と安全なエラーハンドリング
設定ファイルの分離と管理強化
import文の統一による開発効率向上

🔗 GitHubでコードを公開中

最新コードやセットアップ手順は以下のリポジトリにて👇
🔗 GitHub - SystermDevelopment/follower-counter

📂 プロジェクト構成を再編成！

■ Before

follower-counter/
├── main.py
├── ui.py
├── config.py
├── QiitaAPI.py
├── xAPI.py
└── ...

すべてがルート直下に並ぶ構造で、規模が大きくなると見通しが悪くなっていました。

■ After

follower-counter/
├── src/
│   ├── api/        # 各SNS連携モジュール
│   ├── ui/         # UI関連（PyQt）
│   └── utils/      # ログ・設定・サウンド
├── settings/       # 設定ファイル（JSON）
├── logs/           # ログ出力
├── data/           # データ保存用
└── requirements.txt

モジュールごとに整理したことで、チームでの開発や長期運用にも対応しやすくなりました✨

📝 ログ出力でデバッグが快適に！

■ logger.pyを新設！

モジュールごとに個別のログファイルを出力しつつ、
コンソール出力とファイル出力のレベルを settings.json から制御できるようにしました。

logger = setup_logger('QiitaAPI', 'qiita.log')
logger.info("Qiita合計いいね数取得開始")

■ セキュリティ配慮も追加！

APIレスポンスなど、ログに機密情報が載らないよう以下のように工夫：

logger.error("レスポンス内容: [詳細はデバッグログを確認]")
logger.debug(f"レスポンス詳細: {res.text[:200]}...")

Git管理からも logs/ を除外し、開発環境にやさしい構成に👌

⚙️ 設定ファイルの分離と強化

settings/settings.json を使って、アプリの挙動を外からコントロール可能に！

{
  "compare_days_ago": 7,
  "daily_json": "./data/daily_followers.json",
  "sound_volume": 50,
  "logging": {
    "console_level": "INFO",
    "file_level": "DEBUG",
    "enabled": true
  }
}

.env ファイルにはAPIトークンなどの機密情報を分離し、セキュリティと移植性を両立しました✨

📦 importも明示的に統一！

従来のようなトップレベルのモジュール呼び出しから、明示的なパス指定に変更：

# Before
import QiitaAPI

# After
import api.qiita as QiitaAPI

IDE補完や静的解析にも強くなり、開発効率が上がりました💡

✅ リファクタリングの成果

モジュール構造の整理で、コードの見通しが改善
ログ機能の導入で、デバッグや障害調査が楽に
機密情報の扱いが明確化され、安全性が向上
環境に応じた設定の柔軟な切り替えが可能に！

🤖 Claudeとの共同リファクタリング

今回のリファクタリングでは、Anthropic社のAI「Claude」にも協力してもらいました。
構成の整理やログ設計など、自分だけでは気づけなかった観点も多く、とても参考になりました。

AIと一緒にコードを書くのはまだ試したことがない方も多いと思いますが、
視点の補完やリファクタリングの相談役として、かなり心強い存在です💡

🙏 さいごに

今回は地味だけど超重要な「裏方作業」でした！
少しでもプロジェクトがスッキリして嬉しいです😊

「うちも整理したい…！」という方の参考になれば幸いです。
いいね・フォローストックもお待ちしています！

🔗 シリーズリンク

第1回：🌟Raspberry PiでSNSフォロワーカウンターシステムを作る【第1回：仕様決定会議編】

📚 全記事まとめはこちら → シリーズまとめリンク