Unique Code

Overview

The Unique Code trait (GenerateUniqueCode) generates guaranteed-unique alphanumeric codes with configurable prefixes. Used by models like Applicant (prefix APP-) to create human-readable identifiers.

How It Works

use App\Traits\Common\GenerateUniqueCode;

class Applicant extends Model
{
    use GenerateUniqueCode;
}

// Generate a code: APP-X7K2M
$code = Applicant::generateUniqueCode(
    modelClass: Applicant::class,
    prefix: 'APP',
    randomLength: 5,
);

Key Methods

Method	Description
generateUniqueCode(modelClass, column, prefix, randomLength)	Generate unique code with retry on collision
sanitizeCode(value)	Strip to uppercase alphanumeric + dash/underscore

---

Key Files

app/Traits/Common/GenerateUniqueCode.php