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

# MES 앱

> 작업자가 스테이션에 로그인하고, 릴리즈된 공정작업을 가져오고, 시간과 수량을 기록하고, 자재를 불출하고, 품질 또는 유지보수 이슈를 제기하는 데 사용하는 현장 앱입니다.

MES 앱은 Alforse의 현장 인터페이스입니다. 계획 담당자는 ERP에서 작업을 릴리스하고 순서를 정하며, 태블릿이나 공용 스테이션의 작업자는 MES를 사용해 각 공정작업을 실행하고, 양품과 불량 산출을 보고하고, 자재를 소비하고, 근무 시간을 기록합니다.

## MES와 ERP의 관계

MES는 계획을 세우는 것이 아니라 실행합니다. 계획 담당자가 릴리스한 공정작업을 나열하고 그 공정작업에서 실제로 일어난 일을 기록합니다. 화면 뒤의 각 레코드에는 자체 페이지가 있습니다. [작업](https://docs.alforse.com/ko/docs/reference/jobs.md), [피킹 목록](https://docs.alforse.com/ko/docs/reference/picking.md), [품질](https://docs.alforse.com/ko/docs/reference/quality.md)을 참조하십시오.

HEADS UP

**MES에는 실시간 연결이 필요합니다.**

모든 변경은 서버에 곧바로 기록되며 **오프라인 모드는 없습니다**. 품목과 사람 선택기는 더 빠르게 열리도록 IndexedDB에 캐시되지만, 네트워크가 없으면 작업자가 작업을 시작하거나 산출을 보고하거나 자재를 불출할 수 없습니다.

## 스테이션에서 로그인

### 로그인 방법

로그인 화면에 어떤 버튼이 제공되는지는 회사의 `AUTH_PROVIDERS` 설정에 따라 다릅니다.

| 옵션 | 결과 |
| - | - |
| **Google로 로그인** | Google 계정 로그인. |
| **Outlook으로 로그인** | Outlook 계정 로그인. |
| **패스키로 로그인** | 기기에 저장된 패스키. |
| 이메일 주소 입력 후 **계속** | 매직 링크가 이메일로 전송되고 화면에 **이메일을 확인하세요**가 표시됩니다. |

예를 들어 패스키만 허용하는 회사에는 패스키 버튼 하나만 표시됩니다.

### 위치 선택

위치가 여러 개인 회사는 사이드바에 **위치** 하위 메뉴가 있습니다. 작업자가 자신이 있는 사업장을 선택하면 이후 일정 보드, 개인 목록, 모든 보고서가 해당 사업장으로 제한됩니다. 위치가 하나인 회사에서는 이 선택이 표시되지 않습니다.

### 콘솔(공용 스테이션) 모드

콘솔 모드는 하나의 기기를 여러 작업자를 위한 키오스크로 만듭니다. Business 플랜과 `consoleEnabled` 회사 설정이 필요합니다. 켜려면 `settings_update` 권한이 있는 계정이 필요하며, 끄는 것은 모든 작업자가 할 수 있습니다.

콘솔 스테이션에서 작업자는 전체 로그인 대신 **4자리 PIN**으로 신원을 확인합니다. PIN은 선택하는 것이 아니라 Alforse가 생성합니다. 관리자는 작업자를 만들거나 PIN을 재설정할 때 PIN을 한 번 보고 전달합니다. 해시만 저장됩니다([현장 PIN 계정](https://docs.alforse.com/ko/docs/reference/permissions.md#shop-floor-pin-accounts) 참조). 스테이션은 선택한 작업자의 PIN을 요청하고, 검증하고, 그 사람에게 작업 실적을 귀속시킵니다.

| 작업 | 동작 |
| - | - |
| **작업자 전환** | 다른 사람이 인계받을 수 있도록 PIN을 요청합니다. |
| **PIN 로그아웃** | 현재 작업자를 스테이션에서 제거합니다. |
| 근무 종료 | 별도 단계 없이 작업자를 PIN 로그아웃합니다. |

NOTE

**PIN은 누가 작업했는지를 기록합니다.**

공용 기기에서 PIN은 생산 이벤트의 실적을 누구에게 귀속시킬지 Alforse에 알려 줍니다. 로그인이 아니며 본인 계정을 대신하지 않습니다.

## 작업 찾기

### 일정 보드

**일정** 보드는 릴리즈된 작업을 작업장마다 하나의 열로 표시합니다. 대기 중인 공정작업은 배정 우선순위로 정렬되므로 열의 맨 위에 있는 것이 다음에 실행됩니다.

표시 팝오버를 열어 스테이션 고유의 보기를 설정합니다.

* **빈 작업장**을 켜거나 끕니다.
* 카드에 표시할 세부 정보를 선택합니다: **고객**, **설명**, **마감일**, **기간**, **진행 상황**, **상태**, **수주**, **썸네일**.
* **작업장**, **공정**, **태그**, **담당자**로 필터링합니다.

HEADS UP

**보드는 계획을 보여 줄 뿐 변경할 수 없습니다.**

카드를 현장에서 새 위치로 드래그할 수 없습니다. 공정작업을 다른 작업장에 다시 배정하거나 작업의 날짜를 옮기는 일은 계획 담당자가 [ERP 일정 보드](https://docs.alforse.com/ko/docs/reference/scheduling.md)에서 합니다. 순서의 소유자를 하나로 유지하면 스테이션들이 같은 대기열을 서로 반대로 재정렬하는 일을 막을 수 있습니다.

### 개인 목록

사이드바에는 대기열을 한 사람으로 좁히는 세 개의 목록이 있습니다.

| 목록 | 표시 내용 | 비어 있을 때 |
| - | - | - |
| **나에게 배정됨** | 나에게 배정된 공정작업이며 작업장별로 그룹화됩니다. | **배정된 공정작업이 없습니다** |
| **활성** | 지금 실행 중인 공정작업, 즉 열린 생산 이벤트가 있는 것입니다. | **진행 중인 공정작업이 없습니다** |
| **최근** | 최근에 작업한 공정작업이며 다시 돌아갈 수 있습니다. | **최근 공정작업이 없습니다** |

카드에는 상태 배지, 진행률 표시기, **가능한 한 빨리**, **마감일 없음**(No Deadline) 또는 날짜를 표시하는 기한 칩이 있으며 기한이 지나면 빨간색으로 표시됩니다. 배지는 공정작업의 상태를 따르며 작업의 상태와 다를 수 있습니다.

### 미결 작업 지시

**미결 작업 지시**는 한 단계 위에서 작동하며 작업 전체를 나열합니다.

| 열 | 열 |
| - | - |
| 작업 | 담당자 |
| 품목 | 마감일 |
| 수량 | 마감일 |
| 추적 | 상태 |

`Closed` 작업도 목록에 포함됩니다.

NOTE

**ERP의 "준비됨"은 MES에서 "릴리즈됨"으로 표시됩니다.**

실행해도 되는 작업의 ERP 상태는 `Ready`입니다. 미결 작업 지시에서 이 값은 "시작해도 됩니다"를 뜻하는 현장 용어인 **릴리즈됨**으로 표시됩니다. 레이블만 다르고 상태는 같습니다.

작업을 열면 공정작업이 방향 그래프(라우팅 DAG)로 그려져 어느 공정작업이 어느 것으로 이어지는지 분명해집니다. 도구 모음에서 **왼쪽에서 오른쪽** 또는 **위에서 아래로** 배치하거나 **맞춤**을 선택할 수 있습니다. 해당하는 경우 노드에는 **재작업** 루프 표시와 폐기된 단위의 수가 표시됩니다.

## 공정작업 실행

### 스테이션 패널

공정작업을 열면 나타나는 패널에는 네 개의 탭이 있습니다.

| 탭 | 내용 |
| - | - |
| **상세 정보** | 공정작업의 상세 정보. |
| **모델** | 품목의 3D 보기. |
| **절차서** | 작업 지침과 **속성** 및 **파라미터** 하위 보기. |
| **채팅** | 이 공정작업의 연속된 메모 스레드. |

### 시간 기록

### 시간 유형 선택

토글을 **설정**(Setup), **노무**(Labor), **기계**(Machine) 중 하나로 설정합니다. 작업 원가에 반영되는 세 가지 생산 이벤트 유형입니다.

### 시작

**시작**을 선택합니다. 공정작업에서 생산 이벤트가 열립니다.

### 일시 중지

멈출 때 **일시 중지**를 선택합니다. 생산 이벤트가 닫힙니다.

### 가이드 조립 보기

**조립** 유형의 공정작업에서 MES는 일반 품목 모델이 아니라 가이드 3D 보기를 표시합니다. 조립은 한 번에 한 단계씩 진행되며 각 단계가 설치하는 구성품을 강조합니다.

플레이어 도구 모음에는 세 가지 표시 모드가 있습니다.

| 모드 | 표시 내용 |
| - | - |
| **빌드**(Build, 기본값) | 이 시점에 작업대에 있어야 하는 조립의 모습입니다. 지금까지 장착된 부품은 불투명하고 이후 단계의 부품은 제외됩니다. |
| **포커스**(Focus) | 앞서 장착된 부품이 반투명해져 현재 단계의 구성품이 문맥 속에서 선명하게 보입니다. |
| **전체**(Full) | 모든 구성품이 불투명하게 표시된 완성품입니다. |

모드를 전환해도 화면만 바뀝니다. 단계 순서, 각 단계의 구성품, 보고되는 내용은 영향을 받지 않습니다.

작성자의 두 가지 선택은 작성된 그대로 반영됩니다. 작성자가 단계에서 숨긴 부품은 여기서도 숨겨지고, 하위 조립품으로 그룹화된 단계는 유닛을 통째로 설치하기 전에 따로 조립됩니다. 자세한 내용은 [조립 지침](https://docs.alforse.com/ko/docs/reference/assembly-instructions.md)에 있습니다.

NOTE

**카메라는 그려지지 않는 부품을 무시합니다.**

**빌드**와 **포커스**는 이후 부품을 제외하므로 카메라는 그 부품들을 장애물로 취급하지 않으며 그 주위를 돌지 않습니다.

작성자는 ERP 조립 편집기에서 게시하기 전에 단계를 확인하는 데 동일한 빌드 / 포커스 / 전체 컨트롤을 사용합니다. 두 화면이 모델을 같은 방식으로 조회하므로 모든 버튼이 작성자와 작업자에게 같은 의미입니다.

### 수량 보고

산출은 수율이 왜곡되지 않도록 세 가지 구분으로 보고됩니다.

| 작업 | 기록 내용 |
| - | - |
| **완료 기록** | 이 공정작업의 양품 단위입니다. **모두 완료**는 남은 수량을 모두 입력하고, **총 수량**으로는 수치를 직접 입력할 수 있습니다. |
| **스크랩 기록** | 스크랩된 단위이며, 손실을 추적할 수 있도록 각각 **스크랩 사유**가 필요합니다. 단위는 **폐기됨**이 되고 대체품이 생성되며 라우팅이 다시 열립니다. [스크랩 및 스크랩 취소](https://docs.alforse.com/ko/docs/reference/scrap.md)를 참조하십시오. |
| **재작업 기록** | 이동하지 않고 이 공정작업에서 재작업된 단위입니다. |

단위를 이전 공정작업으로 되돌려 보내는 것은 **재작업 생성**이라는 별도의 작업입니다. **공정작업으로 돌아가기**에서 대상을 선택하고 **재작업 사유**를 입력하면 Alforse가 그 지점부터 현재까지의 모든 공정작업을 반복합니다.

### 공정작업 완료

**완료로 표시**는 열린 이벤트를 닫고 공정작업을 `Done`으로 설정합니다. 그 전에 두 가지 검사가 실행됩니다.

| 경고 | 나타나는 이유 |
| - | - |
| **수량 부족** | 보고된 수량이 필요한 수량보다 적습니다. |
| **단계가 누락되었습니다** | 필수 절차 단계가 기록되지 않았습니다. |

검사에 실패하면 버튼이 **그래도 완료로 표시**가 되어 재정의할 수 있습니다. 세 번째 보호 장치는 불출된 적 없는 추적 자재에 대한 것으로, 공정작업을 종결하려면 **I understand and want to complete without issuing**(불출하지 않고 완료하는 것을 이해하며 원합니다)을 선택해야 합니다.

HEADS UP

**"공정작업 종료"는 작업을 멈출 뿐 완료하지 않습니다.**

**공정작업 종료**는 작업자가 열어 둔 모든 생산 이벤트를 닫습니다. 근무 종료 시 깔끔하게 멈추는 방법이며, 근로 시간 카드가 활성화되어 있으면 작업자의 작업 종료도 기록합니다. 완료되는 공정작업은 없습니다. 모든 것이 그대로 남아 다음 근무조가 이어받습니다.

### 자재 불출

같은 패널의 **이슈**(Issue)로 공정작업에 대해 자재를 소비합니다. 조정 유형을 선택합니다.

| 조정 유형 | 전기 형태 |
| - | - |
| **재고에 추가** | `Positive Adjmt.` |
| **재고 사용** | `Negative Adjmt.` |

일련번호 및 배치 추적 자재에는 세 개의 탭이 추가됩니다. 바코드를 **스캔**하거나, 현재고에서 **선택**하거나, 이미 불출한 자재를 반환하는 **소비 취소**입니다.

유통기한이 지난 재고는 `Warn`, `Block`, `BlockWithOverride` 중 하나인 회사 정책으로 처리됩니다. 재정의 가능한 차단에서는 작업자가 **유통기한이 지난 재고를 불출하는 사유**를 입력해야 하므로 결정이 조용히 실패하는 대신 기록으로 남습니다.

### 작업 시작과 종료 기록

`timeCardEnabled` 회사 설정을 켜면 사이드바에 근로 시간 카드가 추가됩니다.

* **작업 시작**과 **작업 종료**.
* 열린 근무 중 시작 시각을 보여 주는 **이후로 근무 중** 배지(Clocked in since).
* **날짜**, **작업 시작**, **작업 종료**, **기간**을 나열하는 **내 근무 시간**.

12시간 동안 열려 있는 근무는 **작업 종료를 잊으셨습니까?**를 띄우며, **아직 작업 중입니다**와 **작업 종료 설정** 두 가지로 답할 수 있습니다.

근로 시간 카드는 급여를 위한 근태를 추적합니다. 작업 원가는 공정작업별 생산 이벤트를 대신 사용하므로 둘은 섞이지 않습니다.

## 현장의 기타 작업

### 피킹

**피킹**은 나에게 배정된 피킹 목록을 나열합니다.

### 시작

**시작**을 선택합니다. 목록이 `In Progress`로 이동합니다.

### 라인 처리

각 라인에 **피킹**, **피킹 취소**, **부족**, **스캔**(추적 자재)을 사용합니다. **재고 없음** 배지는 비어 있는 소스를 표시합니다.

### 부족분 처리

부족한 피킹은 \*\*실제로 몇 개를 피킹했습니까?\*\*에 수치를 입력하고 **부족으로 표시**를 선택합니다.

### 마감

**마감**을 선택합니다. 목록이 `Completed`로 이동합니다.

NOTE

**종료된 피킹 목록은 ERP에서만 다시 열 수 있습니다.**

`Completed` 및 `Cancelled` 목록은 잠기며 MES는 "This picking list is closed. Reopen it from the ERP to continue."(이 피킹 목록은 종료되었습니다. 계속하려면 ERP에서 다시 여십시오.)로 알려 줍니다. 현장 앱에는 다시 열기에 필요한 재고 권한이 없습니다. 전체 수명 주기는 [피킹 목록](https://docs.alforse.com/ko/docs/reference/picking.md)에 있습니다.

### 품질 이슈 제기

작업자는 스테이션을 떠나지 않고 문제를 보고할 수 있습니다. **품질 이슈 생성**은 **이슈 유형**, **우선순위**(낮음, 보통, 높음, 심각), **설명**을 수집하고 품질 팀을 위한 부적합을 엽니다. 해당 레코드가 처리되는 방식은 [품질](https://docs.alforse.com/ko/docs/reference/quality.md)에서 다룹니다.

### 절차 및 검사 단계

**절차서** 탭은 작업 지침과 검사를 유형이 있는 단계로 실행하며 모두 아홉 가지입니다.

| 단계 유형 | 작업자 입력 |
| - | - |
| **작업** | 지침을 완료로 표시합니다. |
| **체크박스** | 예/아니요 확인. |
| **값** | 텍스트 또는 자유 형식 값. |
| **측정** | 숫자. 측정 단위에 대해 설정된 최소값과 최대값을 벗어나면 Alforse가 경고합니다. |
| **타임스탬프** | 단계를 수행한 시각. |
| **목록** | 미리 정의된 목록에서 한 가지 옵션. |
| **담당자** | 단계를 수행한 사람. |
| **파일** | 사진이나 문서 같은 첨부 파일. |
| **검사** | **검사 통과** 스위치로 설정하는 통과 또는 실패. |

### 유지보수 배차

작업자는 설비가 고장나면 MES에서 유지보수 배차를 요청합니다. 여기서 요청한 모든 항목의 소스는 `Reactive`입니다. 예정된 배차와 부적합 배차는 다른 곳에서 시작됩니다.

각 배차에는 심각도, 우선순위, OEE 영향이 있습니다. OEE 영향이 **가동중단**이면 수리하는 동안 아무것도 생산할 수 없으므로 작업장의 활성 생산 이벤트가 중지됩니다.

유지보수 담당자는 재생, 일시 중지, 완료 컨트롤, 누적 **작업 시간**, **추가 및 출고**가 있는 **예비 부품** 섹션이 있는 상세 보기에서 배차를 처리합니다. 완료되면 **유지보수 완료**가 표시됩니다.

## 문제 해결

### "Incorrect PIN"(PIN이 올바르지 않습니다)

* **원인:** 콘솔 스테이션에서 입력한 PIN이 선택한 작업자의 것이 아닙니다.
* **해결 방법:** 다시 입력하거나, 다른 사람이 선택되어 있으면 **작업자 전환**을 사용하십시오. 콘솔 PIN은 본인 비밀번호와 별개입니다.

### "Too many incorrect PINs. Please wait a few minutes and try again."(잘못된 PIN이 너무 많습니다. 몇 분 후에 다시 시도하십시오.)

* **원인:** 15분 안에 같은 사람이 PIN을 다섯 번 틀리면 모든 스테이션에서 그 사람의 PIN 로그인이 잠깁니다. 잠금은 1분에서 시작하여 반복될 때마다 두 배가 되며 최대 한 시간입니다. 이와 별개로 각 스테이션은 15분 안에 모든 작업자를 합쳐 잘못된 PIN을 최대 30회까지 허용하며, 한 계정으로 로그인한 스테이션들은 이 허용량을 공유합니다.
* **해결 방법:** 잠금이 풀릴 때까지 기다린 다음 올바른 PIN을 입력하십시오.

### "No PIN set. Ask an admin to set a console PIN for you."(PIN이 설정되지 않았습니다. 관리자에게 콘솔 PIN 설정을 요청하십시오.)

* **원인:** 해당 인원에게 아직 콘솔 PIN이 없으므로 작업 실적을 귀속시킬 수 없습니다. PIN은 현장에서 설정할 수 없습니다.
* **해결 방법:** 관리자가 ERP에서 생성합니다. 작업자는 **설정 → 사용자 → 작업자**의 **PIN 재설정**으로, 그 외의 사람은 **계정** 목록의 **콘솔 PIN 설정**으로 합니다(이 경우에도 `settings_update`가 필요합니다).

### "This picking list is closed. Reopen it from the ERP to continue."

* **원인:** 목록이 `Completed` 또는 `Cancelled`이며 피킹, 피킹 취소, 부족, 스캔이 차단됩니다. MES에는 다시 열기에 필요한 재고 권한이 없습니다.
* **해결 방법:** 해당 권한이 있는 사람이 ERP에서 목록을 다시 엽니다.

### 완료로 표시할 때 "수량 부족" 또는 "단계가 누락되었습니다"가 경고됩니다

* **원인:** 필요한 수량보다 적게 보고되었거나 필수 절차 단계가 기록되지 않았습니다.
* **해결 방법:** 누락된 것을 보고하거나 **그래도 완료로 표시**로 재정의하십시오. 추적 자재가 불출된 적이 없다면 **I understand and want to complete without issuing**도 선택하십시오.

### "작업 종료를 잊으셨습니까?"

* **원인:** 근로 시간 카드가 12시간 이상 열려 있습니다.
* **해결 방법:** 열어 두려면 **아직 작업 중입니다**를, 닫으려면 **작업 종료 설정**을 선택하십시오.

### 콘솔 모드 토글이나 근로 시간 카드가 없습니다

* **원인:** 둘 다 회사 설정으로 전환됩니다. **콘솔 모드**는 `consoleEnabled`가 켜져 있고 이를 포함한 플랜일 때, 그리고 `settings_update` 권한이 있는 계정에만(또는 종료할 수 있도록 이미 콘솔 모드인 스테이션에서) 표시됩니다. **작업 시작** / **작업 종료** 카드와 12시간 프롬프트에는 `timeCardEnabled`가 필요합니다.
* **해결 방법:** 관리자가 회사 설정에서 해당 설정을 켭니다.

### 일정 보드에서 카드를 드래그할 수 없습니다

* **원인:** MES **일정** 보드는 표시와 필터링만 하며 일정을 변경하지 않습니다.
* **해결 방법:** 계획 담당자가 [ERP 일정 보드](https://docs.alforse.com/ko/docs/reference/scheduling.md)에서 순서를 변경합니다.


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