권한 — 역할 묶음 · 데이터 범위 · 문서 등급
코파일럿은 사람마다 세 가지를 정합니다. 2026.10 재릴리즈 6(2026-10-08)부터 들어간 기능입니다.
| 무엇 | 정하는 것 | 어디서 |
|---|---|---|
| 역할 묶음 | 무엇을 할 수 있나 — 메뉴 · 제안의 출처 · 승인 · 검토 · 채팅 도구 · 자동화 · 관리 콘솔 | 관리 콘솔 › 역할 묶음(/admin/bundles), 사람에게는 사용자(/admin/users)에서 붙입니다 |
| 데이터 범위 | 어느 설비 · 프로젝트 · PO 까지 보나 | 사람마다 — 사용자 편집의 범위·등급 묶음. 아래 데이터 범위 |
| 열람 등급 | 어느 등급의 문서까지 보나 — 일반 · 사내 · 대외비 · 통제 | 사람마다 — 사용자 편집의 범위·등급 묶음. 문서 쪽은 관리 콘솔 › 문서 등급(/admin/grades) |
판정은 코파일럿 한 곳에서 하고, 뒷단(디지털 스레드 · RAG · 시계열 인사이트)은 코파일럿이 요청마다 실어 보내는 사용자 정보대로 거르기만 합니다. 그래서 묻기 · 제안 · 자동화 · 문서 답 · API 어디로 물어도 같은 범위만 보입니다. 바꾼 값은 그 사람의 다음 요청부터 (늦어도 30초 안에) 적용되고, 다시 로그인할 필요가 없습니다.
처음 기동할 때 기존 사용자마다 업무 역할의 묶음(관리자는 «관리자» 묶음도), 범위 전체, 열람 등급 대외비를 붙입니다.
메뉴 · 승인 · 검토는 업그레이드 전과 같고, 감사 기록에 system:migration 으로 남습니다. 달라지는 것은 하나 — 통제 등급
문서는 사람마다 열람 등급을 통제로 지정해야 열립니다.
기본 묶음은 작업자 · 반장 · 정비 · 공장장 · 관리자 다섯이고, 나머지 여덟은 그 밖의 묶음으로 따로 보입니다 — 기능 · 권한 · 붙어 있는 사람은 그대로입니다. 함께 현장 묶음의 기본 권한을 줄였습니다(아래 표). 기동이 작업자 · 반장 · 정비 묶음을 «앞선 기본값 그대로» 일 때만 한 번 바꾸고, 관리자가 고친 묶음은 건드리지 않습니다. 작업자에게 제안의 «확인할 이상» 이 보이지 않는 것은 의도입니다.
코파일럿은 묻기 · 제안 · 자동화 세 가지로 씁니다(사이드바에는 위에서부터 새 대화 · 제안 · 자동화가 있고, 묻기는 «새 대화» 와 첫 화면으로 들어갑니다). 권한 목록과 묶음의 기본값은 바뀌지 않았고, 같은 권한이 여는 자리만 새 화면으로 옮겨졌습니다 — 옛 «수행 제안 · 이상 진단 · 해결» 권한은 이제 제안의 출처(계획 · 확인할 이상 · 이상 접수)를 엽니다. 업그레이드할 때 손댈 것은 없습니다 → 코파일럿 화면 지도
역할 묶음
권한은 사람에게 직접 붙지 않고 묶음에 붙습니다. 한 사람이 묶음을 여러 개 가질 수 있고, 권한은 그 합입니다.
관리 콘솔 › 역할 묶음(/admin/bundles)에 기본 묶음 다섯과 그 밖의 묶음이 나뉘어 보입니다. 열은 묶음 · 권한 수 · 기본 열람 등급 ·
사람 수 · 마지막 변경이고, 직접 만든 묶음에는 «직접 만든 것» 표시가 붙습니다. 줄을 누르면 오른쪽에 묶음이 열립니다.
| 번호 | 자리 | 하는 일 |
|---|---|---|
| ① | 묶음 목록 | 기본 묶음 다섯. 줄을 누르면 오른쪽에 열리고, 맨 위에 그 묶음이 붙은 사람 수(「N명이 씁니다」)가 보입니다 |
| ② | 권한 | 이 묶음이 드는 권한 — 아래 표 |
| — | 범위 종류 · 기본 열람 등급 | 권한 아래로 내리면 있습니다. 이 묶음의 사람에게 지정할 범위의 종류(설비 · 프로젝트 · 고객 PO · 협력사 등)와 기본 등급 |
| ③ | 저장 | 바꾼 것이 있을 때만 눌립니다. 묶음이 붙은 사람의 다음 요청부터 적용되고 감사에 남습니다 |
사람의 답을 실제로 거르는 값은 사람마다 정하는 데이터 범위 · 열람 등급(아래 두 절)입니다. 묶음의 범위 종류 · 기본 열람 등급은 그 묶음의 «틀» 로 저장해 두는 값이고, 묶음에서 바꿔도 이미 붙어 있는 사람의 범위 · 등급은 바뀌지 않습니다. 예외는 «외부 API» 묶음 하나 — API 키로 들어온 호출은 이 묶음의 기본 열람 등급을 따릅니다.
권한 이름은 관리 화면에 보이는 그대로이고, 괄호 안이 권한 코드입니다.
| 권한 | 여는 것 · 없으면 |
|---|---|
메뉴 — 묻기 (menu:ask) | 묻기(/chat). 없으면 사이드바에서 새 대화 단추가 빠지고 그 주소는 403 |
제안 — 계획 (menu:work) | 제안의 계획 출처 — 수행 제안과 자동화가 올린 카드 |
제안 — 확인할 이상 (menu:floor) | 제안의 돌발 가운데 «확인할 이상» |
제안 — 이상 접수·진행·완료 (menu:resolve) | 제안의 돌발 가운데 «이상 접수», 그리고 진행 중 · 완료 탭. 이상 접수의 조치안 승인 · 고쳐서 승인 · 거절도 이 권한으로 합니다 — 승인 권한이 따로 들지 않습니다 |
메뉴 — 옛 오늘 화면 (menu:today) | 🔴 새 화면에는 이 권한을 쓰는 자리가 없습니다. 옛 «오늘» 화면을 열던 권한이고, 묶음에는 그대로 남아 있습니다 |
| 승인 — 공급망 독촉 초안 · 승인 — MES 정비 요청 | 묻기 답 밑 «할 수 있는 행동» 카드에 승인 단추가 없습니다 |
승인 — 제안 카드 초안 (approve:proposal) | 제안 상세의 승인하고 초안 만들기 단추가 없습니다(칸은 보입니다). 자동화가 제안한 작업 지시 초안도 이 권한으로 승인합니다 |
승인 — 이상 접수 조치 실행 (approve:incident_action) | 제안 상세의 조치 실행(알람 확인 · 담당자 통보 · 현장 점검 · 조사 기록)을 못 하고, 실행 요청은 403. 조치안을 승인 · 거절하는 것은 이 권한이 아니라 «제안 — 이상 접수·진행·완료» 입니다. 자동화의 결과를 나 아닌 사람 · 역할 · 메신저 채널로 보내지도 못합니다(받는 곳이 «나» 로만 남습니다) |
그림자 판정 검토 (review:shadow) | 🔴 새 화면에는 이 권한을 쓰는 자리가 없습니다. 옛 화면의 「검증 대기」 에서 그림자 판정을 맞다 · 틀리다로 표시하던 권한이고, 묶음에는 그대로 남아 있습니다 |
치명 설비 장기 선반 (shelve:alert) | 🔴 새 화면에는 이 권한을 쓰는 자리가 없습니다. 옛 화면의 알림 선반에서 치명 설비의 알림을 1시간 넘게 미뤄 두던 권한이고, 묶음에는 그대로 남아 있습니다 |
임계 조정 승격·되돌리기 (tune:accuracy) | 관리 콘솔 › 정확도 튜닝의 승격 · 되돌리기 · 재개를 못 합니다 |
감사 기록 보기 (read:audit) | 감사 화면이 「«감사 기록 보기» 권한이 있는 묶음이 필요합니다.」 로 막힙니다 |
| 채팅 도구 — 내장(문서 검색·설비 상태) · 플랫폼 통합 MCP · 등록 MCP 서버 | 묻기에서 그 출처의 도구가 빠지고 실행도 거절됩니다 |
문서 등급 지정 (grade:set) | 문서 등급 화면이 「«문서 등급 지정» 권한이 있는 묶음이 필요합니다.」 로 막힙니다 |
자동화 만들기·관리 (manage:agent) | 사이드바에서 자동화가 빠집니다 |
브랜드 바꾸기 (manage:brand) | 관리 콘솔 › 브랜드에서 이름 · 로고 · 색을 못 바꿉니다 |
영상 작업 절차 게시 (publish:procedure) | 영상에서 만든 작업 절차 초안을 게시하지 못합니다 — 「이 일을 할 권한이 없습니다 — 만든 사람이나 게시 권한이 있는 사람만 할 수 있습니다」(초안을 만들고 고치는 것은 됩니다) |
관리 콘솔 (admin) | 관리 콘솔 전체. «관리자» 묶음에서는 뺄 수 없습니다 |
- 제안에서 볼 수 있는 출처가 하나도 없으면(계획 · 확인할 이상 · 이상 접수 권한이 모두 없으면) 사이드바에서 제안이 빠집니다. «메뉴 — 묻기» 가 없으면 새 대화 단추가 빠집니다.
- 화면에 안 보이는 옛 값 —
menu:report. 옛 리포트 화면만 여닫던 권한이라 새 화면에서는 아무것도 막지 않고, 묶음 편집에 보이지 않습니다. 완료 탭과 요약은 «제안 — 이상 접수·진행·완료» 권한으로 열립니다. 묶음에 들어 있던 값은 다른 칸을 고쳐 저장해도 그대로 남습니다. - 알림 채널 · 메일 허용 도메인을 다루는 권한은 따로 없습니다 — 관리 콘솔을 열 수 있으면 됩니다 → 코파일럿 관리 콘솔 — 알림 채널
- 이번 화면 교체로 새로 생긴 권한은 없습니다.
기본 제공 묶음 — 다섯 + 고급 여덟
처음 기동할 때 없을 때만 넣습니다. 그 뒤 관리자가 고친 값은 업그레이드가 덮지 않습니다. 앞의 다섯이 화면의 기본 묶음, 나머지가 그 밖의 묶음입니다.
| 묶음 | 보이는 것 | 그 밖의 권한 |
|---|---|---|
| 작업자 | 묻기 · 제안(계획 · 이상 접수) — 조치안 승인 · 거절과 결과 기록을 이상 접수에서 합니다(조치 실행은 못 합니다) | — |
| 정비 | 묻기 · 제안(계획 · 확인할 이상 · 이상 접수) | 정비 요청 승인 · 그림자 판정 검토 · 이상 접수 조치 실행 · 영상 작업 절차 게시 |
| 반장 | 정비와 같음 | 정비 요청 승인 · 그림자 판정 검토 · 이상 접수 조치 실행 · 영상 작업 절차 게시 |
| 공장장 | 전부 | 독촉 초안 승인 · 정비 요청 승인 · 이상 접수 조치 실행 · 영상 작업 절차 게시 |
| 관리자 | 전부 + 관리 콘솔 | 전부(브랜드 바꾸기 포함) |
| (그 밖) 품질 | 전부 | — |
| (그 밖) 설계 · 구매 · 생산관리 · EHS · 감사 · 협력사 | 전부(협력사는 묻기만) | 감사는 «감사 기록 보기». 기본으로 아무에게도 붙어 있지 않습니다 — 필요할 때 붙입니다 |
| (그 밖) 외부 API | — | 외부 시스템이 API 키로 부를 때의 권한 · 등급 — 사람에게는 붙이지 않습니다 |
- 자동화 만들기·관리는 사람에게 붙는 기본 제공 묶음이 모두 듭니다(외부 API 묶음만 빠집니다). 자동화는 만든 사람의 권한 · 범위 안에서만 돌기 때문에 권한이 넓어지지 않습니다. 처음에는 공장장 · 관리자에만 있었고, 기존 설치에는 기동이 나머지 묶음에 한 번 더합니다 — 그 뒤 관리자가 떼면 다시 붙이지 않습니다.
- 관리자 외 모든 묶음은 채팅 도구 권한을 듭니다(협력사는 내장 · 등록 MCP 만).
- 모든 사람 묶음에는 옛 «오늘» 권한도 그대로 들어 있습니다 — 지금은 아무것도 열거나 막지 않습니다.
사람에게 붙이기 — 사용자 편집
관리 콘솔 › 사용자(/admin/users)에서 사람의 줄을 누르면 오른쪽에 편집 칸이 열립니다. 새 사람은 사용자 추가로 만듭니다.
칸은 위에서부터 기본 · 역할 묶음 · 범위·등급 · 위임·만료 · 플랫폼 연결 다섯 묶음입니다.
편집 화면의 칸 전부입니다(화면에 적힌 이름 그대로).
| 묶음 | 칸 | 하는 일 |
|---|---|---|
| 기본 | 이름 · 이메일 · 휴대폰 | 계정 정보 |
| 내 업무 | 작업자 · 반장 · 정비 · 품질 · 공장장 가운데 하나. 「처음 열 때 보이는 화면이 달라지고, 그 업무의 역할 묶음으로 바뀝니다. 관리자만 정합니다.」 — 고르면 아래 역할 묶음에서 업무 역할 묶음 다섯 가운데 그 하나만 체크되고, 관리자 · 협력사 같은 다른 묶음은 그대로입니다 → 사용자 권한과 업무 역할 | |
| 관리 콘솔 열기 | 켜면 이 사람이 관리 콘솔(/admin)을 엽니다. «관리자» 묶음과 같은 것이라 한쪽을 바꾸면 다른 쪽도 바뀝니다 | |
| 새 비밀번호 | 비워 두면 바꾸지 않습니다. 8자 이상 | |
| 역할 묶음 | 묶음 체크 목록 | 기본 묶음과 그 밖의 묶음이 한 목록에 있습니다. 여러 개를 고르고, 권한은 고른 묶음의 합입니다 |
| 범위·등급 | 전체 범위 스위치 | 켜면 모두 봅니다. 「끄면 아래에 적은 범위의 데이터만 보입니다.」 |
| 종류 · 키 · 범위 더하기 | 종류(설비·라인·사이트 · 프로젝트 · 고객 PO · 협력사)를 고르고 키를 적어 한 줄씩 더합니다. 설비는 키 칸에서 자산 트리의 사이트 · 라인 · 설비를 골라 넣습니다. 줄 끝의 ×로 뺍니다 | |
| 열람 등급 | 「이 등급까지의 문서를 열 수 있습니다.」 — 일반 · 사내 · 대외비 · 통제 | |
| 위임·만료 | 묶음마다 기한 | 고른 묶음마다 날짜 칸이 하나씩 생깁니다. 「묶음에 기한을 두면 그날 끝까지만 유효하고, 지나면 다음 요청부터 빠집니다.」 비우면 기한 없음. «협력사» 묶음은 만료일(필수) 입니다 |
| 기간 위임(대행) | 누구의 묶음을(사람 고르기) · 언제까지(날짜)를 넣고 위임. 「고른 사람의 지금 역할 묶음을 그날 끝까지 이 사람에게 줍니다. 누르면 바로 적용됩니다.」 — 아래 저장과 따로 들어갑니다. 편집에만 있고 사용자 추가에는 없습니다 | |
| 플랫폼 연결 | 플랫폼 사용자 | 플랫폼 로그인 아이디를 목록에서 고르거나 적습니다. 「플랫폼 로그인 아이디와 이으면 플랫폼 도구를 그 사람 권한으로 부릅니다. 비우면 잇지 않습니다.」 목록을 못 읽으면 「플랫폼 사용자 목록을 읽지 못했습니다 — 아이디를 직접 적으세요.」 가 뜹니다 |
| 바닥 | 비활성으로 · 저장 | 아래 |
- 저장은 계정 정보 → 내 업무 → 권한(묶음 · 범위 · 등급) 순으로 넣습니다. 중간에 거절되면 「저장됨: … / 저장 안 됨: … — 이유」 로 어디까지 들어갔는지 알려 주고, 고치던 칸은 그대로 남습니다.
- 권한 칸을 불러오지 못했을 때는 「권한 설정을 불러오지 못했습니다. 지금 저장하면 계정 정보만 바뀝니다.」 가 뜹니다 — 이때 저장해도 범위 · 등급은 건드리지 않습니다.
- 사용자 추가로 만드는 사람은 아무것도 고르지 않으면 작업자 묶음 · 전체 범위 · 열람 등급 대외비로 시작합니다.
- 바꾼 내용은 감사 기록에
access.user:<아이디>로 남습니다(묶음 · 범위 · 등급의 이전 값 → 바뀐 값, 누가). 내 업무를 바꾼 기록은employee.work_role:<아이디>입니다. - 본인은 설정(
/settings)의 프로필 묶음에서 자기 역할과 볼 수 있는 범위를 볼 수만 있습니다.
저장이 거절될 때 화면이 말하는 이유입니다.
| 화면 문구 | 뜻 |
|---|---|
| 「범위가 비어 있습니다 — 이대로 저장하면 아무 데이터도 보이지 않습니다.」 | 전체 범위를 끄고 항목을 하나도 넣지 않았습니다(경고 — 저장은 됩니다) |
| 「범위가 너무 큽니다(6KB 초과) — 사이트·라인 단위로 묶어 지정하세요」 | 항목이 너무 많습니다 |
| 「협력사 묶음에는 만료일이 있어야 합니다」 · 「협력사 계정의 범위는 협력사 항목으로만 지정합니다(하나 이상)」 · 「협력사 계정은 통제 등급을 볼 수 없습니다」 | 아래 협력사 계정 규칙 |
| 「기한은 앞날이어야 합니다」 | 묶음 기한 · 위임 날짜가 오늘보다 앞입니다 |
| 「자기 자신에게는 위임할 수 없습니다」 · 「위임할 묶음이 없습니다」 | 기간 위임의 대상이 틀렸거나 고른 사람에게 줄 묶음이 없습니다 |
데이터 범위
어디서 넣나 — 관리 콘솔 › 사용자 › 그 사람 › 범위·등급 묶음. 전체 범위 스위치를 끄고 종류 · 키를 적어 범위 더하기로 한 줄씩 넣습니다. 열람 등급도 같은 묶음의 열람 등급 칸에서 고릅니다(문서 쪽 등급은 아래 문서 등급).
| 범위 항목 | 뜻 |
|---|---|
all(«전체 범위») | 모두 봅니다. 다른 항목과 함께 둘 수 없습니다 |
asset:<자산 id> | 플랫폼 자산 트리의 노드 — 사이트 · 구역 · 라인 · 설비 어느 층이든 그 아래 설비가 모두 범위 안입니다 |
project:<id> · customer_po:<PO> · supplier:<id> | 그 프로젝트 · 고객 PO · 협력사에 걸린 것 |
- 🔴 비우면 아무것도 보이지 않습니다. 모두 보게 하려면 전체 범위 스위치를 켭니다(
all). 스위치를 꺼도 적어 둔 항목은 화면에 남아 있어, 다시 끄면 돌아옵니다. - 항목이 너무 많아 6 KB 를 넘으면 저장이 거절됩니다 — 설비를 하나씩 넣지 말고 사이트 · 라인 단위로 묶습니다. 키 하나는 200자까지입니다.
- 범위의 뜻은 플랫폼의 자산 범위(보안 정책)와 같습니다. 같은 사람이 플랫폼 화면과 AI 답에서 다른 설비를 보지 않게 하기 위해서입니다.
범위가 거르는 곳
| 어디 | 범위 사용자에게 보이는 것 |
|---|---|
| 화면 | 묻기 첫 화면의 «오늘 할 일» · 제안(확인할 이상 · 이상 접수 · 진행 중 · 완료) · 알림(/alerts) — 범위 안 설비의 것만. 제안의 계획 카드는 설비가 적힌 카드만 보입니다 |
| 공장 전체 집계 | 공장 OEE 처럼 공장 전체를 센 값은 닫히고, 설비 건강은 범위 안 설비로만 셉니다. 온톨로지 그래프는 «모름» 으로 답합니다 |
| 알림 | 화면 알림 · 휴대폰 · 브라우저 푸시도 범위 안 설비의 것만. 설비 없는 공장 단위 알림은 전체 범위인 사람에게만 갑니다. 자동화가 보내는 앱 알림은 받는 사람으로 정해진 사람의 알림 목록에만 남고, 결과가 다룬 설비가 그 사람의 범위 밖이면 보내지 않습니다 |
| 묻기 | 범위 밖 설비를 물으면 범위 밖이라고 답합니다. 문서 답 · 오늘 작업 · 준비도 · 디지털 스레드 도구의 답도 범위 안에서만 |
| 자동화 | 만든 사람의 권한 · 범위 안에서만 돕니다. 자동화 목록의 전체 탭(모두의 자동화)은 관리자와 «공장장» 묶음에게만 보이고, 남의 자동화를 열고 · 끄고 · 지우는 것은 관리자만 합니다 |
| 범위 밖 대상을 주소로 열 때 | «없음»(404) — 있는데 막힌 것인지 알리지 않습니다. 제안에서는 「이 일을 찾을 수 없습니다」 로 보입니다 |
241 데모에서 범위를 로터 라인 하나로 두면 보이는 설비가 122개에서 3개로, 이상 접수가 100건에서 0건으로 줄고, 범위 밖 설비를 물으면 답을 거절합니다.
계정을 비활성으로 바꾸면 그 사람의 열린 세션은 다음 요청에서 끊기고, 그 사람이 만든 자동화도 돌지 않습니다.
문서 등급
등급은 넷입니다 — 일반 < 사내 < 대외비 < 통제. 사람은 자기 열람 등급 이하의 문서만 봅니다. 등급을 정하지 않은 문서는 사내입니다.
관리 콘솔 › 문서 등급(/admin/grades, 권한 «문서 등급 지정»)에서 설비로 좁혀 문서마다 등급을 고릅니다. 고르는 즉시 문서 서버에 지정되고 감사에 남습니다 —
따로 누르는 저장 단추가 없습니다.
| 번호 | 자리 | 하는 일 |
|---|---|---|
| ① | 설비 아이디로 좁히기 | 설비 아이디로 좁힙니다. 비우면 전부 — 처음 300건까지만 보이므로 많으면 좁힙니다 |
| ② | 표 | 문서 이름 · 설비 |
| ③ | 등급 | 줄마다 등급을 고르면 곧바로 지정됩니다 |
- 지정하는 사람은 지금 등급과 새 등급을 둘 다 볼 수 있어야 합니다. 통제로 지정하려면 자기 열람 등급이 통제여야 합니다.
- 도면은 같은 번호 · 판의 파일 전부(DXF 원본 · PDF · 설비별 사본)가 그중 가장 높은 등급으로 다뤄집니다. 묶는 기준은 파일 이름이 아니라 표제란의 번호 · 판입니다.
- 지정은 감사 기록에
access.grade:<설비>/<문서>로 남습니다.
| 등급 | 화면 | 묻기 |
|---|---|---|
| 일반 · 사내 | 그대로 | 그대로 |
| 대외비 | 도면 쪽 미리보기에 보는 사람 아이디 · 시각 워터마크. 열람이 기록됩니다 | 인용한 답이 기록됩니다 |
| 통제 | 워터마크 + 미리보기 해상도 제한, 원본 내려받기는 볼 수 있는 사람에게도 막힙니다. 열람이 기록됩니다 | 인용한 답이 기록됩니다 |
열람 등급을 넘는 문서는 영상 · 도면 쪽 · 판 비교가 열리지 않고, 묻기 답의 재료에서도 빠집니다 — 근거 카드와 인용 번호에도 나오지 않습니다.
열람 기록에 남는 것 — 대외비 · 통제 문서의 영상 재생 시작, 도면 쪽 보기, 묻기 답의 인용(답이 실제로 인용한 것만), 그리고 제안이 근거로 실은 문서 답.
감사 화면 — /audit
설정 · 권한 변경과 대외비 · 통제 문서의 열람 기록을 한 화면에서 봅니다. 읽기 전용입니다.
| 번호 | 자리 | 하는 일 |
|---|---|---|
| ① | 거르는 칸 | 시작일 · 끝일 · 사용자(아이디) · 종류(전체 · 변경 · 열람). 비워 두면 최근 7일입니다 |
| ② | CSV 내려받기 | 거른 결과를 받습니다. 엑셀에서 엽니다. 표 위에 거른 기간과 줄 수가 보이고, 한 번에 2,000건까지 — 넘으면 기간을 좁힙니다 |
| ③ | 표 | 시각 · 종류 · 사용자 · 대상(access.bundle:… · access.user:… · agent:… 등) · 내용(이전 값 → 바뀐 값) |
들어오는 길
| 누구 | 어디서 |
|---|---|
| 관리자 | 관리 콘솔 › 감사 로그(/admin/audit) |
| 관리자가 아니면서 «감사 기록 보기» 권한이 있는 사람(«감사» 묶음 등) | 사이드바 아래 프로필 줄 › 감사(/audit) — 같은 화면입니다 |
권한 «감사 기록 보기» 하나로 열립니다. 기동 때의 이관 기록은 사용자가 system:migration 으로 남습니다.
2인 승인 · 대행 · 협력사 계정
재릴리즈 7(2026-10-09)부터 들어간 규칙입니다.
| 무엇 | 어떻게 |
|---|---|
| 무엇 | 어떻게 |
| --- | --- |
| 2인 승인 | 묻기 답 밑의 «할 수 있는 행동» 카드는 그 대화를 한 사람(작성자)이 승인하지 못합니다 — 「작성자는 승인할 수 없습니다 — … 권한이 있는 다른 사람이 제안의 승인 대기에서 승인합니다.」 가 뜨고, 승인 권한이 있는 다른 사람이 제안에서 그 일을 열어 사유를 적고 승인 · 거절합니다. 영향 큰 행동은 첫 승인 뒤 「○○님이 먼저 승인했습니다. 다른 승인자를 기다립니다」 가 되고, 첫 승인자와 다른 사람이 승인해야 보냅니다. 제안 상세의 승인하면 만들어지는 초안도 같습니다 → 제안 |
| 대행 | 다른 사람의 지금 묶음을 정한 날짜 끝까지 이 사람에게 줍니다. 묶음마다 기한을 둘 수도 있고, 지나면 다음 요청부터(늦어도 30초) 빠집니다 |
| 협력사 계정 | «협력사» 묶음을 붙일 때는 범위가 supplier:<협력사 키> 만(하나 이상), 묶음의 만료일 필수, 열람 등급은 통제가 아니어야 저장됩니다. 만료일이 지나면 그 계정의 열린 세션은 다음 요청에서 끊깁니다 |
휴가 · 교대로 승인자가 비면 대행으로 채웁니다. 모두 감사 기록에 access.user:<아이디> 로 남습니다.
외부 시스템 — API 키로만
외부 연동 주소 /api/v1/** 와 /mcp 는 API 키로만 열립니다. 로그인한 브라우저 세션으로 부르면 거절(403)합니다.
API 키로 부른 호출의 권한 · 등급은 «외부 API» 묶음(기본 대외비)을 따르고, 범위는 늘 전체입니다 → 코파일럿 관리 콘솔 — API 키
운영 — 뒷단의 사용자 정보 점검 모드
뒷단 셋은 사용자 정보 없이 들어온 호출을 어떻게 다룰지 설치 값 하나로 정합니다(PI_USER_CONTEXT_MODE, 기본 off).
코파일럿이 보내는 호출은 늘 사용자 정보를 싣기 때문에, 기본값 off 에서도 위의 범위 · 등급은 그대로 적용됩니다.
| 값 | 사용자 정보 없는 호출 |
|---|---|
off(기본) | 전체 범위로 처리(통제 문서는 닫힘) |
log | 전체 범위로 처리하되 경고와 지표 user_context_missing_total 을 남깁니다 |
enforce | 401 로 거절 |
권장 운영값은 log 입니다. enforce 는 보안 경계가 아니라 «사용자 정보 전달 누락 감지» 이고(뒷단 인바운드 키를 든 쪽은 이미
모든 권한을 가집니다), 뒷단을 바깥 고객 클라이언트에 열지 않은 설치 — 프록시의 /mcp/rag/ · /mcp/timeseries/ 와 rag.* · timeseries.*
호스트를 고객 MCP · API 클라이언트가 쓰지 않는 설치 — 에서만 켭니다. 바깥 기계 클라이언트는 enforce 에서 401 을 받습니다.
enforce 로 바꾸기 전에 log 로 하루 돌려 지표가 0인지 확인합니다. 관리 콘솔(admin-web)이 뒷단을 직접 부르는 호출도
여기에 들어갑니다. 뒷단이 401 user_context_* 를 내면 코파일럿과 뒷단의 인바운드 키가 같은지, 호스트 시계가 맞는지
(허용 오차 30초) 확인합니다.
문제 해결
| 증상 | 원인 · 조치 |
|---|---|
| 로그인은 되는데 제안이 텅 비고 묻기 첫 화면에 «오늘 할 일» 줄이 없습니다 | 데이터 범위가 비어 있을 수 있습니다. 사용자 편집의 범위·등급에서 전체 범위를 켜거나 범위 항목을 넣습니다 |
| 사용자를 저장했는데 「저장됨: 계정 정보 / 저장 안 됨: …」 이 뜹니다 | 계정 정보만 들어가고 권한 쪽이 거절됐습니다. 함께 뜬 이유(협력사 규칙 · 범위 · 기한)를 고쳐 다시 저장합니다 |
| 묶음 편집에 «리포트» 권한이 안 보입니다 | 정상입니다 — menu:report 는 새 화면에서 아무것도 막지 않아 숨겨 둡니다 |
| 사이드바에 제안 메뉴가 없습니다 | 볼 수 있는 출처가 하나도 없습니다 — 묶음에 «제안 — 계획 · 확인할 이상 · 이상 접수·진행·완료» 가운데 하나를 넣습니다 |
| 사이드바에 자동화 메뉴가 없습니다 | 묶음에 «자동화 만들기·관리» 가 없습니다. 기본 제공 묶음에는 들어 있으므로 관리자가 뗀 것입니다 |
| 공장 OEE 같은 공장 전체 숫자를 물으면 답하지 않습니다 | 범위가 지정된 사람입니다 — 공장 전체 집계는 전체 범위인 사람에게만 보입니다 |
| 있는 설비인데 주소로 열면 «없음» 입니다 | 그 설비가 내 범위 밖입니다 |
| 도면 원본 내려받기가 막힙니다 | 통제 문서입니다. 통제 문서의 원본은 누구에게도 주지 않습니다 |
| 문서 등급을 통제로 바꾸면 거절됩니다 | 내 열람 등급이 통제가 아니거나 그 설비가 내 범위 밖입니다 |
| 공장장인데 독촉 카드에 승인 단추가 없습니다 | 내가 물어본 대화의 카드라면 정상입니다 — 작성자는 승인하지 못하고 다른 승인자가 제안에서 승인합니다. 남의 카드인데도 없으면 «공장장» 묶음이 붙어 있지 않습니다 |
| 독촉을 승인했는데 보내지지 않습니다 | 두 사람 승인 행동입니다 — 첫 승인자와 다른 사람의 둘째 승인을 기다립니다 |
| 업그레이드 뒤 작업자에게 제안의 «확인할 이상» 이 안 보입니다 | 재릴리즈 7 의 기본값입니다. 필요하면 «작업자» 묶음에 «제안 — 확인할 이상» 을 체크합니다 |
| 품질 · 설계 묶음이 안 보입니다 | 역할 묶음 화면의 그 밖의 묶음 아래에 있습니다. 사용자 편집에서는 묶음 전부가 한 목록에 있습니다 |
| 범위가 지정된 사람의 문서 답이 조금 늦습니다 | 정상입니다 — 문서 등급 지정이 있거나 범위 사용자이면 걸러 낸 근거로만 답을 짓습니다 |
브라우저에서 /api/v1/... 을 열면 403 입니다 | 정상입니다 — 외부 연동 주소는 API 키로만 열립니다 |
관련 문서
- 사용자 권한과 업무 역할 — 업무 역할별로 보이는 메뉴
- 코파일럿 관리 콘솔 — 사용자 · 역할 묶음 · 문서 등급 · 감사 로그
- 코파일럿 화면 지도 · 제안
- 도면으로 묻기