Merge pull request #184 from yuja201/fix/183-null-generation

[fix] null generation issue and stabilize faker mappings

Author: minju-22

src/main/database/migrations/005_add_locales_to_hex_domain.sql

@@ -0,0 +1,4 @@
+UPDATE domains 
+SET locales = '["en","ko"]' 
+WHERE id = 51;  -- HEX
+

src/main/database/rules.ts

@@ -99,7 +99,7 @@ export function createRule(data: RuleInput): Rule {
     data.domain,
     data.model_id ?? null,
     data.prompt ?? null,
-    data.locale ?? null,
+    data.locale ?? 'en',
     now,
     now
   )

src/main/database/schema.ts

@@ -48,6 +48,7 @@ CREATE TABLE IF NOT EXISTS domains (
   name TEXT NOT NULL UNIQUE,
   description TEXT,
   logical_type TEXT NOT NULL DEFAULT 'string',
+  locales TEXT NOT NULL DEFAULT '["en"]',
   created_at NUMERIC NOT NULL DEFAULT (strftime('%s', 'now')),
   updated_at NUMERIC NOT NULL DEFAULT (strftime('%s', 'now')),
   FOREIGN KEY (category_id) REFERENCES domain_categories(id) ON DELETE CASCADE
@@ -61,7 +62,7 @@ CREATE TABLE IF NOT EXISTS rules (
   domain_id INTEGER NOT NULL,
   model_id NUMERIC,
   prompt TEXT,
-  locale TEXT,
+  locale TEXT NOT NULL DEFAULT 'en',
   created_at NUMERIC NOT NULL DEFAULT (strftime('%s', 'now')),
   updated_at NUMERIC NOT NULL DEFAULT (strftime('%s', 'now')),
   FOREIGN KEY (domain_id) REFERENCES domains(id) ON DELETE CASCADE
@@ -123,60 +124,60 @@ INSERT OR IGNORE INTO domain_categories (id, name) VALUES
 
 // 도메인 종류 저장
 export const insertDefaultDomainData = `
-INSERT OR IGNORE INTO domains (id, category_id, name, description, logical_type) VALUES
-  (1, 1, '이름', '이름(First Name)', 'string'),
-  (2, 1, '성', '성(Last Name)', 'string'),
-  (3, 1, '전체 이름', '이름과 성을 합친 전체 이름', 'string'),
-  (4, 1, '직업명', '직업 또는 직책', 'string'),
-  (5, 2, '도로명 주소', '상세 도로명 주소', 'string'),
-  (6, 2, '도시', '도시 이름', 'string'),
-  (7, 2, '국가', '국가 이름', 'string'),
-  (8, 2, '우편번호', '우편번호', 'string'),
-  (9, 3, '이메일', '이메일 주소', 'string'),
-  (10, 3, '전화번호', '전화번호', 'string'),
-  (11, 3, '사용자명', '계정 아이디 또는 닉네임', 'string'),
-  (12, 3, '도메인', '도메인 이름', 'string'),
-  (13, 4, '회사명', '회사 이름', 'string'),
-  (14, 4, '슬로건', '회사 슬로건 또는 문구', 'string'),
-  (15, 4, '부서', '부서 이름', 'string'),
-  (16, 4, '직종', '직무 분야', 'string'),
-  (17, 5, '계좌번호', '은행 계좌번호', 'string'),
-  (18, 5, '금액', '거래 금액', 'number'),
-  (19, 5, '카드번호', '신용/체크카드 번호', 'string'),
-  (20, 5, '거래유형', '입금, 출금 등 거래 종류', 'string'),
-  (21, 6, '상품명', '제품 이름', 'string'),
-  (22, 6, '카테고리', '제품 분류', 'string'),
-  (23, 6, '가격', '제품 가격', 'number'),
-  (24, 6, '설명', '제품 설명 또는 소개문', 'string'),
-  (25, 7, '제조사', '차량 브랜드명', 'string'),
-  (26, 7, '모델명', '모델 이름', 'string'),
-  (27, 7, '차량번호', '차량 번호판', 'string'),
-  (28, 7, '차량 타입', '차량 종류 (SUV, 트럭 등)', 'string'),
-  (29, 8, '과거 날짜', '무작위 과거 일시', 'date'),
-  (30, 8, '미래 날짜', '무작위 미래 일시', 'date'),
-  (31, 8, '최근 날짜', '최근 시점의 일시', 'date'),
-  (32, 8, '타임스탬프', 'UNIX timestamp', 'number'),
-  (33, 9, 'UUID', '고유 식별자(UUID)', 'string'),
-  (34, 9, '파일명', '파일 이름', 'string'),
-  (35, 9, '버전', '소프트웨어 버전 문자열', 'string'),
-  (36, 9, '커밋 메시지', 'Git 커밋 메시지', 'string'),
-  (37, 10, '정수', '랜덤 정수 값', 'number'),
-  (38, 10, '실수', '랜덤 실수 값', 'number'),
-  (39, 10, '불리언', 'true 또는 false 값', 'boolean'),
-  (40, 10, '랜덤 문자열', '무작위 문자열 데이터', 'string'),
-  (41, 11, '문장', '짧은 문장', 'string'),
-  (42, 11, '문단', '랜덤 긴 문단', 'string'),
-  (43, 11, '단어', '단어 하나', 'string'),
-  (44, 11, '키워드', '주제나 태그용 단어', 'string'),
-  (45, 12, '화학 원소', '화학 원소 이름', 'string'),
-  (46, 12, '단위', '물리 단위', 'string'),
-  (47, 12, '과목명', '학교 과목 이름', 'string'),
-  (48, 12, '학교명', '학교 또는 기관 이름', 'string'),
-  (49, 13, '색상명', '사람이 읽을 수 있는 색상 이름', 'string'),
-  (50, 13, 'RGB 값', 'RGB 형태의 색상값', 'string'),
-  (51, 13, 'HEX 코드', '16진수 색상 코드', 'string'),
-  (52, 13, '이미지 URL', '랜덤 이미지 주소', 'string'),
-  (53, 14, '음악 장르', '랜덤 음악 장르', 'string'),
-  (54, 14, '노래 이름', '랜덤 노래 제목', 'string'),
-  (55, 14, '동물 이름', '동물 이름', 'string');
+INSERT OR IGNORE INTO domains (id, category_id, name, description, logical_type, locales) VALUES
+  (1, 1, '이름', '이름(First Name)', 'string', '["en","ko"]'),
+  (2, 1, '성', '성(Last Name)', 'string', '["en","ko"]'),
+  (3, 1, '전체 이름', '이름과 성을 합친 전체 이름', 'string', '["en","ko"]'),
+  (4, 1, '직업명', '직업 또는 직책', 'string', '["en"]'),
+  (5, 2, '도로명 주소', '상세 도로명 주소', 'string', '["en"]'),
+  (6, 2, '도시', '도시 이름', 'string', '["en","ko"]'),
+  (7, 2, '국가', '국가 이름', 'string', '["en"]'),
+  (8, 2, '우편번호', '우편번호', 'string', '["en","ko"]'),
+  (9, 3, '이메일', '이메일 주소', 'string', '["en","ko"]'),
+  (10, 3, '전화번호', '전화번호', 'string', '["en","ko"]'),
+  (11, 3, '사용자명', '계정 아이디 또는 닉네임', 'string', '["en"]'),
+  (12, 3, '도메인', '도메인 이름', 'string', '["en","ko"]'),
+  (13, 4, '회사명', '회사 이름', 'string', '["en","ko"]'),
+  (14, 4, '슬로건', '회사 슬로건 또는 문구', 'string', '["en"]'),
+  (15, 4, '부서', '부서 이름', 'string', '["en"]'),
+  (16, 4, '직종', '직무 분야', 'string', '["en"]'),
+  (17, 5, '계좌번호', '은행 계좌번호', 'string', '["en"]'),
+  (18, 5, '금액', '거래 금액', 'number', '["en"]'),
+  (19, 5, '카드번호', '신용/체크카드 번호', 'string', '["en"]'),
+  (20, 5, '거래유형', '입금, 출금 등 거래 종류', 'string', '["en"]'),
+  (21, 6, '상품명', '제품 이름', 'string', '["en"]'),
+  (22, 6, '카테고리', '제품 분류', 'string', '["en"]'),
+  (23, 6, '가격', '제품 가격', 'number', '["en"]'),
+  (24, 6, '설명', '제품 설명 또는 소개문', 'string', '["en"]'),
+  (25, 7, '제조사', '차량 브랜드명', 'string', '["en"]'),
+  (26, 7, '모델명', '모델 이름', 'string', '["en"]'),
+  (27, 7, '차량번호', '차량 번호판', 'string', '["en"]'),
+  (28, 7, '차량 타입', '차량 종류 (SUV, 트럭 등)', 'string', '["en"]'),
+  (29, 8, '과거 날짜', '무작위 과거 일시', 'date', '["en","ko"]'),
+  (30, 8, '미래 날짜', '무작위 미래 일시', 'date', '["en","ko"]'),
+  (31, 8, '최근 날짜', '최근 시점의 일시', 'date', '["en","ko"]'),
+  (32, 8, '타임스탬프', 'UNIX timestamp', 'number', '["en"]'),
+  (33, 9, 'UUID', '고유 식별자(UUID)', 'string', '["en"]'),
+  (34, 9, '파일명', '파일 이름', 'string', '["en"]'),
+  (35, 9, '버전', '소프트웨어 버전 문자열', 'string', '["en","ko"]'),
+  (36, 9, '커밋 메시지', 'Git 커밋 메시지', 'string', '["en"]'),
+  (37, 10, '정수', '랜덤 정수 값', 'number', '["en","ko"]'),
+  (38, 10, '실수', '랜덤 실수 값', 'number', '["en","ko"]'),
+  (39, 10, '불리언', 'true 또는 false 값', 'boolean', '["en","ko"]'),
+  (40, 10, '랜덤 문자열', '무작위 문자열 데이터', 'string', '["en","ko"]'),
+  (41, 11, '문장', '짧은 문장', 'string', '["en","ko"]'),
+  (42, 11, '문단', '랜덤 긴 문단', 'string', '["en","ko"]'),
+  (43, 11, '단어', '단어 하나', 'string', '["en","ko"]'),
+  (44, 11, '키워드', '주제나 태그용 단어', 'string', '["en"]'),
+  (45, 12, '화학 원소', '화학 원소 이름', 'string', '["en"]'),
+  (46, 12, '단위', '물리 단위', 'string', '["en"]'),
+  (47, 12, '과목명', '학교 과목 이름', 'string', '["en"]'),
+  (48, 12, '학교명', '학교 또는 기관 이름', 'string', '["en"]'),
+  (49, 13, '색상명', '사람이 읽을 수 있는 색상 이름', 'string', '["en","ko"]'),
+  (50, 13, 'RGB 값', 'RGB 형태의 색상값', 'string', '["en","ko"]'),
+  (51, 13, 'HEX 코드', '16진수 색상 코드', 'string', '["en","ko"]'),
+  (52, 13, '이미지 URL', '랜덤 이미지 주소', 'string', '["en"]'),
+  (53, 14, '음악 장르', '랜덤 음악 장르', 'string', '["en"]'),
+  (54, 14, '노래 이름', '랜덤 노래 제목', 'string', '["en"]'),
+  (55, 14, '동물 이름', '동물 이름', 'string', '["en"]');
 `

src/main/services/data-generator/faker-generator.ts

@@ -8,6 +8,8 @@ const LOCALE_FAKERS = {
   ko: fakerKO
 } as const
 
+type FakerOptions = Record<string, unknown> | undefined
+
 /**
  * Faker 생성 요청 파라미터
  */
@@ -98,37 +100,66 @@ export async function* generateFakeStream({
   if (!fakerPath) {
     throw new Error(`No faker mapping for domain: ${domainName}`)
   }
-
-  const [category, method] = fakerPath.split('.') as [keyof Faker, string]
+  const [category, method, optionName, optionValue] = fakerPath.split('.') as [
+    keyof Faker,
+    string,
+    string?,
+    string?
+  ]
   const fakerCategory = faker[category]
+
+  if (!fakerCategory) {
+    throw new Error(`❌ Invalid faker path: ${fakerPath}`)
+  }
+
   const fn = (fakerCategory as Record<string, unknown>)[method]
 
   if (typeof fn !== 'function') {
     throw new Error(`❌ Invalid faker path: ${fakerPath}`)
   }
 
+  let opts: FakerOptions = undefined
+
+  if (optionName && optionValue) {
+    const parsedValue = Number(optionValue)
+    opts = {
+      [optionName]: Number.isNaN(parsedValue) ? optionValue : parsedValue
+    }
+  }
+
   // 단일 값을 생성하는 헬퍼 함수
   const generateSingleValue = (): string => {
-    // 숫자 범위 제약 적용
-    if (
-      typeof min === 'number' &&
-      typeof max === 'number' &&
-      /INT|DECIMAL|NUMERIC|FLOAT|DOUBLE/i.test(sqlType)
-    ) {
-      return String(
-        (fn as (opts: { min: number; max: number }) => number)({
-          min,
-          max
-        })
-      )
+    const callOpts: Record<string, unknown> = { ...(opts ?? {}) }
+
+    // 숫자 범위 제약
+    if (/INT|DECIMAL|NUMERIC|FLOAT|DOUBLE/i.test(sqlType)) {
+      if (typeof min === 'number') callOpts.min = min
+      if (typeof max === 'number') callOpts.max = max
+    }
+
+    const raw = Object.keys(callOpts).length > 0 ? fn(callOpts) : fn()
+
+    // 날짜 처리
+    if (/DATE|DATETIME|TIMESTAMP/i.test(sqlType)) {
+      if (raw instanceof Date) {
+        const iso = raw.toISOString()
+
+        if (/^DATE$/i.test(sqlType)) {
+          return iso.slice(0, 10)
+        }
+
+        return iso.slice(0, 19).replace('T', ' ')
+      }
+
+      return String(raw)
     }
-    // 문자열 길이 제약 적용
+
+    // 문자열 길이
     if (typeof maxLength === 'number') {
-      const raw = String((fn as () => string)())
-      return raw.slice(0, maxLength)
+      return String(raw).slice(0, maxLength)
     }
-    // 제약조건 없음
-    return String((fn as () => string | number)())
+
+    return String(raw)
   }
 
   // 고유값 보장이 필요 없는 경우

src/main/utils/faker-mapper.ts

@@ -11,7 +11,7 @@ export const fakerMapper: Record<string, string> = {
 
   이메일: 'internet.email',
   전화번호: 'phone.number',
-  사용자명: 'internet.userName',
+  사용자명: 'internet.username',
   도메인: 'internet.domainName',
 
   회사명: 'company.name',
@@ -54,8 +54,8 @@ export const fakerMapper: Record<string, string> = {
   단위: 'science.unit',
 
   색상명: 'color.human',
-  'RGB 값': 'color.rgb',
-  'HEX 코드': 'color.hex',
+  'RGB 값': 'color.rgb.format.css',
+  'HEX 코드': 'color.rgb.casing.upper',
   '이미지 URL': 'image.url',
 
   '음악 장르': 'music.genre',