# 공식 지침과 프로젝트 규칙

확인일: 2026-07-24

## 확인됨: 행정안전부 고시

출처 파일: `backend/references/공공기관의 데이터베이스 표준화 지침(제2025-19호)(20250224).hwpx`

신뢰도: 높음. 국가법령정보센터에서 제공한 행정안전부고시 제2025-19호 원문이다.

핵심 근거:

- 제8조: 기관 및 개별 데이터베이스 표준에 표준용어, 표준단어, 표준도메인, 표준코드를
  정의하고 최신성을 유지한다.
- 제9조: 논리·물리 모델과 엔터티·속성·테이블·컬럼 정의서를 작성하고 메타데이터를
  등록·현행화한다.
- 별표 1: 표준용어명은 한글 사용을 원칙으로 하고 공백과 특수문자를 사용하지 않는다.
- 별표 1: 표준단어는 영문명·영문약어명·형식단어 여부·도메인분류명·금칙어를 관리한다.
- 별표 1: 표준도메인은 도메인분류명, 타입, 길이, 소수점 길이, 형식, 단위, 허용값을
  관리한다.
- 별표 1: 컬럼 한글명은 논리 속성과 표준용어를 따르고 영문명은 등록된 용어를 사용하며,
  데이터 길이는 표준도메인 정의를 따른다.

## 프로젝트 강제 규칙

다음은 사용자 요청으로 정한 기관 내부 규칙이며 고시 자체의 문구가 아니다.

- 테이블 물리명은 논리 테이블명을 구성하는 활성 표준단어의 영문약어를 조합하고 `TB_`를
  붙인 대문자 스네이크 형식이다.
- 테이블마다 PK는 하나이며 이름은 `{table_name}_SN`이다.
- PK는 NOT NULL 숫자형이고 `일련번호` 분류의 활성 표준도메인을 사용한다.
- 논리 용어는 활성 표준단어만으로 완전히 구성한다.
- 논리 용어의 마지막 단어는 형식단어여야 한다.
- 컬럼은 활성 표준도메인을 명시한다.
- 모든 테이블 마지막에 등록일시, 등록자아이디, 수정일시, 수정자아이디를 고정 순서와
  프로젝트 표준 정의로 둔다.
- 코드 분류 도메인은 승인된 기관 코드그룹을 명시적으로 참조한다.
- 기관표준과 코드사전은 작성·승인을 분리하고 버전 및 불변 변경이력을 관리한다.

공통표준용어에 없는 조합용어가 이 조건을 통과하면 기관 또는 개별 DB 표준사전에 별도로
등록해야 하므로 `institution_term_registration_required` 경고를 남긴다.

## 구현상 추가 경고

- 마지막 형식단어의 도메인분류명과 지정 도메인의 분류명이 다르면 경고한다. 공통표준
  원본에도 업무상 예외가 있어 오류로 강제하지 않는다.
- 테이블 또는 컬럼 정의 설명이 없으면 표준화 산출물 누락 가능성으로 경고한다.
- 외래키 컬럼에 인덱스가 없으면 성능 검토 대상으로 경고한다.