sam-api/app/Helpers/TenantCodeGenerator.php

<?php

namespace App\Helpers;

use App\Models\Tenants\Tenant;

/**
 * 테넌트 코드 생성 헬퍼
 * - 회사명에서 한글 초성 추출 및 영문 변환
 * - 고유한 순번을 36진수 4자리로 추가
 * - 형식: {초성영문}{순번36진수} (예: TKP0001, GSS0002)
 */
class TenantCodeGenerator
{
    // 한글 초성 배열
    private const INITIALS = ['ㄱ', 'ㄲ', 'ㄴ', 'ㄷ', 'ㄸ', 'ㄹ', 'ㅁ', 'ㅂ', 'ㅃ', 'ㅅ', 'ㅆ', 'ㅇ', 'ㅈ', 'ㅉ', 'ㅊ', 'ㅋ', 'ㅌ', 'ㅍ', 'ㅎ'];

    // 36진수 문자 (0-9, A-Z)
    private const BASE36_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ';

    /**
     * 회사명에서 고유한 테넌트 코드 생성
     *
     * @param  string  $companyName  회사명
     * @return string 생성된 코드 (예: TKP0001)
     */
    public static function generate(string $companyName): string
    {
        // 1. 한글 초성 추출 및 영문 변환
        $initials = self::extractKoreanInitials($companyName);

        // 2. 기존 테넌트들의 코드에서 최대 순번 찾기
        $lastNumber = -1;
        $existingTenants = Tenant::all();

        foreach ($existingTenants as $tenant) {
            // 코드 마지막 4자리를 순번으로 간주
            if (strlen($tenant->code) >= 4) {
                $sequenceString = substr($tenant->code, -4);

                // 마지막 4자리가 36진수 문자열인지 확인
                if (strspn($sequenceString, self::BASE36_CHARS) === 4) {
                    $sequence = self::fromBase36($sequenceString);
                    if ($sequence > $lastNumber) {
                        $lastNumber = $sequence;
                    }
                }
            }
        }

        // 3. 다음 순번 계산 (36^4 = 1,679,616로 순환)
        $nextSequence = ($lastNumber + 1) % 1679616;

        // 4. 36진수 4자리로 포맷
        $formattedSequence = self::toBase36($nextSequence);

        // 5. 초성 + 순번 조합하여 최종 코드 생성
        return $initials.$formattedSequence;
    }

    /**
     * 한글 텍스트에서 초성 추출 및 영문 변환
     *
     * @param  string  $text  한글 텍스트
     * @return string 영문 초성 (예: "테크컴퍼니" → "TKP")
     */
    private static function extractKoreanInitials(string $text): string
    {
        $initials = '';
        $charLength = mb_strlen($text, 'UTF-8');

        for ($i = 0; $i < $charLength; $i++) {
            $char = mb_substr($text, $i, 1, 'UTF-8');
            $code = mb_ord($char, 'UTF-8');

            // 한글 유니코드 범위 (가-힣: 0xAC00-0xD7A3)
            if ($code >= 0xAC00 && $code <= 0xD7A3) {
                $index = floor(($code - 0xAC00) / 588);
                $initials .= self::INITIALS[$index];
            }
            // 한글이 아닌 문자는 무시
        }

        // 초성을 영문으로 변환
        $koreanInitials = ['ㄱ', 'ㄲ', 'ㄴ', 'ㄷ', 'ㄸ', 'ㄹ', 'ㅁ', 'ㅂ', 'ㅃ', 'ㅅ', 'ㅆ', 'ㅇ', 'ㅈ', 'ㅉ', 'ㅊ', 'ㅋ', 'ㅌ', 'ㅍ', 'ㅎ'];
        $englishInitials = ['G', 'KK', 'N', 'D', 'TT', 'R', 'M', 'B', 'BB', 'S', 'SS', 'O', 'J', 'JJ', 'CH', 'K', 'T', 'P', 'H'];
        $initials = strtr($initials, array_combine($koreanInitials, $englishInitials));

        // 공백 제거 및 대문자 변환
        return strtoupper(str_replace(' ', '', $initials));
    }

    /**
     * 36진수 문자열을 10진수로 변환
     *
     * @param  string  $str  36진수 문자열 (예: "0001")
     * @return int 10진수 값
     */
    private static function fromBase36(string $str): int
    {
        return intval($str, 36);
    }

    /**
     * 10진수를 4자리 36진수 문자열로 변환
     *
     * @param  int  $num  10진수 값
     * @return string 4자리 36진수 문자열 (예: "0001")
     */
    private static function toBase36(int $num): string
    {
        return str_pad(strtoupper(base_convert((string) $num, 10, 36)), 4, '0', STR_PAD_LEFT);
    }
}