feat: 테넌트 코드 생성 헬퍼 추가 및 RegisterService 적용

- TenantCodeGenerator 헬퍼 클래스 생성 - 한글 초성 추출 및 영문 변환 - Base-36 순번 생성 (최대 1,679,616 코드) - 순환형 코드 생성 (초성+순번 조합) - RegisterService에서 테넌트 생성 시 코드 자동 생성 - 회원가입 시 'code' 필드 누락 오류 해결
2025-11-07 18:11:03 +09:00
parent 8c2d2b4c14
commit be746041fc
2 changed files with 120 additions and 1 deletions
--- a/app/Helpers/TenantCodeGenerator.php
+++ b/app/Helpers/TenantCodeGenerator.php
@@ -0,0 +1,114 @@
+<?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);
+    }
+}