Sqemo

용어사전

갱신

용어사전(Business glossary)은 스키마와 다른 질문에 답합니다: “어떤 컬럼이 있는가”가 아니라 “이 말로 우리가 뜻하는 게 무엇인가?” Sqemo에서 용어사전은 모델 옆에 따로 관리하는 문서가 아닙니다 — 열 때마다 논리 모델에서 파생되는 용어사전(Glossary) 뷰입니다.

툴바의 선택기로 뷰를 바꿉니다: 논리(Logical) · 물리(Physical) · 명명(Naming) · 용어사전(Glossary) · 도메인(Domains). 무료 기본 기능이며 계정 없이 로컬 파일에서 동작합니다.

무엇이 용어가 되는가

용어는 논리 속성명입니다. 엔터티 열 개에 “고객 번호”라는 속성이 있으면 용어사전에는 그 용어 한 행이 있고, 열 곳이 전부 나열됩니다.

  • 매칭은 앞뒤 공백을 떼고 연속 공백을 하나로 합치며 대소문자를 무시합니다. 그래서 “Order Date”와 “order date”는 같은 용어입니다. 띄어쓰기 자체는 의미가 있습니다 — “Order Date”와 “OrderDate”는 다른 용어입니다.
  • 외래키에서 파생된 속성은 건너뜁니다. 부모의 용어를 반복하기 때문입니다. 외래키에 역할명(role name) 이 있으면 그 이름이 대신 용어가 됩니다.
  • 논리명이 빈 속성은 건너뜁니다.

각 행은 용어, 생성된 물리명, 도메인, 데이터 타입, 정의, 그 용어가 쓰인 모든 엔터티, 그리고 충돌 상태 열을 보여 줍니다.

정의는 모델에 삽니다

정의 셀을 클릭하고 입력하세요. 저장하면 그 용어를 가진 모든 논리 속성에 정의가 기록됩니다. 즉 ERD 하나에 용어당 정의는 하나입니다 — 그것이 핵심이고, 정의가 엔터티마다 달라질 수 없는 이유입니다.

새로 저장되는 것은 없습니다: 정의는 속성 자신의 설명(description) 필드입니다. .erd.json에 함께 실려 git에서 diff할 수 있고, MCP로 읽을 수 있고, 엔터티·컬럼 정의서 내보내기에 포함됩니다.

정의의 범위는 ERD입니다. 같은 단어가 두 모델에서 다른 뜻일 수 있고, 여기서는 그래도 됩니다 — 모델이 곧 맥락입니다.

충돌은 숨기지 않고 표시합니다

상태 열에 배지 두 종류가 나타납니다:

  • 정의 충돌(Definition conflict) — 같은 용어를 공유하는 속성들이 서로 다른(비어 있지 않은) 정의를 가진 경우. 행에는 첫 번째 비어 있지 않은 정의가 보이고, 셀을 편집하면 전부 통일됩니다(실행 취소는 평소처럼 됩니다).
  • 도메인 충돌(Domain conflict) — 같은 용어가 엔터티에 따라 다른 도메인이나 데이터 타입으로 풀리는 경우. 용어사전이 표시하고, 인스펙터에서 도메인을 지정해 고칩니다.

누군가 용어사전 문서를 달라고 하기 전에 정리할 행이 바로 이것들입니다 — 충돌이 곧 드리프트이고, 그것을 보이게 한 것입니다.

용어가 쓰인 곳으로 이동

사용처(Used In) 셀에 그 용어를 쓰는 엔터티가 나열됩니다. 하나를 클릭하면 논리 뷰로 전환되며 그 엔터티가 선택되고 캔버스에서 포커스됩니다.

created_at이나 updated_by 같은 감사 컬럼은 거의 모든 엔터티에 있으므로, 셀은 처음 다섯 개만 보여 주고 나머지는 +N개 더 토글 뒤에 접습니다. 펼치면 어느 것이든 갈 수 있습니다 — 빠지는 것은 없습니다. 검색 중에는 일치하는 엔터티가 앞으로 와서 왜 매칭됐는지 항상 보입니다.

감사용 내보내기

툴바 ▸ 내보내기(Export) ▸ 용어사전 내보내기 (CSV) 는 용어당 한 행을 씁니다:

logicalTerm,definition,physicalName,domain,dataType,entities,conflicts

entities와 conflicts는 ;로 구분됩니다. conflicts가 비어 있지 않은 행은 아직 결정이 필요한 용어입니다.

용어 가져오기는 없습니다. 용어사전은 모델 위의 뷰이지 무언가를 적재하는 등록소가 아닙니다 — 물리명을 만드는 단어는 단어사전으로 가져오고, 용어는 그것을 쓰는 모델에서 따라 나옵니다.

사전 셋, 모델 하나

Sqemo는 셋을 유지합니다: 단어사전(각 단어가 어떤 물리 단어가 되는가), 용어사전(각 업무 용어가 무엇을 뜻하는가), 도메인(용어가 어떤 타입·길이로 풀리는가). 이 구분은 ISO/IEC 11179에서 왔습니다 — 데이터 요소의 이름과 정의는 별개 시스템이 아니라 같은 등록 항목에 속합니다. 긴 논의는 Data Dictionary vs Business Glossary (영문), 표준이 규정하는 것과 멈추는 지점은 ISO 11179 Naming Conventions (영문)을 보세요.

공유와 팀 표준

읽기 전용 공유 링크에서는 용어사전 뷰가 보이지만 정의를 편집할 수는 없습니다.

단어·도메인과 달리 정의는 프로젝트가 팀 표준에 연결돼 있어도 잠기지 않습니다. 단어와 도메인은 표준의 캐시 사본이지만, 정의는 프로젝트 자신의 데이터이므로 연결 여부와 관계없이 계속 편집할 수 있습니다.