> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 조립 지침

> ERP에서 제조 부품의 CAD 모델로 애니메이션이 있는 단계별 3D 가이드를 만들어 게시하고, 작업자가 현장에서 이를 따르게 합니다.

조립 지침은 제조 부품의 CAD 모델을 순서가 있는 3D 조립 가이드로 바꿉니다. 각 단계는 설치할 구성품의 이름을 밝히고 이들이 제자리로 이동하는 모습을 보여 줍니다. 작성자는 ERP에서 만들고, 작업자는 현장의 [가이드 조립 보기](https://docs.alforse.com/ko/docs/reference/mes.md#the-guided-assembly-view)에서 따라 합니다.

## 작동 방식

지침은 사내 제조 부품 하나에 속하며 그 부품의 STEP 모델로 만듭니다. 버전이 관리됩니다. **초안**을 편집하고 게시하면 **조립** 유형의 작업 공정작업이 게시된 버전을 재생합니다. 작업은 단계의 자체 사본을 보유하므로, 버전이 활성화되거나 누군가 동기화할 때만 변경됩니다.

Alforse screenshot**조립 지침 편집기: 왼쪽의 단계 목록, 가운데의 3D 모델, 오른쪽의 선택한 단계의 상세 정보 탭(구성품 및 재생 상자)**

세 개의 창: 단계 목록, 3D 모델, 선택한 단계의 설정.

## 지침 만들기

### 부품에 모델이 있는지 확인

부품은 사내에서 제조하는 것이어야 하며 **모델** 탭에 STEP 파일이 있어야 합니다. 없으면 Alforse가 3D 보기를 만들 수 없습니다.

### 지침 시작

**생산 → 조립품**으로 이동하여 **새 조립 지시사항**을 선택하고 **품목**을 선택합니다.

### Alforse가 준비하도록 두기

필요하면 Alforse가 3D 보기를 위해 모델을 변환하고, 편집기를 열고, 초안 단계 생성을 시작합니다.

## 버전과 상태

<details>
  <summary>**초안**</summary>

  편집할 수 있습니다. 모든 새 지침과 새 버전은 이 상태에서 시작합니다.
</details>

<details open>
  <summary>**게시됨**</summary>

  사용 중입니다. 이 지침을 사용하는 작업 공정작업이 따르는 버전입니다.
</details>

<details>
  <summary>**보관됨**</summary>

  더 새로운 활성 버전으로 대체되었으며 참고용 읽기 전용으로 보관됩니다.
</details>

모든 버전은 완전하고 독립적인 사본입니다. 두 가지 작업으로 버전 간에 이동합니다.

| 작업 | 사용 가능한 대상 | 효과 |
| - | - | - |
| **새 버전** | 게시된 지침 | 현재 단계로 시작하는 편집 가능한 초안을 만듭니다. |
| **활성으로 설정** | 초안 | 게시하고 이전에 활성이던 버전을 보관합니다. |

HEADS UP

**버전을 활성으로 설정하면 이미 진행 중인 작업도 갱신됩니다.**

이 지침의 다른 버전을 사용하는 모든 작업 공정작업이 새 버전으로 이동하고 단계가 동기화됩니다. 단, 공정작업이 완료되었거나 취소되었거나 작업이 잠긴 경우는 제외됩니다. 완료된 작업의 공정작업은 만들어질 때의 단계를 유지하므로 기록이 정확하게 남습니다.

## 단계 만들기

### 단계 생성 또는 추가

새 지침은 단계를 만들기 전까지 단계가 없습니다.

* **단계 생성**은 모션 플래너를 실행하여 조립 순서와 모든 부품의 충돌 없는 경로를 계산합니다. 보통 1\~3분 걸립니다.
* **단계 수동 추가**는 빈 단계 하나를 만듭니다.

단계가 생기면 **단계 추가**로 다른 단계를 추가하며, 행의 핸들을 드래그하여 순서를 바꿉니다.

**단계 추가** 옆의 플래너 메뉴에는 두 가지 옵션이 더 있습니다.

| 옵션 | 효과 |
| - | - |
| **모션 계획 실행** | 현재 단계 순서를 유지한 채 모션 경로를 다시 계산합니다. |
| **단계 다시 생성** | 모든 단계를 새 계획으로 대체합니다. |

직접 추가한 단계나 **완료**로 표시된 단계가 하나라도 있으면 다시 생성이 차단되어, 확인했거나 직접 작성한 작업이 버려지지 않습니다.

### 단계 상태

단계 행 끝의 아이콘을 클릭하여 상태를 변경합니다.

<details>
  <summary>**할 일**</summary>

  직접 추가했고 아직 확인하지 않았습니다.
</details>

<details>
  <summary>**검토**</summary>

  모션 플래너가 만들었으며 작성자가 텍스트와 애니메이션을 확인하기를 기다립니다.
</details>

<details open>
  <summary>**완료**</summary>

  작성자가 확인했습니다.
</details>

### 플래너 경고

단계 목록의 아이콘은 계획 문제를 알려 줍니다.

| 아이콘 | 의미 |
| - | - |
| 경고 삼각형 | 플래너가 충돌 없는 경로를 찾지 못했습니다. 부품은 이동하는 대신 최종 위치로 페이드 인합니다. |
| 손 | 배치된 부품이 넘어질 수 있으며 고정구나 두 번째 사람이 필요할 수 있습니다. |

## 단계 상세 정보

**상세 정보** 탭에는 작업자가 단계에서 읽고 기록하는 내용이 있습니다.

FieldType

<details>
  <summary>**유형**</summary>

  단계가 요구하는 입력의 종류입니다. **작업**은 단순한 지시이며, 나머지는 값, 최소·최대와 비교하는 측정값, 체크박스, 목록에서 선택, 타임스탬프, 사람, 파일, 검사 결과를 받습니다.
</details>

<details>
  <summary>**제목**</summary>

  선택 사항입니다. 비어 있으면 Alforse가 구성품의 이름으로 단계 이름을 정합니다. 예: "Add Bearing (×2)".
</details>

<details>
  <summary>**지시사항**</summary>

  작업자에게 보이는 텍스트입니다. `@`를 입력하면 품목의 자재 명세서에서 부품을 참조할 수 있습니다.
</details>

<details>
  <summary>**필수**</summary>

  켜면 작업자가 이 단계를 기록하기 전에는 공정작업을 완료할 수 없습니다.
</details>

NOTE

**저장 방식은 두 가지입니다**

이 네 필드는 패널 하단의 **저장**을 선택하거나 ⌘/Ctrl+Enter를 누를 때만 저장됩니다. 단계의 나머지 모든 항목(구성품, 숨긴 부품, 재생 설정, 상태, 자재, 공구, 슬라이드)은 변경하는 즉시 저장됩니다.

## 구성품과 숨긴 부품

**구성품**은 단계가 설치하는 부품을 나열합니다.

### 부품 선택

**추가**를 선택한 다음 3D 보기에서 부품을 클릭합니다. Shift-클릭으로 여러 개를 한 번에 추가할 수 있습니다.

### 확인

**추가 완료**를 선택합니다. 나중에 부품을 빼려면 행의 ✕를 사용합니다.

### 방해되는 부품 숨기기

부품이 작업을 가로막으면 **구성품** 탭에서 해당 행의 눈 아이콘을 클릭합니다. 부품은 선택한 단계에서만 사라지고 다른 단계에서는 사라지지 않습니다. 숨긴 부품은 **이 단계에서 숨김** 목록에 모이며 여기서 복원할 수 있습니다.

두 가지 규칙이 적용됩니다. 단계 자신의 구성품은 그 단계에서 숨길 수 없고, 작업자는 사용자가 숨긴 대로 정확히 봅니다.

## 재생 설정

**재생** 상자는 단계가 애니메이션되는 방식을 제어합니다.

### 모션

| 상태 | 의미 |
| - | - |
| "자동" | 플래너가 찾은 경로를 사용합니다. |
| "사용자 지정 경로" | 사용자가 경로를 그렸습니다. **초기화**는 플래너의 경로를 복원합니다. 그린 경로는 "경로 없음"도 대체합니다. |
| "경로 없음" | 플래너가 경로를 찾지 못했습니다. 헤더 메모에 마우스를 올리면 어느 부품이 막고 있는지 볼 수 있습니다. |

**경로 편집**은 3D 보기에서 경로를 빨간 웨이포인트로 표시하며, 선택한 웨이포인트 자세에 부품의 투시 사본을 보여 줍니다.

* 웨이포인트를 드래그하면 경로의 모양을 바꿉니다.
* 경로를 더블클릭하면 웨이포인트를 추가합니다.
* Delete를 누르면 선택한 웨이포인트를 제거합니다.

부품은 이동 중에 회전할 수도 있습니다. 뷰어의 **이동 / 회전** 컨트롤을 **회전**으로 설정하면 선택한 웨이포인트 주위에 링이 나타납니다. 링을 드래그하면 해당 지점에서 부품이 15° 단위로 회전하며, 부품을 뒤집어서 들어오게 하는 방법입니다. 웨이포인트의 위치를 바꾸려면 **이동**으로 돌아갑니다.

### 카메라

| 상태 | 의미 |
| - | - |
| "자동" | Alforse가 단계의 부품을 직접 화면에 맞춥니다. 똑바로 세운 조립에서 생성된 단계는 플래너가 선택한 각도에서 봅니다. |
| "저장된 보기" | 현재 각도를 저장하는 **현재 보기 사용**으로 설정합니다. **지우기**(이 상태에서만 표시)는 자동으로 되돌립니다. |

### 방향

방향은 한 단계 동안 조립 전체를 돌립니다. 예를 들어 아랫면에 부품을 넣을 수 있도록 뒤집습니다.

| 버튼 | 회전 |
| - | - |
| **뒤집기** | 반 바퀴, 위아래가 바뀝니다. |
| **앞으로 기울이기** / **뒤로 기울이기** | 옆으로 눕히는 4분의 1 바퀴입니다. |
| **왼쪽으로 돌리기** / **오른쪽으로 돌리기** | 작업대 위에서 4분의 1 바퀴입니다. |

회전은 현재 보는 각도를 기준으로 하며, 조립이 회전하는 동안 카메라는 움직이지 않습니다. 이후 행에는 위치가 "똑바로", "거꾸로", "옆으로"로 보고됩니다.

방향이 이어지는 규칙은 다음과 같습니다.

* **이후 단계가 상속합니다.** 같은 조립의 다음 단계들은 방향을 유지하며, 다른 단계가 돌릴 때까지 예를 들어 "거꾸로, 11단계부터"로 표시됩니다. 재생에서는 해당 단계의 부품이 들어가기 전에 조립이 뒤집힙니다.
* **회전이 보기를 저장할 수 있습니다.** 단계에 저장된 보기가 없는데 회전으로 조립이 돌아간 상태라면, 보고 있는 시점도 함께 저장되어 카메라 행이 "저장된 보기"로 표시되고 재생에서 그 각도로 단계를 보여 줍니다. 조립을 다시 돌려도 그 보기는 유지됩니다. 카메라 행의 **지우기**를 누르면 자동으로 돌아갑니다.
* **하위 조립품은 별개입니다.** 하위 조립품은 똑바로 시작하며 자체 방향을 유지합니다.
* **초기화**는 단계에 이전 단계의 방향을 부여합니다.

### 하위 조립품 경로

하위 조립품을 끼우는 단계에는 하위 조립품마다 행이 하나씩 생깁니다. "자동"으로 두면 완성된 유닛이 조립의 측면에서 미끄러져 들어옵니다. **경로 편집**을 사용하면 부품에 쓰는 것과 같은 웨이포인트 및 회전 링 도구로 유닛의 경로를 그릴 수 있으며, **초기화**는 자동으로 되돌립니다.

## 하위 조립품

실제 조립에서는 유닛을 따로 조립해 통째로 설치하는 경우가 많습니다. 예를 들어 허브에 베어링, 서클립, 브레이크 디스크를 작업대에서 장착한 다음에야 트레일링 암에 장착합니다. 하위 조립품은 이를 따로 조립한 뒤 주 조립에 합류하는 이름 있는 단계 그룹으로 모델링합니다.

### 만들기와 구성

| 작업 | 위치 | 효과 |
| - | - | - |
| **하위 조립품 만들기** | 단계의 메뉴 | 해당 단계를 첫 단계로 하는 하위 조립품을 만듭니다. |
| 단계를 하위 조립품으로 드래그하거나 **이동** | 단계의 메뉴 | 단계를 하위 조립품에 추가합니다. |
| **하위 조립품에서 이동**(Move Out of Sub-Assembly) | 단계의 메뉴 | 단계를 주 목록으로 되돌립니다. |
| **그룹 해제** | 하위 조립품 | 그룹을 제거하고 단계는 주 목록에 유지합니다. |
| **하위 조립품 삭제** | 하위 조립품 | 그룹을 단계와 함께 제거합니다. |

구성원 단계는 그룹 아래에 번호가 매겨집니다. 하위 조립품 4에는 4.1, 4.2 등이 포함됩니다.

하위 조립품을 더블클릭하거나 **하위 조립품 열기**를 선택하면 격리됩니다. 단계 목록과 3D 보기가 해당 단계와 부품으로 제한되고 **단계 추가**는 그 안에 단계를 만듭니다. 전체 지침을 다시 보려면 **모든 단계**를 선택합니다.

### 들어가는 위치

하위 조립품을 선택하면 이름, 단계, **들어가는 위치**(Where it goes) 섹션이 표시됩니다.

FieldType

<details>
  <summary>**사용 단계**</summary>

  완성된 유닛을 설치하는 이후 단계입니다. 기본값인 \*\*주 조립(마지막 단계 이후)\*\*은 이를 설치하는 단계가 없으며 자체 단계 직후 조립에 합류한다는 뜻입니다.
</details>

<details>
  <summary>**지시사항**</summary>

  기본값일 때만 표시됩니다. 유닛이 주 조립에 합류할 때 작업자가 읽는 텍스트입니다.
</details>

<details>
  <summary>**하위 조립품 경로**</summary>

  기본값일 때만 표시됩니다. **경로 편집**으로 그리는, 유닛이 주 조립으로 들어가는 경로입니다.
</details>

<details>
  <summary>**카메라**</summary>

  기본값일 때만 표시됩니다. 그 순간의 보는 각도이며 **현재 보기 사용**으로 저장합니다.
</details>

이를 끼우는 단계에서 연결할 수도 있습니다. 단계의 **하위 조립품 사용**(Use Sub-Assembly)에서 완성된 하위 조립품을 선택하면 해당 단계 행에 예를 들어 **4 사용**이 표시됩니다.

### 재생 방식

재생은 먼저 하위 조립품 자체의 단계를 순서대로 실행합니다. 이를 사용하는 단계에서는 완성된 유닛이 그려진 경로가 있으면 그 경로를 따라, 없으면 측면에서 미끄러져 들어옵니다.

* 자체 경로가 있는 유닛은 단계의 다른 부품이 움직이기 전에 도착합니다.
* 한 단계가 여러 유닛을 끼우면 유닛이 차례로 도착합니다.
* 하위 조립품을 선택한 상태에서 재생을 누르면 첫 단계부터 조립합니다.

NOTE

**중첩은 한 단계까지만 가능합니다.**

하위 조립품은 중첩되지 않습니다. 한 유닛을 다른 유닛에 넣으려면 다른 유닛의 단계에서 끼우십시오. 끼우는 단계는 하위 조립품보다 뒤에 있어야 하며 그 구성원이 아니어야 합니다.

## 자재, 공구, 슬라이드

| 탭 또는 작업 | 용도 |
| - | - |
| **BOM** 탭 | 단계를 품목의 자재 명세서에서 소비하는 부품과 필요한 공구에 연결합니다. |
| **BOM 매칭**(**구성품**에서) | 3D 구성품을 자재 명세서 품목과 맞추고 각 단계의 자재를 채웁니다. |
| **슬라이드** 탭 | 이 단계에서 작업자가 보는 사진, PDF, 추가 3D 모델을 추가합니다. |

## 작업과 현장에서

품목의 공정 목록에서 **조립** [공정작업](https://docs.alforse.com/ko/docs/reference/jobs.md#operation-type)에 지침을 첨부합니다. 새 작업은 생성될 때 지침 단계의 사본을 가져갑니다.

작업은 이후 편집 내용을 자동으로 반영하지 않습니다. 작업 공정작업에서 **조립 단계 동기화**를 실행하여 가져오십시오. 지침에서 파생된 단계는 일치하도록 갱신되거나 삭제되며, 작업에서 직접 추가한 단계는 유지됩니다.

작업자는 결과를 [가이드 조립 보기](https://docs.alforse.com/ko/docs/reference/mes.md#the-guided-assembly-view)에서 동일한 단계, 숨긴 부품, 하위 조립품과 함께 봅니다. 하위 조립품은 그룹이 아니라 구성원 단계를 각각 기록합니다. 지침 단계는 공정작업에 이미 있던 단계 뒤에 배치됩니다.

## 권한

지침을 편집하려면 두 가지가 동시에 필요합니다. 버전이 **초안**이어야 하고, 생산 모듈의 **update** 권한이 있어야 합니다. 이 권한이 없으면 초안이더라도 편집기가 읽기 전용으로 열립니다. [권한 및 액세스](https://docs.alforse.com/ko/docs/reference/permissions.md)를 참조하십시오.

## 문제 해결

각 항목에는 메시지나 증상, 나타나는 이유, 해야 할 일이 있습니다.

### "The selected item has no 3D model. Upload a STEP file on the item's Model tab first."(선택한 품목에 3D 모델이 없습니다. 먼저 품목의 모델 탭에서 STEP 파일을 업로드하십시오.)

* **원인:** **새 조립 지시사항**에서 선택한 부품에 STEP 파일이 없습니다.
* **해결 방법:** 품목의 **모델** 탭에 파일을 업로드한 다음 지침을 다시 시작하십시오.

### "Only draft instructions can be edited"(초안 지침만 편집할 수 있습니다)

* **원인:** 게시됨 또는 보관됨 버전을 변경하고 있으며, 이 버전은 고정되어 있습니다.
* **해결 방법:** 게시된 버전에서 **새 버전**을 선택하고 새 초안에서 변경하십시오.

### 초안인데 편집기가 읽기 전용입니다

* **원인:** 계정에 생산 **update** 권한이 없습니다.
* **해결 방법:** 관리자에게 권한 부여를 요청하십시오.

### "Steps already exist — delete them before generating from the plan"(단계가 이미 있습니다. 계획에서 생성하기 전에 삭제하십시오)

* **원인:** **단계 생성**은 아직 단계가 없는 지침에 대해서만 계획을 만듭니다.
* **해결 방법:** 기존 단계를 먼저 삭제하거나 플래너 메뉴의 **단계 다시 생성**을 사용하십시오.

### "Some steps are locked — cannot regenerate"(일부 단계가 잠겨 있어 다시 생성할 수 없습니다)

* **원인:** 하나 이상의 단계가 직접 작성되었거나 **완료**로 표시되어 있습니다. 다시 생성하면 그 작업이 버려집니다.
* **해결 방법:** 단계를 유지하고 **모션 계획 실행**을 선택하십시오. 단계 순서를 건드리지 않고 경로를 새로 고칩니다.

### "The geometry service is offline — motion planning is unavailable right now." / "The geometry service is unavailable — motion planning can't run right now."(지오메트리 서비스가 오프라인입니다. 지금은 모션 계획을 사용할 수 없습니다. / 지오메트리 서비스를 사용할 수 없습니다. 지금은 모션 계획을 실행할 수 없습니다.)

* **원인:** 모션 플래너에 연결할 수 없어 **단계 생성**이 비활성화됩니다.
* **해결 방법:** 서비스가 복구된 후 다시 시도하십시오. 그동안에도 단계를 직접 추가할 수 있습니다.

### "Motion planning is already running"(모션 계획이 이미 실행 중입니다)

* **원인:** 이 지침의 계획 실행이 아직 끝나지 않았습니다.
* **해결 방법:** 끝날 때까지 기다리십시오. 실행은 보통 1\~3분 걸립니다.

### "This instruction has no processed model" / "The model must finish converting before planning"(이 지침에는 처리된 모델이 없습니다 / 계획하기 전에 모델 변환이 완료되어야 합니다)

* **원인:** CAD 모델이 3D 보기를 위한 변환을 아직 마치지 않았습니다.
* **해결 방법:** 변환이 완료되도록 기다린 다음 계획을 시작하십시오.

### "This step is already a sub-assembly" / "This step is already in a sub-assembly"(이 단계는 이미 하위 조립품입니다 / 이 단계는 이미 하위 조립품 안에 있습니다)

* **원인:** 이미 하위 조립품이거나 이미 하나에 속한 단계에 **하위 조립품 만들기**를 사용했습니다.
* **해결 방법:** 주 목록의 단계를 선택하거나 먼저 **하위 조립품에서 이동**으로 꺼내십시오.

### "A sub-assembly can't be inside another sub-assembly"(하위 조립품은 다른 하위 조립품 안에 둘 수 없습니다)

* **원인:** 중첩은 한 단계로 제한됩니다.
* **해결 방법:** 안쪽 그룹을 분리해 두고 바깥 그룹의 단계에서 **하위 조립품 사용**으로 끼우십시오.

### "A sub-assembly can only be used after it is built" / "A sub-assembly can't be used by one of its own steps"(하위 조립품은 조립된 후에만 사용할 수 있습니다 / 하위 조립품은 자신의 단계에서 사용할 수 없습니다)

* **원인:** 유닛을 끼우도록 선택한 단계가 하위 조립품보다 앞에 있거나 그 구성원입니다.
* **해결 방법:** 하위 조립품 밖에 있는 더 뒤의 단계를 선택하십시오.

### "A sub-assembly's steps must come directly before it"(하위 조립품의 단계는 그 바로 앞에 있어야 합니다)

* **원인:** 하위 조립품의 단계는 목록에서 헤더 바로 위에 있어야 하는데 이 변경이 그것을 깨뜨립니다.
* **해결 방법:** 그룹을 함께 유지하십시오. 구성원 변경은 **이동** 또는 **하위 조립품에서 이동**으로 하십시오.

### "This job is locked — steps can't be synced to it"(이 작업은 잠겨 있어 단계를 동기화할 수 없습니다)

* **원인:** **조립 단계 동기화**는 잠긴 작업을 절대 변경하지 않습니다.
* **해결 방법:** 필요 없습니다. 작업은 만들어질 때의 단계를 유지합니다.

### "Failed to make assembly instruction active"(조립 지침을 활성으로 설정하지 못했습니다)

* **원인:** 초안 게시가 서버에서 완료되지 않았습니다.
* **해결 방법:** **활성으로 설정**을 다시 시도하십시오.

## 관련 문서

**MES 앱**

작업자가 빌드, 포커스, 전체 표시 모드를 포함하여 지침을 따르는 곳입니다.

[Open](https://docs.alforse.com/ko/docs/reference/mes.md#the-guided-assembly-view)

**작업**

조립 공정작업이 단계의 사본을 가지는 작업 지시입니다.

[Open](https://docs.alforse.com/ko/docs/reference/jobs.md)

**제조방법 및 조달**

각 단계의 자재를 선택하는 대상인 자재 명세서입니다.

[Open](https://docs.alforse.com/ko/docs/reference/methods.md)

**권한 및 액세스**

지침을 편집하고 게시할 수 있는 사람입니다.

[Open](https://docs.alforse.com/ko/docs/reference/permissions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.