ERP-node/.cursor/rules/multilang-component-guide.mdc

---
description: (Deprecated) 이 파일은 component-development-guide.mdc로 통합되었습니다.
alwaysApply: false
---

# 다국어 지원 컴포넌트 개발 가이드 (Deprecated)

> **이 문서는 더 이상 사용되지 않습니다.**
>
> 새로운 통합 가이드를 참조하세요: `component-development-guide.mdc`

다국어 지원을 포함한 모든 컴포넌트 개발 가이드가 다음 파일로 통합되었습니다:

**[component-development-guide.mdc](.cursor/rules/component-development-guide.mdc)**

통합된 가이드에는 다음 내용이 포함되어 있습니다:

1. **엔티티 조인 컬럼 활용 (필수)**

   - 화면을 새로 만들어 임베딩하는 방식 대신 엔티티 관계 활용
   - `entityJoinApi.getEntityJoinColumns()` 사용법
   - 설정 패널에서 조인 컬럼 표시 패턴

2. **폼 데이터 관리**

   - `useFormCompatibility` 훅 사용법
   - 레거시 `beforeFormSave` 이벤트 호환성

3. **다국어 지원**

   - 타입 정의 시 `langKeyId`, `langKey` 필드 추가
   - 라벨 추출/매핑 로직
   - 번역 표시 로직

4. **컬럼 설정 패널 구현**

   - 필수 구조 및 패턴

5. **체크리스트**
   - 새 컴포넌트 개발 시 확인 항목