테마
화면 설명 — 공유
메뉴 공유 아래에 데이터스페이스와 API 5종(디지털 트윈 레지스트리 API · 디지털 트윈 이벤트 API · 품질 알림 API · CCM 알림 API · PCF 교환 API)이 있습니다.
데이터스페이스
- Catena-X 참여 정보: BPNL · BPNS · BPNA · 멤버십 ID. 소유자는 수정 가능, 멤버는 읽기 전용
- 커넥터 정보: 연결 상태(정상 / 연결 오류 / 확인 중 / 알 수 없음) · DSP 주소 · 커넥터 버전. 모두 읽기 전용(운영팀 설정 값). 마지막 확인 시각(방금 확인 / N분 전 / …)
- 연결 상태 기록(최근 24시간): 확인 시각 · 대상(Control Plane / Data Plane) · 상태 · 메시지 · 데이터
엔드포인트 API 공통 화면
공유 > API 5종 각 페이지는 위에서부터 내 엔드포인트 카드 → 파트너 관계 카드 순서입니다. 관계 추가 버튼은 파트너 관계 카드 오른쪽 위에 있습니다(소유자만, 멤버는 잠금 안내).
내 엔드포인트 카드
| 항목 | 내용 |
|---|---|
| 제목 옆 태그 | 등록된 채널 수 / 전체 채널 수(예: 1/4) |
| 부제 | 상대 기업이 우리에게 요청을 보낼 때 쓰는 엔드포인트입니다. 채널은 이 API 가 받는 요청 종류별 수신 항목입니다. |
| 행 | 이 API가 만들 수 있는 채널마다 한 줄 고정(PCF·CCM·디지털 트윈 1, 품질 알림 4, 디지털 트윈 이벤트 3), 채널 순서 고정 |
| 표 열 | 채널 · 등록 · 호환 · 공개 범위 · 계약 중인 기업 · 관리 |
| 채널 | 채널 이름 + 상태 태그 활성 · 숨김 · 삭제됨 · 미등록. 숨김=협상 이력이 있어 숨긴 최신 발행본, 삭제됨=최근 삭제된 발행본 |
| 등록 | 발행본 배지(v{n}) + 등록일. 삭제됨이면 삭제일도 표시 |
| 호환 | 직접 추가한 EDC 버전 태그(Saturn / Jupiter), 3개째부터 +n. 자동 추가되는 버전은 없음 |
| 공개 범위 | 활성이면 모든 참여자, 아니면 — |
| 계약 중인 기업 | 기업 수, 이전 발행본하고만 계약한 기업이 있으면 재계약 필요 N곳 |
| 관리 | 활성: 버전 관리 · (플랫폼 사양 개정 필요 시)재발행 · 삭제(소유자만). 숨김: 버전 관리 · 등록. 삭제됨·미등록: 등록(소유자만) |
| 재발행 배너 | "플랫폼 업데이트로 재발행이 필요합니다(필요 규격 r{required}, 현재 r{current}). 아래 [재발행]으로 새 발행본을 등록하세요." — 재발행 클릭 시 확인 창(새 발행본 생성 예고 + 계약 중인 상대 기업은 재계약 필요 경고) 후 실행. 실행하면 이전 발행본은 내려가고(계약 이력 있으면 숨김, 없으면 완전 삭제) 새 발행본이 등록되며, 이 자산과 계약 중이던 관계는 모두 재계약 필요로 표시됨 |
| 멤버 화면 | 등록 버튼 대신 "엔드포인트 API 등록과 버전 추가는 조직 소유자만 할 수 있습니다. 조직 소유자에게 등록을 요청하세요." |
엔드포인트 API 추가 창(행의 등록 · 버전 관리 모달의 호환 버전 추가 공통) — EDC 버전 행 Saturn(현재, EDC 0.11 이상) / Jupiter(이전, EDC 0.10 이하) 각 추가, 이미 있으면 이미 등록됨. 등록할 버전은 사용자가 직접 고르며, 상대 기업 버전은 파트너 관계 상세의 상대 기업 EDC 버전 카드(현재 버전 · 이전 버전 가능성 · 미확인, 새로고침 버튼)로 확인
버전 관리 모달 (카드 행에서 열기)
| 항목 | 내용 |
|---|---|
| 헤더 | 채널 이름 + 상태 태그(활성 / 숨김), 협상 이력이 있으면 협상 이력 N건 |
| 재발행 배너(활성 + 플랫폼 사양 개정 필요 시) | 헤더 아래 경고 배너 + 재발행 버튼 — 카드 행 작업과 같은 확인 창·동작 |
| 속성 | ID · 이름 · 발행본 · 등록일 · 계약 중인 기업 |
| 자산 | 자산 ID · 이름, 원문 펼쳐보기 — 소유자는 펼친 원문을 바로 고칠 수 있음. 고치면 경고("이 JSON을 직접 편집하면…", 협상 이력이 있으면 "협상 이력이 있어 수정하면…")와 되돌리기 · 저장이 켜짐. @id·@type·dct:type·cx-common:version은 바꿀 수 없음("바꿀 수 없는 항목을 수정했습니다…") |
| 버전별 계약 정의 | 오른쪽 위 호환 버전 추가(소유자·활성만). EDC 버전별로 접힌 항목 — 펼치면 계약 정의 ID · 등록일, 계약 정의 원문 펼쳐보기, 접근 정책 · 계약 정책(이름·ID, 정책 상세 보기), 항목 오른쪽 버전 삭제 |
| 이전 발행본 | 이전 발행본 아래 접힌 목록(v{n} · 날짜 · 숨김), 계약 중인 기업 표시, 버전 삭제는 불가 |
| 구버전으로 계약 중인 파트너 | 재계약 안내 필요 표시 |
| 자산 삭제(협상 이력 있음) | 카탈로그에서 숨김 — 삭제하지 않고 숨겨 파트너에게 더 보이지 않음. 이전 발행본 영역에서 계속 확인 |
| 자산 삭제(협상 이력 없음) | 완전 삭제("자산과 연결된 모든 EDC 버전의 계약 정의와 전용 정책이 삭제됩니다. 되돌릴 수 없습니다.") |
파트너 관계 카드
| 항목 | 내용 |
|---|---|
| 버튼 | 관계 추가(소유자만) · 모두 검증(현재 페이지가 아니라 이 API 전체 관계를 서버가 일괄 검증) |
| 검색·필터 | 기업명 · BPN 검색창, 상태 필터(전체 포함) |
| 열 | 기업 · 상태 · 상대 API 연결 · 내 API 연결 · 최근 활동 · 작업. 기업 칸은 이름과 BPN만 보입니다(이름 출처는 이름에 마우스를 올리면 보임) |
| 상대 API 연결 상태 | 연결 중 · 선택 필요 · 상대 미지원 · 연결됨 · 갱신 필요 · 재계약 필요 · 실패 · 미연결 · 계약 없음. 색 점 + 상태 옆에 수립일, 실패면 아래 줄에 사유 |
| 내 API 연결 상태 | 엔드포인트 없음 · 미공개 · 대기 중 · 계약됨 · 구버전 계약 · 종료됨 · 계약 없음. 상태 옆에 상대 기업이 계약한 내 발행본과 계약일(예: v1 · 2026-09-20). 내 최신 발행본이 더 높으면 v1 → v2 |
| 상태 칩 | 양방향 정상 · 연결 중 · 한쪽만 연결 · 조치 필요 · 비활성. 한쪽만 연결·조치 필요면 칩 아래에 봐야 할 방향(상대 API 연결 확인 · 내 API 연결 확인 · 양방향 확인) |
| 행 작업(⋯ 메뉴) | 연결 · 재시도 · 연결할 엔드포인트 선택 · 재계약 · 검증 · 상세 · 관계 종료 — 연결/재시도/엔드포인트 선택/재계약/관계 종료는 소유자만 |
| 빈 상태 | "아직 관계가 없습니다" + 시작 안내 |
| 하단 | 전체 계약 목록 보기 → 제품 관리 → 계약으로 이동 |
관계 추가 모달(2단계) — 상대 API 연결과 내 API 연결은 관계 하나에서 함께 시작합니다.
| 단계 | 내용 |
|---|---|
| 1/2 상대 기업 | 기업 이름(읽기 전용, 등록 조직 → 비즈니스 파트너 디렉터리 → BPN 순으로 자동 표시) · DSP 주소(선택, 비우면 자동으로 찾음) · DID 로 협상(선택) |
| 2/2 무엇을 할까요 | 상대 API 연결(나 → 상대) · 내 API 연결(상대 → 나) 체크. 내 엔드포인트가 없으면 지금 등록 안내 |
| 완료 | 관계 만들기 → "관계를 만들었습니다." 창은 바로 닫히고, 진행 상황은 목록 행에서 확인합니다 |
| 후보가 여럿일 때 | 행 상태가 선택 필요가 되고, 연결할 엔드포인트 선택 창에서 채널별 후보 중 하나를 골라 이 엔드포인트로 연결 |
관계 상세 페이지 (행 클릭)
| 항목 | 내용 |
|---|---|
| 머리 | 기업 이름 · BPN, 오른쪽에 재계약 · ⋯(⋯ 메뉴: 파트너 정보 수정 · 이 기업 차단 · 관계 종료) |
| 요약 카드 4칸 | 상태(대표 상태를 글자로, 한쪽만 연결·조치 필요면 아래 줄에 봐야 할 방향) · 생성일(아래 줄에 생성 경로: 직접 추가 · 상대 기업이 먼저 연결 · 기존 계약에서 생성 · 시스템) · 마지막 검증(카드 안 검증 버튼) · 상대 기업 EDC 버전(현재 버전 · 이전 버전 가능성 · 미확인, 마우스를 올리면 지원 DSP 버전, 아래 줄에 확인 시각, 카드 안 새로고침 버튼). 이전 버전 가능성이면 "상대 기업 커넥터가 EDC 0.10 이하(Jupiter)로 보입니다…" 안내 |
| 방향 카드 | 상대 API 연결(나 → 상대) / 내 API 연결(상대 → 나) 두 카드가 같은 틀입니다. 오른쪽 위 계약 상세 링크(계약 기록이 없으면 회색 — 마우스를 올리면 아직 연결 전·상대 기업이 아직 계약 안 함·계약 기록 기능 이전 계약 등 이유), 상태(내 API 연결은 옆에 상대 기업이 계약한 내 발행본 태그, 내 최신 발행본이 더 높으면 v1 → v2), 항목 수립일시 · 최근 갱신일시 · 사유 / 계약일시 · 공개 범위(값이 없으면 —). 하단 바 왼쪽 이 방향 사용 스위치(소유자만, 마지막 켜진 방향이면 끌 수 없고 경고 아이콘에 이유), 오른쪽에 그 방향의 조치 하나 — 상대 API 연결은 연결 · 재시도 · 연결할 엔드포인트 선택 · 재계약 중 필요한 것, 내 API 연결은 재계약 안내 복사. 다채널이면 카드는 채널 n/m 집계만 보이고 오른쪽 위 링크가 채널 관리(아래 표로 이동) |
| 채널 관리 (데이터 종류별 연결, 품질 알림 4채널·디지털 트윈 이벤트 2채널) | 행 = 채널(디지털 트윈 이벤트 API는 아래에 공급사 → 고객 같은 방향 한 줄), 열 = 상대 API 연결·내 API 연결. 칸마다 한 줄에 사용 스위치(소유자만) · 상태 · 버전 태그(내 API 연결) · 오른쪽 끝 계약 상세(아직 연결되지 않았으면 그 채널만 연결하는 연결 버튼), 사유는 그 아래 작은 글씨. 꺼진 칸은 사용 안 함만 표시. 켜고 끄면 그 목록만 저장되고, 모두 켜면 앞으로 추가되는 채널까지 자동 포함. 디지털 트윈 이벤트 API는 상대 기업이 트윈 이벤트 단일 자산을 내놓으면 두 채널이 계약 하나를 함께 써서, 내 엔드포인트 자산은 3개·채널은 2개 |
| 이력 | 최근 20건 + 이력 전체 · 계약 목록 창 |
| 작업 | 검증 · 재계약 · 관계 종료 · 재계약 안내 복사 · 파트너 정보 수정(소유자만, 검증은 멤버도 가능) |
| 파트너 정보 수정 창 | DSP 주소(옆 ⓘ 에 비우고 저장할 때 자동으로 찾는 순서: 등록 조직 → 파트너 디렉터리 → EDC Discovery) · DID 로 협상 스위치 · 메모. 이 기업과 맺은 모든 파트너 관계에 적용. DSP 주소를 바꿔 저장하면 상대 기업 EDC 버전을 자동으로 다시 확인 |
| 계약 원문·데이터 주소 | 계약 상세 링크로 이동(기존 계약 상세 화면과 동일) |
API 5종의 역할
| API | 화면 부제 | 쓰이는 곳 |
|---|---|---|
| 디지털 트윈 레지스트리 API | 파트너에게 공개하는 디지털 트윈 레지스트리 엔드포인트 | 파트너가 우리 제품을 탐색으로 찾을 때 |
| PCF 교환 API | 파트너에게 공개하는 제품 탄소발자국 교환 엔드포인트 | 제품에 PCF 붙이기, PCF 교환 |
| 디지털 트윈 이벤트 API | 파트너에게 공개하는 디지털 트윈 이벤트 수신 엔드포인트 | 고객에게 부품 식별 정보 보내기를 받을 때 |
| 품질 알림 API | 파트너에게 공개하는 품질 알림 수신 엔드포인트 | 품질 추적의 알림 수신 |
| CCM 알림 API | 파트너에게 공개하는 기업 인증서 관리 알림 수신 엔드포인트 | 기업 인증서 → 교환 수신 |