Refactor PHP and Laravel code

Refactor PHP/Laravel classes for clarity and maintainability without changing logic

Modernizing legacy Laravel code to DRY, readable patterns while preserving behavior.

• · PHP class file
• · .cursor/rules/ rulesets

• · refactored class with improved structure
• · code coverage report

• · PHPStan
• · PHPUnit
• · Spatie DTOs
• · Laravel helpers

• · PHP 8.0+ syntax
• · Test suite runnable
• · No external API changes

• · Test coverage regression
• · PHPStan analysis fails
• · Clever code becomes unreadable

• · Single Responsibility Principle applied
• · Private method extraction (>30 lines)
• · No single-use variables
• · PHPDoc for PHPStan