QR 라벨과 공개 페이지
구역 · 라인 · 설비마다 QR 라벨을 만들어 붙이면, 휴대폰으로 찍어 그 설비의 정보를 바로 볼 수 있습니다. 라벨을 찍으면 공개 페이지(/qr/<토큰>)가 열립니다. 공개 페이지는 로그인 없이 보이므로 사이트마다 기본으로 꺼져 있고, 관리자가 켠 사이트에서만 설비 정보가 나옵니다.
먼저 설정할 주소
설정 화면에서 키 두 개를 넣습니다. 값은 사람이 브라우저에 치는 주소입니다 — 프록시 뒤에서는 서버가 듣는 주소와 다르므로 플랫폼이 스스로 알아낼 수 없습니다.
| 설정 키 | 쓰임 | 비우면 |
|---|---|---|
PP_UI_CONSOLE_URL | 라벨에 들어가는 주소(<콘솔 주소>/qr/<토큰>). 알람 메일의 링크도 이 주소입니다 | QR 코드를 그리지 않고 «QR 라벨에 넣을 콘솔 주소가 없습니다» 안내가 나옵니다 |
PP_UI_FRONTLINE_URL | 공개 페이지의 «frontline 에서 열기» 버튼이 가는 주소 | 버튼을 숨깁니다 |
값은 https://plantpulse.example.com 처럼 http(s) 로 시작하는 절대 주소이고, 뒤의 / 는 저장할 때 잘립니다. 쿼리나 # 이 붙은 값은 거절됩니다. 공개 페이지가 휴대폰에서 열리려면 이 주소에 휴대폰이 닿아야 합니다.
라벨 만들기
설비 트리에서 구역 · 라인 · 설비를 고르고 고유 속성 탭을 열면 QR 라벨 카드가 있습니다. 라벨에는 QR 코드 · 이름 · ID · 위치(사이트 › 구역 › 라인)가 실립니다. 크기는 70 × 40 mm 이고 화면에도 인쇄 크기 그대로 그립니다. ID 와 위치가 길면 두 줄까지 나오고, 더 길면 잘립니다.
| 번호 | 자리 | 하는 일 |
|---|---|---|
| ① | 카드 머리 오른쪽 | PNG 저장 · 라벨 인쇄 · 재발급 — 아래 표 |
| ② | 카드 본문 | 인쇄 크기 그대로 그린 라벨(QR · 이름 · ID · 위치) |
| 버튼 | 하는 일 | 누가 |
|---|---|---|
| PNG 저장 | 라벨을 그림 파일로 내려받습니다 | 로그인한 사용자 누구나 |
| 라벨 인쇄 | 라벨만 인쇄합니다 | 로그인한 사용자 누구나 |
| 재발급 | 토큰을 새로 만듭니다 | 관리자(ADMIN) |
토큰은 라벨을 처음 볼 때 만들어지고, 설비 하나에 살아 있는 토큰은 하나입니다. 라벨에는 설비 ID 대신 추측할 수 없는 무작위 토큰이 들어갑니다.
재발급한 뒤 옛 라벨을 찍으면 «찾을 수 없는 QR 코드입니다» 가 나옵니다. 새 라벨을 인쇄해 바꿔 붙여야 합니다. 라벨 사진이 밖으로 나갔을 때처럼 옛 라벨을 막아야 할 때 씁니다.
공개 페이지 켜기
공개 여부는 사이트마다 정합니다. 설비 트리에서 사이트를 고르고 고유 속성 탭의 QR 공개 페이지 카드에서 바꿉니다. 스위치는 관리자만 바꿀 수 있습니다.
| 스위치 | 기본 | 켜면 | 끄면 |
|---|---|---|---|
| 공개 페이지 켜기 | 꺼짐 | 그 사이트 설비의 라벨을 찍으면 아래 정보가 보입니다 | «공개되지 않은 설비입니다» 와 로그인 버튼만 보입니다. 이름 · 사진도 보이지 않습니다 |
| 담당자 연락처 보이기 | 꺼짐 | 담당자의 전화 · 이메일이 함께 보입니다 | 담당자 이름만 보입니다. 공개 페이지가 켜져 있을 때만 적용됩니다 |
공개 페이지에 보이는 것
| 항목 | 값 |
|---|---|
| 이름 · 사진 | 설비 이름과 연결된 사진. 사진이 없으면 층 아이콘 |
| 위치 | 사이트 › 구역 › 라인 |
| 기능 위치 | 설비의 functional_location. 없으면 줄이 빠집니다 |
| 설비 분류 | 보는 사람의 언어로 |
| 운전 상태 | 기록해 둔 운전 상태(operational_status_code). 실시간 값이 아닙니다 |
| 담당 | 담당 직원. 없으면 «지정된 담당자가 없습니다» |
| 전화 · 이메일 | «담당자 연락처 보이기» 를 켠 사이트만 |
실시간 값 · 알람 · 일련번호 · 제조사 · 모델 · 내부 ID 는 공개 페이지에 나오지 않습니다. 언어는 보는 사람의 브라우저를 따릅니다.
아래 버튼은 둘입니다.
| 버튼 | 가는 곳 |
|---|---|
| frontline 에서 열기 | 현장 앱의 그 설비. PP_UI_FRONTLINE_URL 이 있을 때만 보입니다 — QR 라벨로 설비 열기 |
| 콘솔에서 보기 | 콘솔의 설비 화면. 로그인하지 않았으면 로그인 뒤 그 화면으로 돌아옵니다. 공개가 꺼져 있을 때의 로그인 버튼도 같습니다 |
찍었을 때 나오는 화면
| 화면 | 언제 |
|---|---|
| 설비 정보 | 공개가 켜진 사이트의 살아 있는 라벨 |
| «공개되지 않은 설비입니다» | 공개가 꺼진 사이트의 라벨 |
| «찾을 수 없는 QR 코드입니다» | 재발급된 옛 라벨이거나 주소가 잘못됐을 때 |
| «요청이 너무 많습니다» | 한 주소에서 요청이 몰릴 때. 한 번에 10건, 그 뒤 분당 30건까지 받습니다 |
무엇이 남나
공개 경로의 응답은 한 건마다 pp.mm_asset_qr_access_audit 에 남습니다 — 시각 · 토큰 힌트 · 접속 주소 · 결과. 공개 경로에는 사람이 없으므로 누구인지는 남지 않고, 토큰 값 자체도 남기지 않습니다. 공개 페이지는 캐시와 검색 엔진 색인을 막아 둡니다.
API
현장 앱처럼 서버에서 토큰으로 설비를 찾을 때는 GET /api/v5/asset/qr/{token} 을 씁니다. 라벨에 담긴 주소는 GET /api/v5/asset/{id} 응답의 qr_payload 입니다. 이 호출은 토큰을 만들지 않으므로, 콘솔에서 라벨을 아직 열지 않은 설비나 콘솔 주소가 없으면 빈 문자열입니다. 엔드포인트 전체 목록 을 보세요.