feat: Add Trait-Based Policy Generation

[zayedadel]

Introduces an optional trait based policy generation approach. This allows users to generate policies that utilize a common GeneralPoliciesTrait for defining standard CRUD permissions, reducing boilerplate in individual policy files. The feature is controlled by a new configuration option generator.generate_trait_policies in config/filament-shield.php. When enabled, the shield:generate command will use a new TraitPolicy.stub to create policies that leverage this trait.

Includes:

• GeneralPoliciesTrait.php with common policy methods.
• TraitPolicy.stub for generating trait-based policies.
• Updates to GenerateCommand.php to handle the new stub and variables.
• New generate_trait_policies config option.
• Utils::isTraitGenerationEnabled() helper method.
• Documentation in README.md for the new feature.

[what-the-diff]

PR Summary

Added Trait-Based Policy Generation

In this pull request, a feature is added for easier management of permissions in the application. It's described in a new section added to the README guide. It uses the idea of "traits" - a technical term for a set of predetermined attributes that can be easily used over and over again.

New Configuration Option

To enable this new feature, a switch is added in the configuration file called filament-shield.php. The option is called generate_trait_policies. When it's turned on, the system can use this new way of managing permissions.

Updated Policy Generation Logic

The underlying script used to generate policies, GenerateCommand.php, has been updated. Now, when the special switch mentioned above is activated, it uses "traits" for providing permissions.

Added GeneralPoliciesTrait

A new list of common permissions has been created in the form of a file called GeneralPoliciesTrait.php. It uses a suffix for permissions which makes them easier to use within the application.

New Policy Stub

A blueprint that defines how the permissions are created when using "traits" is created. It's like a skeleton that the application uses to breed specific permissions.

[bezhanSalleh]

Hey Thanks for the PR. since we don't have tests, and your pr have some issues. could you fix and push an update so i can test it out. to reproduce clone the Filament Demo and follow shields installation and your PR's instructions.

[bezhanSalleh]

Do pull the latest v3 cause i think you would need to handle the feature introduced in #547 as well.