pipeline/.cursor/skills/table-sql/SKILL.md

name, description

name	description
table-sql	리포트 관련 테이블 SQL 작성 가이드. 리포트 테이블 생성 DDL, 메타데이터 등록 시 사용.

리포트 테이블 SQL 작성 가이드

수정 범위 제약

리포트 관련 테이블(report_master, report_details 등)만 대상. 기존 테이블 구조는 수정하지 않는다.

핵심 원칙

1. 모든 비즈니스 컬럼은 VARCHAR(500)로 통일
2. 날짜/시간 컬럼만 TIMESTAMP 사용
3. 기본 컬럼 5개 자동 포함: id, created_date, updated_date, writer, company_code
4. 3개 메타데이터 테이블 등록 필수: table_labels, column_labels, table_type_columns

테이블 생성 DDL 템플릿

CREATE TABLE "테이블명" (
  "id" varchar(500) PRIMARY KEY DEFAULT gen_random_uuid()::text,
  "created_date" timestamp DEFAULT now(),
  "updated_date" timestamp DEFAULT now(),
  "writer" varchar(500) DEFAULT NULL,
  "company_code" varchar(500),
  -- 사용자 정의 컬럼
  "컬럼1" varchar(500),
  "컬럼2" varchar(500)
);

메타데이터 등록 (3개 필수)

INSERT INTO table_labels (table_name, display_name, description, company_code)
VALUES ('테이블명', '표시명', '설명', '회사코드');

INSERT INTO column_labels (table_name, column_name, display_name, company_code)
VALUES ('테이블명', '컬럼명', '표시명', '회사코드');

INSERT INTO table_type_columns (table_name, column_name, column_type, display_order, company_code)
VALUES ('테이블명', '컬럼명', 'VARCHAR', 순서, '회사코드');