README

The console (platform admin) panel for Laravel. It is the console user'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-activity-log, misaf/vendra-localization, misaf/vendra-user and misaf/vendra-support

Installation

composer require misaf/vendra-console
php artisan migrate

The consoles table holds one row per canonical user (misaf/vendra-user) allowed into the panel, and only active rows grant access; the host application's config/auth.php points the console guard at the tenantless console provider and the console password broker, whose reset tokens live in console_password_reset_tokens. Console users hold no tenant or reseller relationship. No credentials are configured for the first one: on a fresh install ConsoleSeeder creates it at the vendra-console.default_email address (VENDRA_CONSOLE_DEFAULT_EMAIL, default console@vendra.test) with the explicit username console and a generated password, and prints it once to the seed output (the container's first-boot log). That address is a plain config value rather than something derived from app.url, and it is validated by UserRules::email() like every other address in the application, so a dotless domain such as console@localhost is rejected.

Five commands manage console users; each does one job and points at its sibling when the user it names is in the wrong state.

php artisan vendra-console:user-create creates a console user with --username, --email and --password. --username and --email are both required and are asked for when omitted from an interactive run (the configured address belongs to the seeded user, so the command never falls back to it); the password is generated unless --password is given. It never turns into a password reset or a grant: when the address or username already belongs to a tenantless user, the run fails and points at user-grant and user-password.
php artisan vendra-console:user-password issues a new password to an existing console user, found by --username, --email or both, and falling back to the configured address when a run without interaction gives neither. It asks before replacing a password with a generated one; --password or --force skips that prompt, and a run without interaction fails and points at them instead of prompting. It never creates a user and never grants access: an unknown user or one without console access fails with a pointer.
php artisan vendra-console:user-grant grants console access to an existing tenantless user, reactivating a revoked console rather than adding a second row, and optionally sets a password with --password. It takes --email, --username or both, and reports a user who already has access without changing anything. Given --password for a user who already has access it fails and points at vendra-console:user-password.
php artisan vendra-console:user-revoke deactivates the user's console while keeping the user, and refuses to deactivate the last active console user. It names the user the same way.
php artisan vendra-console:user-two-factor-reset removes the authenticator app and recovery codes of a console user who lost both, so they set it up again on their next sign-in. It names the user like user-revoke, asks before resetting unless --force is given, and reports a user without two-factor without changing anything. There is deliberately no panel control for this, so one console account cannot remove another's second factor.

user-create, user-password and user-grant ask for the password without echoing it when --password is given without a value, which keeps it out of shell history and the process list. Without interaction that fails rather than falling back to a generated one. An answer to any of these questions that fails the user rules is rejected and asked for again.

When an interactive user-grant, user-revoke or user-password run gives neither --email nor --username, it searches tenantless users by email or username and lets you pick one: users without console access for user-grant, console users for the other two. When nobody fits, the run fails with a message instead of searching. Without interaction, user-grant and user-revoke require an identifier instead.

Every command that takes both --email and --username requires them to resolve to the same tenantless user: an identifier that names nobody fails naming it, and two that name different users are rejected as mismatched. A blank identifier is rejected. Usernames must contain 3–12 letters, numbers, dashes, or underscores and be unique among tenantless users that have not been soft-deleted; duplicates fail rather than receive an automatic suffix. Supplied and generated passwords must pass the application's default password rules, so an explicitly empty or whitespace-only password is rejected. Generated passwords come from PasswordGenerator::generate(), so tightening the policy in a provider never leaves a command unable to issue one.

The panel

Providers\ConsolePanelServiceProvider registers everything:

served on the console. subdomain of vendra-tenant.central_host, the host in APP_URL
console auth guard against the canonical User (misaf/vendra-user) through the tenantless console provider and the console password broker, whose reset tokens live in console_password_reset_tokens; panel access is granted by an active consoles row, with password reset and required email verification
top navigation, global search key bindings, database notifications and transactions
required two-factor authentication through an authenticator app, with recovery codes: a console user without one is sent to set it up before any page, and manages it from the profile page

It runs outside the tenant middleware stack so a console user 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 provisioning, lifecycle, storefront, domain, billing-reseller, and offboarding actions; administrator membership delegates to `misaf/vendra-user`
`StorefrontDeploymentResource`	Read-only deployment history, with live observation through `StorefrontProvisioner` in the lazy `StorefrontRuntimeObservation` footer widget; recovery delegates to `vendra-store` actions
`ResellerResource`	`Misaf\VendraReseller`'s reseller/user account actions and `misaf/vendra-subscription`'s lifecycle actions
`PlanResource`	`misaf/vendra-subscription`'s plan model; the form edits the plan's `PlanFeature` flags and one field per `PlanLimit`, where an empty limit means unlimited
`ActivityLogResource`	`misaf/vendra-activity-log`'s model, read-only and across every tenant
`InvoiceResource`	`misaf/vendra-subscription`'s issued invoices, read-only, filtered by reseller, with an on-demand PDF download

DomainsRelationManager (a subclass of vendra-store's) manages a store's domains, like AdministratorsRelationManager manages its administrators: its header action adds an alias and each alias row can be removed (soft-deleted, so it stays listed as trashed history). The primary domain, the one the store was created with, cannot be replaced, demoted or removed.

The store and reseller lists carry header stats: Stores\Widgets\StoreStatusOverview counts every store per status and failed storefronts, and Resellers\Widgets\ResellerSubscriptionOverview counts resellers by subscription health and over-plan; each stat opens the list with the matching filter. The store view page shows Misaf\VendraStore\Filament\Widgets\StorePlanUsage for a store whose plan sets limits. The reseller view shows every column of the reseller list, and its user account section mirrors the user list (username, email, email verification, created and updated).

The console dashboard (Filament\Pages\Dashboard) lists its widgets by urgency. NeedsAttention shows only what a console user should act on — stores still provisioning or failed, failed storefront deployments, past-due subscriptions, payments awaiting review, subscriptions ending within a week, and jobs that failed in the last day (counted only when the failed-job driver stores them in the database) — each linked to the filtered list that resolves it, and collapses to one all-clear stat when there is nothing. PlatformMetrics shows store, reseller and subscription totals and this month's paid revenue per currency against last month's. PlatformGrowthChart plots new stores and resellers, and subscriptions started (renewals and plan changes included), per day over 7, 30 or 90 days. Both count offboarded records too, so past days never shrink. RecentActivity lists the latest audit entries.

ContainerRuntimeHealth never contacts the runtime: only the storefront worker holds the runtime socket. The scheduler dispatches vendra-store's RecordStorefrontRuntimeHealthJob onto the storefronts queue every minute, and the widget reads the report it records through StorefrontRuntimeHealth, warning when no report exists or the last one is more than five minutes old.

Store rows expose suspend/reactivate, provisioning recovery, managed storefront start/stop/restart/redeploy/retry/reconcile, deployment viewing, recent logs, safe offboarding, and restoration. The deployment resource filters by status, store, and request date and exposes confirmed recovery controls without copying provisioning logic into Filament. The edit page manages store administrators without permitting the final enabled administrator to be removed, demoted, or disabled. Reseller row actions manage user credentials/account replacement, two-factor reset for a reseller user who lost their authenticator, and subscription change, renewal, extension, cancellation, and reactivation; a plan change or renewal whose plan cannot hold the reseller's current stores is disabled and labelled in the plan picker, and refused with a notification if it slips through. Plan changes go through Misaf\VendraSubscription\Actions\ChangeSubscriptionPlanAction: each option is labelled with its effect, an upgrade applies now with a prorated charge up to the current end date, a downgrade is scheduled for the period end, and picking the current plan drops a scheduled change. A change that charges now is refused with the charge and balance when the wallet cannot cover it, so staff credit the wallet first. Renewal is offered only when nothing is running and no renewal awaits payment, and goes through Misaf\VendraSubscription\Actions\RenewSubscriptionAction: it takes a scheduled downgrade unless the stores have outgrown it (the modal says so and the renewal stays on the current plan), keeps the auto-renew choice, and continues from the old end date while within grace. The reseller table and overview show whether the active plan includes priority support, and the table filters by it. Like the user list, the table shows the main account's username, email and email verification (reusing vendra-user's columns) and filters by them with a query builder over the user relationship. The Credit wallet row action records a payment the reseller made outside the platform through Misaf\VendraReseller\Actions\CreditResellerWalletAction (amount in minor units, a platform currency or one the reseller already holds, and a required note), and the reseller overview lists the wallet balance per currency. Each control invokes the owning domain package; no meaningful transition is an Eloquent column toggle. Every password form uses the shared NewPasswordInput and PasswordConfirmationInput fields.

Currencies

Resources\Currencies\CurrencyResource manages the platform's currencies, the tenantless currencies rows, reusing misaf/vendra-currency's form, table and catalog install. A plan's currency is picked from them (the platform default comes preselected) and stays with the plan: changing the default later changes no plan, and every subscription, payment and invoice keeps the currency it was created in. Support\PlatformCurrencies lists the options and keeps a record's own code selectable after its currency is deactivated.

Languages and translations

Resources\Languages\LanguageResource and Resources\LanguageLines\LanguageLineResource manage the platform's tenantless languages and translation overrides. They reuse misaf/vendra-language's forms, tables, and synchronization action. Store languages and translations remain separate from platform rows.

Assigning a store to a reseller

The Assign reseller row action moves a store to another reseller, or back to the platform when no reseller is chosen. It runs Misaf\VendraStore\Actions\AssignStoreResellerAction, which takes the same row lock and quota check as creating a store — a reassignment consumes a slot in the receiving reseller's plan — and reports a full plan as a notification rather than writing the column anyway. This is why reseller_id is not an editable form field. The action is hidden for offboarded stores, which the domain action refuses.

Activity

ActivityLogResource is the platform's audit trail. It is deliberately the console's own resource rather than the clustered, permission-gated one misaf/vendra-activity-log registers on the admin panel: a console user holds no tenant roles and is trusted by panel access alone, so the read is granted here and every write stays closed. Rows arrive unscoped because the tenant scope applies only while a tenant is current and this panel has none. Changes made in the console itself, such as creating a reseller or a platform language, are platform activity and show Platform in the Store column.

Platform settings

The console keeps no config file. Everything a console user changes at runtime is a settings row, edited on ManagePlatformSettings.

The panel's brand name is Misaf\VendraConsole\Settings\ConsoleSettings::$brand_name, seeded as Vendra Console by a settings migration and read per request, so a rename takes effect on the next page load.

The Billing section edits Settings\BillingSettings: the seller name (falling back to the brand name), address and tax ID named on invoices, and the tax rate and label added to every plan charge. The rate is entered as a percentage and stored in basis points. Support\SettingsBillingProfile reads it as the subscription engine's BillingProfile, so a change applies to the next charge; issued invoices keep what they were issued with. The reseller overview counts a reseller's invoices and links to them.

The page also exposes one platform rule: whether the platform is creating stores at all. That rule is Misaf\VendraStore\Settings\StoreCreationSettings, and it lives in misaf/vendra-store precisely because the reseller panel creates stores too and sits below this package. Closing it therefore closes reseller creation as well; a reseller's own plan remains the second half of their gate.

The console picks a store's billing reseller from the form and lets the console user 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.

Store creation asks for the domain, administrator email, and managed storefront identity. The managed storefront starts with sample contact, location, and social details and deploys when the runtime is configured. The store administrator replaces those details on the admin Storefront settings page.

Layering

This is the topmost layer:

vendra-console → vendra-reseller → vendra-store → laravel-docker-engine

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

Testing

Act as a canonical user with an active consoles row on the console guard. A test that makes an HTTP request creates that user with User::factory()->withAppAuthentication(), or the panel redirects it to the two-factor setup page. 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

Package info

Security

Statistics