> ## 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.

# 이슈(부적합)

> 부적합을 기록하고, 조치 작업과 MRB 승인 워크플로로 처리하며, 공급업체 조치를 SCAR로 공유하고, 이슈를 종결하기 전에 영향받는 모든 품목과 로트를 처분합니다.

자재나 작업이 요구 사항을 충족하지 못하면 Alforse에 **이슈**, 즉 시스템의 부적합 기록으로 남깁니다. 품질 엔지니어와 검사자는 이를 사용해 문제를 격리하고, 시정 및 예방 작업을 조율하며, 사례를 종결하기 전에 영향받는 모든 부품이 어떻게 될지 결정합니다.

## 개요

이슈 레코드는 `quality` 모듈에 있습니다. 내부적으로 ID는 `nc`로 시작하며, 사람들은 별도의 `nonConformanceId`를 봅니다. [품질 개요](https://docs.alforse.com/ko/docs/reference/quality.md#issues)에서 이슈가 검사, 계측기, 문서와 어떻게 연관되는지 설명합니다.

### 이슈를 생성하는 방법

* 이슈 목록에서 **직접**.
* MES의 **현장에서**.
* **Slack에서**.
* [수입 검사](https://docs.alforse.com/ko/docs/reference/quality.md#inbound-inspection)에서 로트를 거부할 때마다 **자동으로**.

이후에는 출처가 차이를 만들지 않습니다. 모든 이슈는 하나의 수명 주기를 공유합니다.

### 두 계층: 헤더와 영향받는 자재

NOTE

**하나의 이슈가 여러 품목과 로트에 걸칠 수 있습니다**

분류(우선순위, 소스, 유형, 워크플로)는 이슈 헤더에 있습니다. 실제로 영향받는 부품은 별도의 레코드(`nonConformanceItem`)에 보관됩니다. 이렇게 분리하면 하나의 이슈가 여러 품목과 많은 추적 로트 또는 일련번호를 다룰 수 있고 각각에 고유한 처분이 부여됩니다. 이슈의 상태와 품목의 처분을 혼동하지 마십시오.

## 헤더 필드

유형과 위치는 반드시 지정해야 합니다. 나머지는 선택 사항이거나 미리 채워집니다.

| 필드 | 값 | 비고 |
| - | - | - |
| **우선순위**(필수) | 낮음, 보통, 높음, 심각 | **"보통"**으로 시작합니다. |
| **소스**(필수) | 내부, 외부 | **"내부"**로 시작합니다. 공급업체나 고객에게서 비롯된 문제는 외부를 선택하십시오. |
| **유형**(필수) | 사용자 목록 | 직접 구성하는 카테고리(`nonConformanceType`)이며 고정된 집합은 없습니다. |
| **워크플로** | 사용자 목록 | 선택 사항입니다. `nonConformanceWorkflow`를 선택하면 우선순위, 소스, 필수 조치, 승인, 문서 템플릿이 미리 채워집니다. [워크플로](#workflows-the-8d-and-its-cousins)를 참조하십시오. |
| **위치**(필수) | 사업장 | 이슈가 생성된 곳입니다. |
| **개설일 / 마감일 / 종료일** | 날짜 | `openDate`는 반드시 지정해야 하고 `dueDate`는 선택이며 `closeDate`는 종료 시 Alforse가 채웁니다. |
| **수량** | 숫자 | 영향받는 양입니다. 헤더에서는 필수가 아닙니다. |

## 워크플로: 8D와 그 유사 형식

**워크플로**는 상태 집합이라기보다 이슈의 시작 키트로 생각하십시오. 초기 서식 있는 텍스트 내용, 우선순위, 소스, 필수 조치, 승인을 묶습니다. 이슈를 만들 때 하나를 선택하면 이 설정이 복사됩니다.

Alforse는 8D를 이렇게 제공합니다. 필수 조치가 여덟 개의 규율인 워크플로로서입니다. 8D가 단지 데이터이므로 사용자가 설계하는 모든 워크플로가 동일한 조치 모델에서 실행됩니다.

## 수명 주기

`nonConformanceStatus`는 세 가지 값으로 구성됩니다. 새로 생성된 이슈는 **"등록됨"**에서 시작하고 **"종료됨"**은 레코드를 고정합니다.

<details>
  <summary>**등록됨**</summary>

  기록되었지만 아직 담당되지 않았습니다. 새 `nonConformance`는 데이터베이스에서 기본적으로 이 값을 받습니다. 여전히 편집할 수 있습니다.
</details>

<details open>
  <summary>**진행 중**</summary>

  작업이 시작되었습니다. 누군가 작업 메모를 입력하면 Alforse가 등록됨 이슈를 자동으로 여기로 옮기며, 헤더에서 \*\*"시작"\*\*을 선택할 수도 있습니다.
</details>

<details>
  <summary>**종료됨**</summary>

  해결되었습니다. `isIssueLocked(status)`가 종료됨에서만 true를 반환하므로 이 상태만 이슈와 작업 배정의 편집을 막습니다. 종료 시 담당자가 지워지고 `closeDate`가 설정됩니다. \*\*"다시 열기"\*\*를 선택하면 등록됨으로 돌아갑니다.
</details>

헤더에는 각 전환에 대한 버튼이 표시됩니다. 모두 `quality` 갱신 권한이 필요합니다.

| 버튼 | 이슈를 이동하는 방향 |
| - | - |
| **"시작"** | 등록됨에서 진행 중으로 |
| **"완료"** | `closeIssue`를 통해 진행 중에서 |
| **"다시 열기"** | 진행 중 또는 종료됨에서 등록됨으로 |

따라서 종료됨은 영구적이지 않습니다. 추가 작업이 생기면 **"다시 열기"**가 레코드의 잠금을 해제합니다.

## 조치 작업

### 작업의 출처

모든 이슈에는 **필수 조치**(`requiredActionIds`) 목록이 있습니다. 이슈가 설정되는 순간 각 필수 조치가 정렬 순서로 번호가 매겨진 **조치 작업**(`nonConformanceActionTask`)이 됩니다. 작업들이 모여 팀의 체크리스트를 이룹니다.

### 다섯 가지 시스템 카테고리

일부 필수 조치에는 어떤 종류의 작업인지 나타내는 `systemType`이 있습니다.

| 카테고리 | 목적 |
| - | - |
| **격리** | 근본 원인을 아직 모르는 동안 의심되는 재고나 작업을 분리하는 즉각적인 조치입니다. 아래의 격리 상태에 반영됩니다. |
| **시정** | 근본 원인이 확인된 후의 해결입니다. |
| **예방** | 같은 실패가 다른 곳에서 나타나지 않도록 하는 조치입니다. |
| **검증** | 시정 및 예방 조치가 효과적이었다는 증거입니다. |
| **커뮤니케이션** | 고객 같은 영향받는 당사자에게 알리는 것입니다. |

Alforse는 각 회사에 카테고리당 하나의 조치를 기본 제공합니다: 격리 조치, 시정 조치, 예방 조치, 검증, 고객 커뮤니케이션입니다. 이들은 **보호**됩니다. 데이터베이스 트리거가 삭제하거나 `systemType`을 변경하는 것을 막으며 회사는 각각 하나만 가질 수 있습니다. 직접 만든 조치에는 `systemType`이 없으며 완전히 편집할 수 있습니다.

NOTE

**격리 상태를 직접 설정하지 않습니다**

`issues` 뷰는 작업에서 **격리 상태**를 계산합니다.

* 격리 유형 작업이 진행 중이거나 완료되면 **"격리됨"**
* 격리 작업이 있지만 시작되지 않았으면 **"미격리"**
* 이슈에 격리 작업이 없으면 **"해당 없음"**

### 작업 상태

작업은 **"대기 중"** → **"진행 중"** → **"완료됨"**으로 이동하며 **"건너뜀"**으로 이 경로를 벗어날 수 있습니다.

* 새 작업은 대기 중으로 기다리며 자동으로 시작되는 것은 없습니다.
* 작업을 완료하면 완료일이 기록됩니다.
* 완료됨과 건너뜀 작업은 대기 중으로 돌아갈 수 있습니다.
* 작업의 순서를 바꾸고, 마감일을 설정하고, 특정 공정에 연결할 수 있습니다.

### 공급업체 시정 조치 요청(SCAR)

작업이 공급업체를 위한 것이면 **SCAR**(공급업체 시정 조치 요청)로 공유합니다. 공급업체는 비공개 링크를 받으며 로그인이 필요하지 않습니다.

공급업체가 보는 것: 부적합 상세, 현재 상태, 자신에게 배정된 조치 작업. 처분, 승인, 종결, 이슈의 나머지는 내부에 남습니다.

공급업체가 할 수 있는 것: 각 작업의 상태를 변경하고 입력하는 동안 저장되는 편집기에서 메모를 작성합니다. **"대기 중"** 작업에 메모를 작성하면 자동으로 **"진행 중"**으로 이동합니다. 이슈가 **"종료됨"**에 도달하면 SCAR는 잠기고 더 이상의 변경을 받지 않습니다.

HEADS UP

**SCAR 링크는 가진 사람이면 누구나 사용할 수 있습니다**

링크를 보호하는 로그인이 없으므로 공급업체 담당자에게만 보내십시오.

## 승인과 자재 검토 위원회

승인은 조치와 별개의 요구 사항입니다. Alforse는 하나를 제공합니다. MRB(자재 검토 위원회)입니다.

1. 이슈에 MRB를 추가합니다. 승인 작업이 생성됩니다.
2. MRB가 아직 필요하지 않았다면 **"엔지니어링"**과 **"품질"**이라는 제목의 두 **검토자**가 추가됩니다.
3. MRB를 제거하면 기본 제공된 두 검토자도 함께 제거됩니다. 직접 입력한 검토자는 남습니다.

검토자는 이슈에 기록된 제목일 뿐이며 인라인으로 편집합니다.

## 처분: 자재의 운명 결정

영향받는 각 자재는 이슈를 종결하기 전에 판정이 필요합니다. 그 판정이 각 `nonConformanceItem` 행에 저장되는 처분입니다. 데이터베이스 열거형은 선택기가 제공하는 것보다 더 크며, 인터페이스는 의도적으로 다섯 가지로 제한합니다.

| 처분 | 의미 | 종결 시 연결된 추적 대상에 미치는 영향 |
| - | - | - |
| **대기 중** | 아직 결정되지 않음(기본값). | 없음 — 행에 연결된 자재가 있으면 **종결을 막습니다**. |
| **공급업체 반품** | 되돌려 보냅니다. | **반려됨**이 되고 음수 조정 원장 항목이 전기됩니다. |
| **재작업** | 수리한 다음 사용합니다. | **가용**으로 돌아갑니다. |
| **스크랩** | 상각합니다. | **반려됨**이 되고 음수 조정 원장 항목이 전기됩니다. |
| **있는 그대로 사용** | 편차를 수용합니다. | **가용**으로 돌아갑니다. |

### 종결 시 확인 사항

HEADS UP

**연결된 자재가 있는 모든 행이 통과해야 이슈를 종결할 수 있습니다**

종결하기 전에 `closeIssue`는 연결된 추적 대상이 있는 모든 영향받는 품목 행을 검사합니다. 그런 행이 아직 대기 중이거나, 연결된 수량의 합이 행 수량과 일치하지 않거나, 연결된 엔터티가 없거나 이미 소진됨이면 *"Cannot close: Disposition is still Pending"*(종결할 수 없습니다: 처분이 아직 대기 중입니다) 또는 유사한 메시지와 함께 종결이 거부됩니다. 모든 행이 정상일 때만 결과가 적용되고 이슈가 \*\*"종료됨"\*\*으로 설정됩니다.

연결된 자재가 없는 행은 이 검사를 건너뜁니다. 추적하지 않은 자재에는 처분이 필요하지 않습니다.

## 이슈를 다른 레코드에 연결

이슈를 **품목**, **고객**, **공급업체**, **작업 공정작업**, **발주서 라인**, **수주 라인**, **출하 라인**, **입고 라인**, **추적 대상**, **수입 검사**와 연관시킬 수 있습니다. 링크는 문제가 발생한 곳까지의 추적성을 제공하고 공급업체 품질 지표에 반영됩니다.

이슈 해결에 일회성 처분이 아니라 엔지니어링 변경이 필요하면 이슈 헤더에서 바로 [변경 통지](https://docs.alforse.com/ko/docs/reference/change-orders.md)를 시작하십시오. 새 변경 통지는 이슈를 출처로 기록합니다.

## 권한

| 작업 | 필요한 것 |
| - | - |
| 이슈 목록 보기 | `quality` **view** |
| 이슈 생성 | `quality` **create** |
| 편집, 종결, 분할 또는 엔터티 이동 | `quality` **update** |
| 이슈 삭제 | `quality` **delete** |

## 관련 문서

**변경 통지**

이슈를 엔지니어링 변경으로 에스컬레이션합니다.

[Open](https://docs.alforse.com/ko/docs/reference/change-orders.md)

**품질**

이슈가 수입 검사, 계측기, 품질 문서와 어떻게 연결되는지입니다.

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

**리스크 등록부**

부적합과 함께 리스크와 기회를 소스별로 추적합니다.

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

**교정**

계측기 기록과 각 교정의 기한입니다.

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


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