aureuserp-test-case-builder

AureusERP テストケースビルダー

テスト専用の修正と再利用可能なヘルパーを使って、Pest でプラグイン API テストを作成するためのスキルです。

対応範囲

1. API テストケース（現在有効）

• エンドツーエンドのワークフロー、ヘルパーの責任範囲、アサーション、ガードレールについては、references/api.md に従ってください。

2. Filament テストケース（将来用に予約）

• このスキルに Filament 固有のテストルールを今の時点で作らないでください。
• API の規約は変更しないでください。
• 後で Filament のガイダンスを追加する場合は、別のリファレンス（例：references/filament-*.md）として追加し、タスクの種類に応じて明示的に選択してください。

基本ルール

1. API エンドポイントには Pest のフィーチャーテストを使用してください（getJson、postJson、patchJson、deleteJson）。
2. セットアップとペイロードの作成には、ファクトリーを優先してください。
3. ヘルパーの責任範囲は厳密に分けてください。

• SecurityHelper は認証／権限／ガードを担当します。
• TestBootstrapHelper はセキュリティ以外のブートストラップとプラグインのインストールを担当します。

4. テストファイルでは RefreshDatabase や LazilyRefreshDatabase を使用しないでください。グローバルな DatabaseTransactions の設定を使用してください。
5. アプリケーションコードを編集する前に、テスト／ヘルパーの修正を優先してください。
6. 解決策としてスキップを使用しないでください。

クイックルーティング

1. API コントローラーのエンドポイントテスト（index/store/show/update/destroy、認証、バリデーション、復元／完全削除）には、references/api.md を使用してください。
2. ヘルパーの整理を伴う API のリファクタリング／バグ修正には、references/api.md を使用してください。
3. 新しいプラグイン API テストファイルのテンプレート生成には、references/api.md を使用してください。

出力要件

1. テストの対象はプラグインの範囲内に限定し、再利用可能にしてください。
2. アサーションは決定的なものにし、JSON リソースに沿ったものにしてください。
3. ペイロードはファクトリーを優先し、必要な箇所のみ上書きしてください。
4. インストール／ブートストラップは、対話を必要とせず、環境に安全な方法で行ってください。