열 이름 미표시: 헤더/fallback 생성 및 Preview 노출 개선 #11

New Issue

lectom · 2026-01-09T16:42:51+09:00

lectom commented

2026-01-09 16:42:51 +09:00

현상

Raw Preview와 Parsed Result 키에서 오른쪽 축(Top Header) 이름이 비어 있어 Sheet:좌측---- 형태로만 생성되는 열이 존재합니다.
머지된 헤더나 비어 있는 헤더 셀이 있는 경우 열 이름이 UI에도 노출되지 않아 어떤 데이터가 어떤 컬럼인지 식별하기 어렵습니다.

영향

Key 식별성이 떨어져 SchemaRegistry 등록/탐색, 저장소 조회 시 혼선 가능.
머지 헤더가 해제되어도 이름이 비어 있으면 추적/검색 기능이 제한됩니다.

원인 추정

ExcelKv.Core/ExcelLoader.FlattenTopHeaders가 비어 있는 헤더 셀을 그대로 빈 문자열로 둠.
Raw Preview 헤더 렌더링이 첫 행 길이 기준(#2 관련)이라 후행 열 이름이 숨겨질 수 있음.

개선 계획(초안)

Raw 데이터 전체의 최대 열 길이를 기준으로 헤더/바디를 패딩해 열 이름 표시 영역 확보(관련: #2와 함께 처리).
FlattenTopHeaders에서 비어 있는 열에 대해 fallback 이름(Col_{index} 등) 생성 옵션을 추가하고, RegionConfig에서 on/off 가능하게 설계.
UI(Rendering)에서 Preview 헤더에 실제/대체 열 이름을 표시하고 Parsed Result 키에도 반영되는지 확인.
회귀 테스트: sample_data의 머지/빈 헤더 케이스로 키가 Sheet:Left----<ColName> 형태로 생성되고 빈 열 이름이 남지 않는지 검증.

산출물

코드 수정(PR) 및 재현/검증 로그

## 현상 - Raw Preview와 Parsed Result 키에서 오른쪽 축(Top Header) 이름이 비어 있어 `Sheet:좌측----` 형태로만 생성되는 열이 존재합니다. - 머지된 헤더나 비어 있는 헤더 셀이 있는 경우 열 이름이 UI에도 노출되지 않아 어떤 데이터가 어떤 컬럼인지 식별하기 어렵습니다. ## 영향 - Key 식별성이 떨어져 SchemaRegistry 등록/탐색, 저장소 조회 시 혼선 가능. - 머지 헤더가 해제되어도 이름이 비어 있으면 추적/검색 기능이 제한됩니다. ## 원인 추정 - `ExcelKv.Core/ExcelLoader.FlattenTopHeaders`가 비어 있는 헤더 셀을 그대로 빈 문자열로 둠. - Raw Preview 헤더 렌더링이 첫 행 길이 기준(#2 관련)이라 후행 열 이름이 숨겨질 수 있음. ## 개선 계획(초안) 1) Raw 데이터 전체의 최대 열 길이를 기준으로 헤더/바디를 패딩해 열 이름 표시 영역 확보(관련: #2와 함께 처리). 2) `FlattenTopHeaders`에서 비어 있는 열에 대해 fallback 이름(`Col_{index}` 등) 생성 옵션을 추가하고, RegionConfig에서 on/off 가능하게 설계. 3) UI(Rendering)에서 Preview 헤더에 실제/대체 열 이름을 표시하고 Parsed Result 키에도 반영되는지 확인. 4) 회귀 테스트: sample_data의 머지/빈 헤더 케이스로 키가 `Sheet:Left----<ColName>` 형태로 생성되고 빈 열 이름이 남지 않는지 검증. ## 산출물 - 코드 수정(PR) 및 재현/검증 로그

👍 1

lectom added the enhancement label 2026-01-09 16:42:53 +09:00

cyhan closed this issue

2026-01-09 19:22:21 +09:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: cyhan/bim-dogma-poc#11