Validation & Structure Improvements

Author: mrjung72

CHANGELOG.md

@@ -1,6 +1,6 @@
 # SQL2Excel Version History
 
-## v1.2.6 - Validation & Structure Improvements (2025-10-14)
+## v1.2.6 - Validation & Structure Improvements (2025-10-15)
 
 ### ✨ New Features
 - **Sheet Name Validation**: Added Excel sheet name validation logic
@@ -17,8 +17,13 @@
 
 - **Interactive Menu System**: User-friendly menu system in sql2db style
   - `app.js`: Multi-language menu system
-  - `run.bat`: English version launcher script
-  - `실행하기.bat`: Korean version launcher script
+  - `run.bat`: English version launcher script (`--lang=en`)
+  - `실행하기.bat`: Korean version launcher script (`--lang=kr`)
+
+- **Multi-language Support**: Language selection via command line arguments
+  - `--lang=en`: English interface
+  - `--lang=kr`: Korean interface
+  - Multi-language support for menus, messages, and errors
 
 ### 🔧 Technical Improvements
 - **Improved dbinfo.json Structure**: Removed dbs wrapper
@@ -30,10 +35,57 @@
   - `mssql-connection-manager.js`: Added pkg environment path handling
   - Unified all file paths based on APP_ROOT
 
+- **pkg Build Optimization** (2025-10-15)
+  - Removed `--no-native-build` option: Improved native module compatibility
+  - Explicit native module inclusion: Added `mssql`, `tedious` to assets
+  - Explicit entry point: Specified as `pkg app.js` format
+  - Explicit target: Specified `--target node18-win-x64`
+  - Added compression: Optimized file size with `--compress GZip`
+
+- **pkg Environment Support** (2025-10-15)
+  - Detect pkg environment and call modules directly in `app.js`
+  - Directly require `excel-cli.js` module for functionality
+  - Automatic branching between Node.js and pkg environments
+  - Dynamic reconstruction of `process.argv` for module calls
+  - `excel-cli.js`: Dynamically read args and command within main() function
+  - `file-utils.js`: APP_ROOT-based path handling (pkg environment support)
+  - `index.js`: Create new yargs instance each time with explicit process.argv
+
+- **Improved Option Parsing** (2025-10-15)
+  - Added `--lang` option handling in `excel-cli.js`
+  - Added unknown option ignore functionality (`default` case)
+  - Enhanced option parser stability
+  - Improved `yargs` usage: Changed to `require('yargs/yargs')`
+  - Explicit `process.argv.slice(2)` passing for pkg environment compatibility
+
 ### 🐛 Bug Fixes
 - **queryDef validation error**: Improved id attribute recognition in queryDef
 - **Variable substitution sheet name validation**: Changed to validate after variable substitution
 - **validate command option parsing**: Improved --xml option recognition
+- **Fixed "i is not defined" error** (2025-10-15)
+  - `index.js`: Added `sheetIndex` variable in for-of loop
+  - Improved index tracking logic in sheet processing loop
+  - Fixed passing correct index to sheet name validation function
+
+- **Fixed sheet name validation not applied during file validation** (2025-10-15)
+  - `excel-cli.js`: Moved sheet name validation logic outside queryDefs block
+  - Improved structure to ensure validation always runs
+  - Returns `false` with clear error messages on validation failure
+  - Auto-correction during query execution, validation failure during file validation
+
+### 🎨 UI/UX Improvements (2025-10-15)
+- **Detailed Validation Output**
+  - Sheet list: Display full list instead of just count
+  - Per-sheet validation results: Show ✅ success / ❌ failure for each
+  - Detailed failure reasons: Specify which rules were violated
+  - Database list: Display detailed info including server, DB name, user, permissions
+
+### 📦 Distribution Improvements (2025-10-15)
+- **Auto-generate Batch Files**: Generate language-specific batch files in `create-release.js`
+  - `run.bat`: Automatically includes `--lang=en`
+  - `실행하기.bat`: Automatically includes `--lang=kr`
+- **Optimized Executable Size**: Reduced size by ~40% through compression
+- **Native Module Inclusion**: Guaranteed proper operation of DB connection libraries
 
 ## v1.2.5 - Batch Interface Improvements (2025-10-10)
 

CHANGELOG_KR.md

@@ -1,6 +1,6 @@
 # SQL2Excel 버전 히스토리
 
-## v1.2.6 - 검증 및 구조 개선 (2025-10-14)
+## v1.2.6 - 검증 및 구조 개선 (2025-10-15)
 
 ### ✨ 새로운 기능
 - **시트명 검증**: Excel 시트명 유효성 검증 로직 추가
@@ -17,8 +17,13 @@
 
 - **인터랙티브 메뉴 시스템**: sql2db 스타일의 사용자 친화적 메뉴
   - `app.js`: 다국어 지원 메뉴 시스템
-  - `run.bat`: 영어 버전 실행 스크립트
-  - `실행하기.bat`: 한글 버전 실행 스크립트
+  - `run.bat`: 영어 버전 실행 스크립트 (`--lang=en`)
+  - `실행하기.bat`: 한글 버전 실행 스크립트 (`--lang=kr`)
+
+- **다국어 지원**: 명령줄 인수를 통한 언어 선택
+  - `--lang=en`: 영문 인터페이스
+  - `--lang=kr`: 한글 인터페이스
+  - 메뉴, 메시지, 에러 모두 다국어 지원
 
 ### 🔧 기술적 개선
 - **dbinfo.json 구조 개선**: dbs 래퍼 제거
@@ -30,10 +35,57 @@
   - `mssql-connection-manager.js`: pkg 환경 경로 처리 추가
   - 모든 파일 경로를 APP_ROOT 기준으로 통일
 
+- **pkg 빌드 최적화** (2025-10-15)
+  - `--no-native-build` 옵션 제거: 네이티브 모듈 호환성 개선
+  - 네이티브 모듈 명시적 포함: `mssql`, `tedious` assets 추가
+  - 진입점 명시: `pkg app.js` 형태로 명확한 진입점 지정
+  - Target 명시: `--target node18-win-x64` 명시적 지정
+  - 압축 추가: `--compress GZip`로 파일 크기 최적화
+
+- **pkg 환경 지원** (2025-10-15)
+  - `app.js`에서 pkg 환경 감지 및 모듈 직접 호출
+  - `excel-cli.js` 모듈 직접 require하여 기능 실행
+  - Node.js 환경과 pkg 환경 자동 분기 처리
+  - `process.argv` 동적 재구성으로 모듈 호출
+  - `excel-cli.js`: args와 command를 main() 함수 내에서 동적 읽기
+  - `file-utils.js`: APP_ROOT 기반 경로 처리 (pkg 환경 지원)
+  - `index.js`: yargs를 매번 새로 생성하여 process.argv 명시적 전달
+
+- **옵션 파싱 개선** (2025-10-15)
+  - `excel-cli.js`에 `--lang` 옵션 처리 추가
+  - 알 수 없는 옵션 무시 기능 추가 (`default` case)
+  - 옵션 파서 안정성 향상
+  - `yargs` 사용 방식 개선: `require('yargs/yargs')`로 변경
+  - `process.argv.slice(2)` 명시적 전달로 pkg 환경 호환성 확보
+
 ### 🐛 버그 수정
 - **queryDef 검증 오류**: queryDef의 id 속성 인식 개선
 - **변수 치환 시트명 검증**: 변수 치환 후 시트명 검증으로 변경
 - **validate 명령 옵션 파싱**: --xml 옵션 인식 개선
+- **"i is not defined" 에러 수정** (2025-10-15)
+  - `index.js`: for-of 루프에서 `sheetIndex` 변수 추가
+  - 시트 처리 루프에서 인덱스 추적 로직 개선
+  - 시트명 검증 함수 호출 시 올바른 인덱스 전달
+
+- **파일 검증 시 시트명 검증 미적용 문제 수정** (2025-10-15)
+  - `excel-cli.js`: 시트명 검증 로직을 queryDefs 블록 밖으로 이동
+  - 검증이 항상 실행되도록 구조 개선
+  - 검증 실패 시 명확한 에러 메시지와 함께 `false` 반환
+  - 쿼리 실행 시에는 자동 수정, 파일 검증 시에는 검증 실패 처리
+
+### 🎨 UI/UX 개선 (2025-10-15)
+- **검증 결과 상세 출력**
+  - 시트 목록: 개수만이 아닌 전체 목록 출력
+  - 각 시트별 검증 결과: ✅ 성공 / ❌ 실패 표시
+  - 실패 원인 상세 설명: 어떤 규칙을 위반했는지 명시
+  - 데이터베이스 목록: 서버, DB명, 사용자, 권한 등 상세 정보 표시
+
+### 📦 배포판 개선 (2025-10-15)
+- **배치 파일 자동 생성**: `create-release.js`에서 언어별 배치 파일 생성
+  - `run.bat`: `--lang=en` 자동 포함
+  - `실행하기.bat`: `--lang=kr` 자동 포함
+- **실행 파일 크기 최적화**: 압축으로 약 40% 크기 감소
+- **네이티브 모듈 포함**: DB 연결 라이브러리 정상 작동 보장
 
 ## v1.2.5 - 배치 인터페이스 개선 (2025-10-10)
 

app.js

@@ -6,6 +6,9 @@ const { execSync } = require('child_process');
 // pkg 실행 파일 경로 처리
 const APP_ROOT = process.pkg ? path.dirname(process.execPath) : __dirname;
 
+// pkg 환경에서 excel-cli 모듈 직접 로드
+const excelCli = process.pkg ? require('./src/excel-cli') : null;
+
 // ANSI 색상 코드
 const colors = {
     reset: '\x1b[0m',
@@ -276,15 +279,36 @@ async function validateQuery() {
     console.log();
 
     try {
-        const command = file.type === 'XML' 
-            ? `node src/excel-cli.js validate --xml "${file.path}"`
-            : `node src/excel-cli.js validate --query "${file.path}"`;
-        
-        execSync(command, { 
-            cwd: APP_ROOT, 
-            stdio: 'inherit',
-            encoding: 'utf8'
-        });
+        if (process.pkg) {
+            // pkg 환경: 직접 모듈 사용
+            const options = {
+                configFilePath: path.join(APP_ROOT, 'config', 'dbinfo.json'),
+                variables: {}
+            };
+            
+            if (file.type === 'XML') {
+                options.xmlFilePath = file.path;
+            } else {
+                options.queryFilePath = file.path;
+            }
+            
+            const isValid = await excelCli.validateQueryFile(options);
+            
+            if (!isValid) {
+                throw new Error('Validation failed');
+            }
+        } else {
+            // Node.js 환경: CLI 실행
+            const command = file.type === 'XML' 
+                ? `node src/excel-cli.js validate --xml "${file.path}"`
+                : `node src/excel-cli.js validate --query "${file.path}"`;
+            
+            execSync(command, { 
+                cwd: APP_ROOT, 
+                stdio: 'inherit',
+                encoding: 'utf8'
+            });
+        }
 
         console.log();
         console.log(colors.green + `  ${msg.validationCompleted}` + colors.reset);
@@ -309,11 +333,18 @@ async function testConnection() {
     console.log();
 
     try {
-        execSync('node src/excel-cli.js list-dbs', { 
-            cwd: APP_ROOT, 
-            stdio: 'inherit',
-            encoding: 'utf8'
-        });
+        if (process.pkg) {
+            // pkg 환경: 직접 모듈 사용
+            const configPath = path.join(APP_ROOT, 'config', 'dbinfo.json');
+            await excelCli.testAllDatabaseConnections(configPath);
+        } else {
+            // Node.js 환경: CLI 실행
+            execSync('node src/excel-cli.js list-dbs', { 
+                cwd: APP_ROOT, 
+                stdio: 'inherit',
+                encoding: 'utf8'
+            });
+        }
 
         console.log();
         console.log(colors.green + `  ${msg.connectionSuccess}` + colors.reset);
@@ -372,11 +403,36 @@ async function exportExcelXML() {
     const startTime = new Date();
 
     try {
-        execSync(`node src/excel-cli.js export --xml "${selectedFile.path}"`, { 
-            cwd: APP_ROOT, 
-            stdio: 'inherit',
-            encoding: 'utf8'
-        });
+        if (process.pkg) {
+            // pkg 환경: 직접 모듈 사용
+            const originalArgv = process.argv;
+            const originalExit = process.exit;
+
+            // process.exit를 무효화하여 프로그램이 종료되지 않도록 함
+            process.exit = (code) => {
+                if (code !== 0) {
+                    throw new Error(`Process exited with code ${code}`);
+                }
+            };
+
+            // --lang 옵션을 제외하고 재구성
+            const filteredArgs = originalArgv.slice(2).filter(arg => !arg.startsWith('--lang='));
+            process.argv = ['node', 'src/excel-cli.js', 'export', '--xml', selectedFile.path, ...filteredArgs];
+
+            try {
+                await excelCli.main();
+            } finally {
+                process.argv = originalArgv;
+                process.exit = originalExit;
+            }
+        } else {
+            // Node.js 환경: CLI 실행
+            execSync(`node src/excel-cli.js export --xml "${selectedFile.path}"`, { 
+                cwd: APP_ROOT, 
+                stdio: 'inherit',
+                encoding: 'utf8'
+            });
+        }
 
         const endTime = new Date();
 
@@ -438,11 +494,36 @@ async function exportExcelJSON() {
     const startTime = new Date();
 
     try {
-        execSync(`node src/excel-cli.js export --query "${selectedFile.path}"`, { 
-            cwd: APP_ROOT, 
-            stdio: 'inherit',
-            encoding: 'utf8'
-        });
+        if (process.pkg) {
+            // pkg 환경: 직접 모듈 사용
+            const originalArgv = process.argv;
+            const originalExit = process.exit;
+
+            // process.exit를 무효화하여 프로그램이 종료되지 않도록 함
+            process.exit = (code) => {
+                if (code !== 0) {
+                    throw new Error(`Process exited with code ${code}`);
+                }
+            };
+
+            // --lang 옵션을 제외하고 재구성
+            const filteredArgs = originalArgv.slice(2).filter(arg => !arg.startsWith('--lang='));
+            process.argv = ['node', 'src/excel-cli.js', 'export', '--query', selectedFile.path, ...filteredArgs];
+
+            try {
+                await excelCli.main();
+            } finally {
+                process.argv = originalArgv;
+                process.exit = originalExit;
+            }
+        } else {
+            // Node.js 환경: CLI 실행
+            execSync(`node src/excel-cli.js export --query "${selectedFile.path}"`, { 
+                cwd: APP_ROOT, 
+                stdio: 'inherit',
+                encoding: 'utf8'
+            });
+        }
 
         const endTime = new Date();
 

queries/test-sheet-name-validation.xml

@@ -11,42 +11,42 @@
   </sheet>
 
   <!-- 허용되지 않는 문자 포함: 백슬래시 -->
-  <sheet name="잘못된\시트명" use="true">
+  <sheet name="잘못된\시트명1" use="true">
     <![CDATA[
       SELECT '백슬래시 포함' as 상태
     ]]>
   </sheet>
 
   <!-- 허용되지 않는 문자 포함: 슬래시 -->
-  <sheet name="잘못된/시트명" use="true">
+  <sheet name="잘못된/시트명2" use="true">
     <![CDATA[
       SELECT '슬래시 포함' as 상태
     ]]>
   </sheet>
 
   <!-- 허용되지 않는 문자 포함: 콜론 -->
-  <sheet name="잘못된:시트명" use="true">
+  <sheet name="잘못된:시트명3" use="true">
     <![CDATA[
       SELECT '콜론 포함' as 상태
     ]]>
   </sheet>
 
   <!-- 허용되지 않는 문자 포함: 별표 -->
-  <sheet name="잘못된*시트명" use="true">
+  <sheet name="잘못된*시트명4" use="true">
     <![CDATA[
       SELECT '별표 포함' as 상태
     ]]>
   </sheet>
 
   <!-- 허용되지 않는 문자 포함: 물음표 -->
-  <sheet name="잘못된?시트명" use="true">
+  <sheet name="잘못된?시트명5" use="true">
     <![CDATA[
       SELECT '물음표 포함' as 상태
     ]]>
   </sheet>
 
   <!-- 허용되지 않는 문자 포함: 대괄호 -->
-  <sheet name="잘못된[시트명]" use="true">
+  <sheet name="잘못된[시트명]6" use="true">
     <![CDATA[
       SELECT '대괄호 포함' as 상태
     ]]>