시스템 관리

Intellidesk의 관리자 설정 모듈은 사용자 관리, 테넌트 구성, 마스터 코드 관리, AI 사용량 모니터링 등 시스템 전반의 운영 관리를 수행하는 기능입니다. 기능별로 Admin 또는 Tenant Admin 역할이 필요합니다.

역할별 관리 범위

Tenant Admin은 현재 테넌트의 사용자와 시스템 설정만 관리합니다. 전체 테넌트 운영, 역할·권한 정의, AI 할당량 변경은 Admin 또는 상위 관리자만 수행할 수 있습니다.

사용자 관리

사용자 목록 조회

관리자 설정 > 사용자 관리 메뉴에서 등록된 전체 사용자를 조회합니다.

표시 항목	설명
이름	사용자 표시 이름. 클릭하면 수정 화면이 열립니다
이메일	알림 수신 이메일
역할	부여된 역할 (Admin, User, Viewer 등)
상태	활성(Active) / 비활성(Inactive)
최근 로그인	마지막 로그인 일시

SUPER_ADMIN, SYSTEM_ADMIN, ADMIN, TENANT_ADMIN 역할을 가진 사용자는 이름 옆에 역할별 색상 배지가 표시됩니다. 여러 관리자 역할을 가진 경우 배지가 함께 표시됩니다.

사용자 생성

1. 사용자 관리 화면에서 새 사용자 버튼을 클릭합니다.
2. 사용자 기본 정보를 입력합니다.
3. 역할을 지정합니다.
4. 저장 버튼을 클릭합니다.

담당자 지정 등 참조 용도로만 필요하고 실제로 로그인하지 않는 사용자는 로그인 불가로 표시해 생성할 수 있습니다. 자세한 절차는 Tenant Admin 가이드의 사용자 생성을 참고하세요.

역할 및 권한

역할	설명	주요 권한
Admin	시스템 관리자	모든 기능 접근, 사용자 관리, 시스템 설정
Tenant Admin	테넌트 관리자	현재 테넌트 사용자와 시스템 설정 관리
Manager	팀/모듈 관리자	티켓 관리, 대시보드 조회, 배정
Developer	개발 담당자	코드 생성, SAP Explorer, 파이프라인 실행
User	일반 사용자	AI 채팅, 노트북, 문서 조회
Viewer	조회 전용	문서 및 대시보드 조회만 가능

역할 조합

하나의 사용자에게 여러 역할을 동시에 부여할 수 있습니다. 예를 들어 Developer + Manager 역할을 함께 부여하면 개발과 관리 기능을 모두 사용할 수 있습니다.

Tenant Admin 역할 위임

Tenant Admin은 본인에게 현재 할당된 역할만 다른 사용자에게 할당하거나 회수할 수 있습니다. 다른 Tenant Admin을 지정하거나 해제할 수 있지만 마지막 활성 Tenant Admin은 해제하거나 비활성화할 수 없습니다.

사용자 비활성화

Tenant Admin은 사용자를 삭제할 수 없습니다. 사용 중지 시 사용자 행의 작업 메뉴에서 비활성화를 선택합니다. Admin 계정과 같은 상위 관리자 계정은 변경할 수 없습니다.

권한 관리

역할별 세부 권한을 커스터마이징할 수 있습니다.

Tenant Admin은 역할과 권한 정의 또는 역할-권한 매핑을 변경할 수 없습니다.

• 모듈 접근 권한: 각 모듈(노트북, 채팅, 코드 생성 등)별 접근 여부
• 데이터 범위: 조회 가능한 데이터 범위 (전체 / 소속 조직 / 본인)
• 실행 권한: 파이프라인 실행, 코드 배포 등 실행 권한
• 관리 권한: 사용자 관리, 설정 변경 등 관리 기능 권한

테넌트 구성

멀티 테넌트 환경에서 각 테넌트의 설정을 관리합니다.

테넌트 설정 항목

항목	설명
테넌트 이름	조직 또는 프로젝트 이름
SAP 시스템 연결	연결할 SAP 시스템 목록
AI 모델 설정	사용할 AI 모델, API Key와 API Base URL
스토리지 한도	문서 및 파일 저장 용량 제한
사용자 한도	최대 등록 가능 사용자 수

테넌트 분리

프로젝트별 또는 조직별로 테넌트를 분리하면 데이터 격리와 독립적인 설정 관리가 가능합니다.

OpenAI Agent 연결은 환경 설정의 OPENAI_API_KEY와 OPENAI_BASE_URL을 함께 사용합니다. OPENAI_BASE_URL에는 https://api.openai.com/v1처럼 /v1까지 포함한 API 루트를 입력합니다. /chat/completions 같은 개별 endpoint 경로를 입력하지 마십시오.

마스터 코드 관리

시스템 전반에서 사용하는 공통 코드를 관리합니다.

코드 그룹

코드 그룹	설명	예시
티켓 카테고리	티켓 유형 분류 코드	장애, 개선, 신규 개발
우선순위	업무 우선순위 코드	Critical, High, Medium, Low
SAP 모듈	SAP 모듈 분류 코드	FI, CO, MM, SD, PP
문서 유형	문서 분류 코드	기능 명세, 기술 명세, 테스트 시나리오
프로그램 유형	프로그램 분류 코드	Report, BDC, Interface, Enhancement

코드 관리 방법

1. 마스터 코드 관리 메뉴에서 코드 그룹을 선택합니다.
2. 코드를 추가, 수정, 비활성화합니다.
3. 변경 사항을 저장합니다.

코드 삭제 제한

이미 사용 중인 마스터 코드는 삭제할 수 없으며, 비활성화만 가능합니다. 비활성화된 코드는 신규 선택 목록에서 제외되지만 기존 데이터에는 영향을 주지 않습니다.

시스템 설정

Intellidesk의 전반적인 동작을 제어하는 설정입니다.

주요 설정 항목

카테고리	설정 항목	설명
일반	시스템 이름	화면에 표시되는 시스템 이름
일반	기본 언어	시스템 기본 언어 (한국어/영어)
AI	기본 모델	기본 사용 AI 모델
AI	최대 토큰	요청당 최대 토큰 수
AI	Temperature	AI 응답의 창의성 수준 (0.0 ~ 1.0)
보안	세션 타임아웃	미활동 시 자동 로그아웃 시간
보안	비밀번호 정책	최소 길이, 복잡도, 변경 주기
알림	이메일 알림	이메일 알림 활성화 여부

Tenant Admin은 현재 테넌트의 시스템 설정을 변경할 수 있지만 AI 할당량은 변경할 수 없습니다. 암호화된 민감 설정값은 마스킹되어 표시됩니다.

Tenant Admin에게는 AI 할당량 설정 탭이 표시되지 않습니다. 역할이 변경된 직후에도 서버는 로그인 토큰이 아니라 현재 활성 역할을 다시 확인하므로 이전 Admin 권한으로 저장할 수 없습니다.

알림 발송 설정과 작업 큐도 운영 관리자 기능입니다. Tenant Admin에게는 두 탭이 표시되지 않으며 해당 설정 조회·저장, 작업 조회·재처리 API도 사용할 수 없습니다.

AI 사용량 모니터링

AI 서비스의 사용량을 모니터링하고 관리합니다.

대시보드

• 일별/주별/월별 사용량: 기간별 AI 토큰 소비량 추이 차트
• 사용자별 사용량: 사용자별 AI 사용량 순위
• 모듈별 사용량: 채팅, 노트북, 파이프라인 등 모듈별 분포
• 비용 추정: 예상 AI 서비스 비용 산출

사용량 제한

제한 유형	설명
사용자별 일일 한도	사용자당 일일 최대 토큰 사용량
사용자별 월간 한도	사용자당 월간 최대 토큰 사용량
테넌트 월간 한도	테넌트 전체 월간 최대 토큰 사용량

한도 초과 시

사용량 한도에 도달하면 해당 사용자의 AI 기능이 일시적으로 제한됩니다. 관리자가 한도를 조정하거나 다음 기간까지 대기해야 합니다.

백그라운드 작업

테넌트 설정의 백그라운드 작업 탭에서 시간이 오래 걸리는 수집·집계 작업을 실행하고 진행 상태를 확인합니다. 작업은 백그라운드로 진행되므로 실행 후 화면을 벗어나도 계속됩니다.

화면 위쪽에서 대상 SAP 시스템을 선택하고, 아래 두 탭으로 나뉩니다.

탭	내용
현재 상태	수집 실행, 진행 상황, 실패 작업, 멈춘 작업 마감
수집 이력	지금까지 수행한 수집 작업의 결과 목록

CBO 의존성 그래프 수집

시스템 전체의 커스텀 오브젝트(Z/Y) 의존성을 수집해 저장합니다. 저장된 결과는 CBO 의존 오브젝트 화면에서 데이터 소스를 "저장된 그래프"로 선택해 SAP 접속 없이 빠르게 조회할 수 있습니다.

백그라운드 수집은 실시간 분석과 같은 소스 기준을 사용합니다. 펑션 모듈의 로컬 PERFORM이 호출하는 Function Group FORM 내부 관계를 포함하고, SQL 대상은 DDIC의 활성 투명 테이블로 확인된 경우에만 테이블 관계로 저장합니다. 이 분석 기준이 변경된 버전을 배포한 뒤에는 기존 저장 결과가 자동 교정되지 않으므로 전체 스캔을 다시 실행해야 합니다.

1. 카드 오른쪽 위에서 수집할 SAP 시스템을 선택합니다.
2. 전체 스캔 실행 또는 증분 스캔 실행을 누릅니다.
3. 진행률과 전체·완료·실패·대기 건수가 표시되며, 진행 중에는 자동으로 갱신됩니다.

스캔 실행 시 입력한 SAP 계정은 해당 스캔에서 한 번 로그인한 뒤 전체 오브젝트 수집에 같은 세션을 재사용합니다. 스캔이 완료·실패·취소되면 서버 메모리의 세션과 저장된 스캔 전용 계정이 제거됩니다.

스캔 유형	대상	사용 시점
전체 스캔	시스템의 모든 커스텀 오브젝트를 다시 수집	최초 구축, 정확한 최신화가 필요할 때
증분 스캔	직전 성공 스캔 이후 변경된 오브젝트만 다시 수집	주기적인 갱신

증분 스캔의 신뢰성

증분 스캔의 변경 감지는 SAP 시스템에 따라 변경분을 일부 놓칠 수 있습니다. 정확성이 중요한 시점에는 전체 스캔을 사용하세요.

이미 진행 중인 스캔이 있으면 새 스캔을 시작할 수 없습니다. 실패한 작업이 있으면 오브젝트 이름, 시도 횟수와 오류 메시지가 목록으로 표시됩니다. 진행률의 실패 건수, 실패 원인별 건수와 실패 작업 목록은 모두 화면에 표시된 최신 스캔 한 건을 기준으로 합니다. 실패 작업 재집계도 같은 스캔의 실패 오브젝트만 다시 수집하며 과거 스캔의 실패는 수집 이력으로 보존됩니다.

스캔 취소

수집은 오브젝트 수천 개를 처리하므로 오래 걸립니다. 잘못 시작했거나 시스템 부하를 줄여야 하면 진행 중에 스캔 취소 버튼으로 멈출 수 있습니다.

• 아직 시작하지 않은 작업은 버립니다.
• 이미 처리 중인 작업은 중간에 끊지 않고 끝까지 진행합니다.
• 지금까지 수집된 결과는 그대로 유지되며, 저장된 그래프에서 계속 조회할 수 있습니다.
• 취소한 스캔은 상태가 취소됨으로 남습니다. 조치가 필요한 실패와는 구분됩니다.

취소와 증분 스캔의 기준 시점

취소한 스캔은 증분 스캔의 기준 시점이 되지 않습니다. 다음 증분 스캔은 마지막으로 완료된 스캔을 기준으로 변경분을 찾습니다.

수집 이력

수집 이력 탭에서 지금까지 수행한 수집 작업을 최신순으로 확인합니다. 유형(전체·증분), 상태(진행 중·완료·실패·취소됨), 전체 / 완료 / 실패 건수, 삭제 건수, 시작 시각, 소요 시간, 실행자가 표시되며 실패한 경우 오류 메시지가 함께 나옵니다.

삭제 건수는 증분 수집이 정리한 오브젝트 수입니다. 증분 수집은 SAP에 더 이상 존재하지 않는 오브젝트를 저장된 그래프에서 제거하는데, 되돌릴 수 없는 작업이므로 0이 아닌 경우 강조해 표시합니다.

변경된 오브젝트가 없어 즉시 끝난 증분 수집은 건수가 모두 0으로 남습니다. 정상 완료이며 오류가 아닙니다.

멈춘 작업 마감

SAP 세션이 만료되는 등의 이유로 작업이 회복 불가능한 상태가 되면 스캔이 끝나지 않고 계속 진행 중으로 남을 수 있습니다. 일정 시간 넘게 진행되지 않은 작업이 있으면 안내와 함께 고착 작업 마감 버튼이 나타납니다.

버튼을 누르면 멈춘 작업을 실패로 처리하고 스캔을 종료합니다. 이미 수집된 결과는 그대로 유지되므로, 마감 후에도 저장된 그래프는 정상적으로 조회할 수 있습니다. 실패한 오브젝트는 원인을 해결한 뒤 다음 스캔에서 다시 수집됩니다.

작업 큐

테넌트 설정의 작업 큐 탭에서 서버가 뒤에서 처리하는 작업을 한 화면으로 확인하고, 실패한 건을 다시 돌립니다. 앞의 백그라운드 작업 탭이 수집을 실행하는 곳이라면, 이 탭은 실행된 작업이 어디까지 처리됐는지 들여다보는 곳입니다.

세 종류의 작업이 함께 표시됩니다.

종류	언제 쌓이나
AI 에이전트	댓글에서 AI를 멘션하거나 봇 댓글에 답글을 달았을 때
CBO 스캔	CBO 의존성 그래프 수집을 실행했을 때
알림	댓글·승인 요청 등 알림을 발생시키는 동작을 했을 때

상단의 두 선택 상자로 종류와 상태를 걸러 봅니다. 상태별 건수는 선택한 종류를 기준으로 집계됩니다.

상태	의미
대기	아직 처리를 시작하지 않음(재시도 대기 포함)
처리중	워커가 집어간 상태
승인 대기	AI가 비가역 행동을 하기 전에 멈춰 세운 상태
완료	정상 처리됨
실패	재시도 횟수를 모두 쓰고 끝난 상태

실패 또는 처리중으로 남은 작업은 오른쪽의 재처리 버튼으로 대기 상태로 되돌립니다. 시도 횟수가 0으로 초기화되어 처음부터 다시 처리됩니다. 여러 건을 한 번에 되돌리려면 위쪽의 실패 재처리를 누릅니다.

실패한 작업은 갈래 아래에 오류 메시지가 함께 표시되므로, 원인을 확인한 뒤 조치하고 재처리하세요.

로그 뷰어

시스템 운영 로그를 조회하고 분석합니다.

로그 유형

로그 유형	설명
접속 로그	사용자 로그인/로그아웃 기록
작업 로그	주요 기능 실행 이력 (파이프라인, 코드 생성 등)
에러 로그	시스템 오류 및 예외 발생 기록
API 로그	외부 API (SAP, AI 서비스) 호출 기록
감사 로그	보안 관련 이벤트 (권한 변경, 설정 변경 등)

로그 조회 및 필터

1. 로그 뷰어 메뉴에서 조회할 로그 유형을 선택합니다.
2. 기간, 사용자, 로그 수준(INFO/WARN/ERROR) 등 필터를 설정합니다.
3. 조회 버튼을 클릭하여 로그를 확인합니다.
4. 필요 시 내보내기 버튼으로 로그를 CSV 파일로 다운로드합니다.

에러 로그 모니터링

운영 안정성을 위해 에러 로그를 주기적으로 확인하는 것을 권장합니다. 반복적으로 발생하는 오류는 근본 원인 분석 후 조치가 필요합니다.