Add a Domain

Create the layer

php artisan osdd:layer functional/invoices \
    --generators=provider,routes,test \
    --requires=functional/orders \
    --composer-update

• provider writes InvoicesServiceProvider, which already loads the layer's migrations, routes, views and translations.
• routes writes the four route files: web.php, api.php, console.php, channels.php.
• --requires declares the dependency on functional/orders in the layer's composer.json, so osdd:check accepts it.
• --composer-update installs the layer, so Laravel discovers its provider.

Generate the resource

php artisan osdd:model Invoice --all --layer=functional/invoices

--all creates every companion inside the same layer:

functional/invoices/
├── src/
│   ├── Models/Invoice.php
│   ├── Policies/InvoicePolicy.php
│   ├── Http/Controllers/InvoiceController.php
│   └── Http/Requests/StoreInvoiceRequest.php, UpdateInvoiceRequest.php
└── database/
    ├── factories/InvoiceFactory.php
    ├── migrations/<timestamp>_create_invoices_table.php
    └── seeders/InvoiceSeeder.php

The seeder is registered in the layer provider with loadSeeders(). The policy needs no registration: Laravel finds Functional\Invoices\Policies\InvoicePolicy for Functional\Invoices\Models\Invoice by convention.

Add the routes

use Functional\Invoices\Http\Controllers\InvoiceController;
use Illuminate\Support\Facades\Route;

Route::resource('invoices', InvoiceController::class);

The provider's withRouting() already mounts this file in the web middleware group. See Routes.

Use the other layer

The migration can reference the orders table, and the model the Order model, because the layer requires functional/orders:

use Functional\Orders\Models\Order;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

public function order(): BelongsTo
{
    return $this->belongsTo(Order::class);
}

Test it

php artisan osdd:test CreateInvoiceTest --layer=functional/invoices
php artisan osdd:phpunit
php artisan test --testsuite=functional/invoices

osdd:phpunit adds the functional/invoices test suite to phpunit.xml. See Tests and CI.

Migrate, seed and check

php artisan migrate
php artisan osdd:seed --layer=functional/invoices
php artisan osdd:check