사내 공정 AAS · 최상위 설비 셸
설비 시스템 셸 — "순환자동제어기"
표준 ID 보기 ⓘ
사내 AAS 저장소에서 제어기나 단위 설비 한 대를 대표하는 최상위 셸(Shell)입니다. 프로젝트 이름을 바꿔도 흔들리지 않는 고유 시스템 식별자와 표준 API 엔드포인트를 갖습니다.
실제 들어가는 핵심 항목
- assetKind
- Instance — 현장에 실제로 설치된 설비 개체
- globalAssetId
- 설비 자산을 가리키는 전역 고유 식별자
- endpoints
- GET /api/v3.0/shells/{b64Id} · AAS Registry Descriptor 자동 동기화
- submodels
- 명판 · 시퀀스 제어 · 통신 접속 · 항목 대응 · 3D 형상 참조 연결
단일 저장소 안에서 같은 SystemName이 중복 등록되면 409 오류로 미리 막아 OPC UA 통신 노드 충돌을 예방합니다.
IDTA 02006-3-0 · DIGITAL NAMEPLATE
설비 디지털 명판 — "Nameplate" V3.0
semanticId ⓘ
설비 외함에 붙어 있는 금속 명판을 디지털 표준으로 옮긴 서브모델입니다. 제조사, 모델명, 제작 연도, 일련번호를 담습니다.
실제 들어가는 핵심 항목
- ManufacturerName
- 설비 제조사 이름 (다국어 지원)
- OrderCodeOfManufacturer
- 설비 주문·형식 코드 (예: DSDX-CTRL-01)
- SerialNumber
- 설비 고유 일련번호
- YearOfConstruction
- 2026 (제작 연도)
설비사·사용자 소유 영역(Zero-Touch)입니다. 처음 비어 있을 때만 기본 틀을 만들고, 이후 DS 모델을 저장소에 다시 반영해도 기존 명판 값을 덮어쓰지 않습니다.
DUALSOFT SMT 1/0 · SEQUENCE CONTROL
시퀀스 제어 정본 — "SequenceControlData" V1.0
semanticId ⓘ
공정 AAS 저장소의 심장입니다. 설비가 어떤 조건과 순서로 움직이는지, 어떤 장치를 부르고 어떤 안전 인터록을 거는지 표준 구조로 담습니다.
3개 관리 구역(Zone)으로 깔끔하게 분리
- Zone A (Sealed)
- Flows, Works, Apis, Mutexes, ControlArtifacts — 오직 .ds2 컴파일 반영으로만 갱신
- Zone B (Open)
- UserAnnotations — 저장소 PATCH + ETag로 현장 엔지니어 조치 메모 편집·보존
- Zone C (Live)
- Phase, ElapsedMs, 소프트 오메가 진단값 — 메모리 HotPlane /$value로만 실시간 응답
외부 클라이언트가 저장소의 Zone A 제어 구조를 직접 고치거나 지우려 하면 403 AAS-E403_SEQUENCE_CONTROL_SEALED로 즉시 차단합니다.
SEQUENCE GRAPH · FLOW · WORK · CALL
공정 흐름과 장치 호출 — Flows · Works · Apis · Mutexes
참조 규격 ⓘ
작업(Work) 사이의 시작·리셋 화살표와 다른 장치 시스템에 보내는 호출(Call), 동시에 켜지면 안 되는 상호배제(Mutex) 관계를 그대로 표현합니다.
실제 들어가는 핵심 항목
- Flows / Works
- 작업 목록, 목표 시간(DurationMs), ST 시작·유지 조건, 인터록 사유
- Calls
- 호출할 대상 API와 대상 설비 셸 참조(TargetShellRef)
- Mutexes
- 전진과 후진처럼 물리적 동시 구동을 금지하는 안전 짝
- IoPortBindings
- 외부 물리 I/O와 연결되는 논리 제어 포트 목록
저장소 API 클라이언트는 TargetShellRef(ModelReference)를 따라 호출 대상 장치의 AAS 셸 엔드포인트로 즉시 이동하며, 표준 탐색기 [Jump] 이동도 지원합니다.
SOURCE INTEGRITY & FIELD COLLABORATION
원본 무결성 및 현장 협업 — ControlArtifacts · UserAnnotations
원본 리소스 ⓘ
불필요한 파생 산출물로 저장소가 비대해지지 않도록, 언제든 제어 로직을 검증·복원할 수 있는 정본 원문(model.ds2) 지문과 트윈 바인딩만 깨끗하게 유지합니다.
실제 들어가는 핵심 항목
- DigitalFile_ModelDs2
- 주석과 서식이 보존된 정본 00_source/model.ds2 리소스와 SHA-256 지문
- TwinInstances
- 3D 기구학 조인트와 작업 동작을 잇는 트윈 동기화 바인딩
- UserAnnotations
- 시운전 중 저장소 API로 기록하는 점검 메모(재컴파일 시에도 100% 유지)
오프라인 백업·이관이 필요할 때만 표준 직렬화(GET /serialization) 스냅샷을 내보내며, 원문 첨부가 없는 외부 서브모델에서도 정규 .ds2 원문을 무손실 역합성합니다.
IDTA 02017-1-1 · ASSET INTERFACES DESCRIPTION
설비 통신 접속 기술 — "AssetInterfacesDescription" V1.1
semanticId ⓘ
설비의 PLC나 OPC UA 서버에 어떤 주소와 보안 방식으로 접속해 어떤 데이터점(태그)을 읽고 쓸 수 있는지 표준 방식으로 기술합니다.
실제 들어가는 핵심 항목
- EndpointMetadata
- opc.tcp://... 접속 주소와 보안 설정 정의
- InteractionMetadata
- 외부에서 읽고 쓸 수 있는 입출력 데이터점(주소·형식) 목록
실제 물리·외부 I/O 배선이 있는 모델에서만 깔끔하게 생성되며, 순수 논리 초안에서는 가짜 주소를 만들지 않습니다.
IDTA 02027-1-0 · MAPPING CONFIGURATION
인터페이스 항목 대응 — "AssetInterfacesMappingConfiguration" V1.0
semanticId ⓘ
설비 인터페이스(02017 AID)에서 읽은 데이터점을 AAS 안의 어느 제어 포트(SequenceControlData.IoPortBindings)에 넣을지 대응시키고, 실제 PLC 물리 주소를 관리합니다.
실제 들어가는 핵심 항목
- InterfaceReference
- 연결할 AssetInterfacesDescription의 인터페이스 참조
- MappingSourceSinkRelations
- 외부 통신 데이터점 ↔ 내부 시퀀스 제어 포트의 1:1 연결 관계
- PlcAddress / OpcUaNodeId
- 현장 시운전 엔지니어가 저장소에 기입한 실제 PLC 물리 주소(예: %IX0.0.0, %QX0.1.0)
저장소 3-Way 병합을 지원하여, 설계자가 .ds2 로직을 수정해 다시 커밋해도 시운전 팀이 입력해 둔 실제 PLC 주소는 사라지지 않고 보존됩니다.
IDTA 02026-1-0 · 3D MODELS
설비 3D 형상 연결 — "Models3D" V1.0
semanticId ⓘ
로봇·실린더·컨베이어의 3D 형상 자산(GLB 등)을 표준 서브모델로 연결합니다. DS Studio와 3D 디지털 트윈 뷰어가 저장소에서 같은 자산을 바로 불러옵니다.
실제 들어가는 핵심 항목
- Model3D (GLB)
- 설비·유닛의 3D 메쉬 자산 또는 검증 완료 공개 라이브러리 참조
- Twin Sync
- 시퀀스 Work 진행률에 맞춰 관절·스트로크가 같은 시간축으로 구동
3D 자산 참조만 독립적으로 추가·교체해도 시퀀스 제어 리비전과 충돌하지 않도록 서브모델 소유권과 ETag가 분리되어 있습니다.
출하 제품 여권 · 단품 최상위 셸
제품 여권 셸 — "AAS_DPP_001_DK_2026_0001"
표준 ID 보기 ⓘ
라인을 통과해 완성된 제품 한 개(시리얼 DK-2026-0001)의 디지털 제품 여권(DPP) 최상위 셸입니다. 유럽 공급망 데이터 스페이스(Catena-X · Manufacturing-X · ESPR) 규격에 맞춰 저장소와 Discovery에 등록됩니다.
실제 들어가는 핵심 항목
- idShort
- AAS_DPP_001_DK_2026_0001 (제품 시리얼별 자동 명명)
- Submodels (5)
- IDTA 공식 번호 템플릿 5종 엔드포인트만 깔끔하게 게시
- Equipment Isolation
- includeEquipmentShell = false — 사내 설비 제어 셸 격리·미노출
외부 데이터 스페이스에서 조회하거나 직렬화 스냅샷을 열어도 사내 설비 셸은 전혀 노출되지 않고 제품 셸과 IDTA 공식 템플릿 5종만 나타납니다.
IEC 61406 IDENTIFICATION LINK & DISCOVERY
제품 자산 식별 및 Discovery — AssetInformation
전체 링크 보기 ⓘ
제품 명판의 QR 코드로 바로 접속하는 국제 표준(IEC 61406) 웹 식별 링크와 데이터 스페이스 자산 역조회(Discovery) 키를 담습니다.
실제 들어가는 핵심 항목
- assetKind
- Instance — 개별 생산된 실물 제품 단품
- globalAssetId
- https://dualsoft.ai/api/id/.../DK-2026-0001 (IEC 61406 링크)
- specificAssetIds
- serialNumber = DK-2026-0001, partInstanceId, BPNL 사업자 코드
- Discovery Lookup
- POST /lookup/shellsByAssetLink 시리얼·로트 기반 셸 역조회 지원
외부 참여자가 식별 링크로 접속하면 Part 4 권한 정책에 따라 공개 서브모델만 먼저 반환하고, 파트너 서브모델은 인가 토큰을 검증합니다.
IDTA 02006-3-0 · DIGITAL NAMEPLATE (PUBLIC)
제품 디지털 명판 — "Nameplate" V3.0
semanticId ⓘ
누가, 언제, 어떤 로트와 시리얼 번호로 만든 제품인지 증명하는 공식 디지털 명판입니다.
실제 들어가는 핵심 항목
- ManufacturerName
- DualSoft Smart Factory
- ManufacturerProductType
- DS-DEMOKIT-CLAMP-26 (제품 형식)
- OrderCodeOfManufacturer
- LOT-DEMOKIT-ST4 (생산 로트 코드)
- SerialNumber
- DK-2026-0001 (개별 제품 일련번호)
열람 등급: PUBLIC (200 OK) — 고객사·검수자 누구나 QR 스캔만으로 정품 여부와 제조 정보를 실시간 조회할 수 있습니다.
IDTA 02099-1-0 · DIGITAL PRODUCT PASSPORT METADATA
디지털 제품 여권 메타데이터 — "DppMetadata" V1.0
semanticId ⓘ
유럽 에코디자인 규정(ESPR) 및 공급망 데이터 스페이스에서 요구하는 여권 고유번호, 발행 단위, 사업자·공장 식별코드를 담습니다.
실제 들어가는 핵심 항목
- granularity / dppStatus
- Item (단품 시리얼 단위) · Active (유효 여권)
- economicOperatorId
- BPNL00000001KR01 (제조 경제주체 식별코드)
- facilityId
- BPNS00000001KR20 (실제 생산 사업장 식별코드)
- delegatedServiceProviderId
- 자체 IT 인프라가 없는 중소 제조사를 대신해 데이터 스페이스 엔드포인트를 운영하는 위임 기관 코드
중소 협력사도 자체 서버 구축 없이 위임 운영자(delegatedServiceProviderId) 연동만으로 글로벌 데이터 스페이스에 표준 DPP를 게시할 수 있습니다.
IDTA 02011-1-1 · HIERARCHICAL STRUCTURES (BOM)
조립 부품·캐리어 계보 — "HierarchicalStructures" V1.1
semanticId ⓘ
이 완제품에 어떤 하위 부품이 조립되었고, 생산 당시 몇 번 팔레트·지그(캐리어)에 실려 이동했는지 1단계 아래 계층(OneDown)으로 기록합니다.
실제 들어가는 핵심 항목
- ArcheType
- OneDown — 상위 제품에서 하위 구성품 여권 방향 연결
- EntryNode
- DK-2026-0001 (SelfManagedEntity, 완제품 자신)
- Node_001_PALLET_01
- 운반 캐리어 및 조립된 하위 부품 여권 연결 관계(HasPart)
열람 등급: DELEGATED_PARTNER — 부품 공급망 계보는 민감 정보이므로 데이터 스페이스에서 인가된 파트너에게만 열람을 허용합니다(미인가 시 403).
IDTA 02031-2 · EXECUTED PROCESSES & QUALITY
실행된 공정 이력 및 품질 판정 — "ExecutedProcesses" V1.0
국제 시맨틱 코드 ⓘ
제품이 각 공정(ST1~ST4)을 거치며 실제로 몇 ms 동안 가공·취출되었는지와 최종 품질 판정(양품·선제 격리·불량)을 기록합니다.
실제 들어가는 핵심 항목
- Run_01.RunResult
- CONFORMING_OK (양품) / HOLD (선제 격리) / NG (불량)
- Process_001..005
- 투입·이송·검사·취출 각 공정 Work의 실측 구동 시간(ms)과 시각
- Semantic Units
- ECLASS 및 IEC CDD 국제 표준 속성 코드로 구동 시간(ms) 의미 명시
별도 아날로그 센서가 없는 순수 DI/DO 설비에서도 실린더 동작 시간 편차(소프트 오메가)로 무알람 불량 원인을 역추적해 여권 저장소에 기록합니다.
IDTA 02003-2-0 · TECHNICAL DATA (PUBLIC)
표준 제품 기술 사양 — "TechnicalData" V2.0
semanticId ⓘ
고객사 구매·품질 시스템이 데이터 스페이스 API로 바로 읽어들일 수 있는 제품의 국제 분류 코드와 기본 기술 특성표입니다.
실제 들어가는 핵심 항목
- GeneralInformation
- 제조사명, 제품 지정명, 제조사 품번(ManufacturerArticleNumber)
- ProductClassifications
- ECLASS 등 국제 산업 제품 분류 체계 코드
- TechnicalPropertyAreas
- 정격 사양, 치수·공차, 품질 기준 특성값
열람 등급: PUBLIC (200 OK) — 통관·입고 검수 시 별도 파일 변환 없이 상대방 시스템이 즉시 사양을 검증할 수 있습니다.