멀티테넌트 & 접근 제어(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 웹 콘솔에는 게이트웨이 전용 관리 메뉴가 있어 등록된 게이트웨이의 헬스 상태(자식 장치 온/오프라인·커넥터 상태·하트비트)를 한눈에 모니터링하고, 문제가 있는 게이트웨이를 우선 표시합니다.
LinkBoard 본체와 별도 버전으로 관리되며, 아직 Pre-Alpha 단계입니다.
simulator외부 장비 없이 랜덤 텔레메트리를 생성합니다 (테스트/데모용).
mqtt외부 MQTT 브로커를 구독해 JSON 필드를 매핑하거나 그대로 전달합니다. 와일드카드(+, #) 토픽을 지원합니다.
modbusTCP/RTU로 레지스터를 폴링합니다. 정수/float32/float64 변환과 scale/offset, 쓰기 가능한 포인트를 지원합니다.
opcua노드를 구독하거나 폴링합니다. 쓰기 가능한 노드로 다운링크 제어를 지원합니다.
cclink미쓰비시 SLMP/MELSEC MC 프로토콜로 연결합니다 (선택 설치).
focasFANUC CNC 컨트롤러와 연동합니다 (별도 라이선스 라이브러리 필요, 선택 설치).
devicenetCAN 기반 CIP 프로토콜로 연결합니다 (선택 설치).
profinetS7 통신(S7comm)으로 지멘스 PLC와 연동합니다 (선택 설치).
db데이터베이스를 SQL SELECT로 주기 폴링해 텔레메트리를 수집하고, 파라미터화된 write 문으로 다운링크를 지원합니다.
media카메라/비전 이미지 소스(RTSP, USB, HTTP 스냅샷, 디렉토리)를 주기 촬영해 LinkBoard로 업로드합니다.
http임의의 REST/HTTP API를 주기 폴링해 텔레메트리·속성을 수집하고, 별도 write 요청으로 다운링크를 지원합니다.
대시보드 & 산업용 위젯
react-grid-layout 기반 드래그앤드롭 대시보드에서 위젯을 자유롭게 배치합니다.
실시간 WebSocket 구독, 실시간/과거 구간 타임윈도우, 다중 상태 드릴다운, 공개 공유 URL을 지원합니다.
Rule Engine 자동화
필터 → 보강 → 변환 → 액션 → 흐름 노드를 조합해 텔레메트리·속성 변경 이벤트를 자동으로 처리합니다.
테넌트 생성 시 root rule chain이 자동 구성되며, 서브체인 라우팅으로 복잡한 처리 흐름을 구성할 수 있습니다.
알람 관리
Device/Asset Profile의 임계값 규칙이나 Rule Engine의 알람 노드로 알람을 생성·해제합니다.
임계값 위반 시 자동 생성, 값 복귀 시 자동 해제되며, 자산 계층으로 전파되고 이메일·Slack으로 알림을 보낼 수 있습니다.
인앱 알림 센터(헤더 알림 벨 + 전체 목록 페이지)로 웹 콘솔 안에서도 알림을 받아볼 수 있고, 인앱·이메일·Slack 세 채널이 같은 알림 템플릿을 공유합니다.
OTA 펌웨어 업데이트
펌웨어 패키지를 등록하고, 대상 장치를 선택해 배포 작업을 생성합니다.
배포 작업의 진행 상태를 API와 화면에서 추적할 수 있으며, 진행 중인 작업의 취소와 실패/취소된 작업의 재시도를 지원합니다.
REST API & 화이트라벨
전체 기능을 `/api/v1` REST API로 공개하고, Swagger/ReDoc 문서와 API 키(`lbk_` 접두) 발급을 제공합니다.
시스템 전역 또는 테넌트별로 로고·색상·파비콘·로그인 배경·커스텀 CSS를 오버라이드해 브랜딩할 수 있습니다.
셀프호스팅 배포
로컬 개발은 hot-reload가 적용된 Docker Compose로 바로 구동할 수 있습니다.
단일 서버 프로덕션 배포용 `docker-compose.prod.yml`에는 Caddy 기반 자동 HTTPS(TLS 종단) 리버스 프록시가 정식 서비스로 포함되어 있습니다.
Prometheus + Grafana 관측 스택(대시보드·알람 룰 프로비저닝 포함)을 옵트인 compose 파일로 제공하고, pg_dump 기반 백업/복원 스크립트(보관 회전·오프사이트 업로드 지원)도 함께 제공됩니다.
그 외 지원 기능
OAuth2 + TOTP 2FA 로그인, 고객사에 텔레메트리 일부만 선택적으로 노출하는 Entity View, react-i18next 기반 한국어/영어 UI를 지원합니다.
텔레메트리·속성 키에 라벨·단위 등 메타데이터를 정의하는 키 정의(Key Definitions) 기능으로, 위젯이 키 메타데이터를 자동 상속해 일관된 표기를 유지합니다.