> For the complete documentation index, see [llms.txt](https://genos-docs.gitbook.io/default/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://genos-docs.gitbook.io/default/v1.9.4/basic-tutorials/guides/data/glossary-approval.md). # 용어사전 변경 승인 용어사전 변경 승인은 사전의 용어를 바꿀 때 **곧바로 반영하지 않고 결재를 거치게** 하는 기능입니다. 사전별로 «변경 승인»을 켜면 용어 추가·수정·삭제와 사전 삭제가 실제 반영 없이 **신청**으로 접수되고, 승인이 떨어진 시점에 용어·벡터 인덱스에 반영됩니다. 반려되거나 취소되면 아무것도 바뀌지 않습니다. 설정은 **데이터 > 용어사전**의 사전 생성 모달과 사전 상세 «운영 정보» 탭에서 하고, 결재는 **운영 > 승인**의 통합 승인 목록에서 합니다. 신청 내역은 용어 탭의 대기 배지·잠긴 행과 사전 상세 «변경 이력» 탭에서 확인합니다.

용어사전 목록의 «승인 상태» 컬럼

> 용어사전 자체(사전 생성·속성 정의·용어 입력·업로드·인증 키·챗봇 연동)는 [용어사전](/default/v1.9.4/basic-tutorials/guides/data/glossary.md) 페이지에서 다룹니다. **이 문서는 승인 게이트만** 다룹니다. ### 주요 개념 | 개념 | 설명 | | -------- | ------------------------------------------------------------ | | 변경 승인 | 사전별 승인 게이트 on/off 설정입니다. 생성 모달과 운영 정보 탭에서 켜고 끕니다. | | 신청(대기) | 변경 내용을 스냅샷으로 저장만 해 둔 상태입니다. 이 시점에는 용어·벡터 인덱스가 전혀 바뀌지 않습니다. | | 스냅샷 | 신청 시점의 값·대상 이름·영향 범위 선택을 굳혀 둔 기록입니다. 승인 시점에 이 값으로 재검증합니다. | | 결재 | 승인 목록에서 승인 또는 반려하는 행위입니다. 승인하면 그때 실제 변경이 적용됩니다. | | 신청 취소 | 신청자 본인이 결재 전에 자기 신청을 거두는 것입니다. | | 적용 실패 | 승인은 났지만 대상이 이미 바뀌었거나 사라져 반영에 실패한 상태입니다. 값은 바뀌지 않습니다. | | 선점 | 대기 중인 신청이 대표어 또는 용어 한 건을 잡아 두는 것입니다. 겹치는 신청을 받지 않는 근거입니다. | | 영향 범위 | 대표어를 바꿀 때 그 이름을 속성 값으로 쓰고 있는 다른 용어들입니다. 함께 바꿀 항목을 신청에 담습니다. | | 통합 승인 목록 | 운영 > 승인 화면입니다. AI 드라이브·스킬·커스텀 토큰·용어사전 등 모든 결재 건이 한 목록에 모입니다. | ### 변경 승인 켜고 끄기 변경 승인은 **사전 단위**로 켭니다. 켜기 전에는 모든 변경이 저장 즉시 반영됩니다. #### 어디서 설정하는가 | 위치 | 표시 | | --------------- | ------------------------------------------------------- | | 용어사전 목록 | «승인 상태» 컬럼 — 표시 전용이며 **이 컬럼으로는 정렬할 수 없습니다.** | | 사전 생성 모달 | 맨 아래 «변경 승인» 구획의 **\[변경 시 승인 필요]** 스위치. **기본값은 꺼짐**입니다. | | 사전 상세 > 운영 정보 탭 | 읽기 모드에서는 «사용»/«사용 안함», 수정 모드에서는 스위치로 보입니다. |

사전 생성 모달의 «변경 승인» 스위치

사전 **생성은 승인 대상이 아닙니다** — 만드는 시점에는 결재할 사전이 아직 없습니다. 생성 모달에서 켜 두면 **첫 용어 등록부터** 결재를 받습니다. 목록 «승인 상태» 컬럼의 값은 셋입니다. | 값 | 뜻 | | -------- | --------------------------------------------- | | 사용 안함 | 변경 승인이 꺼져 있습니다. | | 신청 없음 | 켜져 있고 대기 건이 0건입니다. | | 승인 대기 N건 | 그 사전의 **대기 신청 전부**입니다 — 추가·수정·삭제·사전 삭제를 합칩니다. | #### 운영 정보 탭에서 바꾸기

운영 정보 탭 — 수정 모드의 «변경 승인» 스위치

변경 승인 스위치는 **수정 모드 안에** 있고, 스위치를 움직여도 그 자리에서 저장되지는 않습니다. \*\*\[저장]\*\*을 눌러야 반영됩니다. 1. \*\*\[수정]\*\*을 눌러 수정 모드로 들어갑니다(확인 창 «수정 하시겠습니까?»). 2. **\[변경 시 승인 필요]** 스위치를 바꿉니다. 이 시점에는 화면 값만 바뀝니다. 3. \*\*\[저장]\*\*은 **임베딩 모델 또는 변경 승인이 실제로 바뀌었을 때만** 활성됩니다. 4. 저장을 누르면 켜기·끄기 확인 모달이 뜹니다.

변경 승인 사용 확인 모달

| 조작 | 확인 모달 문구 | 저장 후 토스트 | | -- | ---------------------------------------------------------------------- | ----------------- | | 켜기 | 용어사전 \*\*"«사전 이름»"\*\*의 변경 승인을 사용합니다. | 변경 승인을 활성화하였습니다. | | 끄기 |

용어사전 \*\*"«사전 이름»"\*\*의 변경 승인을 해제합니다.
이후 변경은 결재 없이 바로 반영됩니다.

| 변경 승인을 비활성화하였습니다. | 임베딩 모델도 함께 바꿨다면 이 확인 뒤에 임베딩 변경 확인(취소 / 무시하고 저장 / 지금 재인덱싱)으로 이어지고, 저장은 **한 번의 호출**로 처리됩니다. 변경 승인만 바꾼 저장이면 위 전용 토스트가, 그 외에는 «용어사전이 성공적으로 수정 되었습니다.»가 뜹니다. #### 대기 건이 있으면 끌 수 없습니다 대기 신청이 **1건이라도** 있으면 변경 승인을 해제할 수 없습니다. 확인 모달이 뜨지 않고 스위치를 움직인 그 자리에서 토스트로 막히며, 스위치는 «사용»으로 되돌아옵니다. > 승인 대기 중인 신청이 N건 있습니다. 결재가 끝난 뒤에 해제할 수 있습니다. 대기 건의 **종류를 가리지 않습니다** — 추가·수정·삭제·사전 삭제 무엇이든 막습니다. 승인을 꺼 버리면 남은 대기 건이 처리할 경로 없이 남기 때문입니다. 이 판정은 저장 시점에 서버가 다시 하므로, 화면이 낡아 스위치가 움직여도 저장 단계에서 걸립니다. ### 승인을 타는 작업과 타지 않는 작업 변경 승인을 **사용**으로 켠 사전에서만 갈립니다. 꺼져 있으면 모든 작업이 바로 반영됩니다. | 작업 | 승인 | 화면에서 어떻게 보이나 | | ------------------- | :-: | ------------------------------------------------- | | 용어 추가 (단건) | O | 저장해도 목록에 행이 생기지 않습니다. 툴바에 «용어 추가 대기 N건» 배지가 생깁니다. | | 용어 추가 (벌크 업로드) | O | 업로드해도 목록이 그대로입니다. 같은 툴바 배지가 함께 셉니다. | | 용어 수정 | O | 값은 그대로 남고 그 행에 «승인 대기» 배지가 붙으며 행이 잠깁니다. | | 용어 삭제 (선택 삭제 포함) | O | 행이 남고 «승인 대기» 배지가 붙습니다. 여러 개를 골라도 **신청 1건**입니다. | | 용어사전 삭제 | O | 사전 상세 우상단에 «사전 삭제 승인 대기» 배지가 붙고 사전 전체가 잠깁니다. | | 용어사전 생성 | X | 바로 반영 | | 속성 추가 | X | 바로 반영 | | 임베딩 모델 변경 · 전체 재인덱싱 | X | 바로 반영 | | 사전 이름 · 상세 설명 수정 | X | 바로 반영 | | 변경 승인 켜기 · 끄기 | X | 바로 반영 | | 인증 키 발급 · 갱신 | X | 바로 반영 | | 용어 다운로드 · 양식 내려받기 | X | 바로 반영 | ### 신청하기 승인이 켜진 사전에서 위 작업을 하면 **신청 확인 모달**이 한 번 뜹니다. 제목은 ««유형» 신청하시겠습니까?»이고 버튼은 \*\*\[닫기] · \[확인]\*\*입니다. 검증이 먼저고 모달이 나중이라, 입력값에 문제가 있으면 모달까지 가지 않고 그 자리에서 걸립니다.

용어 추가 신청 확인 모달

확인하면 접수 토스트가 뜹니다. | 작업 | 토스트 | | --------------- | ----------------- | | 용어 추가 (단건 · 벌크) | 용어 추가가 신청되었습니다. | | 용어 수정 | 용어 수정이 신청되었습니다. | | 용어 삭제 | 용어 삭제가 신청되었습니다. | | 용어사전 삭제 | 용어사전 삭제가 신청되었습니다. | #### 용어 추가 (단건) 용어 추가 패널 하단에는 **«저장하면 신청으로 접수되고, 결재 후 반영됩니다.»** 안내가 붙습니다. 저장해도 **목록에 행이 생기지 않습니다** — 아직 등록된 용어가 아니어서 «전체 N개» 카운트에도 들어가지 않고, 검색해도 나오지 않습니다. 대표어 중복 판정은 **세 축**입니다. | 축 | 안내 문구 | | --------------------- | ---------------------- | | ① 이미 등록된 용어와 겹침 | 이미 등록된 용어입니다. | | ② **대기 중인 추가 신청**과 겹침 | 같은 대표어로 승인 대기 신청이 있습니다 | | ③ (업로드일 때) 파일 안에서 중복 | 업로드 판정 표의 메시지로 표시 | ②가 필요한 이유는 추가 신청이 **여러 건 동시에 대기할 수 있어서**입니다. 다른 사람이 같은 대표어로 먼저 신청해 결재를 기다리는 중이면, 사전에 그 용어가 **없어도** 막힙니다. 앞뒤 공백과 영문 대소문자 차이는 같은 용어로 봅니다. > **대표어는 최대 255자**입니다. 다른 문자 속성(1,024자)보다 짧습니다 — 이력의 «대상» 칸과 선점 기록에 그대로 들어가는 값이라 그 폭에 맞춘 것입니다. 저장할 때 앞뒤 공백은 자동으로 정리됩니다. #### 용어 추가 (벌크 업로드) 업로드 모달의 판정 표는 그대로 쓰되, 안내 문구가 \*\*«가능 행만 신청에 담기고, 결재 후 반영됩니다.»\*\*로 바뀝니다. 불가 판정 행은 신청에 담기지 않으므로 신청의 «N개»는 **가능 판정 건수**입니다. 판정 불가 사유에 \*\*«대기 중인 추가 신청과 겹칩니다.»\*\*가 추가됩니다 — 위 ② 축입니다. **대기 중에도 다른 파일을 더 올릴 수 있습니다.** 업로드 버튼은 잠기지 않습니다. #### 용어 수정 — 대표어 영향 범위 값을 고치고 저장하면 결재를 거쳐 반영됩니다. 대표어를 바꾸는 신청이면 저장 전에 \*\*\[영향 범위 확인]\*\*을 거쳐야 하고, 체크한 항목이 **신청에 함께 담깁니다.** * 영향 범위 목록은 **전량**이 내려옵니다. 건수가 많으면 체크리스트 안에서 스크롤합니다. * 체크를 푼 항목은 «신청할 때 일부러 뺀 것»으로 따로 기록되어, 승인 시점 재계산에서도 제외됩니다. * 대표어 앞뒤 공백만 다른 저장은 «대표어 변경»으로 보지 않습니다 — 영향 범위 단계가 뜨지 않습니다. **저장 시점에 동시 편집 충돌을 검사합니다.** 화면을 열어 둔 사이 **내가 고친 속성**을 남이 다른 값으로 바꿨으면 저장이 거부됩니다. > 다른 사람이 먼저 수정했습니다. 다시 시도해 주세요. 판정 기준은 **수정일시가 아니라 값**입니다. 그래서 그 사이 재인덱싱이 돌았거나 남이 **다른** 속성을 고친 경우는 그대로 저장됩니다 — 저장은 바꾼 속성만 덮으므로 남의 수정분도 남습니다. #### 용어 삭제 체크박스로 여러 개를 골라도 **신청은 1건**입니다. 지울 용어의 이름은 신청할 때 함께 저장되어, 승인 뒤 사전에서 사라진 다음에도 이력에서 무엇이 없어졌는지 읽을 수 있습니다. 대기 중인 용어는 체크박스가 잠겨 애초에 고를 수 없습니다. 그래도 고른 뒤에 남이 신청하면 화면이 낡으므로, 실행 시점에 토스트로 막습니다. > 승인 대기 중인 «신청 유형» 신청이 있습니다. 결재가 끝난 뒤에 다시 시도해 주세요. **일부만 지우지 않습니다** — 고른 것 중 하나라도 걸리면 전체를 멈춥니다. #### 용어사전 삭제 사전 상세 ⋮ 더보기 > **\[삭제]**. 되돌릴 수 없으므로 확인 창에 `삭제`를 직접 입력해야 하고, 그 뒤에 신청 확인 모달이 한 번 더 뜹니다. 사전 삭제는 **대기 건이 0건일 때만** 신청할 수 있습니다. ⋮ 더보기의 \[삭제]가 잠기고 사유를 툴팁으로 알립니다. | 상황 | 안내 문구 | | ------------- | ------------------------------------------- | | 다른 대기 건이 있음 | 승인 대기 중인 신청이 N건 있습니다. 결재가 끝난 뒤에 삭제할 수 있습니다. | | 이미 사전 삭제를 신청함 | 이미 사전 삭제 승인 대기 중입니다. | 사전 단위 신청은 **사전당 1건**입니다. ### 대기 상태가 보이는 네 자리 같은 사전인데 자리마다 숫자가 다릅니다. **세는 범위가 다르기** 때문입니다. | 보이는 자리 | 무엇을 세는가 | | -------------------------- | ----------------------------------- | | 용어사전 목록 «승인 상태» 컬럼 | 그 사전의 대기 신청 **전부** — 추가·수정·삭제·사전 삭제 | | 용어 탭 툴바 «용어 추가 대기 N건» 배지 | **용어 추가 신청 건수만** (단건·벌크 함께) | | 용어 행의 «승인 대기» 배지 | 그 **용어 한 건**에 걸린 수정 또는 삭제 신청 | | 사전 상세 우상단 «사전 삭제 승인 대기» 배지 | 사전 단위 신청 (사전당 1건) |

용어 탭 — 툴바 대기 배지와 행 «승인 대기» 배지

* 툴바 배지의 N은 **신청 건수**입니다. 등록될 용어 개수가 아닙니다 — 단건 1 · 벌크 50개 · 단건 1이 대기 중이면 **3건**입니다. * **용어 추가 대기는 목록에 행으로 나타나지 않습니다.** 아직 등록된 용어가 아닙니다. * **용어 수정·삭제 대기는 목록에 그대로 남습니다.** 값도 그대로 보이고 배지만 붙습니다. 추가는 놓을 행이 없고, 수정·삭제는 이미 등록된 용어라 빼면 «없어졌다»로 읽히기 때문입니다. * 배지는 대기 0건이면 통째로 사라지고, **읽기 권한만 있는 계정에도 보입니다.** #### 용어 추가 승인 대기 패널 툴바 배지를 누르면 패널이 열립니다. 신청이 **1건이어도 이 목록을 거칩니다** — 배지를 누른 결과가 건수에 따라 달라지지 않게 한 것입니다.

용어 추가 승인 대기 패널 — 행을 펼친 상태

* 부제에 **사전 이름 · 신청 건수 · 등록될 용어 합계**를 함께 적습니다. * 한 행에 **형태 배지(단건 / 벌크) · 대상 · 용어 N개 · 신청자 · 신청 일시**가 들어갑니다. 최근 신청이 위입니다. * 행을 누르면 **그 자리에서** 등록될 용어가 펼쳐집니다. 여러 건을 동시에 펼쳐 견주며 볼 수 있습니다. * 펼친 표의 컬럼은 그 사전의 속성 정의를 그대로 따릅니다. 벌크는 **100개씩 읽고, 표 안쪽 스크롤이 80%를 넘으면 다음 100개**를 잇습니다. * **본인이 올린 신청에만 \[신청 취소] 버튼이 있습니다.** ### 잠금 — 무엇이 막히나 «충돌하는 것만» 막습니다. 결재가 늦어도 팀 전원이 멈추지 않습니다. | 대기 중인 신청 | 막히는 것 | 막히지 않는 것 | | --------------- | ------------------------------------------------------------------ | -------------------------- | | 용어 추가 (단건 · 벌크) | **같은 대표어**로 다시 추가 | 다른 용어의 추가·수정·삭제·업로드 모두 그대로 | | 용어 수정 | **그 용어 한 행** — 체크박스와 수정 진입 | 다른 행은 그대로 | | 용어 삭제 | 같습니다 — **그 용어 한 행** | 다른 행은 그대로 | | 용어사전 삭제 | **그 사전 전부** — 용어 추가·업로드·선택 삭제·모든 행·속성 추가·운영 정보 저장·이름 수정·인증 키 발급·갱신 | 조회·다운로드·인증 키 **복사** | | 아무 대기 건 (종류 무관) | **변경 승인 해제** · **용어사전 삭제 신청** | — | 잠금은 버튼을 **숨기지 않고 비활성**으로 보여주고, 사유는 툴팁으로 그 자리에서 알립니다. > 운영 정보 탭만 예외입니다 — 사전 삭제 대기 중에도 **\[수정]은 눌리고 입력칸도 열립니다.** 막히는 것은 **저장**이며, 저장을 누르면 «사전 삭제 승인 대기 중에는 수정할 수 없습니다.»로 거부됩니다. | 잠긴 자리 | 툴팁 문구 | | ---------------------- | --------------------------------- | | 용어 대기로 잠긴 행 | 승인 대기 중인 용어는 수정 · 삭제할 수 없습니다. | | 사전 삭제 대기로 잠긴 행·버튼 | 사전 삭제 승인 대기 중에는 수정할 수 없습니다. | | 사전 삭제 대기 중의 인증 키 생성·갱신 | 사전 삭제 승인 대기 중에는 키를 생성·갱신할 수 없습니다. |

사전 삭제 승인 대기 배지가 붙은 사전 상세

사전 삭제 대기 중에는 우상단에 **«사전 삭제 승인 대기»** 배지가 붙고, 제목 옆 ✎(이름·상세 설명 수정)도 함께 잠깁니다. 용어 행에는 «승인 대기» 배지를 붙이지 않습니다 — 그 용어에 걸린 신청이 아니기 때문입니다. 잠긴 행을 눌러도 열리지 않고, 사전 삭제 신청은 **우상단 배지**에서 엽니다. > 인증 키 **복사**는 잠그지 않습니다 — 읽기만 하는 동작입니다. 생성·갱신을 막는 이유는, 승인되면 사전과 함께 사라질 키를 결재 대기 중에 새로 만들어 나눠 주면 삭제된 뒤에 그 키를 받아 간 쪽만 조용히 끊기기 때문입니다. ### 신청 취소 | 항목 | 규칙 | | --- | ------------------------------------------------------- | | 누가 | **신청자 본인만.** 결재 권한이 있어도 남의 신청은 취소할 수 없습니다. | | 언제 | **대기 상태일 때만.** 결재가 끝난 건은 취소 버튼이 없습니다. | | 어디서 | 신청 상세 패널의 **\[신청 취소]**, 또는 용어 추가 대기 패널의 행별 **\[신청 취소]** |

신청 상세 패널과 「신청 취소」

취소 확인 모달의 제목은 ««유형» 신청을 취소하시겠습니까?», 본문은 «진행 중인 신청이 철회됩니다.»입니다. 취소하면 «신청이 취소되었습니다.»가 뜨고 **아무것도 바뀌지 않습니다.** 결재 상태만 «취소»로 남습니다. 벌크 신청이었다면 업로드 판정 결과도 함께 정리됩니다. 이미 취소한 건을 다시 취소해도 오류 없이 성공 처리되며 알림이 다시 나가지는 않습니다. 남의 신청을 열면 버튼 대신 안내가 뜹니다. > 본인이 신청한 건만 취소할 수 있습니다. ### 결재하기 [**운영 > 승인**](/default/v1.9.4/admin-management/settings/approval.md) 화면에서 용어사전 결재 건을 처리합니다. 용어사전은 승인 유형 **«데이터»** 범위에 속합니다.

통합 승인 목록의 용어사전 행과 「검토」

* AI 드라이브·스킬·커스텀 토큰·운영 이관과 **한 목록**에 모입니다. * 목록의 «상태» 칸은 **신청 유형**을 칩으로 보여줍니다 — **용어추가 · 용어수정 · 용어삭제**. 단건 추가와 벌크 업로드는 둘 다 «용어추가»입니다. \*\*사전 자체 삭제는 «삭제»\*\*로 표시되어 다른 리소스의 삭제 결재와 같은 칩을 씁니다 — 대상이 사전인지 용어인지는 «상세 유형»·«대상» 칸으로 구분합니다. * «결재 유형»은 **데이터**, «상세 유형»은 **용어사전**입니다. * **용어사전은 일괄 결재가 되지 않습니다.** 결재는 **\[검토]** 버튼으로 여는 «결재 상세» 모달에서 한 건씩 합니다 — 바뀌는 값을 보지 않고 결재할 자리를 두지 않기 위해서입니다. * 행 이동은 더블클릭입니다(공용 화면 규약). 용어사전 행은 그 **사전 상세로 이동**합니다. 사전이 이미 삭제됐으면 이동하지 않고 «이미 삭제된 용어사전입니다.» 안내만 뜹니다 — 그 사전의 변경 이력 탭도 함께 사라져 이 목록이 유일한 기록처가 되기 때문입니다. * 결재 상세 모달·신청 상세·변경 상세의 **«대상» 값은 링크**입니다. 누르면 그 사전 상세가 **새 탭**으로 열립니다 — 결재 화면을 벗어나지 않기 위해서입니다. #### 결재 권한 결재하려면 **그 사전의 쓰기 권한**과 **`Data Approval` 정책 쓰기 권한**을 **둘 다** 가져야 합니다(슈퍼 관리자는 예외). 한쪽만 있으면 목록에 보이더라도 승인·반려가 되지 않습니다. #### 결재 상세 모달

결재 상세 모달 — 용어 수정

모달은 **«신청 내용» → «내용 상세»** 순서로 읽습니다. * **신청 내용** — 신청자 / 신청일시 · 결재 유형 · 상태 · 상세 유형 · 대상 * **내용 상세** — 접었다 펼칠 수 있고 기본은 펼침입니다. 신청 유형에 따라 표가 갈립니다. | 신청 유형 | «내용 상세» 표 | | ---------- | -------------------------------------------- | | 용어 추가 (단건) | `No` + 그 사전의 속성 전부. 속성이 많으면 표를 옆으로 스크롤합니다. | | 용어 추가 (벌크) | 등록될 용어 목록. 100개씩 읽고 80% 스크롤에서 다음 100개를 잇습니다. | | 용어 수정 | **«항목 / 변경 전 / 변경 후»** — **바뀌는 속성만** 담습니다. | | 용어 삭제 | «No / 용어» 전량 | | 용어사전 삭제 | «No / 항목 / 값» — 등록 용어 수 · 속성 정의 수 · 벡터 인덱스 | 대표어를 바꾸는 수정이면 «변경 전» 칸에 **«N개 용어에서 사용 중»** 캡션이 붙고, 표 아래에 **«함께 수정되는 용어»** 표가 따라옵니다. 이 목록은 **신청 시점에 굳혀 둔 값**이라 결재자가 보는 것은 예상 범위입니다 — 실제 대상은 승인하는 순간 다시 계산합니다(아래). \[승인]을 누르면 확인 창이, \[반려]를 누르면 반려 사유를 입력하는 창이 뜹니다. #### 승인하는 순간 다시 검사합니다 결재를 기다리는 사이에 사전이 바뀔 수 있어, 승인 시점에 다시 확인합니다. | 신청 유형 | 승인 직전 재검사 | 어긋나면 | | -------------- | ----------------------- | ------------------------- | | 용어 추가 (단건) | 같은 대표어가 이미 등록됐는지 | **적용 실패** | | 용어 추가 (벌크) | 담긴 전건의 대표어 겹침 | 하나라도 겹치면 **신청 전체가 적용 실패** | | 용어 수정 | 신청에 담긴 속성의 값이 그대로인지 | **적용 실패** | | 용어 수정 (대표어 변경) | **옛 대표어로 영향 범위 재계산** | 실패로 만들지 않고 결과를 기록 | | 용어 삭제 | — (이미 지워진 용어는 건수에서 걸러냄) | — | | 용어사전 삭제 | — | — | * **벌크를 일부만 등록하지 않는 이유** — 결재자가 승인한 파일과 실제 등록분이 달라지기 때문입니다. * **수정 충돌은 값으로 판정합니다.** 수정일시가 아니라 «신청에 담긴 속성의 값»을 비교하므로, 그 사이 재인덱싱이 돌았거나 남이 **다른** 속성을 고친 경우는 통과하고, 같은 속성을 다른 값으로 고친 진짜 충돌만 막습니다. * **영향 범위 재계산** — 신청 이후 그 이름을 쓰게 된 용어는 함께 바꾸고, 사라졌거나 값이 바뀐 항목은 건너뜁니다. 결과는 «함께 수정되는 용어» 옆에 이렇게 남습니다. | 표기 | 뜻 | | ------------------ | ------------------------------------ | | · 적용 N건 (신청 시점 M건) | 실제로 함께 바꾼 건수와 신청 당시 예상 건수 | | 신규 N건 | 신청 이후 이 이름을 쓰게 된 용어도 함께 수정했습니다 | | 빠짐 N건 | 신청 이후 값이 바뀌었거나 용어가 삭제되어 대상에서 제외되었습니다 | | 제외 N건 | 신청할 때 체크를 푼 항목입니다 | #### 사전 삭제를 승인하면 사전·용어·속성 정의·벡터 인덱스가 함께 삭제됩니다. 그 사전에 남아 있던 **다른 대기 건은 전부 «취소»로 정리**됩니다 — 사전이 사라지면 처리할 경로가 없어지기 때문입니다. ### 결과 확인 — 알림 · 신청 상세 · 변경 이력 결과를 읽는 자리가 셋이고, 자리마다 보이는 것이 다릅니다. #### 알림 신청이 접수되면 그 사전에 **읽기 이상 권한**이 있는 사용자에게 알림이 갑니다. 문장은 신청 유형과 대상을 넣어 만들어집니다. | 상황 | 문장 | | ----- | ---------------------------------------------- | | 신청 | '«이름»'님이 '«사전»' 용어 추가(«대표어»)을(를) 신청하였습니다. | | 벌크 신청 | '«이름»'님이 '«사전»' 용어 추가(«파일명» · N개)을(를) 신청하였습니다. | | 승인 | … 을(를) 승인하였습니다. | | 반려 | … 을(를) 반려하였습니다. | | 취소 | … 신청을 취소하였습니다. | | 적용 실패 | … 반영에 실패하였습니다. | 알림의 **\[검토]** 버튼은 결재 권한이 있는 수신자에게만 보입니다. 누르면 화면과 무관하게 **그 자리에서 결재 상세 모달**이 뜹니다. #### 결재 상태 7종 변경 이력 탭의 «결재 상태» 컬럼에서 보이는 값입니다. | 값 | 뜻 | 결재자 / 결재 일시 | 인덱싱 / 반영 일시 | | ----- | ------------------------------------------ | ----------- | ------------ | | 대기 | 결재를 기다립니다. 값은 아직 바뀌지 않았습니다 | - | - | | 승인 | 신청 내용이 반영됐습니다 | 결재자 · 승인 시각 | 용어 수 · 완료 시각 | | 반려 | 반영하지 않았습니다. 원래 값이 그대로 남습니다 | 결재자 · 반려 시각 | - | | 취소 | 결재 전에 신청자가 거뒀습니다. 아무것도 바뀌지 않았습니다 | - | - | | 적용 실패 | 결재는 났는데 반영이 실패했습니다. 값은 바뀌지 않았습니다 | 결재자 · 승인 시각 | 실패로 기록 | | 사용 안함 | 승인 대상 작업인데 그때 이 사전이 변경 승인을 쓰지 않았습니다 | - | 완료 시각 | | 대상 아님 | 애초에 승인 대상이 아닌 작업입니다 (속성 추가 · 설정 변경 · 재인덱싱) | - | 완료 시각 | > «적용 실패» 배지는 **용어사전 화면에만** 있습니다. 통합 승인 목록에서는 취소·적용 실패 둘 다 승인·반려 칸이 «-»로 보여 구별되지 않습니다 — 가르는 자리는 그 사전의 «변경 이력» 결재 상태입니다. #### 변경 이력 탭

변경 이력 탭 — 결재 상태 컬럼

컬럼은 **작업자 / 작업 일시 · 작업 유형 · 대상 · 변경 내용 · 결재자 / 결재 일시 · 결재 상태 · 인덱싱 / 반영 일시** 순입니다. * **작업 유형은 7종**입니다 — 용어 추가 · 용어 수정 · 용어 삭제 · 용어사전 삭제 · 속성 추가 · 설정 변경 · 재인덱싱. 앞의 4종이 결재를 타고, 뒤의 3종은 «대상 아님»입니다. * 결재 일시와 인덱싱 / 반영 일시는 **따로 적습니다** — 두 시각이 같지 않습니다. * **유형·결재 상태 필터는 없습니다.** 시간 순으로 읽는 자리이고, 골라 보는 일은 승인 목록의 몫입니다. 좁힐 때는 **대상 · 작업자** 두 축으로 검색합니다. * 신청하면 그 시점에 이력 행이 하나 생기고, 결재가 나면 **같은 행의 상태만 바뀝니다.** 결재 이력이 별도 행으로 쌓이지 않습니다. * 사전 삭제가 승인되면 사전과 함께 이 탭도 사라집니다 — 그때부터는 통합 승인 목록이 유일한 기록처입니다. #### 신청 상세 · 변경 상세 같은 신청을 어디서 여느냐에 따라 제목과 구성이 갈립니다. | 여는 자리 | 제목 | 구성 | | ------------------------ | --------- | --------------------------------- | | 용어 탭의 잠긴 행 · 사전 삭제 대기 배지 | **신청 상세** | 신청 내용 → 내용 상세 (+ 본인 건이면 \[신청 취소]) | | 변경 이력 탭의 행 | **변경 상세** | 신청 내용 → 내용 상세 → **결재 결과** | | 승인 목록 \[검토] · 알림 \[검토] | **결재 상세** | 신청 내용 → 내용 상세 (+ \[승인] · \[반려]) |

변경 상세 — 결재 결과

«결재 결과» 블록은 **변경 상세에만** 있습니다. 신청 상세는 대기 건만 열려 «대기 / -» 밖에 적을 것이 없고, 결재 상세는 결재를 내리는 자리라 아직 결과가 없기 때문입니다. * 반려 건에는 **«반려 사유»** 행이, 적용 실패 건에는 **«적용 실패 사유»** 행과 «되살리는 경로는 없습니다. 새로 신청해 주세요.» 안내가 붙습니다. * 삭제 건은 «삭제한 용어» 칸이 무엇이 사라졌는지 알려줍니다. 신청할 때 함께 저장해 둔 이름이라 사전에서 지워진 뒤에도 읽힙니다. * **결재를 타지 않는 3종**(속성 추가 · 설정 변경 · 재인덱싱)은 «결재 결과» 블록이 없고, 라벨도 «신청자»가 아니라 \*\*«작성자 / 작성일시»\*\*입니다. «내용 상세» 표는 유형별로 채워집니다 — 속성 추가는 «추가한 속성», 설정 변경은 «항목 / 변경 전 / 변경 후»(용어사전 이름 · 상세 설명 · 임베딩 모델 · 변경 승인), 재인덱싱은 «반영 건수 · 반영 일시». * **벌크 추가가 취소·반려·적용 실패로 끝나면 «내용 상세» 표가 비고** 안내 문구가 대신 뜹니다 — «벌크 업로드 신청은 취소·반려·적용 실패 시 상세 내용이 제공되지 않습니다.» 최대 5,000건이라 이력 행에 담지 않고 업로드 본문을 참조하는데, 종결된 신청은 그 본문을 정리하기 때문입니다. ### 생성일시 · 수정일시가 찍히는 시점 | 상태 | 생성일시 | 수정일시 | | ----------------------- | ------------- | ---------------- | | 승인 대기 — 추가 신청이 결재를 기다린다 | **목록에 행이 없다** | 행이 없다 | | 승인됨 — 등록된 직후 | **승인 시각** | 승인 시각 (생성일시와 같다) | | 수정이 승인된 뒤 | 그대로 | 승인 시각 | | 승인을 쓰지 않는 사전에서 등록 | 등록 시각 | 등록 시각 | **신청한 시각은 생성일시에 찍히지 않습니다.** 신청 시각은 대기 목록과 신청 상세, 변경 이력의 «작업 일시»에서 봅니다. ### 오류·예외 처리 | 발생 상황 | 안내 문구 | | --------------------------- | ------------------------------------------------ | | 같은 대표어로 대기 중인 추가 신청이 있음 | 같은 대표어로 승인 대기 신청이 있습니다 | | 그 용어에 대기 중인 수정·삭제 신청이 있음 | 승인 대기 중인 «신청 유형» 신청이 있습니다. 결재가 끝난 뒤에 다시 시도해 주세요. | | 대기 건이 있는데 변경 승인을 끄려 함 | 승인 대기 중인 신청이 N건 있습니다. 결재가 끝난 뒤에 해제할 수 있습니다. | | 대기 건이 있는데 사전을 지우려 함 | 승인 대기 중인 신청이 N건 있습니다. 결재가 끝난 뒤에 삭제할 수 있습니다. | | 사전 삭제 승인 대기 중에 사전을 고치려 함 | 사전 삭제 승인 대기 중에는 수정할 수 없습니다. | | 취소 대상 신청을 찾을 수 없음 | 취소할 승인 신청을 찾을 수 없습니다 | | 남의 신청을 취소하려 함 | 본인이 신청한 건만 취소할 수 있습니다. | | 이미 결재가 끝난 건을 취소하려 함 | 이미 결재가 완료된 요청입니다. | | 삭제 신청 한 건에 담을 수 있는 용어 상한 초과 | — | | 저장 시점 동시 편집 충돌 | 다른 사람이 먼저 수정했습니다. 다시 시도해 주세요. | 승인 시점에 반영이 실패하면 오류로 끝나지 않고 **«적용 실패»** 상태로 기록되며, 사유가 신청 상세·변경 상세의 «적용 실패 사유» 칸에 그대로 실립니다. | 적용 실패 사유 | 상황 | | ------------------------------------------------- | --------------------------------- | | 다른 사람이 먼저 수정했습니다. 다시 시도해 주세요. | 신청에 담긴 속성의 값이 결재 전에 바뀜 | | 대상 용어가 이미 삭제되어 반영할 수 없습니다. | 수정 대상 용어가 사라짐 | | 대표어가 이미 등록되어 있습니다. 결재를 기다리는 사이 다른 신청이 먼저 반영되었습니다. | 추가·벌크의 대표어 겹침 (벌크는 겹친 대표어를 함께 표기) | ### 사용자 시나리오 #### 운영 중인 사전에 결재를 도입한다 관리자가 «사내 용어사전» 상세 > 운영 정보 탭에서 \[수정] → \*\*\[변경 시 승인 필요]\*\*를 켜고 \[저장] → 확인 모달에서 \[예]. «변경 승인을 활성화하였습니다.»가 뜨고, 변경 이력에 «설정 변경» 행이 결재 상태 «대상 아님»으로 남습니다. 이후 이 사전의 용어 추가·수정·삭제와 사전 삭제는 모두 결재를 거칩니다. #### 용어를 하나 올렸는데 목록에 안 보인다 실무자가 \[용어 추가]에서 «자동 갱신»을 입력하고 저장하면 «용어 추가 신청하시겠습니까?» → \[확인] → «용어 추가가 신청되었습니다.»가 뜹니다. **용어 목록에는 «자동 갱신» 행이 없고** 검색해도 나오지 않습니다 — 아직 등록된 용어가 아닙니다. 대신 툴바에 «용어 추가 대기 1건» 배지가 생기고, 그 배지를 눌러 신청 내용과 \[신청 취소]를 확인합니다. 결재자가 승인하면 그때 목록에 나타나며, 생성일시는 신청 시각이 아니라 **승인 시각**입니다. #### 엑셀 50건을 올렸는데 결재 중에 한 건이 겹쳤다 실무자 A가 50건짜리 파일을 올려 «가능 48 / 불가 2» 판정을 확인하고 신청합니다. 결재를 기다리는 사이 실무자 B의 단건 추가 신청이 먼저 승인돼 같은 대표어가 등록됐습니다. 결재자가 A의 건을 승인하면 승인 직전 전건 재검사에서 그 한 건이 걸려 \*\*신청 전체가 «적용 실패»\*\*로 끝나고, 사유에 겹친 대표어가 함께 표시됩니다. A는 파일에서 그 행을 빼고 다시 올립니다. #### 대표어를 바꾸는 사이 그 이름을 쓰는 용어가 늘었다 실무자가 «연차» → «연차휴가» 수정을 신청하면서 영향 범위 12건 중 2건의 체크를 풉니다. 결재 전에 다른 팀이 «연차»를 동의어로 쓰는 용어를 1건 더 등록했습니다. 결재자가 승인하면 **승인 직전에 영향 범위를 다시 계산**해 새로 생긴 1건까지 함께 바꾸고, 체크를 푼 2건은 그대로 둡니다. 변경 상세의 «함께 수정되는 용어»에 «· 적용 11건 (신청 시점 10건)», «신규 1건 …», «제외 2건 …»이 표시됩니다. #### 사전을 지우려는데 대기 건이 남아 있다 관리자가 «임시 검증» 사전을 지우려 하지만 대기 건이 2건 남아 있어 ⋮ 더보기의 \[삭제]가 잠기고 «승인 대기 중인 신청이 2건 있습니다. 결재가 끝난 뒤에 삭제할 수 있습니다.» 툴팁이 뜹니다. 대기 2건을 승인·반려로 정리한 뒤 다시 삭제하면, 확인 입력 → 신청 확인 모달을 거쳐 신청이 접수되고 사전 전체가 잠깁니다(용어 추가·업로드·모든 행·속성 추가·운영 정보 저장·인증 키 발급·갱신). 결재자가 승인하는 시점에 사전·용어·속성 정의·벡터 인덱스가 함께 삭제되고, 그 뒤로는 통합 승인 목록이 이 신청의 유일한 기록처가 됩니다. #### 결재자가 남의 신청을 취소하려 한다 결재 권한이 있는 사용자가 용어 탭의 잠긴 행을 눌러 «신청 상세»를 열면 \[신청 취소] 버튼이 없고 «본인이 신청한 건만 취소할 수 있습니다.» 안내만 보입니다. 결재자가 할 일은 승인 목록에서의 승인·반려입니다. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://genos-docs.gitbook.io/default/v1.9.4/basic-tutorials/guides/data/glossary-approval.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.