テスト仕様 (Test Specification)

方針 (Policy)

リファクタリング等，挙動を変えない変更で処理が変わっていないことを確認するためのテスト仕様．

テストの種類:

ビルドテスト: コンパイルエラーがないことを確認する
回帰テスト: リファクタリング前後の出力が一致することを確認する
セルフテスト: 実機なしで依存ロード・プレビュー経路・校正〜保存を自動確認する（手動テストの前段）
手動テスト: 実機を使って動作を目視確認する

セルフテスト (Self Test)

依存更新やハードウェア結合層の変更後，手動テストの前に実施する（Debug|x64 のみ．手順は ENV_04 の「セルフテスト」，判定は .claude/verify-profile.md．/verify から自動実行できる）．

python scripts/verify/run_selftest.py（依存を変えた場合は --full）
合格条件: 終了コード 0（deps・preview・calib-save の 3 項目が PASS）
代替していない範囲（実カメラ SDK との結合・実プレビュー表示・実チャートの検出性能・画像の見た目・長時間のメモリ/GDI）は，引き続き下記の手動テストで確認する

ビルドテスト (Build Test)

全フェーズで実施する．

手順

Visual Studio で「ビルド」→「ソリューションのビルド」を実行する
エラーが0件であることを確認する
警告が増加していないことを確認する（リファクタリング前の警告数を記録しておく）

合格条件

ビルドエラーが0件

回帰テスト: 色補正処理（フェーズ2）

リファクタリング前に基準データを作成し，リファクタリング後の出力と比較する．

基準データの作成（リファクタリング前に実施）

実機でキャリブレーションを実行する
保存された以下のファイルを「基準データ」として別フォルダに保管する
- TCC_RGB.csv ← チャート24色票のRGB値
- Conv_RGB-sRGB{CN}.csv ← RGB→sRGB 変換行列
- Conv_RGB-XYZ{CN}.csv ← RGB→XYZ 変換行列
- Conv_sRGB-XYZ{CN}.csv ← sRGB→XYZ 変換行列
- TCC_sRGB{CN}.csv ← チャートのsRGB変換値
- sRGB{CN}_0001.jpg ← 撮影した sRGB 変換画像1枚

比較（リファクタリング後に実施）

同一のキャリブレーション画像・撮影条件で再度実行する
- ※ 実機でのキャリブレーション再現が困難な場合は，TCC_RGB.csv を直接入力として行列計算のみ比較する
基準データと出力ファイルを比較する

合格条件

CSV の数値が全行・全列で一致する（または浮動小数点誤差 ±1e-6 以内）
画像のピクセル値が全ピクセルで一致する

※ 2026-08-29 に自動テスト ChartDetectorTests を追加した（合成した AR マーカー画像を入力し，早期 return・上下逆判定・固定判定・24 枚のマスク生成を検証する）．本節の実機による目視比較を置き換えるものではない．自動テストが担保するのは検出ロジックの分岐と幾何であり，実写のノイズ・照明ムラ・レンズ歪み・実際のマーカー印刷品質に対する検出性能は実機でしか確認できない．OpenCvSharp のネイティブ側更新（例: 4.10 → 4.13）を行ったときは，自動テストが緑でも本節の実機比較を必ず実施すること．

基準データの作成（リファクタリング前に実施）

キャリブレーション時に保存される TCC_ROIs.jpg を基準データとして保管する
- ※ TCC_ROIs.jpg はチャートの ROI マスク位置を緑色で重ねた確認画像

比較（リファクタリング後に実施）

同一条件でキャリブレーションを実行する
出力された TCC_ROIs.jpg を基準データと目視比較する
- ※ 緑色のマスク位置が完全に一致していることを確認する

合格条件

マスクの位置・形状が基準データと目視で一致する

手動テスト（全フェーズ）

実機を使った動作確認．フェーズごとに実施する．

確認項目

アプリが正常に起動する
カメラが自動で接続される（Lucam または ImagingSource）
プレビューが表示される
舌診チャートを映すとキャリブレーションが自動開始される
キャリブレーション完了後に撮影ボタンが有効になる
1枚撮影が正常に完了し，ファイルが保存される
連続撮影が正常に完了し，ファイルが保存される
光源の ON/OFF が切り替わる
アプリを閉じてもエラーが出ない

合格条件

上記の全項目でエラー・クラッシュが発生しない