HOME機能の概要

概要

HOME機能は、アプリケーションのメインメニュー画面を提供し、各機能への入り口となる機能群です。ユーザーが最初に接触するインターフェースであり、直感的なナビゲーションを提供します。

主要機能

メニュー選択

ボタン	機能
START	ゲーム本体（DUNGEON）へ遷移
CONFIG	設定画面（CONFIG）へ遷移
LOAD	セーブデータ管理（SAVE）へ遷移
EXIT	アプリケーション終了

画面構成

背景表示: ゲームのメイン画像・ロゴ
メニューボタン: 4つの主要機能へのナビゲーション
BGM再生: ホーム画面専用の音楽再生
マウス操作: クリックによる直感的な操作

技術仕様

アーキテクチャ

HOME機能は完全な3層構造で実装されています：

Controller層 (common/home/*.py) - 外部I/Oの処理
Service層 (common/home/service/*.py) - ビジネスロジック
Component層 (common/home/service/component/*.py) - 再利用可能な部品

状態管理

画面状態: HOME画面の表示状態管理
ボタン状態: 各ボタンのホバー・クリック状態
音楽状態: BGM再生の開始・停止制御

データフロー

マウスクリック
     ↓
HOME Controller（クリック判定）
     ↓
HOME Service（遷移先決定）
     ↓
システム状態更新（次画面へ遷移）

関連ファイル

Controller層

common/home/display.py - 画面描画処理
common/home/sound.py - 音声再生処理
common/home/status.py - 画面遷移処理

Service層

common/home/service/display.py - 描画制御ロジック
common/home/service/sound.py - 音声制御ロジック
common/home/service/status.py - 状態遷移ロジック

Component層

Display Validator系

common/home/service/component/displayRequestValidator.py - ディスプレイリクエストバリデーション

Display Manager系

common/home/service/component/displayScreenManager.py - 画面描画管理とリカバリー処理

Sound Validator系

common/home/service/component/soundRequestValidator.py - サウンドリクエストバリデーション

Sound Manager系

common/home/service/component/soundChannelManager.py - 音声再生管理

リクエスト・レスポンス

common/layer/request/home/*.py - HOME機能のリクエストオブジェクト

今後の拡張予定

設定プレビュー: ホーム画面での現在設定の表示
最近のセーブデータ: 直近のプレイ情報表示
アニメーション: ボタンやロゴのアニメーション効果
多言語対応: メニューの国際化対応