각 시트 상단에 출처 DB명 출력 기능 추가

Author: mrjung72

README.md

@@ -140,6 +140,7 @@ node src/index.js -q resources/queries-sample.json --db main --out output/result
 - **컬럼별 집계 데이터 표시** (목차 시트에서 한눈에 확인)
 - **조회 건수 제한 기능** (대용량 데이터 처리 시 안전장치)
 - **시트별 다중 DB 연결** (여러 데이터베이스의 데이터를 하나의 엑셀로 통합)
+- **DB 출처 표시** (각 시트 상단에 데이터 출처 DB 자동 표시)
 
 ---
 
@@ -281,6 +282,7 @@ node src/index.js -q resources/queries-sample.json --db main --out output/result
 - DB 연결 풀을 효율적으로 관리하여 동일 DB는 재사용
 - 시트별 DB 설정이 없으면 기본 DB 사용
 - 모든 작업 완료 후 자동으로 모든 DB 연결 정리
+- **각 시트 상단에 데이터 출처 DB명 자동 표시** (연한 파란색 배경)
 
 #### XML에서 시트별 DB 지정
 ```xml
@@ -357,6 +359,36 @@ node src/index.js -q resources/queries-sample.json --db main --out output/result
 - **환경별 비교**: 개발/스테이징/운영 DB의 동일 테이블 비교
 - **데이터 마이그레이션**: 구버전과 신버전 DB 데이터 비교
 
+### DB 출처 표시 기능
+각 데이터 시트의 맨 위에 해당 데이터가 어떤 데이터베이스에서 가져온 것인지 자동으로 표시됩니다.
+
+#### 표시 형태
+```
+📊 데이터 출처: sampleDB 데이터베이스
+[빈 행]
+[헤더 행]
+[데이터 행들...]
+```
+
+#### 스타일링
+- **배경색**: 연한 파란색 (`#E7F3FF`)
+- **글꼴**: 굵게, 11pt, 파란색 (`#2F5597`)
+- **아이콘**: 📊 차트 이모지로 시각적 구분
+- **구분**: 빈 행으로 DB 정보와 데이터 구분
+
+#### 데이터 없는 경우
+```
+📊 데이터 출처: orderDB 데이터베이스
+[빈 행]
+데이터가 없습니다.
+```
+
+#### 장점
+- **데이터 추적성**: 각 시트의 데이터 출처를 명확하게 파악
+- **신뢰성**: 여러 DB 통합 시 데이터 혼동 방지
+- **문서화**: 별도 설명 없이도 데이터 출처 자동 기록
+- **시각적 구분**: 연한 파란색 배경으로 쉽게 식별 가능
+
 ### 목차 시트 특징
 - **하이퍼링크**: 시트명, 데이터 건수, 집계 정보 클릭 시 해당 시트로 즉시 이동
 - **시트명 자동 처리**: 31자 초과 시 자동 잘림 및 원본명 주석 표시

src/excel-style-helper.js

@@ -139,6 +139,22 @@ function applyHeaderStyle(sheet, columns, headerStyle) {
   }
 }
 
+/**
+ * 지정된 행에 헤더 스타일을 적용
+ * @param {Object} sheet - ExcelJS 워크시트 객체
+ * @param {Array} columns - 컬럼 배열
+ * @param {Object} headerStyle - 헤더 스타일 객체
+ * @param {number} rowNumber - 헤더가 위치할 행 번호
+ */
+function applyHeaderStyleAtRow(sheet, columns, headerStyle, rowNumber) {
+  if (!headerStyle || !sheet || !columns) return;
+
+  for (let i = 1; i <= columns.length; i++) {
+    const cell = sheet.getRow(rowNumber).getCell(i);
+    applyCellStyle(cell, headerStyle);
+  }
+}
+
 /**
  * 데이터 행들에 스타일을 적용
  * @param {Object} sheet - ExcelJS 워크시트 객체
@@ -158,6 +174,26 @@ function applyBodyStyle(sheet, columns, dataRowCount, bodyStyle) {
   }
 }
 
+/**
+ * 지정된 시작 행부터 데이터 행들에 스타일을 적용
+ * @param {Object} sheet - ExcelJS 워크시트 객체
+ * @param {Array} columns - 컬럼 배열
+ * @param {number} dataRowCount - 데이터 행 수
+ * @param {Object} bodyStyle - 데이터 스타일 객체
+ * @param {number} startRow - 데이터 시작 행 번호
+ */
+function applyBodyStyleAtRow(sheet, columns, dataRowCount, bodyStyle, startRow) {
+  if (!bodyStyle || !sheet || !columns || dataRowCount <= 0) return;
+
+  for (let r = 0; r < dataRowCount; r++) {
+    const row = sheet.getRow(startRow + r);
+    for (let i = 1; i <= columns.length; i++) {
+      const cell = row.getCell(i);
+      applyCellStyle(cell, bodyStyle);
+    }
+  }
+}
+
 /**
  * 컬럼 너비를 자동으로 계산
  * @param {Array} columns - 컬럼명 배열
@@ -194,7 +230,7 @@ function calculateColumnWidths(columns, data, colwidths = { min: 10, max: 30 })
  * @param {Object} excelStyle.header - 헤더 스타일
  * @param {Object} excelStyle.body - 데이터 스타일
  */
-function applySheetStyle(sheet, data, excelStyle) {
+function applySheetStyle(sheet, data, excelStyle, startRow = 1) {
   if (!sheet || !data || data.length === 0) return;
 
   const columns = Object.keys(data[0]);
@@ -217,17 +253,28 @@ function applySheetStyle(sheet, data, excelStyle) {
     sheet.columns = columns.map(key => ({ header: key, key }));
   }
 
-  // 데이터 추가
-  sheet.addRows(data);
+  // 헤더 행 추가 (startRow 위치에)
+  const headerRow = sheet.getRow(startRow);
+  columns.forEach((col, index) => {
+    headerRow.getCell(index + 1).value = col;
+  });
+
+  // 데이터 행 추가 (startRow + 1부터)
+  data.forEach((row, rowIndex) => {
+    const dataRow = sheet.getRow(startRow + 1 + rowIndex);
+    columns.forEach((col, colIndex) => {
+      dataRow.getCell(colIndex + 1).value = row[col];
+    });
+  });
 
-  // 헤더 스타일 적용
+  // 헤더 스타일 적용 (startRow에 적용)
   if (excelStyle.header) {
-    applyHeaderStyle(sheet, columns, excelStyle.header);
+    applyHeaderStyleAtRow(sheet, columns, excelStyle.header, startRow);
   }
 
-  // 데이터 스타일 적용
+  // 데이터 스타일 적용 (startRow + 1부터)
   if (excelStyle.body) {
-    applyBodyStyle(sheet, columns, data.length, excelStyle.body);
+    applyBodyStyleAtRow(sheet, columns, data.length, excelStyle.body, startRow + 1);
   }
 }
 

src/index.js

@@ -388,8 +388,31 @@ async function main() {
       }
 
       if (recordCount > 0) {
-        // 헬퍼 함수를 사용하여 시트에 데이터와 스타일 적용
-        excelStyleHelper.applySheetStyle(sheet, result.recordset, excelStyle);
+        // 데이터와 스타일 적용 (1행부터 시작)
+        excelStyleHelper.applySheetStyle(sheet, result.recordset, excelStyle, 1);
+        
+        // 데이터 추가 후 맨 앞에 DB 정보 행 삽입
+        sheet.spliceRows(1, 0, [`📊 출처: ${sheetDbKey} DB`]);
+        sheet.spliceRows(2, 0, []);  // 빈 행 추가
+        
+        // DB 정보 셀 스타일링
+        const dbCell = sheet.getCell('A1');
+        dbCell.font = { bold: true, size: 11, color: { argb: 'FFFFFF' } };
+        dbCell.fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: '366092' } };
+        
+        console.log(`\t[DB정보] ${sheetDbKey} DB 출처 표시 완료`);
+      } else {
+        // 데이터가 없는 경우
+        sheet.addRow([`📊 출처: ${sheetDbKey} DB`]);
+        sheet.addRow([]);
+        sheet.addRow(['데이터가 없습니다.']);
+        
+        // 스타일링
+        sheet.getCell('A1').font = { bold: true, size: 11, color: { argb: 'FFFFFF' } };
+        sheet.getCell('A1').fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: '366092' } };
+        sheet.getCell('A3').font = { italic: true, color: { argb: '999999' } };
+        
+        console.log(`\t[DB정보] ${sheetDbKey} DB 출처 표시 완료 (데이터 없음)`);
       }
       console.log(`\t---> ${recordCount} rows were selected `);
     } catch (error) {