> For the complete documentation index, see [llms.txt](https://docs.medcrypt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.medcrypt.com/ko/msi/review-and-correct-device-knowledge/manage-device-versions-and-changes.md).

# 기기 버전 및 변경 사항 관리

MSI의 디바이스에는 하나 이상의 버전이 있습니다. 예를 들어 제출한 릴리스 버전과 현재 개발 중인 버전이 있습니다. 각 버전은 자체 지식을 보유하며, MSI는 모든 변경 사항을 기록합니다. 따라서 어느 시점에서든 문서에 어떤 내용이 있었는지 정확히 확인하고, 두 시점의 내용을 비교하고, 어느 버전에서든 새 버전을 시작할 수 있습니다.

## 시작하기 전에

* 디바이스를 선택합니다. 자세한 내용은 [MSI 탐색 방법](/ko/msi/get-started.md#switch-organization-workspace-or-device).
* 디바이스를 볼 수 있는 사람은 누구나 해당 디바이스의 버전과 기록을 확인할 수 있습니다. 버전을 생성, 편집 또는 분기하려면 조직의 플랜에 Maturity Assessment가 포함되어 있어야 합니다.

## 버전에 포함되는 항목 이해하기

각 버전에는 다음 항목이 포함됩니다.

* 아키텍처 등록부, 다이어그램 및 보안 등록부
* 기술 자료 및 요구 사항
* 첨부 문서
* 설정: **수명 주기** (**연구개발**, **시판 전**, **시판 후** 또는 **수명 종료**), **규정 준수 목표** (규제 경로), **디바이스 변경 상태** 및 **위험 공식**

페이지 헤더에서 디바이스 옆에 있는 버전 선택기로 작업할 버전을 지정합니다. 디바이스 페이지에서 확인하거나 생성하는 위협 모델 또는 감사와 같은 항목은 모두 선택한 버전에 해당합니다. 디바이스에는 기본 버전이 하나 있으며, 디바이스 전체 요약에는 이 버전이 사용됩니다.

## Versions 탭 열기

1. 사이드바에서 **Device Knowledge**.
2. 그룹에서 **Versions** 을 선택한 다음 **Versions** 탭을 선택합니다.

표에는 각 버전과 해당 버전의 다음 정보가 표시됩니다. **수명 주기**, **규정 준수 목표**, **변경 상태**, **위험 공식** 그리고 해당 버전이 분기된 **버전**이 표시됩니다. 기본 버전에는 **default**.

버전 행에서 다음 작업을 수행할 수 있습니다.

* **열기** 를 선택하여 현재 보고 있는 버전으로 설정합니다.
* **편집** 을 선택하여 레이블과 설정을 변경한 다음 **저장**.
* **기본값으로 설정** 을 선택하여 해당 버전을 디바이스의 기본 버전으로 지정합니다.
* 버전의 수명 주기 상태를 **수명 주기** 배지에서 바로 변경합니다.

**변경 기록** 탭 하단의 변경 기록에는 선택한 버전의 설정 변경 사항과 각 변경을 수행한 사람 및 시각이 표시됩니다.

## 새 버전 만들기

새 릴리스 작업을 시작할 때 새 버전을 분기하세요. 새 버전은 소스 버전의 지식을 복사한 상태로 시작한 다음, 독립적으로 변경됩니다. 소스 버전에는 영향을 주지 않습니다.

1. 에서 **Versions** 탭에서 **Branch new version** 를 선택해 현재 보고 있는 버전에서 분기하거나, **Branch** 를 아무 행에서나 선택합니다.
2. 다음을 입력합니다: **New version label**. 이 값은 해당 장치에서 고유해야 합니다.
3. 다음 항목을 선택합니다: **Lifecycle state**.
4. 선택적으로 다음을 추가합니다: **Notes**. 이 내용은 감사 로그에 기록됩니다.
5. 다음 항목을 확인합니다: **Compliance Goal**, **Device Modification Status** 및 **Risk Formula**.
6. 를 선택하고 **Create branch**.

를 선택합니다. MSI에서 새 버전이 열립니다. 해당 버전의 지식이 구축되는 동안 버전 선택기에 **Building…**.

## 시간 경과에 따른 변경 사항 추적

의 **Change tracking** 탭에는 여러 버전에 걸쳐 장치 지식에 기록된 모든 변경 사항이 최신순으로 표시됩니다. 변경 사항은 문서 읽기, 아키텍처 실행, 분석, 사용자 편집을 통해 발생합니다.

1. 다음 항목을 선택합니다: **Versions** 그룹에서 **Change tracking** 탭을 선택합니다.
2. 를 선택하면 **Graph** 에서 버전을 분기 형태로 볼 수 있고, **Table** 을 선택하면 각 변경 사항과 함께 다음 정보를 볼 수 있습니다: **Version**, 변경한 사람(**By**), **When** 및 **What changed**.
3. 이름이 지정된 주요 시점으로 이동하려면 **Go to a tag…**.
4. 필요한 시점보다 목록이 먼저 끝나면 **Load older changes**.

를 선택합니다. 새 변경 사항은 적용된 후 잠시 지나면 표시됩니다. 버전 기록은 첫 스냅샷부터 시작됩니다.

## 특정 시점의 기기 보기

1. 에서 **변경 추적** 탭에서 변경 항목을 선택합니다.
2. 배너에 다음이 표시됩니다. **보기 중인 *****버전***** 기준 시점: *****날짜 및 시간***** — 읽기 전용**. 다음 항목 간에 전환합니다. **아키텍처**, **기술 자료**, **엔터티 및 주장**, **문서**, **기기 기록** 및 **변경 사항**.
3. 선택 **기록으로 돌아가기** 를 선택해 목록으로 돌아가거나, **현재 버전으로 돌아가기** 를 선택해 최신 버전으로 돌아갑니다.

단일 아키텍처 요소의 기록을 보려면 **아키텍처** 탭에서 요소를 열고 **기록 보기**.

## 두 시점 비교

1. 에서 **변경 추적** 탭에서 두 변경 항목을 선택하고 **비교** 를 선택합니다.
2. 선택 **비교** 표시되는 도구 모음에서 선택합니다.

비교 결과에 지식 유형별로 추가, 삭제 및 변경된 항목의 **요약** 이 표시됩니다. 시점 간격이 크면 비교하는 데 몇 초가 걸릴 수 있습니다. 한 시점과 그 직전 변경 사항을 비교하려면 해당 시점을 열고 **상위 항목과 비교**.

## 마일스톤 태그 지정

FDA에 제출한 시점이나 나중에 다시 확인해야 할 다른 마일스톤에 태그를 지정합니다.

1. 시점을 엽니다. 다음 탭에서 **변경 추적** 탭.
2. 선택 **이 커밋에 태그 지정**.
3. 다음을 입력합니다. **태그 이름** (예: "FDA 제출 2026-10-01") 및 선택적으로 다음을 입력합니다. **참고** 예: 제출 번호입니다.
4. 선택 **태그 추가**.

{% hint style="warning" %}
태그는 영구적으로 유지됩니다. 이름을 변경하거나 이동하거나 삭제할 수 없습니다. 태그가 잘못된 경우 다른 태그를 추가하세요.
{% endhint %}

## 기록의 특정 시점에서 버전 만들기

이 기능을 사용하면 태그가 지정된 제출물 등 과거 특정 시점에 문서에 기재된 내용 그대로 새 버전을 시작할 수 있습니다. MSI는 기존 버전을 되돌리지 않습니다.

1. 시점을 엽니다. 다음 탭에서 **변경 추적** 탭.
2. 선택 **이 시점에서 새 버전 만들기**.
3. 다음을 입력하세요: **새 버전 라벨** 그리고 선택적으로 **참고**.
4. 선택 **버전 만들기**.

새 버전은 해당 시점의 등록부, 다이어그램, 지식 기반 및 문서로 시작합니다. 기존 버전은 모두 그대로 유지됩니다.

## 다음 단계

* [기기 지식 검토 및 수정](/ko/msi/review-and-correct-device-knowledge.md): 방금 만든 버전에서 작업합니다.
* [AI 주장 추적하기](/ko/msi/review-and-correct-device-knowledge/trace-an-ai-claim-to-its-source.md): 각 요소의 출처를 확인합니다.
* [규제 감사 실행](/ko/msi/check-estar-readiness/run-a-regulatory-audit.md): 특정 버전을 감사합니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.medcrypt.com/ko/msi/review-and-correct-device-knowledge/manage-device-versions-and-changes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.