VEXPLOR
VEXPLOR AAS STUDIO · OPEN SOURCE · APACHE-2.0 · v2.2.0

VEXPLOR AAS Studio는AASX 작성 · 검사부터 설비 값 수집과 MES · ERP · CMMS 연동까지 웹 화면 하나로 처리합니다

설비 AASX를 올리면 규칙 43종이 어긋난 곳을 짚고, 고칠 수 있는 지적은 미리 보고 한 번에 고칩니다. 같은 서버가 IDTA Part 2 REST API로 AAS를 내주고, OPC UA · Modbus TCP · MQTT로 설비 값을 모으고, MES · ERP · CMMS에 사건(이벤트)과 설비 정보를 보냅니다.

제조 IT · OT 엔지니어, MES · ERP · CMMS 연동 담당, AAS 제출을 준비하는 기업이 직접 설치해 쓰는 오픈소스입니다.

데모 계정 demo / 0629 — 새 창으로 열립니다. 체험 서버는 시연용입니다.

VEXPLOR AAS STUDIO · 작업 화면
VEXPLOR AAS Studio 작업 화면 — 왼쪽 AAS 트리, 가운데 요약, 오른쪽 수집 칸. 견본 파일(롤포밍 설비)을 연 화면

작업 화면 — 왼쪽 트리 · 가운데 요약(서브모델 7 · 요소 175 · 규칙 위반 0건) · 오른쪽 수집 칸. 견본 파일 · v2.1.0 화면

43검사 규칙
19자동 고치기 규칙
V3.0AAS 메타모델
3수집 규약 OPC UA · Modbus TCP · MQTT
01WHYTHREE TOOLS · ONE SCREEN

VEXPLOR AAS Studio는 도구 셋이 하던 일을
브라우저 한 화면에 모읍니다

하던 일예전 도구여기서는
AASX 열기 · 고치기 · 내려받기AASX Package Explorer (설치형)브라우저에서, 고칠 곳을 짚어 주고 자동으로 고칩니다
다른 시스템에 AAS 내주기 (Part 2 REST · 레지스트리)Eclipse BaSyx 서버같은 서버가 내줍니다
설비 값 모으기 · 구독으로 내주기별도 OPC UA 클라이언트 · 서버AAS 안의 AID대로 모으고 OPC UA 서버로 내줍니다

위 도구들과 제휴하거나 그 소스를 쓴 것이 아닙니다 — 같은 일을 한곳에 모았다는 뜻입니다.

최종 합격 판정은 제출처 검증기가 합니다표준 검증을 모두 통과한 AASX도 제출처 검증기의 사업 규칙(semanticId 허용 목록 · 필수 서브모델 · 패키지 구조)에서 떨어질 수 있습니다. VEXPLOR AAS Studio는 그 규칙을 제출 전에 미리 검사합니다.
02FEATURESSIX FEATURES · REAL SCREENS

VEXPLOR AAS Studio의 기능 6가지
— 그림은 모두 실제 화면입니다

01작성 · 트리

트리 화면은 AASX 구조를 펼쳐 보여 주고, 사용자는 그 화면에서 바로 값을 고칩니다

  • AASX(JSON · XML)를 열어 AAS → 서브모델 → 요소 순서로 봅니다
  • 값 · 요소 · 서브모델 · ConceptDescription을 고치고, 값 표나 CSV 설비 대장으로 여러 값을 한 번에 채웁니다
  • 한 번에 되돌리고, 서브모델을 지난 시점으로 복원합니다
  • 파일이 없으면 「견본으로 시작하기」가 다 채운 설비 1종과 공정 구성을 엽니다
VEXPLOR AAS STUDIO · 검사 결과
검사 결과 화면 — 위반 0건 · 경고 9건(자동 고치기 대상)

검사 결과 — 위반 0건 · 경고 9건(자동 고치기 대상). 견본 파일 SPREquipment · v2.1.0 화면

VEXPLOR AAS STUDIO · 자동 고치기
자동 고치기 미리보기 — 항목마다 체크 상자, 고치기 전 값과 후 값

자동 고치기 미리보기 — 항목마다 체크 상자, 고치기 전 값과 후 값

02검사 · 자동 고치기

규칙 43종이 어긋난 곳을 짚고, 고치기 전에 바뀔 값을 먼저 보여 줍니다

  • 패키지 구조(L1) · 메타모델 제약(L2) · 제출처 사업 규칙(L3)으로 나눠 검사합니다
  • 위반 · 경고 · 참고로 나누고, 왜 틀렸는지와 고치는 법을 함께 적습니다
  • 고칠 수 있는 지적(규칙 19종)은 전 / 후를 보고 체크한 것만 반영합니다. 바꾼 내용은 이관 대장에 남습니다
AAS STUDIO · 수집
수집 칸 — 견본 파일을 가상 PLC(시뮬레이션)에 연결한 화면

수집 칸 — 견본 파일을 가상 PLC(시뮬레이션)에 연결한 화면입니다. 시연 값이며 실제 설비 데이터가 아닙니다.

03현장 값 수집

서버가 AAS 안의 AID대로 설비 값을 모으고, 설비마다 하루 상태를 그립니다

  • OPC UA · Modbus TCP · MQTT — 주소는 AAS 안의 AID(IDTA 02017) 서브모델이 정합니다
  • 값마다 받는 중 · 끊김 · 값 없음을 보여 줍니다
  • 설비마다 하루 상태 막대(가동 · 정지 · 알람)를 그립니다
  • 실물 PLC가 없으면 도구 안의 가상 PLC로 바로 시험합니다

04표준 API

다른 시스템은 IDTA Part 2 REST API로 이 서버의 AAS를 읽어 갑니다

  • AasxFileServer 6/6 · ConceptDescription 7/7 · AAS Repository 47/54 · Submodel Repository 38/45, 레지스트리와 Discovery 일부
  • globalAssetId로 셸을 찾고, 레지스트리 디스크립터에 적힌 주소로 서브모델을 읽습니다
  • node scripts/part2-coverage.mjs가 명세의 OpenAPI와 구현을 대조해 정확한 범위를 출력합니다
# 셸 찾기 (globalAssetId)
GET /api/v3.0/lookup/shells?assetIds=<base64url>
# 파일별 Part 2 기준 주소
GET /packages/{packageId}/api/v3.0/shells
GET /packages/{packageId}/api/v3.0/submodels/{id}
VEXPLOR AAS STUDIO · 레퍼런스 번들
레퍼런스 번들 화면 — 설비 수, 사전 점검, 실동작 증빙 집계와 구성 상태

레퍼런스 번들 — 설비 수, 사전 점검, 실동작 증빙 집계와 구성 상태. 가상 PLC(시뮬레이션) 시연 파일

05제출 번들 · 결과서

공정 묶음은 제출용 레퍼런스 번들과 검증 결과서로 나갑니다

  • 회사 → 라인 → 공정 → 설비 → 부품 계층으로 설비를 묶습니다
  • 레퍼런스 번들 ZIP 하나에 모델 · 첨부 · 사전 점검 결과를 담고, bundle-manifest.json에 파일마다 SHA256을 적습니다
  • 검증 결과서는 HTML이라 인쇄하면 그대로 PDF가 됩니다
VEXPLOR AAS STUDIO · 연동
연동 창 — 내보내기 탭, 설비 마스터 · BOM · 공정 계층 · 보전 계획 · 문서 목록

연동 창 — 내보내기 탭: 설비 마스터 · BOM · 공정 계층 · 보전 계획 · 문서 목록

06MES · ERP · CMMS 연동 · 2.0부터

2.0부터 MES · ERP · CMMS가 설비 사건과 설비 정보를 받아 갑니다

  • 읽어 가는 주소(pull feed) — 모든 변경과 가동 사건을 CloudEvents 1.0으로 순서대로 내주고, 원하는 번호부터 다시 읽을 수 있습니다
  • 서명 웹훅 — HMAC-SHA256 서명, 실패하면 다시 보내고 끝내 실패한 건은 따로 남깁니다
  • MQTT — 같은 사건을 토픽으로 보내고, 설비마다 현재 상태를 retained로 둡니다
  • 판정 규칙 — 수집한 값으로 가동 상태 · 알람 · 계수기 · 한계값 사건을 만듭니다
  • 내보내기 — 설비 마스터 · BOM · 공정 계층 · 보전 계획 · 문서 목록을 JSON · CSV로. 2.1.0부터 한 묶음 ZIP으로도 받고, 2.2.0부터는 서버 없이 AASX 파일에서 같은 묶음을 만드는 라이브러리(@aas/bundle)도 있습니다
  • 외부 번호 — ERP · MES · CMMS 번호는 AASX 안이 아니라 옆에 따로 보관합니다

연동은 INTEGRATIONS=on으로 켭니다(기본은 꺼짐). PostgreSQL에서 구독을 만들려면 AAS_SECRET_KEY도 필요합니다. 체험 서버에서는 항상 꺼져 있습니다.

연동 안내 (MES · ERP · CMMS) →
03CONNECTIONSSTANDARD PROTOCOLS

VEXPLOR AAS Studio는 설비와 공장 시스템을
표준 규약으로 연결합니다

설비 · PLC

  • OPC UA
  • Modbus TCP
  • MQTT

주소는 AAS 안의 AID가 정합니다

VEXPLOR AAS Studio

  • AASX 보관 · 편집
  • 규칙 43종 검사
  • 수집값 시계열
  • 사건 기록 (event log)

MES

  • CloudEvents 읽어 가는 주소
  • 웹훅 · MQTT
  • OPC UA 구독 (읽기 전용)
  • 공정 계층 CSV · JSON

ERP

  • 설비 마스터 · BOM 내보내기
  • equipment.master.changed 사건

CMMS

  • 알람 웹훅
  • 보전 계획 · 문서 목록
  • 계량값 (meters)

다른 AAS 도구

  • AAS Part 2 REST
  • 레지스트리 · Discovery
내보내기만 합니다VEXPLOR AAS Studio는 MES · ERP · CMMS에 쓰지 않고, 설비에 명령하지 않습니다. OPC UA 서버도 읽기 전용입니다.
04SECURITY · DEPLOYMENTSELF-HOSTED

운영자가 서버를 직접 설치하고
계정과 권한을 정합니다

항목내용
직접 설치Docker Compose 또는 Node.js 22 이상에서 소스로 실행합니다. 외부 클라우드가 필요 없습니다.
저장소공유 운영은 PostgreSQL, 혼자 쓸 때는 데이터 폴더 하나에 저장합니다.
계정 · 역할관리자 · 편집자 · 열람자. 누가 무엇을 고쳤는지 변경 이력에 남습니다.
어디에서 열리나소스로 실행하고 계정도 API 키도 없으면 127.0.0.1에서만 열립니다. Docker 예시는 .env.example의 AAS_ALLOW_OPEN=1 때문에 같은 망에 열리므로, 띄운 직후 첫 관리자를 만들고 앞단에 HTTPS를 둡니다.
OPC UA 서버기본은 꺼짐. 켜면 웹 계정으로 로그인하고 Sign · SignAndEncrypt만 받습니다. 익명 접속은 없고, 클라이언트 인증서는 관리자가 한 번 신뢰해 줍니다.
개인 작업 공간AAS_WORKSPACE=private로 사람마다 자기가 올린 파일만 봅니다.
로그인 보호비밀번호는 scrypt 해시만 저장하고, 5회 실패하면 5분 잠급니다. 쿠키는 HttpOnly · SameSite=Strict입니다.
밖으로 나가는 연결웹훅 · MQTT는 루프백 · 메타데이터 주소를 거부하고, 사설망은 허용 목록에 적은 곳만 갑니다. 서명 비밀값은 AES-256-GCM으로 봉합니다.
05LIMITSWHAT IT DOES NOT DO

VEXPLOR AAS Studio가 하지 않는 일과
알려진 제약

  • 합격 판정은 제출처 검증기가 합니다. 이 도구는 제출 전 사전 점검입니다.
  • MES · ERP · CMMS에 쓰지 않고, 설비에 명령하지 않고, OEE 숫자를 계산하지 않습니다(재료가 되는 시간과 계수만 줍니다).
  • 기본은 공유입니다. 로그인한 사람은 같은 파일을 봅니다. 개인 모드에서도 관리자와 API 키는 모든 파일을 봅니다.
  • 세션은 서버 메모리에 있습니다. 서버를 다시 켜면 모두 로그아웃되고, 서버 1대를 전제로 합니다.
  • 메일을 보내지 않습니다. 비밀번호를 잊으면 관리자가 다시 정합니다.
  • 연동 구독은 서버 전체 범위입니다. 한 고객의 자료가 다른 시스템에 가면 안 될 때는 구독을 파일 단위로 좁힙니다.
  • AAS 메타모델은 V3.0에 고정돼 있고 3.1로 자동 전환하지 않습니다. Part 2 API는 위 범위만 구현돼 있습니다.
보안 정책 전문 →
06GET STARTEDDOCKER · TRIAL SERVER

VEXPLOR AAS Studio는
Docker 명령 4줄로 실행됩니다

git clone https://github.com/waceinc/vexplor-aas.git && cd vexplor-aas
cp .env.example .env
sed -i.bak "s/^POSTGRES_PASSWORD=.*/POSTGRES_PASSWORD=$(openssl rand -hex 16)/" .env
docker compose up -d --build

셋째 줄은 비어 있는 데이터베이스 비밀번호(POSTGRES_PASSWORD)를 무작위 값으로 채웁니다. 이 값이 비어 있으면 Docker가 시작하지 않습니다.

브라우저에서 http://localhost:8080을 열고 설정 → 첫 관리자 만들기로 들어갑니다. 이 서버는 같은 망에 열려 있어(AAS_ALLOW_OPEN=1) 첫 관리자를 만들 때 설치 코드를 묻습니다. 코드는 docker compose logs app | grep "설치 코드"로 찾습니다. 첫 관리자를 만들기 전까지는 같은 망의 누구나 이 서버를 열 수 있습니다.

체험 서버

가입 없이 데모 계정으로 바로 써 볼 수 있습니다. 작업한 파일을 내려받으려면 회원가입이 필요합니다.

데모 계정회원
열기 · 고치기 · 검사 · 자동 고치기가능가능
검증 결과서 보기가능가능
AASX · 번들 내려받기회원만가능

데모 계정 demo / 0629. 데모는 로그인할 때마다 빈 작업 공간이 따로 생기고, 한동안 쓰지 않은 파일은 지워집니다. 운영자가 볼 수 있으므로 기밀 자료는 올리지 마십시오.

오픈소스내용
현행 판VEXPLOR AAS Studio 2.2.0
라이선스Apache License 2.0 — 고쳐 쓰고 상용 제품에 넣을 수 있습니다
이름 · 로고VEXPLOR · WACE 이름과 로고는 Apache-2.0 사용 허락에 들어 있지 않습니다 (NOTICE 참고)
소스 · 문서github.com/waceinc/vexplor-aas · 공식 프로젝트 페이지
07PLACE IN VEXPLOR SUITEUNDER CONNECT

VEXPLOR Suite 안의 위치

Connect 아래에 오픈소스 도구 VEXPLOR AAS Studio(Apache-2.0)가 있습니다.

Connect는 설비 · 시스템 연동 모듈입니다. 국제표준 AAS(IEC 63278)와 산업 프로토콜로 설비 데이터를 표준 형식으로 변환합니다.

VEXPLOR Connect 보기 →

AASX 작성부터 MES · ERP · CMMS 연동까지 웹 화면 하나로

공개 저장소에서 내려받아 직접 설치하실 수 있습니다. 설비 연동을 함께 검토하시려면 도입 진단을 요청해 주십시오.

GitHub에서 받기도입 진단 받기