README

The console (platform admin) panel for Laravel. It is the operator's cross-tenant view of the platform: resellers, plans, and every store with its domains and storefront state.

The panel is presentation. Every state change it performs belongs to a domain package's action, so this package stays thin on purpose.

Requirements

PHP 8.4+
Laravel 13
Filament 5
misaf/vendra-reseller, misaf/vendra-store, misaf/vendra-subscription, misaf/vendra-tenant, misaf/vendra-localization and misaf/vendra-support

Installation

composer require misaf/vendra-console
php artisan migrate

The console_users table and the console guard, console_users provider, and console_password_reset_tokens broker are configured by the host application's config/auth.php and migrations.

The panel

Providers\ConsolePanelServiceProvider registers everything:

served on console.<app host>, derived from app.url — no hard-coded host
console auth guard against Models\ConsoleUser, with the console_users password broker, password reset, and required email verification
top navigation, global search key bindings, database notifications and transactions

It runs outside the tenant middleware stack so an operator can work across every tenant. There is no current tenant: never scope a console query with tenant-aware helpers, and join explicitly where a listing must be per-tenant.

Resources

Resource	Delegates to
`StoreResource`	`Misaf\VendraStore`'s `CreateStorePage` (which runs `ProvisionStoreAction`), `StorefrontConfigurationFields` and `ReplaceDomainAction`
`ResellerResource`	`Misaf\VendraReseller`'s `CreateResellerAction`, `CreateResellerOwnerAction` and `OffboardResellerAction`, plus `misaf/vendra-subscription`'s `SubscribeAction`
`PlanResource`	`misaf/vendra-subscription`'s plan model

DomainsRelationManager manages a store's domains, and ConsoleOverview gives the operator the platform-wide counts.

The console picks a store's billing owner from the form and lets the operator turn off Create storefront. Turning it off creates the store and domain but does not record or provision a managed storefront, which supports storefront source running outside Docker. The reseller panel continues to require a managed storefront.

Layering

This is the topmost layer:

vendra-console → vendra-reseller → vendra-store → vendra-container

Nothing depends on this package, so anything reusable belongs one layer down.

Testing

Act as a ConsoleUser on the console guard. A test that sets up a current tenant is testing the wrong panel. Assert that the domain action ran rather than re-asserting the domain package's own behaviour.

php artisan test --compact --testsuite=vendra-console

License

MIT. See LICENSE.

misaf / vendra-console

Maintainers

Package info

Statistics

Security