생체 인식 출퇴근 상태 자동화: 체크인 및 체크아웃
생체 인식 근태 시스템에서는 출퇴근 기록이 IN(입실)인지 OUT(퇴실)인지를 정확하게 식별하는 것이 올바른 근태 관리를 위해 매우 중요합니다. Cams Biometrics는 출퇴근 상태를 결정하는 유연한 방법을 제공합니다. 이는 하드웨어 수준과 관리자 포털(API) 수준 모두에서 가능합니다.
이 문서에서는 출퇴근 상태가 어떻게 기록되는지, 개발자가 설정할 수 있는 옵션은 무엇인지, 그리고 실시간 시스템에서 안정적인 성능을 보장하기 위해 반드시 고려해야 할 중요한 기술적 제약 사항을 설명합니다.
🛠️ 1. 하드웨어 수준의 출퇴근 상태
대부분의 생체 인식 장치에서는 모든 출퇴근 기록이 기본적으로 “체크인”으로 저장됩니다.
사용자가 “체크아웃” 또는 기타 사용자 지정 상태를 기록하려면, 출퇴근 기록 전에 장치에서 적절한 출퇴근 모드를 직접 선택해야 합니다(예: “체크아웃” 버튼을 누르거나 터치스크린 옵션을 사용).
✅ 이 설정은 사용자가 장치에서 올바른 출퇴근 모드를 선택하도록 교육받은 환경에서 잘 작동합니다.
❌ 중요: 하드웨어 수준에서 상태를 자동으로 선택하는 것은 불가능합니다. 생체 인식 장치는 비즈니스 로직을 전혀 보유하지 않습니다. 개발자는 출퇴근 상태가 연결된 소프트웨어 또는 API 로직에서 올바르게 처리되도록 해야 합니다.
🌐 2. Cams 포털 수준의 출퇴근 상태(자동화 옵션)
사용자 경험을 간소화하고 출퇴근 상태 분류를 자동화하기 위해, Cams Web API와 연동하는 개발자는 다음의 서버 측 로직 옵션 중에서 선택할 수 있습니다. 이 규칙은 장치에 출퇴근 기록이 저장된 이후에 적용됩니다.
📌 옵션 1: Actual
- 사용자가 장치에서 선택한 정확한 출퇴근 상태(IN/OUT)가 그대로 서버로 전달됩니다.
📌 옵션 2: First In Rest Out
- 하루의 첫 번째 기록은 IN으로 표시됩니다.
- 같은 사용자의 이후 모든 기록은 24시간 내에 OUT으로 표시됩니다.
- 사용자가 출퇴근 유형을 수동으로 선택하지 않는 시스템에 적합합니다.
📌 옵션 3: ZigZag
- 하루 동안 기록이 IN과 OUT을 번갈아 가며 표시됩니다.
- 첫 번째 기록은 IN, 두 번째는 OUT, 세 번째는 IN이며, 이후 같은 방식으로 이어집니다.
- 이 로직은 각 사용자의 지난 24시간 활동 기록을 기준으로 유지됩니다.
ℹ️
First In Rest Out모드와ZigZag모드 모두 정확하게 작동하려면 지난 24시간의 출퇴근 기록에 접근할 수 있어야 합니다.
⚠️ 유의해야 할 주요 제약 사항
이러한 자동 로직 옵션은 연동을 간소화하지만, 이해해야 할 중요한 제한 사항이 있습니다.
❗ 1. 사용자 데이터의 영구 저장 없음
Cams Biometrics는 사용자 데이터나 출퇴근 데이터를 영구적으로 저장하지 않습니다. First In Rest Out 및 ZigZag 모드의 경우, 당사는 지난 24시간의 출퇴근 기록만 일시적으로 저장합니다.
장치가 24시간 이상 오프라인 상태이면, 다음 기록을 올바르게 판단하는 데 필요한 이전 기록을 더 이상 사용할 수 없습니다. 이로 인해 잘못된 분류가 발생할 수 있습니다(예: 두 번째 기록을 OUT이 아닌 IN으로 처리).
❗ 2. 로직은 장치별로만 작동함
이러한 출퇴근 상태 로직은 장치별, 사용자별로 적용됩니다. 사용자가 여러 장치에서 기록하는 경우, 시스템은 장치 간 기록을 상호 참조하지 않습니다. 따라서 여러 장치를 사용하는 환경에서는 로직 오류가 발생합니다.
❗ 3. 장치는 최소 24시간마다 한 번 이상 연결되어야 함
출퇴근 상태 자동화가 안정적으로 작동하려면 장치가 24시간마다 최소 한 번 온라인 상태가 되어 동기화되어야 합니다. 그렇지 않으면 Cams 서버가 필요한 단기 출퇴근 기록을 유지할 수 없습니다.
❗ 4. 교대 근무 근태에는 적합하지 않음
출퇴근 상태 자동화는 지난 24시간의 데이터만을 기반으로 하며, 분류는 기록이 발생한 같은 달력 날짜 내에서 이루어집니다.
특히 야간 근무나 유연 근무와 같은 교대 근무 근태를 관리하는 경우, API의 출퇴근 상태에 의존하지 않을 것을 강력히 권장합니다. 대신 교대 근무 정의에 따라 출퇴근 기록을 해석하는 로직을 자체 시스템 내에 구축하십시오.
🛠️ Cams는 현재 교대 시간에 기반한 출퇴근 상태 자동화를 지원하지 않습니다. 해당 로직은 지정된 근태 관리 소프트웨어에서 구현해야 합니다.
✅ 모범 사례 및 권장 사항
자동 출퇴근 상태 로직(First In Rest Out 또는 ZigZag)을 활성화하기 전에 다음 사항을 확인하십시오.
- 사용자가 지정된 한 대의 장치에서 일관되게 기록합니다.
- 각 장치가 서버에 24시간마다 최소 한 번 연결됩니다.
- 잘못된 출퇴근 해석을 피하기 위해 이러한 로직 모드의 작동 방식과 제한 사항을 충분히 이해하고 있습니다.
🛑 설정이 위의 조건을 모두 충족하지 않는 한 이러한 옵션을 활성화하지 마십시오. 부적절하게 사용하면 고객의 근태 계산 오류로 이어질 수 있습니다.
🚀 Cams는 노코드 및 즉시 연동을 제공합니다
개발 과정을 간소화하기 위해, Cams는 플러그 앤 플레이(노코드) 연동 옵션과 전체 맞춤형 지원을 함께 제공합니다.
필요한 경우 당사 팀은 다음을 지원할 수 있습니다.
- 고객 시스템의 업무 흐름에 맞춘 맞춤형 로직을 개발합니다.
- 모든 서버 언어(PHP, Node.js, Java, Python, .NET 등)와 모든 데이터베이스(MySQL, PostgreSQL, SQL Server 등)에 대해 바로 설치 가능한 연동 코드를 제공합니다.
사용 중인 기술 스택을 알려주시면, 원활한 연동을 위해 도와드리겠습니다.