Coming from Laravel

If you've used owen-it/laravel-auditing, the mental model carries over directly. Here's the mapping.

Comparison Table

Laravel (`laravel-auditing`)	Go Audit
`use Auditable` trait on model	`db.Use(auditgorm.Plugin(auditor))`
`$model->audits()` relation	`auditor.Query(ctx, DataFilter{...})`
`config/audit.php`	`audit.Config{}` passed to `audit.New`
`Audit::$exclude`	`DataAudit.ExcludeFields`
Table-level disabling	`DataAudit.ExcludeEntities`
`Audit::resolveUser()`	`Config.UserFunc(ctx)`
`Audit::$auditable = ['created']`	All actions recorded; filter on read via `DataFilter.Action`
—	`Snapshot(ctx, type, id, at)`
—	`Restore(ctx, type, id, at)`
—	API call logging (`Auditor.API().Record`)
—	`transaction_id` correlation across tables

Key Differences

Model-centric vs Connection-centric

Laravel-auditing works at the model level — each Eloquent model opts in via a trait. Go Audit works at the connection level — register the plugin once and every model is covered.

This is usually what you want: new models are audited automatically, no trait to remember.

Diff Scope

laravel-auditing stores old_values and new_values as full field maps. Go Audit only stores the changed fields on UPDATE, which keeps the table small on wide updates.

Laravel has no built-in equivalent — API call logging typically lives in a separate package. Go Audit bundles it with a matching schema and transaction correlation that links API calls to the data changes they drove.

Transaction Correlation

laravel-auditing doesn't ship with cross-table transaction linking. Go Audit's transaction_id groups data changes and API calls under one ID so you can reconstruct an entire business transaction with QueryByTransaction.

Snapshot & Restore

Laravel-auditing doesn't reconstruct past state. Go Audit's Snapshot(ctx, type, id, at) replays audit history to return what an entity looked like at a given time, and Restore writes a restore audit entry plus returns the target values for you to apply.

User Attribution

Laravel pulls the user from the auth guard by default. Go Audit uses a UserFunc(ctx) callback so you can integrate with whatever pattern your app uses for request context (middleware, JWT claims, tenant context, etc.).