기능
v1.0.3 기준 · 동기화일 2026-07-17아래는 LinkBoard에 실제로 구현되어 있는 기능입니다. 구현 예정 기능은 이 페이지에 포함하지 않습니다 — 로드맵 페이지에서 확인하세요.
멀티테넌트 & 접근 제어(RBAC)
SystemAdmin → Tenant → Customer → User 4단계 계층으로 조직을 구성합니다.
SYSTEM_ADMIN · TENANT_ADMIN · CUSTOMER_ADMIN · USER 4개 역할 기반 접근 제어로 장치·자산·대시보드를 고객사(Customer) 단위로 격리하고, 테넌트별 엔티티 한도(Tenant Profile)를 적용합니다.
자산·장치 계층 구조 & 관계
AssetGroup(공장) → Asset(라인) → Device(장비) 계층으로 현장을 모델링합니다.
장치는 SERVER · CLIENT · SHARED 3종 스코프의 Attribute를 가지며, 장치·자산 간 임의의 관계(타입·방향 지정)를 정의하고 관계 그래프로 시각화할 수 있습니다.
실시간 텔레메트리 수집
MQTT(EMQX 5.x, MQTT 5.0) · HTTP · WebSocket 세 가지 경로로 장치 데이터를 수집합니다.
수집된 데이터는 PostgreSQL/TimescaleDB 하이퍼테이블에 저장되어 대시보드에서 실시간·과거 구간 조회가 가능합니다. CoAP/LwM2M/SNMP는 아직 지원하지 않습니다.
엣지 게이트웨이 (linkboard-gateway)
현장 장비(PLC·OPC-UA 서버·MQTT 장치 등)의 데이터를 수집·변환해 단일 MQTT 연결로 LinkBoard 백엔드에 중계하는 별도 오픈소스 엣지 게이트웨이입니다.
SQLite 기반 영속 큐로 네트워크 단절 시에도 데이터 유실 없이 재연결 시 밀린 데이터를 전송합니다. YAML 설정 파일 기반이며 Docker로 배포합니다.
LinkBoard 본체와 별도 버전으로 관리되며, 아직 Pre-Alpha 단계입니다.
외부 장비 없이 랜덤 텔레메트리를 생성합니다 (테스트/데모용).
simulator외부 MQTT 브로커를 구독해 JSON 필드를 매핑하거나 그대로 전달합니다. 와일드카드(+, #) 토픽을 지원합니다.
mqttTCP/RTU로 레지스터를 폴링합니다. 정수/float32/float64 변환과 scale/offset, 쓰기 가능한 포인트를 지원합니다.
modbus노드를 구독하거나 폴링합니다. 쓰기 가능한 노드로 다운링크 제어를 지원합니다.
opcua미쓰비시 SLMP/MELSEC MC 프로토콜로 연결합니다 (선택 설치).
cclinkFANUC CNC 컨트롤러와 연동합니다 (별도 라이선스 라이브러리 필요, 선택 설치).
focasCAN 기반 CIP 프로토콜로 연결합니다 (선택 설치).
devicenetS7 통신(S7comm)으로 지멘스 PLC와 연동합니다 (선택 설치).
profinet대시보드 & 산업용 위젯
react-grid-layout 기반 드래그앤드롭 대시보드에서 위젯을 자유롭게 배치합니다.
실시간 WebSocket 구독, 실시간/과거 구간 타임윈도우, 다중 상태 드릴다운, 공개 공유 URL을 지원합니다.
Rule Engine 자동화
필터 → 보강 → 변환 → 액션 → 흐름 노드를 조합해 텔레메트리·속성 변경 이벤트를 자동으로 처리합니다.
테넌트 생성 시 root rule chain이 자동 구성되며, 서브체인 라우팅으로 복잡한 처리 흐름을 구성할 수 있습니다.
- 스크립트 필터
- 키 필터
- 장치 타입 필터
- 스위치(다중 분기)
- 메시지 타입 분기
- 중복 제거
- 지오펜스
- 발신자 속성 추가
- 발신자 최신 텔레메트리 추가
- 상위 자산 속성 추가
- 스크립트 변환
- 단위 변환
- 수식 계산
- 속성 저장
- 텔레메트리 저장
- REST API 호출
- 알람 생성
- 알람 해제
- 이메일 발송
- Slack 발송
- 로그
- 지연
- 룰 체인 호출
- 출력
알람 관리
Device/Asset Profile의 임계값 규칙이나 Rule Engine의 알람 노드로 알람을 생성·해제합니다.
임계값 위반 시 자동 생성, 값 복귀 시 자동 해제되며, 자산 계층으로 전파되고 이메일·Slack으로 알림을 보낼 수 있습니다.
OTA 펌웨어 업데이트
펌웨어 패키지를 등록하고, 대상 장치를 선택해 배포 작업을 생성합니다.
배포 작업의 진행 상태를 API와 화면에서 추적할 수 있습니다.
REST API & 화이트라벨
전체 기능을 `/api/v1` REST API로 공개하고, Swagger/ReDoc 문서와 API 키(`lbk_` 접두) 발급을 제공합니다.
시스템 전역 또는 테넌트별로 로고·색상·파비콘·로그인 배경·커스텀 CSS를 오버라이드해 브랜딩할 수 있습니다.
셀프호스팅 배포
로컬 개발은 hot-reload가 적용된 Docker Compose로 바로 구동할 수 있습니다.
단일 서버 프로덕션 배포용 `docker-compose.prod.yml`과 Nginx 정적 서빙/리버스프록시 구성도 함께 제공되어 자체 서버에 셀프호스팅할 수 있습니다.
그 외 지원 기능
OAuth2 + TOTP 2FA 로그인, 고객사에 텔레메트리 일부만 선택적으로 노출하는 Entity View, react-i18next 기반 한국어/영어 UI를 지원합니다.