README

Laravel library for recording changes (update and delete) in models.
Records modified fields, their previous value, new value, the responsible user, and the date of the change in a database table.

📦 Installation

Add the package to your project via Composer:

composer require carlosdev/model-change-logger

Make sure you have PHP 8.0+ and Laravel 10.

🔧 Configuration

Publish and run migrations:

php artisan migrate

Use the trait in the model you want to audit:

use CarlosDev\ModelChangeLogger\Traits\TracksChanges;

class JobOffer extends Model
{
    use TracksChanges;
}

(Optional) Audit only specific fields: If you want to record only certain fields, define the $auditFields property in your model:

protected array $auditFields = ['job_offer_status_id', 'title'];

🧠 What does it record?

• Changes to individual fields when performing update().
• Deletions (delete and forceDelete), saving the event but without specific fields.
• Responsible user (Auth::id()).
• Affected model and ID.
• Date and time of the change.

📄 Structure of the model_changes table

✅ Compatibility

• PHP: >= 8.0
• Laravel: ^10.0

📬 Contributions

Suggestions, improvements, and pull requests are welcome! 🚀

This package is designed for projects that require change traceability without depending on complex auditing packages.

📄 License

MIT © CarlosDev