Update document for v1.2.8

Author: mrjung72

CHANGELOG.md

@@ -1,5 +1,44 @@
 # SQL2Excel Version History
 
+## v1.2.8 - Language Configuration & Type Safety Improvements (2025-10-19)
+
+### 🔧 Improvements
+- **Unified Language Configuration**: Standardized language settings using environment variable (`LANGUAGE`)
+  - `app.js`: Use environment variable instead of command-line argument
+  - `src/index.js`: Environment variable-based language configuration
+  - `src/excel-cli.js`: Use environment variable, changed default from 'kr' to 'en'
+  - `src/excel-style-helper.js`: Use environment variable
+  - `src/file-utils.js`: Use environment variable
+  - `src/style-manager.js`: Use environment variable
+  - `src/variable-processor.js`: Use environment variable
+  - `src/query-parser.js`: Use environment variable
+  - `src/excel-generator.js`: Use environment variable
+
+- **Batch File Improvements**: Added environment variable settings, removed `--lang` parameter
+  - `run.bat`: Added `set LANGUAGE=en`
+  - `실행하기.bat`: Added `set LANGUAGE=kr`
+  - `create-release.js`: Added environment variable settings to release batch file templates
+  - `package.json`: Changed `start:kr` script to message directing users to use batch files
+
+### 🐛 Bug Fixes
+- **Type Conversion Error Fix**: Improved type safety when handling empty arrays in IN clauses
+  - `src/mssql-helper.js`: `createInClause()` function now returns `NULL` instead of `'^-_'`
+  - `src/variable-processor.js`: Unresolved dynamic variables replaced with `NULL` instead of `'^-_'`
+  - **Issue**: Type conversion error when executing `WHERE OrderID IN ('^-_')` on INT columns
+  - **Solution**: Using `WHERE OrderID IN (NULL)` works safely with all data types
+  - **Impact**: Executes without errors on all column types (numeric, string, date, etc.) and always returns 0 rows
+
+### 📝 Documentation
+- Enhanced multilingual messages
+  - `variable-processor.js`: Shows `(no match)` / `(매칭 없음)` message when replacing with NULL
+  - Clarified messages when replacing with empty strings
+
+### 🔄 Migration Guide
+- If you were running with `node app.js --lang=kr`:
+  - Windows: `set LANGUAGE=kr && node app.js`
+  - Or use `실행하기.bat` (automatically sets environment variable)
+- In development environment, you can set `LANGUAGE=kr` in `.env` file
+
 ## v1.2.7 - Encoding & Validation Improvements (2025-10-16)
 
 ### 🔧 Improvements

CHANGELOG_KR.md

@@ -1,5 +1,44 @@
 # SQL2Excel 버전 히스토리
 
+## v1.2.8 - 언어 설정 개선 및 타입 안정성 향상 (2025-10-19)
+
+### 🔧 개선사항
+- **언어 설정 통일**: 모든 모듈에서 환경 변수(`LANGUAGE`)로 언어 설정 통일
+  - `app.js`: 명령줄 인수 대신 환경 변수 사용
+  - `src/index.js`: 환경 변수 기반 언어 설정
+  - `src/excel-cli.js`: 환경 변수 사용, 기본값 'kr'에서 'en'으로 변경
+  - `src/excel-style-helper.js`: 환경 변수 사용
+  - `src/file-utils.js`: 환경 변수 사용
+  - `src/style-manager.js`: 환경 변수 사용
+  - `src/variable-processor.js`: 환경 변수 사용
+  - `src/query-parser.js`: 환경 변수 사용
+  - `src/excel-generator.js`: 환경 변수 사용
+
+- **배치 파일 개선**: 환경 변수 설정 추가, `--lang` 파라미터 제거
+  - `run.bat`: `set LANGUAGE=en` 추가
+  - `실행하기.bat`: `set LANGUAGE=kr` 추가
+  - `create-release.js`: 릴리스 배치 파일 템플릿에 환경 변수 설정 추가
+  - `package.json`: `start:kr` 스크립트를 배치 파일 사용 안내 메시지로 변경
+
+### 🐛 버그 수정
+- **타입 변환 오류 해결**: IN 절에서 빈 배열 처리 시 타입 안정성 개선
+  - `src/mssql-helper.js`: `createInClause()` 함수에서 `'^-_'` 대신 `NULL` 반환
+  - `src/variable-processor.js`: 해결되지 않은 동적 변수를 `'^-_'` 대신 `NULL`로 대체
+  - **문제**: INT 타입 컬럼에서 `WHERE OrderID IN ('^-_')` 실행 시 타입 변환 오류 발생
+  - **해결**: `WHERE OrderID IN (NULL)` 사용으로 모든 데이터 타입에서 안전하게 작동
+  - **효과**: 숫자, 문자열, 날짜 등 모든 타입의 컬럼에서 오류 없이 실행 (항상 0개 행 반환)
+
+### 📝 문서
+- 다국어 메시지 개선
+  - `variable-processor.js`: NULL 대체 시 메시지에 `(매칭 없음)` / `(no match)` 표시
+  - 빈 문자열 대체 시 메시지 명확화
+
+### 🔄 마이그레이션 가이드
+- 기존에 `node app.js --lang=kr` 형태로 실행하던 경우:
+  - Windows: `set LANGUAGE=kr && node app.js`
+  - 또는 `실행하기.bat` 사용 (자동으로 환경 변수 설정됨)
+- 개발 환경에서는 `.env` 파일에 `LANGUAGE=kr` 설정 가능
+
 ## v1.2.7 - 인코딩 및 검증 개선 (2025-10-16)
 
 ### 🔧 개선사항

README.md

@@ -56,7 +56,9 @@ npm run build
 #### Option B: Standalone Executable
 1. Download the release package from the releases section
 2. Extract to your desired directory
-3. Run `sql2excel.bat` for interactive menu
+3. Run interactive menu:
+   - English: Run `run.bat`
+   - Korean: Run `실행하기.bat`
 4. Or use `sql2excel-v{version}.exe` directly
 
 ### 3. Database Connection Setup
@@ -92,11 +94,38 @@ Create `config/dbinfo.json` file:
 
 ## 🚀 Basic Usage
 
+### Language Settings
+
+The tool supports Korean and English through environment variables:
+
+#### Development Environment
+- **English**: Run `run.bat` (automatically sets `LANGUAGE=en`)
+- **Korean**: Run `실행하기.bat` (automatically sets `LANGUAGE=kr`)
+
+#### Release Package
+- **English**: Run `run.bat`
+- **Korean**: Run `실행하기.bat`
+
+> 💡 **Note**: Language is controlled via the `LANGUAGE` environment variable. Default is English (en).
+
 ### Method 1: Interactive Batch File (Recommended for Windows Users)
 
-Run the interactive batch file for a user-friendly menu:
+#### Development Environment
 ```bash
-sql2excel.bat
+# English version
+run.bat
+
+# Korean version
+실행하기.bat
+```
+
+#### Release Package
+```bash
+# English version
+run.bat
+
+# Korean version
+실행하기.bat
 ```
 
 The interactive menu provides:

README_KR.md

@@ -56,7 +56,9 @@ npm run build
 #### 옵션 B: 독립 실행 파일
 1. 릴리스 섹션에서 릴리스 패키지 다운로드
 2. 원하는 디렉토리에 압축 해제
-3. 대화형 메뉴를 위해 `sql2excel.bat` 실행
+3. 대화형 메뉴 실행:
+   - 영어: `run.bat` 실행
+   - 한글: `실행하기.bat` 실행
 4. 또는 `sql2excel-v{version}.exe`를 직접 사용
 
 ### 3. 데이터베이스 연결 설정
@@ -92,11 +94,38 @@ npm run build
 
 ## 🚀 기본 사용법
 
+### 언어 설정
+
+도구는 환경 변수를 통해 한국어와 영어를 지원합니다:
+
+#### 개발 환경
+- **영어**: `run.bat` 실행 (자동으로 `LANGUAGE=en` 설정)
+- **한글**: `실행하기.bat` 실행 (자동으로 `LANGUAGE=kr` 설정)
+
+#### 배포 환경 (Release Package)
+- **영어**: `run.bat` 실행
+- **한글**: `실행하기.bat` 실행
+
+> 💡 **참고**: 환경 변수 `LANGUAGE`를 사용하여 언어를 제어합니다. 기본값은 영어(en)입니다.
+
 ### 방법 1: 대화형 배치 파일 (Windows 사용자 권장)
 
-사용자 친화적인 메뉴를 위해 대화형 배치 파일 실행:
+#### 개발 환경
 ```bash
-sql2excel.bat
+# 영어 버전
+run.bat
+
+# 한글 버전
+실행하기.bat
+```
+
+#### 배포 환경 (Release Package)
+```bash
+# 영어 버전
+run.bat
+
+# 한글 버전
+실행하기.bat
 ```
 
 대화형 메뉴 제공 항목:

USER_MANUAL.md

@@ -71,7 +71,9 @@ npm run build
 #### Option B: Standalone Executable
 1. Download the release package from the releases section
 2. Extract to your desired directory
-3. Run `sql2excel.bat` for interactive menu
+3. Run interactive menu:
+   - English: Run `run.bat`
+   - Korean: Run `실행하기.bat`
 4. Or use `sql2excel-v{version}.exe` directly
 
 ### 3. Database Connection Setup
@@ -107,11 +109,38 @@ Create `config/dbinfo.json` file:
 
 ## 🚀 Basic Usage
 
+### Language Settings
+
+The tool supports Korean and English through environment variables:
+
+#### Development Environment
+- **English**: Run `run.bat` (automatically sets `LANGUAGE=en`)
+- **Korean**: Run `실행하기.bat` (automatically sets `LANGUAGE=kr`)
+
+#### Release Package
+- **English**: Run `run.bat`
+- **Korean**: Run `실행하기.bat`
+
+> 💡 **Note**: Language is controlled via the `LANGUAGE` environment variable. Default is English (en).
+
 ### Method 1: Interactive Batch File (Recommended for Windows Users)
 
-Run the interactive batch file for a user-friendly menu:
+#### Development Environment
 ```bash
-sql2excel.bat
+# English version
+run.bat
+
+# Korean version
+실행하기.bat
+```
+
+#### Release Package
+```bash
+# English version
+run.bat
+
+# Korean version
+실행하기.bat
 ```
 
 The interactive menu provides:

USER_MANUAL_KR.md

@@ -71,7 +71,9 @@ npm run build
 #### 옵션 B: 독립 실행 파일
 1. 릴리스 섹션에서 릴리스 패키지 다운로드
 2. 원하는 디렉토리에 압축 해제
-3. 대화형 메뉴를 위해 `sql2excel.bat` 실행
+3. 대화형 메뉴 실행:
+   - 영어: `run.bat` 실행
+   - 한글: `실행하기.bat` 실행
 4. 또는 `sql2excel-v{version}.exe`를 직접 사용
 
 ### 3. 데이터베이스 연결 설정
@@ -107,11 +109,38 @@ npm run build
 
 ## 🚀 기본 사용법
 
+### 언어 설정
+
+도구는 환경 변수를 통해 한국어와 영어를 지원합니다:
+
+#### 개발 환경
+- **영어**: `run.bat` 실행 (자동으로 `LANGUAGE=en` 설정)
+- **한글**: `실행하기.bat` 실행 (자동으로 `LANGUAGE=kr` 설정)
+
+#### 배포 환경 (Release Package)
+- **영어**: `run.bat` 실행
+- **한글**: `실행하기.bat` 실행
+
+> 💡 **참고**: 환경 변수 `LANGUAGE`를 사용하여 언어를 제어합니다. 기본값은 영어(en)입니다.
+
 ### 방법 1: 대화형 배치 파일 (Windows 사용자 권장)
 
-사용자 친화적인 메뉴를 위해 대화형 배치 파일 실행:
+#### 개발 환경
 ```bash
-sql2excel.bat
+# 영어 버전
+run.bat
+
+# 한글 버전
+실행하기.bat
+```
+
+#### 배포 환경 (Release Package)
+```bash
+# 영어 버전
+run.bat
+
+# 한글 버전
+실행하기.bat
 ```
 
 대화형 메뉴 제공 항목:

app.js

@@ -29,7 +29,7 @@ const LANGUAGE = process.env.LANGUAGE || 'en';
 // 다국어 메시지
 const messages = {
     en: {
-        title: 'SQL2Excel Tool v1.2.7',
+        title: 'SQL2Excel',
         menuTitle: 'Menu Selection',
         menu1: '1. Validate Query Definition File',
         menu2: '2. Test Database Connection',
@@ -95,7 +95,7 @@ const messages = {
         interrupted: 'Interrupted by user'
     },
     kr: {
-        title: 'SQL2Excel 도구 v1.2.7',
+        title: 'SQL2Excel',
         menuTitle: '메뉴 선택',
         menu1: '1. 쿼리 정의 파일 검증',
         menu2: '2. 데이터베이스 연결 테스트',

package.json

@@ -1,11 +1,11 @@
 {
   "name": "sql2excel",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "SQL 쿼리 결과를 엑셀 파일로 저장하는 도구 (시트별 쿼리, 변수, XML/JSON 지원)",
   "main": "app.js",
   "scripts": {
     "start": "node app.js",
-    "start:kr": "node app.js --lang=kr",
+    "start:kr": "echo Please use 실행하기.bat for Korean language",
     "export": "node src/excel-cli.js export",
     "validate": "node src/excel-cli.js validate",
     "list-dbs": "node src/excel-cli.js list-dbs",

run.bat

@@ -6,7 +6,7 @@ color 0F
 
 echo.
 echo ================================================================
-echo                   SQL2Excel Tool v1.2.7
+echo                   SQL2Excel
 echo ================================================================
 echo.
 

src/excel-cli.js

@@ -15,7 +15,7 @@ const messages = {
         sheetNameWhitespace: 'Sheet name has leading or trailing whitespace.',
 
         helpMessage: `
-        SQL2Excel Tool v1.2
+        SQL2Excel
         Usage: node src/excel-cli.js <command> [options]
 
         Commands:
@@ -126,7 +126,7 @@ const messages = {
         sheetNameWhitespace: '시트명 앞뒤에 공백이 있습니다.',
 
         helpMessage: 
-        `SQL2Excel 도구 v1.2
+        `SQL2Excel
         사용법: node src/excel-cli.js <명령> [옵션]',
         명령:',
           export                     SQL 쿼리 결과를 엑셀 파일로 내보내기',