# 명명 표준

> 공유 단어사전과 명명 규칙이 어떻게 모든 테이블·컬럼의 일관된 물리명이 되는지 — Sqemo의 동작 방식.

명명 규칙은 보통 아무도 읽지 않는 위키에 삽니다. Sqemo는 그 규칙을 모든 컬럼에서
실행되는 규칙으로 바꿉니다: 업무 용어로 모델링하면, 팀이 관리하는 단어사전에서
물리명이 생성됩니다.

> 캡처는 영문 UI입니다. 앱은 브라우저 언어를 따라 한국어로 뜨므로, 아래 본문은
> 화면 라벨을 **한글(영문)** 으로 병기합니다.

## 단어사전

단어사전(Word list)은 논리 단어 하나를 표준 물리 단어 하나에 대응시킵니다 —
예를 들어 "고객" → `cust`, "번호" → `no`. 논리명 "고객 번호"를 치면 물리 컬럼은
`cust_no`로 나옵니다. 매번, 누구에게나 같은 이름입니다. 단어사전은 가져오기·
내보내기가 되고, 중복 단어가 끼어드는 것은 Sqemo가 막습니다.

단어는 절반입니다: "고객 번호"라는 용어 전체가 *무엇을 뜻하는지*는
[용어사전(Business glossary)](/ko/docs/business-glossary/)에 있고, 이것은 따로
관리하는 문서가 아니라 모델에서 파생됩니다.

## 명명 규칙

명명 규칙(Naming rules)은 생성된 단어를 어떻게 조립할지 — 대소문자 스타일과
구분자 — 그리고 논리명에 단어사전에 아직 없는 단어가 쓰였을 때 어떻게 할지
(미등록 단어 처리, `unknown word mode`)를 정합니다:

- **경고(warn)** — 미등록 단어를 표시해 단어사전에 추가되게 합니다.
- **유지(keep)** — 단어를 그대로 씁니다.
- **로마자(romanize)** — 로마자로 옮깁니다.

## 예외는 드러나게

물리명이 생성값과 달라야 할 때가 있습니다. 덮어쓸 수 있습니다 — 그 항목은
수동(`manual override`)으로 표시되고 자동 재생성에서 빠지므로, 단어사전이 바뀌어도
조용히 다시 쓰이지 않습니다. 예외가 눈에 보인다는 점이 중요합니다: 보이지 않는
예외가 명명 표준이 죽는 방식이기 때문입니다.

## 준수 검사

- **앱에서** — 검증(Validation)이 미등록 단어가 든 논리명과 표준에서 벗어난
  물리명을 표시합니다.
- **CI에서** — [MCP/CLI 패키지](/ko/docs/mcp/)가 프로젝트 파일을 린트하고 위반이
  있으면 빌드를 실패시킵니다:

```bash
npx sqemo-mcp lint schema.erd.json   # 위반이 있으면 종료 코드 1
```

## 팀 전체에 표준 하나

워크스페이스에서는 단어사전과 명명 규칙이 **팀 표준(Team standard)** 이 되어,
연결된 모든 ERD가 거기서 이름을 생성합니다. 멤버가 새 단어를 제안하고, 표준
소유자가 승인하면, 승인된 단어가 연결된 프로젝트로 전파됩니다.
[공유와 협업](/ko/docs/collaboration/)을 보거나, 단어 하나가 제안에서 컬럼명 변경까지
가는 과정을 담은 [2분 영상](https://youtu.be/wHsoFbak6GY)을 보세요.

프로젝트가 연결돼 있는 동안 검증 패널 위의 상태 바가 표준과 동기화됐는지 보여 주고,
진입점 — 최신 버전 가져오기(Pull), 제안 목록, 준수 현황 — 을 담습니다:

![연결된 프로젝트의 팀 표준 바: 동기화 상태, Pull, 멤버·설정 관리, 대기 건수가 붙은 제안 목록, 준수 현황 진입점.](/screenshots/docs/team-standard-bar.png)

---
Source: https://sqemo.com/ko/docs/naming-standards/ · Updated 2026-08-29