Widget Grid Type Registration Checklist

Purpose

대시보드에 새로운 위젯(TableGrid/차트) 타입을 추가할 때 한쪽만 고쳐서 "메뉴는 뜨는데 렌더가 빈 값"이 되는 회귀를 막기 위한 전수 반영 체크리스트.

When to Activate

• TableGridType.XXX 같은 enum/리터럴에 신규 값 추가
• 새 차트/카드 위젯 종류 도입
• "타입 추가했는데 컬럼이 안 보인다", "optionsData 에 안 뜬다" 류 증상

5-Point Checklist

Step 1. columns 매핑 테이블 두 곳 모두 등록
        - tableGridTypeToColumns           (컬럼 정의)
        - tableGridTypeToColumnsMapping    (표시명/포맷 매핑)
Step 2. 데이터 fetch hook 분기 추가
        - fallbackUrl (타입별 기본 API 경로)
        - makeServerSideParams (타입별 쿼리 파라미터 조합)
Step 3. 에디터 폼에 분기 추가
        - optionsData 배열에 옵션 추가
        - handleChangeType 에 신규 타입 케이스
Step 4. detectType 유틸에 신규 타입 판정 조건 추가
Step 5. 모델/DTO 레이어에 신규 필드(있다면) 선언
        - shared/models/... 쪽 위젯 메인 DTO
        - 백엔드 DTO @JsonView 범위 동기화

Sub-pattern: 사용자 선택형 타입 (예: CUSTOM_TABLE)