시작하기
PlantPulse Studio 는 채팅으로 현장 화면을 만드는 도구입니다. 코드를 몰라도 "3번 라인 온도 대시보드 만들어줘" 라고 쓰면 실제 설비 데이터에 연결된 앱이 만들어집니다.
이 장에서는 로그인부터 화면 구성까지, 처음 5분 동안 알아야 할 것만 다룹니다.
로그인
브라우저에서 관리자가 알려준 주소로 접속하면 로그인 화면이 나옵니다.
- 아이디 와 비밀번호 를 입력합니다.
- 로그인 버튼을 누릅니다.
계정은 두 종류가 있지만 사용법은 같습니다 — 스튜디오에서 따로 만들어 준 계정이거나, 평소 쓰던 플랜트 플랫폼 계정입니다. 어느 쪽이든 관리자에게 받은 계정을 그대로 입력하면 됩니다.
로그인 카드 오른쪽 위의 KO · EN 을 눌러 로그인 화면 언어를 바꿀 수 있습니다.
아이디나 비밀번호가 틀리면 아이디 또는 비밀번호가 올바르지 않습니다 가 표시됩니다. 계정은 맞는데 다른 메시지가 뜬다면 서버나 플랫폼 쪽 문제일 수 있습니다 — 트러블슈팅을 참고하거나 관리자에게 문의하세요.
첫 로그인 안내 카드
처음 로그인하면 5단계 안내 카드가 뜹니다. 다음 으로 넘기며 읽고 마지막에 시작하기 를 누르면 닫힙니다. 지금 보고 싶지 않다면 왼쪽 아래 건너뛰기 를 누르세요. 한 번 닫으면 다시 뜨지 않습니다.
화면 구성
로그인하면 홈 화면이 열립니다. 화면은 크게 세 부분입니다.
| 위치 | 이름 | 역할 |
|---|---|---|
| 왼쪽 세로 띠 | 네비게이션 | 메뉴 이동 (아이콘만 표시) |
| 가운데 | 작업 영역 | 선택한 메뉴의 내용 |
| 맨 아래 가는 줄 | 상태바 | 연결 상태 · 테마 · 언어 · 버전 |
왼쪽 네비게이션
왼쪽 끝의 좁고 어두운 세로 띠가 네비게이션 입니다. 공간을 아끼려고 아이콘만 표시하므로, 아이콘 위에 마우스를 올리면 오른쪽에 메뉴 이름이 툴팁으로 뜹니다. 현재 보고 있는 메뉴는 초록 테두리로 둘러싸입니다.
위에서부터 차례로:
| 아이콘 | 메뉴 | 하는 일 |
|---|---|---|
집 fa-house | 홈 | 큰 입력창에 한 문장을 써서 앱을 만듭니다 → 홈에서 앱 만들기 |
말풍선 fa-messages | 채팅 | 앱을 만들지 않고 데이터에 바로 질문합니다 → 채팅으로 데이터 질의 |
격자 fa-grid-2 | 애플리케이션 | 내가 만든 앱 목록 · 열기 · 배포 · 공유 → 앱 카탈로그와 공유 |
레이더 fa-radar | 와처 | 데이터를 주기적으로 감시하고 알림을 받습니다 → 와처와 알림 |
전구 fa-lightbulb | 스킬 | 우리 현장의 노하우를 등록해 둡니다 → 현장 스킬 |
상점 fa-store | 템플릿 | 이미 만들어진 화면 틀로 앱을 시작합니다 |
격자 fa-grid-2 | 갤러리 ↗ | 공개 배포된 앱 모음 (새 탭으로 열림) |
책 fa-book-open | 매뉴얼 ↗ | 지금 보고 있는 이 설명서 (새 탭으로 열림) |
맨 아래쪽에는 로그아웃과, 관리자에게만 보이는 관리 메뉴가 있습니다.
| 아이콘 | 메뉴 | 비고 |
|---|---|---|
사람들 fa-users | 사용자 관리 | 관리자만 |
막대그래프 fa-chart-column | 통계 | 관리자만 |
톱니바퀴 fa-gear | 환경설정 | 관리자만 → 환경설정(관리자) |
나가는 화살표 fa-arrow-right-from-bracket | 로그아웃 | 모두 |
가장 아래 동그란 표시는 내 계정입니다. 마우스를 올리면 내 아이디가 뜹니다.
레이더 아이콘 오른쪽 위에 빨간 숫자가 붙으면 아직 확인하지 않은 알림이 있다는 뜻입니다. 9개를 넘으면 9+ 로 표시됩니다.
화면마다 주소가 있습니다
메뉴를 옮기면 브라우저 주소가 함께 바뀝니다. 그래서 화면을 링크로 건네줄 수 있고, 브라우저 뒤로/앞으로 가기가 그대로 동작하며, 새로고침해도 보던 화면이 유지됩니다.
| 화면 | 주소 |
|---|---|
| 홈 | / |
| 채팅 | /ask |
| 애플리케이션 (전체) | /projects |
| 애플리케이션 — 개발 중 · 배포됨 · 공유받음 | /projects/dev · /projects/deployed · /projects/shared |
| 와처 | /watchers |
| 알림 | /notifications |
| 스킬 | /skills |
| 템플릿 | /market |
| 사용자 관리 | /users |
| 통계 | /usage |
| 환경설정 | /settings |
관리자에게 "환경설정 → AI 탭을 보세요" 라고 말로 설명하는 대신
https://<STUDIO_HOST>/settings 를 그대로 보내면 됩니다.
오타가 났거나 옛 북마크를 열면 빈 화면 대신 홈이 뜹니다. 로그아웃하거나 세션이 끊겨
다시 로그인하면 주소도 / 로 돌아갑니다.
빌더에서 앱을 열고 있는 상태는 링크로 건네줄 수 없습니다. 받은 사람은
애플리케이션 목록(/projects)에서 해당 앱을 직접 열어야 합니다.
/m 으로 갑니다휴대폰 브라우저로 접속하면 모바일 화면(/m)으로 자동 전환됩니다 →
휴대폰에서 쓰기. 배포된 앱 주소(/apps/…)는 전환되지
않고 그대로 열립니다.
하단 상태바
화면 맨 아래의 가는 줄에서 지금 상태를 한눈에 볼 수 있습니다.
- 왼쪽 — AI: 앞의 작은 불빛이 초록이면 정상입니다. 노랑은 연결 중, 빨강은 오류입니다.
- 오른쪽 — 테마: 밝은 화면(라이트)과 어두운 화면(다크)을 전환합니다. 현장 조명이 밝으면 라이트, 어두운 통제실이면 다크가 편합니다.
- 오른쪽 — KO / EN: 화면 언어를 한국어와 영어로 즉시 바꿉니다. 다시 로그인할 필요는 없습니다.
- 오른쪽 — 버전: 지금 설치된 스튜디오 버전입니다. 문제를 문의할 때 이 번호를 함께 알려주세요.
- 맨 오른쪽 — 플랫폼: 설비 데이터가 오는 플랜트 플랫폼과의 연결 상태입니다. 불빛 위에 마우스를 올리면 자세한 상태가 뜹니다.
| 플랫폼 불빛 | 뜻 |
|---|---|
| 초록 | 플랫폼 연결됨 — 정상 |
| 노랑 | 플랫폼 응답 이상 — 느리거나 일부 실패 |
| 빨강(깜빡임) | 플랫폼 단절 — 실데이터·와처 일시 중지 |
| 회색 | 플랫폼 상태 확인 중 |
설비 데이터를 읽을 수 없는 상태라 채팅 답변과 와처 실행이 멈춥니다. 앱을 편집하는 것 자체는 가능하지만, 실데이터가 필요한 작업은 연결이 복구된 뒤에 하세요.
역할별로 할 수 있는 일
계정마다 역할이 정해져 있고, 역할에 따라 보이는 메뉴와 할 수 있는 일이 다릅니다.
| 역할 | 할 수 있는 일 |
|---|---|
| 뷰어 | 채팅으로 데이터 질문, 공유받은 앱 사용. 앱을 만들거나 고칠 수는 없습니다. |
| 빌더 | 뷰어가 할 수 있는 일 전부 + 앱 만들기·수정·배포·공유, 와처와 스킬 만들기 |
| 관리자 | 빌더가 할 수 있는 일 전부 + 사용자 관리, 통계, 환경설정 |
대부분의 현장 엔지니어는 빌더 입니다.
입력창 아래에 뷰어 권한은 앱을 생성할 수 없습니다. 라고 안내가 뜨고 만들기 버튼이 비활성화됩니다. 앱 제작이 필요하면 관리자에게 역할 변경을 요청하세요.
다음 단계
- 앱을 하나 만들어 보고 싶다면 → 홈에서 앱 만들기
- 앱 없이 데이터부터 확인하고 싶다면 → 채팅으로 데이터 질의
- 휴대폰으로 현장에서 쓰려면 → 현장 모바일