個人開発 » beatoraja

実装に着手しました。

• ブランチ: feature/178
• 対応方針: 検証用 *Smoke(Gradle verify* タスク用 main エントリ)を *Verification へリネームして JUnit スモークテストと名前で区別し、各クラス・Gradle タスクに用途/前提/実行方法のコメントを付与。さらに検証コード全体(検証エントリ/JUnit スモーク/experimental の @Disabled PoC)の地図となる docs/verification.md を新設し、README・関連 docs から参照する。

対応が完了しました。

概要¶

検証コードが性質の異なる3種類「Smoke」名で混在し境界が分かりにくかった問題を、命名規約とドキュメントで整理。削除候補と誤認されにくく、保守者に用途が分かる状態にした（ロジック変更・ソースセット分離はなし）。

変更点¶

• A群（Gradle verify* タスク用 main エントリ）をリネーム: PortAudioDevicesSmoke / PortAudioPlaybackSmoke / Lwjgl3BackendSmoke / FfmFfmpegDecoderSmoke → それぞれ *Verification。本文ロジックは無変更。build.gradle の4タスクの mainClass も更新。
• A群各クラスに Javadoc（用途・非JUnit・実行タスク名・引数/前提・保守対象）を付与。verify* タスクに「手動/ローカル検証用で test には含まれない」コメントを追加。
• B群（test で常時走る JUnit スモーク）: LauncherFxmlLoadSmokeTest / SQLiteDependencySmokeTest に「A群とは別物」のクラスコメントを追加（リネームなし）。
• C群（experimental の @Disabled PoC）: package-info.java を新設、FfmApiSmokeTest に docs 参照コメントを追加。
• ドキュメント: 新規 docs/verification.md（A/B/C 3層の地図・検証エントリ一覧表・命名規約 *SmokeTest vs *Verification・通常 test に環境依存が混入しない保証）。README.md / docs/audio-testing.md / docs/codebase-overview.md をクラス名整合・クロスリンク更新。
• 変更ファイル: リネーム4・新規3（docs/verification.md, experimental/package-info.java ほか）・更新7、計16件。

テスト¶

• .\gradlew.bat test : 成功（BUILD SUCCESSFUL、全スイート通過）
• net-new テスト追加なし（機械的リネーム＋コメント＋ドキュメントのみ＝TDD例外）

関連 MR¶

• !133 (feature/178 → develop)