Skip to content
cccskills
FreePublished on GitHub

testing-domain

Test or fix domain rules, state transitions, value objects, and domain services directly. Use for business-rule regression tests, rejected transitions, and model behavior without HTTP.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md1.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Testing Domain behavior

Test public behavior at the lowest useful level. Use Unit tests for pure PHP behavior. Use Feature tests with Laravel's TestCase when Eloquent behavior needs the framework or database; being a Domain test does not imply it is a pure unit test.

For Order::cancel(), verify that a pending order becomes cancelled in memory, a shipped order raises OrderCannotBeCancelled, and cancellation does not save itself. Persist an order in a database-backed test, invoke cancel(), and compare the in-memory status with a fresh query; persistence is the Action's responsibility.

If Domain produces events, assert the resulting fact and payload through its public API without requiring a particular internal event collection. Dispatch timing belongs in Application tests.

For Value Objects, test invalid construction and meaningful value behavior. For domain services, test business outcomes with real domain objects and substitute only external contracts when needed. Avoid testing private methods or mirroring implementation details.

Keep Eloquent factories in database/factories, with explicit mappings for relocated models when needed. Prefer factories and Laravel database facilities over mocked Eloquent behavior.

See order cancellation for a rejected-transition test and the surrounding application flow. Run architecture tests when changing adopted code.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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.

The English summary is being prepared. Showing the original description.

maiobarbero/laravel-boost-ddd11Updated Sep 29, 2026

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.

The English summary is being prepared. Showing the original description.

maiobarbero/laravel-boost-ddd11Updated Sep 29, 2026

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

The English summary is being prepared. Showing the original description.

maiobarbero/laravel-boost-ddd11Updated Sep 29, 2026

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.

The English summary is being prepared. Showing the original description.

maiobarbero/laravel-boost-ddd11Updated Sep 29, 2026

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.

The English summary is being prepared. Showing the original description.

maiobarbero/laravel-boost-ddd11Updated Sep 29, 2026

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.

The English summary is being prepared. Showing the original description.

maiobarbero/laravel-boost-ddd11Updated Sep 29, 2026

See all skills by maiobarbero

Report a problem with this skill