本文へ移動
cccskills
無料GitHub で公開

testing-action

Test or debug application use cases through their public Action API, including persistence, authorization failures, atomic rollback, and post-commit reactions. Use when adding regression tests for business operations.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md2.1 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Testing Actions

Test public handle() behavior, preferably with real domain models and database facilities. Action tests requiring Laravel or a database belong in Feature tests even when no HTTP request occurs. Use the application's TestCase and appropriate database isolation; do not mock Domain models merely to isolate an Action.

For the shared CancelOrder example, cover:

  • An authorized actor cancels a pending order; the persisted state changes and an audit record is written.
  • An unauthorized actor receives an authorization exception; state and audit records remain unchanged.
  • A shipped order raises OrderCannotBeCancelled; no cancellation is persisted.
  • A failure after the order save rolls back both coordinated writes and causes no external reaction.

Fake consumer-owned external contracts or use Laravel's HTTP/Mail/Queue fakes at the relevant boundary. An adapter's HTTP fake tests request/response translation; an Action's contract substitute tests the use case.

Event timing

Separate dispatch assertions from timing tests. Event::fake() can prove dispatch intent; it does not prove a real listener waited for commit. Test the real dispatcher with a harmless recording listener: no reaction inside the transaction, one after successful commit, none after rollback.

Do not rely on a test-wide transaction to commit. For actual after-commit tests, use a database isolation strategy without an enclosing transaction (for example DatabaseMigrations) and explicitly exercise commit/rollback. Fake only the external boundary so no real external effect occurs.

HTTP validation, authentication middleware, exception rendering, and Resources belong in separate entry-point Feature tests. Run the architecture suite for adopted code too.

Read order cancellation for the implementation and connected test examples.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Create, modify, or refactor application use cases into Laravel-native DDD Actions. Use for business operations such as placing or cancelling orders, extracting controller orchestration, and fixing use-case behavior.

日本語の概要は準備中です。原文の説明を表示しています。

maiobarbero/laravel-boost-ddd92026年9月29日 更新

Create or change structured input for application use cases, including extracting HTTP request data for Actions invoked from controllers, jobs, or commands. Avoid DTOs for trivial scalar input.

日本語の概要は準備中です。原文の説明を表示しています。

maiobarbero/laravel-boost-ddd92026年9月29日 更新

Create, modify, or debug business events and their follow-up reactions, including order cancellation events, queued listeners, transaction timing, and rollback behavior.

日本語の概要は準備中です。原文の説明を表示しています。

maiobarbero/laravel-boost-ddd92026年9月29日 更新

Create, extend, or fix Eloquent business models and their state transitions. Use when moving business rules out of controllers or Actions, or explicitly migrating a model into a DDD capability.

日本語の概要は準備中です。原文の説明を表示しています。

maiobarbero/laravel-boost-ddd92026年9月29日 更新

Create or refactor business calculations and rules spanning multiple domain objects when no single entity or value object naturally owns the behavior. Use when assessing a growing service class.

日本語の概要は準備中です。原文の説明を表示しています。

maiobarbero/laravel-boost-ddd92026年9月29日 更新

Add, change, or debug external API integrations, vendor SDK adapters, and bridges to legacy business workflows. Use when an Action or domain service needs an outer technical dependency.

日本語の概要は準備中です。原文の説明を表示しています。

maiobarbero/laravel-boost-ddd92026年9月29日 更新

maiobarbero のスキルをすべて見る

このスキルの問題を報告する