관리자 가이드

IntelliDesk의 관리 기능은 플랫폼 운영을 담당하는 Admin 계층과 현재 테넌트를 운영하는 Tenant Admin으로 구분됩니다. 필요한 역할과 관리 범위를 확인한 뒤 해당 가이드를 이용하세요.

서버 설치 담당자는 온프레미스 설치 마법사와 온프레미스 파일 스토리지에서 사내 저장소 준비와 연결 설정 절차를 확인할 수 있습니다.

역할별 가이드

역할	관리 범위	가이드
SUPER_ADMIN	전체 테넌트와 플랫폼 운영	시스템 관리, AI 채택률, MCP 툴 호출 기록
SYSTEM_ADMIN	시스템 운영 정책에 따라 부여된 플랫폼 관리 역할	시스템 관리
ADMIN	시스템 기능, 사용자, 운영 설정 관리	시스템 관리
TENANT_ADMIN	현재 테넌트의 사용자와 허용된 시스템 설정 관리	Tenant Admin 가이드

Tenant Admin이 할 수 있는 작업

• 현재 테넌트의 사용자를 조회하고 생성·수정·비활성화합니다.
• 본인에게 현재 할당된 역할을 다른 사용자에게 할당하거나 회수합니다.
• 다른 Tenant Admin을 지정하거나 해제합니다.
• 시스템 설정의 환경 설정, 마스터 코드, SAP 시스템 관리 영역을 운영합니다.

Tenant Admin에게 제한되는 작업

• 사용자를 물리적으로 삭제할 수 없습니다.
• ROLE, PERMISSION 및 역할-권한 매핑을 생성하거나 변경할 수 없습니다.
• 본인에게 할당되지 않은 역할을 다른 사용자에게 부여할 수 없습니다.
• 상위 관리자 계정을 변경할 수 없습니다.
• AI 할당량, 알림 발송 설정, 작업 큐를 조회하거나 변경할 수 없습니다.
• 전체 테넌트 운영, 로그, 서버 재시작, 마이그레이션과 같은 플랫폼 기능을 사용할 수 없습니다.

역할 확인

사용자 관리 목록에서 SUPER ADMIN, SYSTEM ADMIN, ADMIN, TENANT ADMIN 역할은 사용자 이름 옆 색상 배지로 표시됩니다.

변경 이력 확인

사용자, 역할, 권한을 누가 언제 어떻게 바꿨는지 이력으로 확인할 수 있습니다. 마지막 변경자만 남기지 않고 모든 변경을 기록하므로, 권한을 부여했다가 회수한 경우에도 양쪽 기록이 모두 남습니다.

사용자 변경 이력

1. 사용자 관리 목록에서 사용자 이름을 클릭하거나 우측 메뉴에서 수정을 선택합니다.
2. 다이얼로그 상단의 변경 이력 탭을 엽니다.
3. 변경 항목마다 변경자, 변경 시각, 바뀐 값이 이전 → 이후 형태로 표시됩니다.

변경자는 이름 (계정 ID) 형태로 표시되어 동명이인을 구분할 수 있습니다. 변경자의 계정이 이후 삭제되면 이름 대신 계정 ID만 남습니다.

기록되는 변경은 다음과 같습니다.

이벤트	남는 시점
사용자 생성	신규 사용자 등록. 일괄 등록으로 만든 계정도 포함합니다
사용자 정보 수정	이름, 이메일, 부서, 직위, 검색용 사용자 여부, 역할 등이 바뀔 때
상태 변경	활성/비활성 전환
이메일 인증 변경	이메일 인증 상태를 수동으로 바꿀 때
역할 부여·회수	목록에서 일괄 역할을 지정하거나 회수할 때
사용자 삭제	계정이 삭제될 때. 계정이 사라져도 이력은 남습니다

역할·권한 변경 이력

1. 역할 관리 화면에서 역할 ID나 역할명을 클릭합니다. 권한은 목록에서 수정을 엽니다.
2. 변경 이력 탭에서 역할명, 설명, 활성 상태, 매핑된 권한 목록의 변경을 확인합니다.

변경이 없으면 기록되지 않습니다

값을 바꾸지 않고 저장만 하면 이력이 쌓이지 않습니다. 목록에는 실제로 값이 달라진 변경만 표시됩니다.

비활성 권한은 반영되지 않습니다

역할에 권한을 매핑할 때 비활성 상태인 권한은 저장되지 않습니다. 이력에는 요청한 값이 아니라 실제로 반영된 권한 목록이 기록됩니다.

서버 로그에서 에러 조사하기

서버 로그(/app/admin/logs)는 SUPER_ADMIN이 사용하는 운영 화면입니다. 처음 열면 최근 에러 탭이 표시됩니다.

1. 상단의 한 줄 요약에서 오늘의 에러 수를 확인합니다. 오늘의 범위와 로그 표시 시각은 브라우저의 시간대를 따르며, 날짜 옆에서 시간대를 확인할 수 있습니다. 상단 집계는 전체 서비스 기준입니다.
2. 최근 에러는 오늘뿐 아니라 보관 중인 에러 파일 전체를 최신순으로 조회합니다. 압축 파일과 용량에 따라 분할된 파일도 포함됩니다. 기본 100건부터 최대 500건까지 펼쳐 볼 수 있으며, 검색은 표시된 항목뿐 아니라 보관 파일 전체에 적용됩니다.
3. 서비스 선택과 검색으로 범위를 좁힙니다. 에러 메시지, 테넌트 ID, 사용자 ID·이름, 요청 ID와 메타데이터를 검색할 수 있습니다. 더 오래된 항목은 검색하거나 로그 파일 탭에서 조회합니다.
4. 목록은 시간·서비스·메시지·테넌트/사용자를 한 행에 표시하고 긴 메시지는 생략합니다. 에러를 선택하면 넓은 상세창에서 요청·사용자 정보, 전체 메시지, 스택 트레이스, 메타데이터와 원본 로그를 확인합니다. 상세 정보 복사로 조사 내용을 복사하거나 원본 파일 열기로 해당 파일을 조회합니다. 파일 내용도 최신순이며 페이지를 이동해 이전 기록을 확인할 수 있습니다.
5. 새로고침으로 새 에러와 오늘의 집계를 다시 조회합니다. 최근 에러 영역의 마지막 갱신 시각을 확인하세요. 조회 실패는 에러가 없는 상태와 구분해 표시됩니다.

테넌트와 사용자 정보

서버의 요청 처리 중 남기는 로그에는 확인 가능한 테넌트 ID, 인증된 사용자 ID·이름, 요청 ID, HTTP 메서드와 요청 경로가 함께 기록됩니다. 5xx 응답도 에러로 기록하며, 응답 상태와 처리 시간을 확인할 수 있습니다. 동일한 요청 ID로 상세 에러와 응답 기록을 연결해 조사할 수 있습니다.

인증 전 에러, 사용자 없이 실행되는 백그라운드 작업, 과거 로그에는 일부 정보가 없을 수 있으며 미기록으로 표시됩니다. 기존 로그에 없던 사용자 정보는 소급해서 채워지지 않습니다. 이번 자동 기록은 Server에 적용되며 Agent·MCP·SSO는 각 서비스가 실제로 남긴 정보를 표시합니다. 자동 기록 필드에는 인증 토큰, 요청 본문, 쿼리 문자열과 사용자 객체 전체를 포함하지 않습니다.

시간대가 없는 과거 로그는 서버의 로컬 시간대로 해석합니다. 서버 시간대를 과거와 다르게 변경했다면 이전 로그의 표시 시각은 별도로 확인해야 합니다. 새 Server 로그에는 시간대가 명확한 ISO 시각을 기록합니다.

피드백 알림

피드백 인박스(/app/admin/feedback)는 SUPER_ADMIN 전용입니다. 새 피드백(별점만 제출한 경우 포함)이나 사용자의 추가 메시지가 등록되면 모든 테넌트의 SUPER_ADMIN에게 앱 알림이 전달됩니다.

접속 중에는 우측 상단 토스트와 알림 배지로 안내됩니다. 접속하지 않은 동안 받은 알림도 다음 접속 시 알림함에서 확인할 수 있습니다. 알림을 누르면 피드백 인박스에서 해당 피드백 대화가 바로 열립니다. 대화 주소로 다시 접속하거나 새로고침해도 같은 피드백이 열립니다. 이 운영 알림은 개인·테넌트의 일반 알림 설정과 무관하게 전달됩니다.

새 피드백이나 아직 읽지 않은 사용자 메시지가 있는 목록 항목에는 진행중 상태와 구분되는 주황색 NEW 배지가 표시됩니다. 대화를 열면 입력창에 자동으로 포커스가 놓이고 해당 관리자의 읽음 상태가 저장됩니다. 다른 관리자의 NEW 표시는 그대로 유지됩니다. 상태 변경이나 운영팀 답장만으로는 NEW가 생기지 않습니다.

피드백 작성자가 티켓으로 등록하면 대화에 티켓 번호와 제목이 링크로 표시됩니다. SUPER_ADMIN도 이 링크로 작성자와 동일한 실제 티켓 상세 화면을 엽니다. 다른 테넌트의 티켓은 해당 테넌트의 대표 주소에서 열리며, 그곳의 로그인과 접근 권한이 적용됩니다. 운영팀이 작성자를 대신해 티켓을 생성하는 기능은 제공하지 않습니다.

피드백 작성자도 내 피드백에서 완료 처리를 누를 수 있습니다. 완료되면 관리자 인박스가 갱신됩니다. 완료된 피드백은 양쪽 모두 읽기 전용이며, 메시지 추가·상태 변경·티켓 신규 등록이 제한됩니다. 기존 대화와 연결된 티켓은 계속 열람할 수 있습니다. 완료된 대화의 입력창 자리에는 입력 제한 사유와 추가 문의 시 새 피드백 작성 안내가 표시됩니다.