invyone/db/migrations/RUN_089_MIGRATION.md

089 마이그레이션 — IS_SOLUTION_ONLY 메뉴 플래그 + TABLE_TYPE_COLUMNS.CODE_CATEGORY rename

작성일: 2026-05-15 작성자: johngreen 관련:

• (V023) 멀티테넌시 메뉴 격리 — 5/15 fix (commit c530a67c)
• (V024) common-code 마스터-디테일 재설계 — 5/15 refactor (commit 2348800e)

목적

V023 과 V024 두 건의 누락된 운영 문서를 합본 처리. 앱 부팅 시 StartupSchemaMigrator 가 idempotent 로 메타 DB + 활성 테넌트 DB 전부에 자동 적용한다.

V023 — MENU_INFO.IS_SOLUTION_ONLY 컬럼 (회상)

테넌트 사이트(*.invyone.com)에서 솔루션 전용 관리자 메뉴(회사관리/회사 프로비저닝/감사로그)를 숨기기 위한 플래그.

• 메뉴 mapper SQL(selectAdminMenuList, selectUserMenuList)이 is_management_host 파라미터를 보고 IS_SOLUTION_ONLY=TRUE 행을 제외.
• 이미 부팅 마이그레이션으로는 적용 중이지만 RUN_*.md 운영 문서가 빠져있어 이번 089 에 합본.

V024 — TABLE_TYPE_COLUMNS.CODE_CATEGORY → CODE_INFO (★ 신규, 본 PR 의 핵심)

5/15 의 commonCode 마스터-디테일 재설계(commit 2348800e)가 mapper SQL 6 군데에서 CL.CODE_CATEGORY → CL.CODE_INFO 로 컬럼 참조명을 바꿨지만, DB 컬럼 rename SQL 을 빠뜨린 채 머지됨. 그 결과 모든 테넌트 DB 의 테이블 타입관리 > 테이블 클릭 > 컬럼 목록 API (GET /api/table-management/tables/{name}/columns) 가 500 반환:

ERROR: column cl.code_info does not exist

본 089 마이그레이션이 CODE_CATEGORY → CODE_INFO 로 컬럼명을 안전하게 변경한다.

스키마

MENU_INFO (V023)

컬럼	타입	제약	설명
IS_SOLUTION_ONLY	BOOLEAN	NOT NULL DEFAULT FALSE	TRUE 인 메뉴는 솔루션 관리 호스트에서만 노출

TABLE_TYPE_COLUMNS (V024)

변경	설명
CODE_CATEGORY → CODE_INFO	컬럼 RENAME (값/타입/제약 그대로)

SQL

-- =================================================================
-- 089-V023: MENU_INFO.IS_SOLUTION_ONLY (idempotent)
-- =================================================================

ALTER TABLE MENU_INFO
    ADD COLUMN IF NOT EXISTS IS_SOLUTION_ONLY BOOLEAN DEFAULT FALSE NOT NULL;

UPDATE MENU_INFO
   SET IS_SOLUTION_ONLY = TRUE
 WHERE IS_SOLUTION_ONLY = FALSE
   AND MENU_URL IN (
       '/admin/sysMng/subdomainList',
       '/admin/userMng/companyList',
       '/admin/audit-log'
   );

-- =================================================================
-- 089-V024: TABLE_TYPE_COLUMNS.CODE_CATEGORY → CODE_INFO (idempotent)
-- =================================================================
-- PostgreSQL 은 RENAME COLUMN 에 IF EXISTS 가 없으므로 DO 블록으로
-- 멱등성 보장 (이미 CODE_INFO 면 no-op, CODE_CATEGORY 만 존재할 때만 rename).

DO $$
BEGIN
    IF EXISTS (
        SELECT 1 FROM information_schema.columns
         WHERE table_schema = 'public'
           AND table_name   = 'table_type_columns'
           AND column_name  = 'code_category'
    ) AND NOT EXISTS (
        SELECT 1 FROM information_schema.columns
         WHERE table_schema = 'public'
           AND table_name   = 'table_type_columns'
           AND column_name  = 'code_info'
    ) THEN
        ALTER TABLE TABLE_TYPE_COLUMNS
            RENAME COLUMN CODE_CATEGORY TO CODE_INFO;
    END IF;
END $$;

멱등성

• V023: ADD COLUMN IF NOT EXISTS + UPDATE WHERE IS_SOLUTION_ONLY = FALSE 로 중복 실행 안전.
• V024: DO 블록 안에서 information_schema 로 현재 상태 확인 후 분기.
  • 신규 테넌트 DB (이미 CODE_INFO 면): no-op
  • 기존 테넌트 DB (CODE_CATEGORY 만 있으면): rename 수행
  • 둘 다 있거나 둘 다 없으면: no-op (방어적)

적용 방법

부팅 시 자동 적용 — 별도 작업 불필요. backend-spring/src/main/java/com/erp/migration/StartupSchemaMigrator.java 의 MIGRATIONS 리스트에 위 SQL 이 등록되어 있어서 앱이 시작할 때 모든 활성 테넌트 DB 에 idempotent 로 실행된다.

수동 적용이 필요한 경우 (예: 새 환경 부트스트랩 전):

psql -h <host> -U <user> -d <tenant_db> -f - <<'SQL'
-- 위 SQL 본문 붙여넣기
SQL

검증

-- V023
SELECT COLUMN_NAME FROM information_schema.columns
 WHERE TABLE_NAME = 'menu_info' AND COLUMN_NAME = 'is_solution_only';
-- → 1 row

SELECT MENU_URL, IS_SOLUTION_ONLY FROM MENU_INFO
 WHERE MENU_URL IN ('/admin/sysMng/subdomainList', '/admin/userMng/companyList', '/admin/audit-log');
-- → 모두 IS_SOLUTION_ONLY = TRUE

-- V024
SELECT COLUMN_NAME FROM information_schema.columns
 WHERE TABLE_NAME = 'table_type_columns' AND COLUMN_NAME IN ('code_category', 'code_info');
-- → 1 row: code_info  (code_category 는 존재하면 안 됨)

영향 범위

• 테이블 타입관리 페이지 컬럼 조회 500 에러 해소.
• common-code 재설계 후속 (mapper/Service/Frontend 는 이미 5/15 에 머지됨).
• 부팅 시점 1회 실행 — 런타임 트래픽에는 영향 없음.

롤백

V024 rename 을 되돌리려면 mapper SQL 도 같이 되돌려야 하므로 일반적으로 권장하지 않음. 만약 필요하면:

ALTER TABLE TABLE_TYPE_COLUMNS RENAME COLUMN CODE_INFO TO CODE_CATEGORY;

• mapper/tableManagement.xml, commonCode.xml, FE commonCode.ts 등 5/15 변경분 revert.