Download the PHP package atendwa/laravel-reporting without Composer

Laravel Reporting

A queue-based reporting system for Laravel with Filament UI integration: define generators, schedule them, export CSV/PDF, and track every run's history — all through a Filament panel.

Requirements

What it does

• Define report generators (auto-discovered classes) that query your data and export it as CSV and PDF
• Schedule automated runs via cron expressions
• Apply dynamic filters/parameters at runtime through a generated Filament form
• Track every execution with full history (status, duration, file paths, modifiers used)
• Prevent concurrent execution of heavy reports via cooldown checking
• Notify users on completion via Filament's notification system

Installation

Publish the config and choose where the resources sit in your Filament navigation:

This asks whether to nest the Reports/Histories/Schedules resources under one of your own Filament clusters (giving its FQCN), or a plain navigation group label, or leave them under the package's own built-in "Reporting" cluster (the default). You can also just publish the config file directly and edit it by hand:

Pick a PDF engine and require it (only one is needed):

Quick start

1. Scaffold a generator:

   This creates app/Reports/Generators/YourReportGenerator.php implementing GeneratorInterface (see src/Contracts/GeneratorInterface.php for the full contract — generate(), getHeaders(), getModifiers(), getName(), etc.).

2. Register it as a Report:

   This walks you through picking a discovered generator and creates the Report row that Filament and the scheduler use.

3. Open the Reporting cluster in your Filament panel — your report is ready to run, schedule, and download from there.

Key concepts

Generators live in App\Reports\Generators (configurable via reporting.generator_namespaces / reporting.generator_paths) and implement GeneratorInterface. The methods you'll actually write are generate(), getHeaders(), getModifiers(), and getDefaultParameters(). Everything else (UI, queuing, file export, cooldown checking) is handled by the package.

Modifiers are filters your generator declares — the package turns them into Filament form fields automatically. Supported types: date_range, select, multiselect, text, number.

Heavy reports (isHeavy(): true) get a cooldown window (reporting.default_cooldown_minutes) so a cached recent result is served instead of re-running the report. Set estimateExecutionTime() for context in the UI.

Schedules are reusable cron configurations that can be attached to multiple reports via a relation manager in Filament.

Tenant-aware generators — the Reporting\Generator\Concerns\IsTenantAware trait is opt-in and scopes data/options to a team/tenant model. Set reporting.team_model to your tenant model's FQCN before using it; the model must expose an is_default boolean column, and your user model must expose a teams() relation.

Artisan commands

Configuration (config/reporting.php)

Key options: generator_namespaces, generator_paths, disk, directory, default_cooldown_minutes, pdf_engine (dompdf|mpdf), chunk_size, pdf_chunk_size, logo_path, queue, cleanup_days, team_model.

Navigation (navigation.cluster / navigation.group)

The Reports, Histories, and Schedules resources are available out of the box under this package's own Reporting\Filament\Clusters\Reporting cluster — no configuration needed to get started. To place them somewhere else in your panel instead, set either key (applied consistently across all three resources):

reporting:install walks you through setting these interactively; cluster wins over group when both are set, since a cluster manages its own top-level navigation entry.

Known portability boundary

Some Filament resources in this package still use small helper traits from an in-house BetaFilament plugin (ResourceAccessGate, UsesFilamentPolicySetup, SupportResourceNavigationGroup, and an overridden ListRecords page) that hasn't been extracted yet. If you install this package in a project that doesn't have BetaFilament, you'll need to either provide equivalent implementations under those same class names or wait for BetaFilament to be published separately. This is the one remaining hard dependency on the package's origin project.

Testing

Test files under tests/ are being migrated to run standalone via Orchestra Testbench — some may not pass yet outside the origin monorepo. Contributions welcome.

Contributing

Issues and pull requests are welcome. Please run vendor/bin/pint and vendor/bin/phpstan analyse before submitting.

License

The MIT License (MIT). See LICENSE for details.