> 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.2/credit/manual/status.md). # 크레딧 현황 메뉴 운영 대분류의 **크레딧 현황** 메뉴(`/credit/status`)에서 관리 그룹과 사용자별 크레딧 지급·사용·잔여 현황을 월 단위로 조회하고, 크레딧 설정 변경 이력을 확인합니다. * 월 별로 관리 그룹과 사용자에게 지급된 **기본 크레딧 지급량, 사용량, 잔여량, 사용률 및 추가 크레딧 지급량, 사용량, 잔여량, 사용률, 초과 사용량 및 공통 정책 적용 여부**를 확인할 수 있습니다.
### 크레딧 현황 > 관리 그룹 탭 * 관리 그룹 기준으로 현재 크레딧 현황 정보를 제공합니다. * 상단에는 현재 공통 기본 크레딧 지급량 정보를 제공합니다.
* 리스트 * **대상 ID :** 크레딧 할당 대상인 관리 그룹 ID * **할당 대상 :** 관리 그룹명 * **기본 크레딧 지급량 :** ’공통 기본 크레딧 정책’을 따라 월 정기 기본 크레딧 지급량 * **기본 크레딧 사용량 :** 기본 크레딧 사용량 * **기본 크레딧 잔여량 :** 기본 크레딧 지급량에서 사용량을 차감한 값 * **기본 크레딧 사용률 :** 기본 크레딧 사용량 / 기본 크레딧 지급량 * **추가 크레딧 지급량 :** 일시적 추가 크레딧 지급량 * **추가 크레딧 사용량 :** 추가 크레딧 사용량 * **추가 크레딧 잔여량 :** 추가 크레딧 지급량에서 사용량을 차감한 값 * **추가 크레딧 사용률 :** 추가 크레딧 사용량 / 추가 크레딧 지급량 * **초과 크레딧 사용량 :** 잔여 크레딧 부족으로 발생한 초과 크레딧 사용량 * **공통 정책 적용 :** 해당 관리 그룹의 기본 크레딧 지급 기준 * Y : 공통 기본 크레딧 정책 적용 * N : 관리 그룹별 기본 크레딧 정책 적용 → 기본 크레딧 지급량은 해당 관리 그룹에 설정된 대상별 정책 값을 따릅니다. * 리스트 업데이트 정책 * **#1. 매월 1일 00:00 (월간 리셋)** * **\[기본 크레딧]** * 지급량 : 해당 월 정책에 정의된 기본 지급량으로 재설정 * 사용량 : 0으로 초기화 * 잔여량 : 지급량-사용량 기준으로 재계산 * 사용률 : 0%로 초기화 * **\[추가 크레딧]** * 지급량 : 지난 달 잔여량을 이월한 값을 기준으로 재설정 * 사용량 : 0으로 초기화 * 잔여량 : 지급량-사용량 기준으로 재계산 * 사용률 : 0%로 초기화 * **\[초과 크레딧]** * 사용량 : 0으로 초기화 * **#2. 관리자가 지급량 변경 시** * **\[기본 크레딧]** * 지급량 : 관리자가 설정한 지급량으로 갱신 * 사용량 : 변경 전 사용량 유지 * 잔여량 : 변경된 지급량 - 기존 사용량 기준으로 재계산 * 사용률 : 사용량 / 변경된 지급량으로 재계산 * **\[기본 크레딧(임시)]** * 지급량 : 현재 사용량 기반으로 갱신되며 (임시) 태그 추가 * 사용량 : 현재 사용량 기반으로 갱신 * 잔여량 : 0으로 초기화 * 사용률 : 100%로 갱신 * **\[추가 크레딧]** * 지급량 : 관리자가 추가/차감한 지급량 반영하여 갱신 * 사용량 : 변경 전 사용량 유지 * 잔여량 : 변경된 지급량 - 기존 사용량 기준으로 재계산 * 사용률 : 사용량 변경된 지급량으로 재계산 * **#3. 관리자가 특정 관리 그룹에 공통 정책 적용 ON/OFF 시** * 공통 정책 적용 : Y ↔ N ### 크레딧 현황 > 사용자 탭 * 사용자 기준으로 현재 크레딧 현황 정보를 제공합니다.
* 리스트 * **대상 ID :** 크레딧 할당 대상인 사용자 ID * **할당 대상 :** 사용자 이름, 사용자 ID, 관리 그룹명 * **기본 크레딧 지급량 :** ’대상별 기본 크레딧 정책’을 따라 월 정기 기본 크레딧 지급량 * **기본 크레딧 사용량 :** 기본 크레딧 사용량 * **기본 크레딧 잔여량 :** 기본 크레딧 지급량에서 사용량을 차감한 값 * **기본 크레딧 사용률 :** 기본 크레딧 사용량 / 기본 크레딧 지급량 * **추가 크레딧 지급량 :** 일시적 추가 크레딧 지급량 * **추가 크레딧 사용량 :** 추가 크레딧 사용량 * **추가 크레딧 잔여량 :** 추가 크레딧 지급량에서 사용량을 차감한 값 * **추가 크레딧 사용률 :** 추가 크레딧 사용량 / 추가 크레딧 지급량 * **초과 크레딧 사용량 :** 잔여 크레딧 부족으로 발생한 초과 크레딧 사용량 ## 관리 그룹 크레딧 설정 이력 * 관리 그룹 기준으로 크레딧 설정 이력을 제공합니다. ### 관리 그룹 크레딧 설정 이력 > 공통 기본 크레딧 설정 변경 이력 탭 * 공통 기본 크레딧 설정의 변경 이력을 제공합니다. * 관리자의 명시적인 설정 변경 이력을 남기며, 시스템에 의해 자동 처리되는 정책 실행 결과는 기록하지 않습니다. * **이력 기록 대상** * 공통 기본 크레딧의 지급량 변경 시 * **이력 미기록 대상** * 공통 기본 크레딧의 월별 정기 지급 시 * 공통 기본 크레딧 잔여량이 소멸될 시 * 임시 기본 크레딧 적용 후 다음 달 정기 지급 시 * 신규 관리 그룹 생성에 따른 공통 기본 크레딧 지급 시
* 리스트 * **변경 일시 :** 정책 변경이 확정된 시점 * **변경자 :** 해당 정책 변경을 수행한 자 * **변경 유형 :** 변경 유형은 아래 유형을 따름 * 지급량 변경 * **변경 전 :** 정책 변경 전 값 * **변경 후 :** 정책 변경 후 값 * **적용 지급량 :** 변경 이후 실제 적용된 지급량 ### 관리 그룹 크레딧 설정 이력 > 대상별 크레딧 설정 변경 이력 * 관리 그룹 대상별 크레딧 설정의 변경 이력을 제공합니다. * 관리자의 명시적인 설정 변경 이력을 남기며, 시스템에 의해 자동 처리되는 정책 실행 결과는 기록하지 않습니다. * **이력 기록 대상** * 대상별 **기본 크레딧** 설정 변경 이력 * 신규 지급 : 특정 대상에게 기본 크레딧 부여 시 * 정책 변경 : 특정 대상에게 공통 정책 적용 옵션 ON / OFF 시 * 지급량 변경 : 특정 대상에게 기본 크레딧 지급량 변경 시 * 대상별 **추가 크레딧** 설정 변경 이력 * 신규 지급 : 특정 대상에게 추가 크레딧 신규 지급 시 * 추가 지급 : 특정 대상에게 추가 크레딧 추가 지급 시 * 차감 : 특정 대상에게 추가 크레딧 일부 차감 시 * 전체 차감 : 특정 대상에게 추가 크레딧 전체 차감 시 * **이력 미기록 대상** * 대상별 기본 크레딧의 월별 정기 지급 시 * 대상별 기본 크레딧 잔여량이 소멸될 시 * 대상별 임시 기본 크레딧 적용 후 다음 달 정기 지급 시 * 추가 크레딧 이월 시
* 리스트 * **변경 일시 :** 정책 변경이 확정된 시점 * **변경자 :** 해당 정책 변경을 수행한 자 * **할당 대상 :** 해당 정책의 대상 관리 그룹 * **크레딧 종류 :** 기본 크레딧 / 추가 크레딧 * **변경 유형 :** 변경 유형은 아래 유형을 따름 * 지급량 변경 * 정책 변경 * 신규 지급 * 추가 지급 * 차감 * 전체 차감 * **변경 전 :** 정책 변경 전 값 * **변경 후 :** 정책 변경 후 값 * **적용 지급량 :** 변경 이후 실제 적용된 지급량 * **비고 :** 이력에 대한 추가 설명을 제공합니다. 1. 임시 케이스 * 적용 지급량 임시 정책에 따른 예정 정책을 말하며, 지급 예정일, 지급량 정보를 제공합니다. * 예) 5/1 50,000 적용 예정 2. 추가 크레딧을 ‘전체 차감’ 했을 시, 관련 내용을 안내합니다. * 예) 잔여량 기준으로 전체 차감 3. 정책을 변경 했을 시, 어떤 정책으로 변경되었는지 안내합니다. * 예) 대상별 정책으로 변경 / 공통 정책으로 변경 * 1,3 케이스에 중복 해당될 시에는 아래의 순서로 2개 문구를 제공합니다. * 예) 공통 정책으로 변경 5/1 100,000 적용 예정 ## 사용자 크레딧 설정 이력 * 사용자 기준으로 크레딧 설정 이력을 제공합니다. ### 사용자 크레딧 설정 이력 * 사용자 대상별 크레딧 설정의 변경 이력을 제공합니다. * 관리자의 명시적인 설정 변경 이력을 남기며, 시스템에 의해 자동 처리되는 정책 실행 결과는 기록하지 않습니다. * 이력 기록 대상 * 대상별 **기본 크레딧** 설정 변경 이력 * 신규 지급 : 특정 대상에게 기본 크레딧 부여 시 * 정책 변경 : 특정 대상에게 공통 정책 적용 옵션 ON / OFF 시 * 지급량 변경 : 특정 대상에게 기본 크레딧 지급량 변경 시 * 대상별 **추가 크레딧** 설정 변경 이력 * 신규 지급 : 특정 대상에게 추가 크레딧 신규 지급 시 * 추가 지급 : 특정 대상에게 추가 크레딧 추가 지급 시 * 차감 : 특정 대상에게 추가 크레딧 일부 차감 시 * 전체 차감 : 특정 대상에게 추가 크레딧 전체 차감 시 * 이력 미기록 대상 * 대상별 기본 크레딧의 월별 정기 지급 시 * 대상별 기본 크레딧 잔여량이 소멸될 시 * 대상별 임시 기본 크레딧 적용 후 다음 달 정기 지급 시 * 추가 크레딧 이월 시
* 리스트 * **변경 일시 :** 정책 변경이 확정된 시점 * **변경자 :** 해당 정책 변경을 수행한 자 * **할당 대상 :** 해당 정책의 대상 관리 그룹 * **크레딧 종류 :** 기본 크레딧 / 추가 크레딧 * **변경 유형 :** 변경 유형은 아래 유형을 따름 * 지급량 변경 * 정책 변경 * 신규 지급 * 추가 지급 * 차감 * 전체 차감 * **변경 전 :** 정책 변경 전 값 * **변경 후 :** 정책 변경 후 값 * **적용 지급량 :** 변경 이후 실제 적용된 지급량 * **비고 :** 이력에 대한 추가 설명을 제공합니다. 1. 임시 케이스 * 적용 지급량 임시 정책에 따른 예정 정책을 말하며, 지급 예정일, 지급량 정보를 제공합니다. * 예) 5/1 50,000 적용 예정 2. 추가 크레딧을 ‘전체 차감’ 했을 시, 관련 내용을 안내합니다. * 예) 잔여량 기준으로 전체 차감 3. 정책을 변경 했을 시, 어떤 정책으로 변경되었는지 안내합니다. * 예) 대상별 정책으로 변경 / 공통 정책으로 변경 * 1,3 케이스에 중복 해당될 시에는 아래의 순서로 2개 문구를 제공합니다. * 예) 공통 정책으로 변경 5/1 100,000 적용 예정 ## 화면 상세 ### 상단 툴바 * **월 선택:** 조회 기준 연월을 선택합니다. 기본값은 당월이며 미래 월은 선택할 수 없습니다. * **설정(관리자):** 공통 기본 크레딧 설정과 대상별 크레딧 설정 메뉴를 엽니다. 관리자 권한일 때만 노출됩니다. * **새로고침:** 현재 조회 조건으로 목록을 다시 불러옵니다. * **공통 기본 크레딧 안내:** 현재 공통 기본 크레딧 지급량을 안내하며, 설정 전에는 미설정으로 표시합니다. ### 현황 목록 컬럼 * **할당 ID:** 할당 대상의 식별 번호입니다. * **할당 대상:** 관리 그룹명 또는 사용자(이름, 아이디, 소속 그룹)입니다. * **기본 크레딧 지급량:** 지급된 기본 크레딧이며, 임시 지급이면 (임시)를 덧붙입니다. * **기본 크레딧 사용량:** 기본 크레딧에서 사용한 양입니다. * **기본 크레딧 잔여량:** 기본 크레딧의 남은 양입니다. * **기본 크레딧 사용률:** 기본 크레딧 사용 비율(%)입니다. * **추가 크레딧 지급량, 사용량, 잔여량, 사용률:** 추가 크레딧의 지급, 사용, 잔여, 사용 비율입니다. * **초과 크레딧 사용량:** 잔여량을 초과해 사용한 양이며, 0을 초과하면 강조(빨강)로 표시합니다. * **공통 정책 적용:** 관리 그룹 목록에만 있으며 공통 정책 적용 여부를 표시합니다. ### 설정 변경 이력 컬럼 * **변경 일시:** 크레딧 설정이 변경된 일시입니다. * **변경자:** 변경을 수행한 사용자의 이름과 아이디입니다. * **할당 대상:** 대상별 이력에서 변경 대상을 표시합니다. * **크레딧 종류:** 기본 크레딧 또는 추가 크레딧을 표시합니다. * **변경 유형:** 추가 지급, 차감, 전체 차감 등 변경 종류입니다. * **변경 전, 변경 후:** 변경 전후 값이며, 추가 지급이나 차감은 변경 후에 부호가 붙은 변경량을 함께 표시합니다. * **적용 지급량:** 실제 적용된 지급량이며, 임시 할당이면 (임시)를 덧붙입니다. * **비고:** 변경에 대한 메모입니다. ### 검색·정렬 * **검색:** 각 목록은 할당 대상 기준(공통 기본 크레딧 이력은 변경자 기준)으로 검색합니다. * **정렬과 페이지:** 목록은 컬럼 정렬과 페이지 크기 변경(10, 20, 50, 100)을 지원합니다. --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://genos-docs.gitbook.io/default/v1.9.2/credit/manual/status.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.