CompanyAudit extends BaseAudit
Company audit trail implementations
Table of Contents
Methods
- companyCreatedLog() : void
- Log Company creation
- companyDeletedLog() : void
- Log Company deletion
- companyExternalIDUpdatedLog() : void
- Log Company External ID update
- companyExternalSystemMappingCreatedLog() : void
- Log Company External System Mapping creation
- companyUpdatedLog() : void
- Log Company update
- addAuditLog() : void
- Log an audit trail entry
- getCompanyId() : int
- Extract company ID from various model types.
- getUserId() : int
- Get the current authenticated user ID, or fallback to job context user ID.
Methods
companyCreatedLog()
Log Company creation
public
static companyCreatedLog(mixed $record[, int $userId = 0 ]) : void
Parameters
- $record : mixed
-
The newly created Company record
- $userId : int = 0
-
The ID of the user who performed the action (optional)
Tags
companyDeletedLog()
Log Company deletion
public
static companyDeletedLog(mixed $record[, int $userId = 0 ]) : void
Parameters
- $record : mixed
-
The Company being deleted
- $userId : int = 0
-
The ID of the user who performed the action (optional)
Tags
companyExternalIDUpdatedLog()
Log Company External ID update
public
static companyExternalIDUpdatedLog(mixed $oldRecord, mixed $newRecord[, int $userId = 0 ]) : void
Parameters
- $oldRecord : mixed
-
The Company External ID data before the update
- $newRecord : mixed
-
The Company External ID data after the update
- $userId : int = 0
-
The ID of the user who performed the action (optional)
Tags
companyExternalSystemMappingCreatedLog()
Log Company External System Mapping creation
public
static companyExternalSystemMappingCreatedLog(mixed $record[, int $userId = 0 ]) : void
Parameters
- $record : mixed
-
The newly created Company External System Mapping record
- $userId : int = 0
-
The ID of the user who performed the action (optional)
Tags
companyUpdatedLog()
Log Company update
public
static companyUpdatedLog(mixed $oldRecord, mixed $newRecord[, int $userId = 0 ]) : void
Parameters
- $oldRecord : mixed
-
The Company data before the update
- $newRecord : mixed
-
The Company data after the update
- $userId : int = 0
-
The ID of the user who performed the action (optional)
Tags
addAuditLog()
Log an audit trail entry
protected
static addAuditLog(int $companyId, int $userId, string $message, string $module, string $action[, mixed|null $currentRecord = null ][, mixed|null $updatedRecord = null ][, string|null $objectName = null ][, string $queueName = 'audit-trails' ][, bool $afterCommit = false ][, string $type = AuditTypesEnum::COMPANY->value ]) : void
Parameters
- $companyId : int
-
Company identifier
- $userId : int
-
User identifier (default 0 for system actions)
- $message : string
-
Human-readable audit message
- $module : string
-
Module name (PAYROLL, LEAVE, PAYMENTS, etc.) - must be a valid AuditModulesEnum value
- $action : string
-
Action type (CREATE, UPDATE, DELETE, etc.) - must be a valid AuditActionsEnum value
- $currentRecord : mixed|null = null
-
Current data being logged
- $updatedRecord : mixed|null = null
-
The updated data (for updates)
- $objectName : string|null = null
-
Optional name of the object being logged - if not provided, will be inferred from the model
- $queueName : string = 'audit-trails'
-
Optional queue name for async processing. Default 'audit-trails'
- $afterCommit : bool = false
-
Whether to log after DB commit
- $type : string = AuditTypesEnum::COMPANY->value
Tags
getCompanyId()
Extract company ID from various model types.
protected
static getCompanyId(mixed $model) : int
This method attempts to determine the company ID from the provided model instance.
It checks for a direct company_id property or navigates through related employee models.
Parameters
- $model : mixed
-
Model instance
Tags
Return values
int —Company ID
getUserId()
Get the current authenticated user ID, or fallback to job context user ID.
protected
static getUserId() : int
This method first checks for an authenticated user via the auth() helper. If no user is authenticated, it looks for a user_id in the job context (for queued jobs).
To add a user ID to the job context, you can use this in your job setup:
app()->instance('job_context', ['user_id' => $userId]);
If neither is available, it returns 0 to indicate a system action.
Return values
int —The determined user ID, or 0 if none found