> 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.5/admin-management/settings/approval.md).

# 결재

v1.9.5부터 결재 목록이 **«리소스 · 리소스 이름 · 결재 대상 · 결재 유형»** 구조로 바뀝니다. 이전 목록은 «결재 유형 · 상세 유형 · 상태» 세 컬럼에 리소스 종류와 신청 동작이 섞여 있어서, 목록만 보고는 무엇을 결재하는지 알기 어려웠습니다. 이번 개편으로 **어떤 리소스의, 무엇을, 어떻게 바꾸려는 신청인지**를 컬럼마다 하나씩 나눠 보여줍니다.

진입 경로는 관리자 화면 사이드바 **운영 > 결재** 메뉴(`/approval`)입니다. 화면 상단에는 "신청된 항목을 검토해 승인하거나 반려합니다."라는 설명이 표시됩니다. 승인·반려 방법과 검토 모달은 이전과 같습니다.

<figure><img src="https://1442180325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa1tsb4kzRuGbCJsMdPX%2Fuploads%2Fgit-blob-46fe431cee78edec3a3a822c4e1bfe3e44828955%2Fapproval_01_overview.png?alt=media" alt=""><figcaption><p>결재 목록 — 운영 > 결재 화면, 리소스 / 리소스 이름 · 결재 대상 · 결재 유형 컬럼 구조</p></figcaption></figure>

### 주요 개념

결재 한 건은 **리소스 → 리소스 이름 → 결재 대상 → 결재 유형** 순서로 읽습니다. 바깥에서 안쪽으로 좁혀 가는 구조입니다.

| 컬럼     | 역할                                     | 예시                             |
| ------ | -------------------------------------- | ------------------------------ |
| 리소스    | 결재가 걸린 리소스의 종류. 사이드바 메뉴명과 같습니다.        | 채팅 앱, 워크플로우, LLM 서빙, AI 드라이브 … |
| 리소스 이름 | 그 리소스의 개별 이름                           | 사내 규정 Q\&A                     |
| 결재 대상  | 리소스 안에서 결재하려는 대상(목적). 리소스보다 한 단계 안쪽 개념 | 리소스, 공유 권한, 인증 키, 데이터, 카탈로그 …  |
| 결재 유형  | 결재 대상에 하려는 **동작(동사)**                  | 추가, 수정, 삭제, 배포 …               |

예를 들어 «채팅 앱 · 사내 규정 Q\&A · 공유 권한 · 추가»는 "사내 규정 Q\&A 채팅 앱에 공유 대상을 추가하려는 신청"입니다.

### 변경 전/후 비교

이전 목록에서는 다음 세 컬럼에 정보가 섞여 있었습니다.

| 이전 컬럼 | 담겨 있던 내용                                                                    | 문제                                                                       |
| ----- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| 결재 유형 | 배포, 공유, 인증 키, 이관, 데이터                                                       | 동작과 대상이 섞여 있음 (예: «배포»는 동작, «인증 키»는 대상)                                  |
| 상세 유형 | 리소스 종류와 동작을 합친 값 (채팅, 워크플로우, 코드 서빙 … / 워크플로우 이관, 카나리 비율 변경, MCP 도구 라벨 변경 …) | 결재 유형과 겹침. «이관 + 워크플로우 이관»처럼 같은 동작이 두 컬럼에 반복되고, «이관 + 코드 서빙»과는 표현 방식이 다름 |
| 상태    | 배포, 업로드, 이용 신청, 공유 변경 …                                                     | 결재 유형·상세 유형과 겹치는 내용이 섞임                                                  |

v1.9.5부터는 아래처럼 바뀝니다.

| 변경 전               | 변경 후                                     |
| ------------------ | ---------------------------------------- |
| 결재 유형 · 상세 유형 · 상태 | **리소스 / 리소스 이름** · **결재 대상** · **결재 유형** |
| 대상                 | **리소스 / 리소스 이름** 컬럼의 아랫줄(리소스 이름)로 합쳐짐    |
| 요청자 · 요청 일시        | **신청자 / 신청일시** (한 컬럼)                    |
| 승인자 · 승인/반려 일시     | **결재자 / 결재일시** (한 컬럼)                    |
| 승인 · 반려            | 승인 · 반려 (그대로)                            |

«리소스 / 리소스 이름» 컬럼은 두 줄로 표시됩니다. 윗줄에 리소스 종류가 작게, 아랫줄에 리소스 이름이 굵게 나옵니다. 리소스 이름에 마우스를 올리면 전체 이름이 툴팁으로 보이고, 건에 따라 ID도 함께 표시됩니다.

<figure><img src="https://1442180325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa1tsb4kzRuGbCJsMdPX%2Fuploads%2Fgit-blob-c69861864a45ffe7dbe773d542d4f0e87d1b37c9%2Fapproval_02_column_structure.png?alt=media" alt=""><figcaption><p>새 컬럼 구조 — 윗줄 리소스 «워크플로우», 아랫줄 리소스 이름, 결재 대상 «리소스», 결재 유형 «배포 중지»</p></figcaption></figure>

#### 결재 세분화

구조를 바꾸면서 두 종류의 결재가 더 잘게 나뉘었습니다.

* **공유 변경 → 추가 · 수정 · 삭제:** 이전에는 «공유 변경» 한 가지로 묶였던 신청이 이제 결재 대상 «공유 권한»에 결재 유형 «추가», «수정», «삭제» 중 하나로 표시됩니다. 그래서 한 번의 공유 변경 신청에 추가·수정·삭제를 섞을 수 없습니다([공유 변경 신청 시 주의](#공유-변경-신청-시-주의) 참고).
* **카탈로그 배포/배포 중지 → 등록/등록 해제:** 카탈로그에 리소스를 올리거나 내리는 신청은 이제 결재 대상 «카탈로그», 결재 유형 «등록»·«등록 해제»로 표시됩니다. 젠빌더 앱의 갤러리 게시도 결재 대상 «카탈로그», 결재 유형 «등록»으로 표시됩니다.
* **인증 키 라벨 통합:** 인증 키 발급, 인증 키 사용 허용(AI 드라이브), 인증 키 없이 호출 허용·해제는 모두 결재 대상 «인증 키»로 표시됩니다. 발급은 «추가», 허용·해제는 «수정»입니다.

### 결재 유형 정의

결재 유형은 다음 11가지입니다. 결재 유형 필터에도 이 순서로 나옵니다.

| 결재 유형 | 의미                                                                                           |
| ----- | -------------------------------------------------------------------------------------------- |
| 추가    | 없던 것을 새로 만들거나, 이미 있는 리소스나 목록에 새 항목을 더하는 동작. 이전의 «생성»(인증 키 발급 등)도 여기에 포함됩니다.                  |
| 수정    | 오브젝트·리소스는 그대로 두고, 그 속성(필드) 값만 바꾸는 동작                                                         |
| 삭제    | 기존 오브젝트·리소스를 제거해 더 이상 존재하지 않게 만드는 동작                                                         |
| 이관    | (개발망 리소스를 스냅샷으로 떠서) 외부 브리지 저장소 등으로 내보내는 동작                                                   |
| 반입    | (수신 환경망에서) 브리지에 도착한 아티팩트를 들여오는 동작                                                            |
| 복원    | 이전 상태의 오브젝트, 리소스 연결(운영) 상태, 버전 등을 과거 특정 시점으로 되돌리는 동작                                         |
| 배포    | 배포 중지 또는 미배포 상태의 리소스를 실제 서비스할 수 있는 상태로 바꾸는 동작                                                |
| 배포 중지 | 운영 중인 리소스를 서비스할 수 없는 상태로 바꾸는 동작                                                              |
| 재배포   | 배포 중이던 리소스를 배포 중지했다가 다시 운영 상태로 바꾸는 동작                                                        |
| 등록    | 이미 있는 리소스를 카탈로그·갤러리 같은 공개 목록에 노출해 다른 사용자가 찾아 쓸 수 있게 하는 동작. 리소스 자체는 생기지도 바뀌지도 않고 노출 범위만 바뀝니다. |
| 등록 해제 | 공개 목록에서 리소스를 내려 더 이상 찾아 쓸 수 없게 하는 동작. 원본 리소스는 삭제되지 않습니다.                                     |

> **헷갈리기 쉬운 구분**
>
> * «추가»는 \_없던 것이 생기는 것\_이고, «등록»은 \_있던 것이 보이게 되는 것\_입니다.
> * «삭제»는 \_리소스가 없어지는 것\_이고, «등록 해제»는 \_보이지 않게 되는 것\_입니다.

#### 리소스별 결재 대상·결재 유형 조합(예시)

리소스별 결재 대상과 결재 유형 조합의 예시입니다. 리소스 순서는 리소스 필터 순서(사이드바 메뉴 순서)를 따릅니다.

> 아래 표는 **v1.9.5 기준**의 대표 조합입니다. 앞으로 새 리소스나 결재가 생기면 같은 기준(리소스 · 결재 대상 · 결재 유형)에 맞춰 조합이 추가될 수 있습니다.

| 리소스                                                          | 결재 대상     | 결재 유형                        |
| ------------------------------------------------------------ | --------- | ---------------------------- |
| AI 드라이브                                                      | 데이터       | 추가, 삭제                       |
|                                                              | 리소스       | 삭제                           |
|                                                              | 버전        | 복원                           |
|                                                              | 보안 등급     | 수정                           |
|                                                              | 인증 키      | 수정 (인증 키 사용 허용·해제)           |
|                                                              | 커스텀 토큰    | 추가, 수정, 삭제                   |
|                                                              | 커스텀 토큰 속성 | 수정                           |
| 용어사전                                                         | 용어        | 추가, 수정, 삭제                   |
|                                                              | 리소스       | 삭제                           |
| 모델 · 평가지표 · Langfuse Evaluator · 가드레일 · MCP 도구 · 프롬프트 · 전처리기 | 카탈로그      | 등록, 등록 해제                    |
| MCP 서버                                                       | 리소스       | 배포, 배포 중지, 재배포               |
|                                                              | MCP 도구 라벨 | 수정                           |
|                                                              | 인증 키      | 추가, 수정                       |
| LLM · 임베딩 · VLM · 리랭킹 · T2I · I2I · Triton 서빙                | 리소스       | 배포, 배포 중지, 재배포               |
|                                                              | 인증 키      | 추가, 수정                       |
|                                                              | 카탈로그      | 등록, 등록 해제                    |
| 코드 서빙                                                        | 리소스       | 배포, 배포 중지(일괄 중지 포함), 재배포, 이관 |
|                                                              | 인증 키      | 추가, 수정                       |
|                                                              | 카탈로그      | 등록, 등록 해제                    |
| 서비스 라우터                                                      | 인증 키      | 추가, 수정                       |
| 워크플로우                                                        | 리소스       | 이관, 반입, 배포 중지(일괄 중지)         |
|                                                              | 카나리 비율    | 수정                           |
|                                                              | 인증 키      | 추가, 수정                       |
|                                                              | 카탈로그      | 등록, 등록 해제                    |
| 채팅 앱                                                         | 리소스       | 배포, 배포 중지, 재배포               |
|                                                              | 공유 권한     | 추가, 수정, 삭제                   |
|                                                              | 이용 권한     | 추가                           |
|                                                              | 운영 버전     | 수정                           |
| 보고서 생성 · 데이터 분석 채팅                                           | 리소스       | 배포, 배포 중지, 재배포               |
|                                                              | 공유 권한     | 추가, 수정, 삭제                   |
|                                                              | 이용 권한     | 추가                           |
| 젠빌더                                                          | 카탈로그      | 등록 (갤러리 게시)                  |

* 인증 키 «추가»는 인증 키 발급 신청, «수정»은 인증 키 없이 호출 허용·해제 신청입니다(AI 드라이브는 인증 키 사용 허용·해제).
* 이 표에 없는 조합(예: 개편 전에 들어온 공유 변경 혼합 신청)은 결재 대상이 `-`로 비고, 결재 유형 자리에 이전 상태 문구(예: «공유 변경»)가 그대로 표시됩니다.

### 결재 목록 보는 법

#### 컬럼

| 컬럼           | 내용                                                                       | 정렬 |
| ------------ | ------------------------------------------------------------------------ | -- |
| ID           | 결재 ID                                                                    | —  |
| 리소스 / 리소스 이름 | 윗줄에 리소스 종류, 아랫줄에 리소스 이름                                                  | —  |
| 결재 대상        | 결재하려는 대상                                                                 | —  |
| 결재 유형        | 하려는 동작 (태그로 표시)                                                          | —  |
| 신청자 / 신청일시   | 결재를 신청한 사용자와 신청 시각                                                       | 가능 |
| 결재자 / 결재일시   | 결재를 처리한 사용자와 처리 시각 (미처리 건은 `-`)                                          | 가능 |
| 승인           | 처리 결과. 대기 중인 건은 `[검토]` 또는 `[승인]` 버튼                                      | —  |
| 반려           | 처리 결과. 대기 중인 건은 `[반려]` 버튼. `[검토]`로 처리하는 건은 `-`로 표시되고, 반려는 검토 모달 안에서 합니다. | —  |

* **선택:** 다건 승인 또는 반려 대상 선택 체크박스입니다. 이관, 용어사전 등 검토가 필요한 대기 건은 체크박스 대신 검토 버튼으로 처리합니다.
* **반려:** 반려 처리 건은 아이콘에 마우스를 올리면 반려 사유를 표시합니다.

#### 검색

검색 필드는 **리소스 이름 → ID → 신청자 → 결재자** 순서로 고를 수 있고, 기본값은 «리소스 이름»입니다. 검색 필드를 고르고 검색어를 넣은 뒤 Enter를 누르면 조회됩니다.

<figure><img src="https://1442180325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa1tsb4kzRuGbCJsMdPX%2Fuploads%2Fgit-blob-3ad0aa640aae8b28f5c496b7bc28aa5dbc7dd421%2Fapproval_03_search_field.png?alt=media" alt=""><figcaption><p>검색 필드 — 리소스 이름(기본) · ID · 신청자 · 결재자 순서</p></figcaption></figure>

#### 필터·초기화

| 필터    | 선택지                      | 비고                |
| ----- | ------------------------ | ----------------- |
| 리소스   | 내 결재 권한으로 볼 수 있는 리소스만 표시 | 여러 개 선택 가능, 검색 가능 |
| 결재 유형 | 11종                      | 여러 개 선택 가능, 검색 가능 |
| 결재 상태 | 대기, 승인, 반려, 신청 취소        | 여러 개 선택 가능        |

* 모든 필터는 서버에서 적용되므로 페이지를 넘겨도 조건이 유지되고, 건수도 조건에 맞게 표시됩니다.
* 필터에서 아무것도 선택하지 않거나 전부 선택하면 «전체»와 같습니다.
* 검색어를 넣거나, 검색 필드를 기본값이 아닌 것으로 바꾸거나, 필터를 하나라도 바꾸면 **\[초기화]** 버튼이 나타납니다. 누르면 검색·필터·정렬이 모두 기본값으로 돌아가고 1페이지부터 다시 조회합니다.
* 필터를 빠르게 연속으로 바꿔도 마지막에 선택한 조건의 목록과 건수만 표시됩니다.
* 조건에 맞는 결재가 없으면 빈 화면에 `[초기화]` 버튼이 함께 나옵니다.

<figure><img src="https://1442180325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVa1tsb4kzRuGbCJsMdPX%2Fuploads%2Fgit-blob-48f4788c3d8626495c6faca2d8d54a16d7aebd08%2Fapproval_04_filters.png?alt=media" alt=""><figcaption><p>필터 적용 — 리소스 «MCP 도구 외 1개», 결재 상태 «대기» 선택 시 「초기화」 노출</p></figcaption></figure>

### 승인·반려

승인·반려 방법은 이전과 같습니다.

* **단건 처리:** 행의 `[승인]`·`[반려]`를 바로 누르거나, `[검토]`가 있는 행은 내용을 확인한 뒤 승인 또는 반려합니다.
* **단건 승인:** 행의 승인 버튼을 누르면 확인 창이 뜨고, 확인하면 승인이 처리됩니다.
* **단건 반려:** 행의 반려 버튼을 누르면 반려 사유 입력 창이 열립니다.
* **일괄 처리:** 체크박스로 여러 건을 고른 뒤 목록 오른쪽 위의 `[승인]` 또는 `[반려]`를 누릅니다.
  * 다음 건은 일괄 선택이 안 되고 `[검토]`로 하나씩 처리합니다: 이관 결재(이관·반입·카나리 비율 변경), 용어사전(유형 무관), 일괄 중지, 스킬, 커스텀 토큰, AI 드라이브 보안 등급 변경, 인증 키 없이 호출 허용·해제, AI 드라이브 인증 키 사용 허용·해제.
  * 처리가 끝나면 결과 창에 "전체 N건 중 N건 승인 완료, N건 승인 실패했습니다" 같은 요약이 나옵니다. 실패한 건이 있으면 그 아래에 **ID · 리소스 · 리소스 이름 · 결재 대상 · 결재 유형** 목록이 표시됩니다.
* **검토 모달:** 용어사전, AI 드라이브 보안 등급 변경, 일괄 중지 건 등은 기존 검토 모달에서 내용을 확인하고 처리합니다.
* **적용 실패 안내:** 승인은 되었으나 반입 또는 이관 적용에 실패하면 실패 사유를 안내하고, 반입 또는 이관 내역에서 확인 후 재반입하도록 표시합니다.
* **상세 이동:** 목록 행을 더블클릭하면 해당 리소스의 상세 화면으로 이동합니다.
* **바로 들어오기:** 결재 토스트의 `[검토]`를 누르거나 알림을 누르면 결재 목록으로 바로 이동합니다. 단, 용어사전·일괄 제어·AI 드라이브 인증 키 결재는 목록으로 가지 않고 그 자리에서 결재 상세 모달이 열립니다.

### 공유 변경 신청 시 주의

공유 변경이 «추가 · 수정 · 삭제»로 나뉘면서, **한 번의 신청에는 한 가지 동작만** 담을 수 있습니다. 예를 들어 사용자 A를 공유 대상에 추가하면서 사용자 B를 빼는 신청은 한 번에 할 수 없습니다. 추가 신청과 삭제 신청을 따로 해야 합니다. 여기서 «수정»은 이미 공유된 대상의 권한(읽기·쓰기)을 바꾸는 것입니다.

* **채팅 앱 · 보고서 생성 · 데이터 분석 채팅**의 공유 탭에서 추가·수정·삭제를 섞어 저장하면 저장되지 않고 다음 오류 토스트가 뜹니다.

  > 공유 대상 추가·수정·삭제를 함께 신청할 수 없습니다. 각각 따로 신청해 주세요.
* 화면을 거치지 않고 API로 섞어서 신청해도 서버가 거부합니다.

### 권한별 노출 범위

결재 메뉴는 아래 권한 중 하나라도 있으면 보입니다. 결재 권한은 권한 정책의 **리소스 타입**으로 부여하며, 리소스 필터에는 가진 권한으로 볼 수 있는 리소스만 나옵니다.

| 권한 (정책 리소스 타입)                       | 리소스 필터에 나오는 리소스                                                                                              |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| 배포 결재 (`Approval`)                   | 서빙 7종, 코드 서빙, 채팅 앱, 보고서 생성, 데이터 분석 채팅, MCP 서버, 워크플로우, 모델, 평가지표, Langfuse Evaluator, 가드레일, MCP 도구, 프롬프트, 전처리기 |
| 공유 결재 (`Share Approval`)             | 채팅 앱, 보고서 생성, 데이터 분석 채팅                                                                                      |
| 인증 키 결재 (`Auth Key Approval`)        | 서빙 7종, 워크플로우, 코드 서빙, MCP 서버, 서비스 라우터, AI 드라이브                                                                |
| 이관 결재 (`Promotion Approval`, 운영망 제외) | 워크플로우, 코드 서빙                                                                                                 |
| 데이터 결재 (`Data Approval`)             | AI 드라이브, 용어사전, 스킬                                                                                            |
| 젠빌더 관리 권한 (관리 > 확장 서비스 > 젠빌더)        | 젠빌더                                                                                                          |

* 결재 유형 필터는 위 권한이 하나라도 있으면 11종 전부 나옵니다.
* 행을 볼 수는 있어도 해당 건의 결재 권한이 없으면 `[승인]`·`[반려]` 버튼이 비활성화되고 일괄 선택도 되지 않습니다.

### 오류·예외 처리

| 상황                      | 화면 표시                                                  |
| ----------------------- | ------------------------------------------------------ |
| 공유 탭에서 추가·수정·삭제를 섞어 저장  | 오류 토스트 "공유 대상 추가·수정·삭제를 함께 신청할 수 없습니다. 각각 따로 신청해 주세요." |
| API로 공유 변경을 섞어 신청       | 서버 거부 "공유 대상 추가·권한 변경·삭제는 한 번에 하나만 신청할 수 있습니다."        |
| 다른 결재자가 먼저 처리한 건을 승인·반려 | "이미 결재가 완료된 요청입니다." 안내 후 목록 갱신                         |
| 일괄 처리 중 일부 실패           | 결과 창에 성공·실패 건수와 실패 목록 표시                               |
| 결재 대상 리소스가 삭제됨          | 행을 더블클릭해 상세로 이동하려 하면 "삭제된 리소스 입니다" 안내                  |

### 사용자 시나리오

#### 결재자: 채팅 앱 공유 신청만 모아 보기

리소스 필터에서 «채팅 앱», 결재 유형 필터에서 «추가»를 고릅니다. 결재 대상이 «공유 권한»인 행이 공유 대상 추가 신청이고, «이용 권한»인 행이 이용 신청입니다. 내용을 확인한 뒤 승인합니다.

#### 결재자: 카탈로그 등록 신청 한꺼번에 처리하기

결재 유형 필터에서 «등록», 결재 상태 필터에서 «대기»를 골라 카탈로그 등록 신청만 모아 봅니다. 체크박스로 여러 건을 고르고 목록 위 `[승인]`을 누릅니다. 일부가 실패하면 결과 창에서 실패한 건을 확인하고 따로 처리합니다.

#### 신청자: 공유 대상 추가와 삭제를 함께 하려 할 때

보고서 생성의 공유 탭에서 사용자를 추가하면서 다른 사용자를 빼고 저장하면 오류 토스트가 뜨고 저장되지 않습니다. 추가만 먼저 저장해 신청하고, 그다음 삭제를 따로 신청합니다. 결재자 목록에는 두 건이 각각 «공유 권한 · 추가», «공유 권한 · 삭제»로 표시됩니다.


---

# 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.5/admin-management/settings/approval.md?ask=<question>&goal=<user_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.