README

Filament ERP Projects

Filament v5 panel resources for the Laravel ERP projects module — projects, tasks and timesheets.

This package is the UI layer for the jeffersongoncalves/laravel-erp-projects domain package (namespace JeffersonGoncalves\Erp\Projects\). It wires the project models into ready-to-use Filament resources, with a submittable timesheet that can be billed to a sales invoice.

Features

• Project resources — Projects, tasks and activity types
• Timesheets — Timesheets with a details relation manager and Submit/Cancel lifecycle
• Billing — Create a sales invoice from a submitted timesheet (cross-module)
• Dashboard widget — ProjectStatsWidget with project and task counts
• Configurable — Swap resource classes, change the navigation group or assign a cluster via config

Compatibility

Installation

Install the package via Composer:

composer require jeffersongoncalves/filament-erp-projects

Register the plugin on a Filament panel:

use JeffersonGoncalves\FilamentErp\Projects\FilamentErpProjectsPlugin;

$panel->plugin(
    FilamentErpProjectsPlugin::make()
        ->navigationGroup('ERP — Projects'),
);

Resources

The timesheet resource exposes Submit and Cancel record actions that drive the domain document lifecycle. A submitted timesheet also exposes a Create Sales Invoice action that bills the logged time to a downstream sales invoice.

Widgets

Configuration

Publish the config to swap resource classes, change the navigation group, or adjust widgets:

php artisan vendor:publish --tag="filament-erp-projects-config"

Changelog

Please see CHANGELOG for what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Jefferson Simão Gonçalves
• All Contributors

License

The MIT License (MIT). Please see License File for more information.