> For the complete documentation index, see [llms.txt](https://kopens.gitbook.io/plantpulse-platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kopens.gitbook.io/plantpulse-platform/user/uns.md).

# UNS

## 목차

* [개요](#overview)
* [화면 구성](#layout)
* [네임스페이스 트리](#namespace-tree)
* [토픽 미리보기](#topic-preview)
* [토픽 설정](#topic-config)
* [AI Topic 설명](#ai-topic)
* [운영 활용](#use-cases)
* [자주 묻는 질문](#faq)
* [관련 화면](#related)

***

## 개요 <a href="#overview" id="overview"></a>

UNS 화면은 **Unified Namespace 계층과 DDS 토픽 라우팅 미리보기**를 제공합니다. 좌측 메뉴에서는 **Standard > UNS** 로 표시되며 내부 URL 은 `/uns/tree` 입니다.

이 화면은 사이트 / 에어리어 / 라인 / 설비 / 태그 계층을 기준으로 Kafka, MQTT, SparkplugB 토픽 경로가 어떻게 만들어지는지 확인할 때 사용합니다.

***

## 화면 구성 <a href="#layout" id="layout"></a>

```
┌──────────────────────────────────────────────────────────────┐
│ UNS                                  [새로고침]              │
│ Unified Namespace 계층과 DDS 토픽 라우팅 미리보기             │
├──────────────────────┬───────────────────────────────────────┤
│ 네임스페이스 트리     │ 토픽 미리보기                         │
│ [사이트 ▼]           │ 선택 노드 / 라우트 미리보기 / 관련 링크 │
│ [네임스페이스 검색]   │ Kafka / MQTT / SparkplugB 토픽          │
│ 트리 노드             ├───────────────────────────────────────┤
│                      │ 토픽 설정                              │
│                      │ Kafka / MQTT / SparkplugB 템플릿        │
└──────────────────────┴───────────────────────────────────────┘
```

| 영역            | 역할                                           |
| ------------- | -------------------------------------------- |
| **상단 헤더**     | 화면 제목, 설명, 새로고침 버튼                           |
| **네임스페이스 트리** | 사이트 선택, 키워드 검색, 계층 노드 선택                     |
| **토픽 미리보기**   | 선택한 노드의 라우트, 관련 링크, Kafka/MQTT/SparkplugB 토픽 |
| **토픽 설정**     | `mq.properties` 기준 DDS 토픽 템플릿 읽기 전용 조회       |

***

## 네임스페이스 트리 <a href="#namespace-tree" id="namespace-tree"></a>

좌측 패널은 사이트별 네임스페이스를 탐색하는 영역입니다.

| 컨트롤           | 설명                                 |
| ------------- | ---------------------------------- |
| **사이트 셀렉터**   | 사이트를 선택합니다. 사이트명과 설명이 함께 표시됩니다.    |
| **네임스페이스 검색** | 트리 노드를 키워드로 필터링합니다.                |
| **트리 노드**     | 사이트 / 구역 / 라인 / 설비 / 태그 계층을 표시합니다. |
| **새로고침**      | 현재 사이트 기준으로 트리와 설정을 다시 불러옵니다.      |

노드를 선택하면 우측 토픽 미리보기 패널이 열립니다. 아직 노드를 선택하지 않았을 때는 "네임스페이스 노드를 선택하면 토픽 경로를 미리 볼 수 있습니다." 안내가 표시됩니다.

***

## 토픽 미리보기 <a href="#topic-preview" id="topic-preview"></a>

선택한 노드의 타입, ID, 경로, 관련 링크, 토픽 경로를 확인합니다.

| 영역             | 표시                           |
| -------------- | ---------------------------- |
| **선택 노드 헤더**   | 노드 타입, 노드 ID, 선택 경로          |
| **라우트 미리보기**   | 사이트 → 구역 → 라인 → 설비 → 태그 경로   |
| **관련 링크**      | 태그 상세, 에셋 트리, 설비, 토픽 라우트, 경로 |
| **Kafka**      | 선택 노드 기준 Kafka 토픽            |
| **MQTT**       | 선택 노드 기준 MQTT 토픽             |
| **SparkplugB** | 선택 노드 기준 SparkplugB 토픽       |

토픽 항목에는 복사 동작이 제공됩니다. 외부 시스템 설정이나 플로우 노드 설정에 토픽을 붙여 넣을 때 사용하세요.

***

## 토픽 설정 <a href="#topic-config" id="topic-config"></a>

하단 토픽 설정 패널은 `mq.properties` 에 정의된 DDS 토픽 템플릿을 읽기 전용으로 보여 줍니다.

| 설정 영역          | 설명                  |
| -------------- | ------------------- |
| **Kafka**      | Kafka 토픽 템플릿과 사용 여부 |
| **MQTT**       | MQTT 토픽 템플릿과 사용 여부  |
| **SparkplugB** | SparkplugB 관련 토픽 설정 |

이 패널은 설정값을 직접 수정하는 화면이 아닙니다. 설정 변경이 필요하면 운영 설정 절차에 따라 서버 설정 파일과 배포 환경을 수정해야 합니다.

***

## AI Topic 설명 <a href="#ai-topic" id="ai-topic"></a>

서버 설정에서 AI Topic 설명이 활성화되어 있으면 선택 노드 헤더에 **Topic 설명** 버튼이 표시됩니다.

| 영역         | 설명                         |
| ---------- | -------------------------- |
| **라우팅 설명** | 선택 노드가 어떤 토픽 경로로 라우팅되는지 요약 |
| **설정 누락**  | 토픽 생성에 필요한 누락 정보           |
| **근거**     | 설명에 사용된 노드·설정 근거           |
| **다음 확인**  | 운영자가 이어서 확인할 항목            |

비활성화되어 있으면 버튼과 설명 패널이 표시되지 않습니다.

***

## 운영 활용 <a href="#use-cases" id="use-cases"></a>

| 상황                 | 확인할 것                                                                                                           |
| ------------------ | --------------------------------------------------------------------------------------------------------------- |
| 외부 시스템에 토픽을 전달해야 함 | 노드를 선택하고 Kafka/MQTT 토픽을 복사합니다.                                                                                  |
| 토픽 경로가 기대와 다름      | 라우트 미리보기에서 사이트·구역·라인·설비·태그 계층을 확인합니다.                                                                           |
| 특정 설비나 태그의 모델이 틀림  | 관련 링크로 [에셋 트리](/plantpulse-platform/user/factory.md) 또는 [태그](/plantpulse-platform/user/factory.md#tag) 화면을 엽니다. |
| 플로우와 메시징을 연결함      | 토픽을 복사해 [플로우](/plantpulse-platform/user/flow.md) 의 외부 입력·DDS 발행 노드 설정에 사용합니다.                                   |
| 설정 템플릿 확인          | 토픽 설정 패널에서 Kafka/MQTT/SparkplugB 템플릿을 확인합니다.                                                                    |

***

## 자주 묻는 질문 <a href="#faq" id="faq"></a>

**Q. 트리에 아무것도 보이지 않습니다.**

A. 선택한 사이트에 에어리어·라인·설비·태그 모델이 등록되어 있는지 [팩토리 모델](/plantpulse-platform/user/factory.md) 에서 확인하세요.

**Q. 토픽이 표시되지 않습니다.**

A. 해당 노드 타입에 대한 토픽 템플릿이 없거나 메시징 설정이 비활성화되어 있을 수 있습니다. 하단 토픽 설정 패널을 확인하세요.

**Q. AI Topic 설명 버튼이 없습니다.**

A. 서버 설정에서 AI Topic 설명 기능이 비활성화된 상태입니다. 기능 활성화 여부는 시스템 관리자에게 문의하세요.

**Q. 토픽 경로를 수정할 수 있나요?**

A. 이 화면은 미리보기와 복사용입니다. 토픽 규칙 변경은 서버 설정과 배포 절차를 통해 처리해야 합니다.

***

## 관련 화면 <a href="#related" id="related"></a>

* [콘솔 탐색과 공통 화면](/plantpulse-platform/user/navigation.md) — Standard 메뉴 구조
* [팩토리 모델](/plantpulse-platform/user/factory.md) — 사이트·에셋·태그 계층 관리
* [데이터 포인트](/plantpulse-platform/user/data-point.md) — 태그 데이터 조회
* [플로우](/plantpulse-platform/user/flow.md) — 토픽 기반 자동화 구성
* [표준 및 외부 도구](/plantpulse-platform/user/tools.md) — OPC-UA, AAS V3, 고급 모니터링