새로운 문서 파일을 추가하여 현재 사용 가능한 16개 컴포넌트의 다국어 지원 및 테이블 설정 기능 현황을 정리했습니다. 각 컴포넌트별 상세 현황과 우선순위 작업 목록을 포함하여 기능 적용 상태를 명확히 하였습니다.

This commit is contained in:
kjs
2026-01-15 17:00:21 +09:00
parent e937ba9161
commit 57d86c8ef1
3 changed files with 293 additions and 483 deletions

View File

@@ -0,0 +1,148 @@
# 컴포넌트 기능 현황
> 작성일: 2026-01-15
> 현재 사용 가능한 16개 컴포넌트의 다국어 지원 및 테이블 설정 기능 현황
---
## 요약
| 기능 | 적용 완료 | 미적용 | 해당없음 |
|------|----------|--------|---------|
| **다국어 지원** | 3개 | 10개 | 3개 |
| **컴포넌트별 테이블 설정** | 4개 | 6개 | 6개 |
---
## 컴포넌트별 상세 현황
### 데이터 표시 (Display) - 4개
| 컴포넌트 | 다국어 지원 | 테이블 설정 | 비고 |
|---------|:----------:|:----------:|------|
| **테이블 리스트** | ✅ 적용 | ✅ 적용 | `customTableName`, `useCustomTable` 지원 |
| **카드 디스플레이** | ❌ 미적용 | ⚠️ 부분 | `screenTableName`만 사용, 컴포넌트별 테이블 선택 UI 없음 |
| **텍스트 표시** | ❌ 미적용 | 해당없음 | 정적 텍스트 표시용 |
| **피벗 그리드** | ❌ 미적용 | ⚠️ 부분 | `tableName` 설정 가능하나 Combobox UI 없음 |
---
### 데이터 입력 (Data) - 2개
| 컴포넌트 | 다국어 지원 | 테이블 설정 | 비고 |
|---------|:----------:|:----------:|------|
| **통합 반복 데이터** | ❌ 미적용 | ✅ 적용 | `mainTableName`, `foreignKeyColumn` 지원, Combobox UI 적용 |
| **반복 화면 모달** | ❌ 미적용 | ⚠️ 부분 | `tableName` 설정 가능하나 Combobox UI 없음 |
---
### 액션 (Action) - 1개
| 컴포넌트 | 다국어 지원 | 테이블 설정 | 비고 |
|---------|:----------:|:----------:|------|
| **기본 버튼** | ✅ 적용 | 해당없음 | `langKeyId`, `langKey` 지원 |
---
### 레이아웃 (Layout) - 5개
| 컴포넌트 | 다국어 지원 | 테이블 설정 | 비고 |
|---------|:----------:|:----------:|------|
| **분할 패널** | ✅ 적용 | ⚠️ 부분 | 다국어 지원, 테이블 설정은 하위 패널에서 처리 |
| **탭 컴포넌트** | ❌ 미적용 | 해당없음 | 화면 전환용 컨테이너 |
| **Section Card** | ❌ 미적용 | 해당없음 | 그룹화 컨테이너 |
| **Section Paper** | ❌ 미적용 | 해당없음 | 그룹화 컨테이너 |
| **구분선** | ❌ 미적용 | 해당없음 | 시각적 구분용 |
---
### 유틸리티 (Utility) - 4개
| 컴포넌트 | 다국어 지원 | 테이블 설정 | 비고 |
|---------|:----------:|:----------:|------|
| **코드 채번 규칙** | ❌ 미적용 | 해당없음 | 채번 규칙 관리 전용 |
| **렉 구조 설정** | ❌ 미적용 | 해당없음 | 창고 렉 설정 전용 |
| **출발지/도착지 선택** | ❌ 미적용 | ⚠️ 부분 | `customTableName` 지원하나 Combobox UI 없음 |
| **검색 필터** | ❌ 미적용 | ⚠️ 부분 | `screenTableName` 자동 감지 |
---
## 상세 설명
### 다국어 지원 (`langKeyId`, `langKey`)
다국어 지원이란 컴포넌트의 라벨, 플레이스홀더 등 텍스트 속성에 다국어 키를 연결하여 언어별로 다른 텍스트를 표시하는 기능입니다.
**적용 완료 (3개)**
- `table-list`: 컬럼 라벨 다국어 지원
- `button-primary`: 버튼 텍스트 다국어 지원
- `split-panel-layout`: 패널 제목 다국어 지원
**미적용 (10개)**
- `card-display`, `text-display`, `pivot-grid`
- `unified-repeater`, `repeat-screen-modal`
- `tabs`, `section-card`, `section-paper`, `divider-line`
- `numbering-rule`, `rack-structure`, `location-swap-selector`, `table-search-widget`
---
### 컴포넌트별 테이블 설정 (`customTableName`, `useCustomTable`)
컴포넌트별 테이블 설정이란 화면의 메인 테이블과 별개로 컴포넌트가 자체적으로 사용할 테이블을 지정할 수 있는 기능입니다.
**완전 적용 (4개)**
| 컴포넌트 | 적용 방식 |
|---------|----------|
| `table-list` | Combobox UI로 테이블 선택, `customTableName`, `useCustomTable`, `isReadOnly` 지원 |
| `unified-repeater` | Combobox UI로 테이블 선택, `mainTableName`, `foreignKeyColumn` 지원, FK 자동 연결 |
| `unified-list` | `TableListConfigPanel` 래핑하여 동일 기능 제공 |
**부분 적용 (6개)**
| 컴포넌트 | 현재 상태 | 필요 작업 |
|---------|----------|----------|
| `card-display` | `screenTableName` 사용 | Combobox UI 추가 필요 |
| `pivot-grid` | `tableName` 설정 가능 | Combobox UI 추가 필요 |
| `repeat-screen-modal` | `tableName` 설정 가능 | Combobox UI 추가 필요 |
| `split-panel-layout` | 하위 패널에서 처리 | 하위 컴포넌트에 위임 |
| `location-swap-selector` | `customTableName` 지원 | Combobox UI 추가 필요 |
| `table-search-widget` | `screenTableName` 자동 감지 | 현재 방식 유지 가능 |
**해당없음 (6개)**
- `text-display`, `divider-line`: 정적 컴포넌트
- `tabs`, `section-card`, `section-paper`: 레이아웃 컨테이너
- `numbering-rule`, `rack-structure`: 특수 목적 컴포넌트
---
## 우선순위 작업 목록
### 1순위: 데이터 컴포넌트 테이블 설정 UI 통일
| 컴포넌트 | 작업 내용 |
|---------|----------|
| `card-display` | Combobox UI 추가, `customTableName` 지원 |
| `pivot-grid` | Combobox UI 추가 |
| `repeat-screen-modal` | Combobox UI 추가 |
### 2순위: 다국어 지원 확대
| 컴포넌트 | 작업 내용 |
|---------|----------|
| `unified-repeater` | 컬럼 라벨 `langKeyId` 지원 |
| `card-display` | 필드 라벨 `langKeyId` 지원 |
| `tabs` | 탭 이름 `langKeyId` 지원 |
| `section-card` | 제목 `langKeyId` 지원 |
---
## 범례
| 기호 | 의미 |
|-----|------|
| ✅ | 완전 적용 |
| ⚠️ | 부분 적용 (기능은 있으나 UI 미비) |
| ❌ | 미적용 |
| | 해당없음 (기능 불필요) |