얼굴인식 출결 시스템 (Face Recognition Attendance System)

얼굴 인식 기술을 활용한 실시간 출결 관리 시스템입니다. PyQt5 기반의 GUI 애플리케이션으로, 카메라를 통해 실시간으로 얼굴을 인식하고 출결을 자동으로 기록합니다.

주요 기능

출결 관리

• 실시간 얼굴 인식을 통한 자동 출석 체크
• 출석 현황 실시간 모니터링
• 미출석자 목록 자동 업데이트
• 출석 기록 CSV 파일 내보내기
• 시간대별 출석 현황 그래프 제공
• 출석 상태별 필터링 (전체/출석/미출석)

얼굴 데이터 관리

• 개별 얼굴 등록
• 대량 얼굴 일괄 등록
• 등록된 얼굴 검색
• 선택한 얼굴 삭제
• 페이지네이션을 통한 효율적인 얼굴 목록 관리

시스템 요구사항

• Python 3.7 이상
• 필수 라이브러리:
  • PyQt5
  • OpenCV (cv2)
  • face_recognition
  • numpy
  • Pillow

설치 방법

1. 저장소 클론

git clone https://github.com/Sungblab/SB_face_recognition_system.git
cd SB_face_recognition_system

2. 필요한 패키지 설치

pip install -r requirements.txt

사용 방법

1. 프로그램 실행

python face_attendance/app/app.py

2. 얼굴 등록

   • '관리' 탭에서 '얼굴 등록' 또는 '대량 등록' 버튼 사용
   • 등록할 사진 선택 및 이름 입력

3. 출석 체크

   • '출결' 탭에서 '출석 시작' 버튼 클릭
   • 카메라에 얼굴이 인식되면 자동으로 출석 처리

주요 특징

• 직관적인 사용자 인터페이스
• 실시간 알림 시스템
• 자동 출석 기록 및 관리
• 효율적인 얼굴 데이터 관리
• CSV 형식의 출석 기록 내보내기
• 미출석자 실시간 모니터링

파일 구조

face_attendance/
├── app/
│   └── app.py        # 메인 애플리케이션 파일
├── faces/            # 등록된 얼굴 이미지 저장 디렉토리
└── attendance_*.csv  # 출석 기록 파일

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE를 참고하세요.

기여

버그 리포트, 기능 제안 및 풀 리퀘스트를 환영합니다.

주의사항

• 카메라 접근 권한이 필요합니다
• 얼굴 인식의 정확도를 위해 적절한 조명이 필요합니다
• 대량 등록 시 얼굴이 명확히 보이는 사진을 사용해야 합니다