README

Shared support infrastructure used by every Vendra module.

Features

• Provider-neutral tenant resolution and tenant-awareness helpers
• Tenant-aware Eloquent traits, scopes, and migration helpers
• Optional tag, attribute, and currency integration contracts
• Provider-neutral subscription charging with idempotent operation results
• Request and queued-job context propagation primitives
• Shared tenant seeders and console commands
• Shared Filament clusters, navigation taxonomy, and concerns
• IsActiveToggle form field and IsActiveToggleColumn table column for boolean active/inactive columns
• IsActiveEntry infolist entry, IsActiveConstraint query-builder constraint, and IsActiveFilter ternary filter (Active / Inactive) for reading and filtering the same columns
• IsDefaultToggle form field, IsDefaultEntry infolist entry, IsDefaultIconColumn table column, IsDefaultFilter ternary filter, and IsDefaultConstraint query-builder constraint for boolean is_default columns
• IsPrimaryToggle form field and IsPrimaryIconColumn table column for boolean is_primary columns
• Observers\Concerns\MaintainsSingleActiveDefault observer trait that keeps exactly one active row flagged is_default, promotes the first active row (by ordered, else by key) when the default goes away, and clears the flag on a soft-deleted default
• CreatedAtColumn, UpdatedAtColumn, DeletedAtColumn, and RowIndexColumn table columns for timestamps (Jalali under the fa locale) and the # row index
• CreatedAtEntry, UpdatedAtEntry, and DateTimeEntry infolist entries with the same timestamp formatting, IsActiveIconColumn, and PositionConstraint, NameConstraint, and SlugConstraint query-builder constraints
• SluggableNameInput, SlugInput, and DescriptionTextarea form fields, NameEntry, SlugEntry, and DescriptionEntry infolist entries, and SlugColumn for the common translated name/slug/description attributes
• NameColumn and DescriptionColumn table columns and the DescriptionRichEditor JSON rich-text field
• Composable policy authorization, sandbox helpers, and shared events

The package binds null capability resolvers by default. Concrete providers can replace those bindings without coupling domain packages to their implementations.

Requirements

• PHP 8.4+
• Laravel 13
• Filament 5
• misaf/filament-jalali

Installation

composer require misaf/vendra-support

The service provider is auto-registered.

Optionally publish the shared panel configuration:

php artisan vendor:publish --tag=vendra-support-config

Demo seeders use bundled JSON fixtures in production and when their declared factory classes are unavailable. Local monorepo development continues to use factories when they are autoloadable.

Testing

Run the package checks from the project root:

php artisan test --compact --testsuite=vendra-support
composer stan

License

MIT. See LICENSE.