テストデータ

テストがpublicフィールドリテラルや生ORM行で状態を組み立てると、本番では構築できない無効状態を「通る」と誤認する。フィクスチャは公開コンストラクタと本番と同じポート経路を通す。

遷移の期待は 状態遷移、広い入力の法則は プロパティベーステスト、観測のアサーションは ロギングとメトリクス を参照する。

正当なフィクスチャを使う

テストhelperは本番と同じfactoryで有効なIDとstateを構築する。

def requestId(value: String = "req-1"): RequestId =
  RequestId(value).fold(err => throw new IllegalArgumentException(err.toString), identity)

失敗経路を検証するときは .get より Either アサーションを優先する。

helperは src/test/scala/.../support/ やモジュールローカル test パッケージで共有する。fake portパターンは 開発環境 を参照。

コンパイル時安全性テスト

別state型が遷移ソースを強制するとき、munit compileErrors テストで非法stateがコンパイルできないことを確認する：

test("EnRouteRequest is not WaitingRequest"):
  val errors = compileErrors("""
    import example.domain.*
    def onlyWaiting(request: WaitingRequest): Unit = ()
    onlyWaiting(enRouteFixture)
  """)
  assert(errors.nonEmpty)

例： CompileTimeSafetySuite.scala。

フィクスチャから PII を除外する

コミット済みフィクスチャには合成identifierを使う。本番exportをリポジトリにコピーしない。

redacted log、安全errorメッセージ、安全metrics label、敏感データがあるときのresponse DTOシリアライズをobservabilityテストでassertする。識別子ポリシーは ロギングとメトリクス のtierルールに従う。

単体と統合フィクスチャを分離する

単体テストはDBや外部サービスを要求しない。統合テストはより豊かな行/DTOを組み立てても、境界parser経由で変換する。

永続化の実装を変更するときは、正常系に加えてDB制約失敗、楽観的ロック競合、トランザクションロールバック、重複コマンド、idempotency key、outbox insert、event version互換もテストする。純粋なユースケースはフェイクリポジトリで十分。トランザクションと制約に依存する挙動はアダプター統合テストで確認する。

安定した不変条件にはプロパティベーステストを使う

多入力で成り立つ不変条件にはScalaCheck（プロパティベーステスト 参照）。遷移が純関数で不変条件が明示的なKamae Scalaに合う。

PR前に 品質ゲート のテストコマンドを実行する。

レビューでは、public経路を迂回する無効状態の構築、非法遷移テストの欠如、フィクスチャへの本番PII、境界変更の検証不足を指摘する。

レビュー観点

テストはコンストラクタと変換を検証しているか — Medium

publicフィールドや生リテラルで無効なドメイン状態を作るテストを指摘する。

目的がマイグレーション互換、デシリアライズ強化、破損行処理、プロパティ縮小、コンパイル失敗カバレッジである無効構築のテストには指摘しない。

主要な非法遷移はカバーされているか — Medium

拒否される遷移、DTO変換失敗、エラーマッピングのテストがない状態機械コードを指摘する。

境界と可観測性の失敗はテストされているか — Medium

未知フィールド、不正DTO、マスキングされたログ / エラー、リードモデルの安全なシリアライズのテストなしに、境界変更を指摘する。

フィクスチャに本番 PII が含まれていないか — Medium

コミット済みテストデータに実メール、電話、政府ID、本番identifierを指摘する。合成値を使う。

入力全体の不変条件はプロパティテストでカバーされているか — Low

プロパティベーステスト も照合する。値オブジェクト検証、往復、遷移法則に例表カバレッジがなく、ジェネレータが公開コンストラクタを使えるときはプロパティテストを提案する。

設計の中心がコンパイル時安全性ならそれをテストしているか — Low

コンパイル時state安全性が中核の約束なら compileErrors テストを提案する。