명명 표준
갱신
명명 규칙은 보통 아무도 읽지 않는 위키에 삽니다. Sqemo는 그 규칙을 모든 컬럼에서 실행되는 규칙으로 바꿉니다: 업무 용어로 모델링하면, 팀이 관리하는 단어사전에서 물리명이 생성됩니다.
캡처는 영문 UI입니다. 앱은 브라우저 언어를 따라 한국어로 뜨므로, 아래 본문은 화면 라벨을 한글(영문) 으로 병기합니다.
단어사전
단어사전(Word list)은 논리 단어 하나를 표준 물리 단어 하나에 대응시킵니다 —
예를 들어 “고객” → cust, “번호” → no. 논리명 “고객 번호”를 치면 물리 컬럼은
cust_no로 나옵니다. 매번, 누구에게나 같은 이름입니다. 단어사전은 가져오기·
내보내기가 되고, 중복 단어가 끼어드는 것은 Sqemo가 막습니다.
단어는 절반입니다: “고객 번호”라는 용어 전체가 무엇을 뜻하는지는 용어사전(Business glossary)에 있고, 이것은 따로 관리하는 문서가 아니라 모델에서 파생됩니다.
명명 규칙
명명 규칙(Naming rules)은 생성된 단어를 어떻게 조립할지 — 대소문자 스타일과
구분자 — 그리고 논리명에 단어사전에 아직 없는 단어가 쓰였을 때 어떻게 할지
(미등록 단어 처리, unknown word mode)를 정합니다:
- 경고(warn) — 미등록 단어를 표시해 단어사전에 추가되게 합니다.
- 유지(keep) — 단어를 그대로 씁니다.
- 로마자(romanize) — 로마자로 옮깁니다.
예외는 드러나게
물리명이 생성값과 달라야 할 때가 있습니다. 덮어쓸 수 있습니다 — 그 항목은
수동(manual override)으로 표시되고 자동 재생성에서 빠지므로, 단어사전이 바뀌어도
조용히 다시 쓰이지 않습니다. 예외가 눈에 보인다는 점이 중요합니다: 보이지 않는
예외가 명명 표준이 죽는 방식이기 때문입니다.
준수 검사
- 앱에서 — 검증(Validation)이 미등록 단어가 든 논리명과 표준에서 벗어난 물리명을 표시합니다.
- CI에서 — MCP/CLI 패키지가 프로젝트 파일을 린트하고 위반이 있으면 빌드를 실패시킵니다:
npx sqemo-mcp lint schema.erd.json # 위반이 있으면 종료 코드 1팀 전체에 표준 하나
워크스페이스에서는 단어사전과 명명 규칙이 팀 표준(Team standard) 이 되어, 연결된 모든 ERD가 거기서 이름을 생성합니다. 멤버가 새 단어를 제안하고, 표준 소유자가 승인하면, 승인된 단어가 연결된 프로젝트로 전파됩니다. 공유와 협업을 보거나, 단어 하나가 제안에서 컬럼명 변경까지 가는 과정을 담은 2분 영상을 보세요.
프로젝트가 연결돼 있는 동안 검증 패널 위의 상태 바가 표준과 동기화됐는지 보여 주고, 진입점 — 최신 버전 가져오기(Pull), 제안 목록, 준수 현황 — 을 담습니다:
