⏰ 근태관리 시스템 사용자 매뉴얼

버전 v1.0.0
최종 업데이트: 2025년 6월 3일

📋 목차

  1. 시스템 개요
  2. 설치 및 설정
  3. 로그인 및 접근
  4. 일일 출퇴근 관리
  5. 보고서 조회
  6. 관리자 기능
  7. 문제 해결
  8. 자주 묻는 질문
  9. 기술 지원

1. 시스템 개요

근태관리 시스템은 그누보드(GNUBoard) 기반으로 개발된 통합 근태관리 솔루션입니다. 직원들의 출퇴근 시간을 효율적으로 관리하고, 근무 현황을 실시간으로 추적할 수 있습니다.

1.1 주요 기능

🟢
출퇴근 관리
원클릭으로 간편한 출퇴근 처리와 실시간 위치 정보 기록
📊
보고서 생성
월간/주간 근태 현황 보고서 및 CSV 내보내기
👑
관리자 기능
부서/직급 관리, 시스템 설정, 전체 현황 모니터링
📱
반응형 웹
PC, 태블릿, 모바일 모든 기기에서 최적화된 사용

1.2 시스템 요구사항

구분요구사항
웹서버Apache 2.4+ 또는 Nginx 1.16+
PHPPHP 7.3.0 이상
데이터베이스MySQL 5.7+ 또는 MariaDB 10.2+
기반 시스템그누보드 5.4+
브라우저Chrome, Firefox, Safari, Edge (최신 버전)
💡 참고사항
그누보드가 이미 설치되어 있어야 하며, 관리자 계정이 필요합니다.

2. 설치 및 설정

2.1 설치 과정

1
파일 업로드
근태관리 시스템 파일들을 그누보드 루트 디렉토리의 'attend' 폴더에 업로드합니다.
2
설치 페이지 접속
웹브라우저에서 http://도메인/attend/install.php 로 접속합니다.
3
시스템 요구사항 확인
PHP 버전, MySQL 연결, 디렉토리 권한 등을 자동으로 검사합니다.
4
설치 실행
"근태관리 시스템 설치하기" 버튼을 클릭하여 설치를 진행합니다.
5
설치 완료
설치가 완료되면 install.php 파일을 삭제하고 시스템 사용을 시작합니다.
⚠️ 중요
설치 완료 후 보안을 위해 반드시 install.php 파일을 서버에서 삭제하세요.

2.2 초기 설정

설치가 완료되면 다음과 같은 기본 데이터가 자동으로 생성됩니다:

3. 로그인 및 접근

3.1 시스템 접근

1
웹브라우저에서 접속
http://도메인/attend/ 또는 http://도메인/attend/index.php 로 접속합니다.
2
그누보드 로그인
그누보드 계정으로 로그인하면 자동으로 근태관리 시스템에 접근됩니다.
3
시스템 확인
로그인 후 메인 화면에서 시스템 상태와 사용자 정보를 확인할 수 있습니다.
시스템 메인 화면 스크린샷
(시스템 상태바, 사용자 정보, 출퇴근 버튼 등이 표시됩니다)

3.2 권한별 접근 기능

권한접근 가능 기능
일반 사용자
(레벨 1-9)		출퇴근 관리, 개인 보고서 조회, 주간 요약
관리자
(레벨 10+)		모든 기능 + 관리자 패널, 부서 관리, 전체 현황

4. 일일 출퇴근 관리

4.1 출근 처리

1
출근 버튼 클릭
메인 화면에서 "🟢 출근하기" 버튼을 클릭합니다.
2
위치 정보 확인
IP 주소가 자동으로 기록되며, GPS 위치 정보 사용 권한을 요청할 수 있습니다.
3
메모 입력 (선택사항)
특이사항이 있다면 메모란에 입력할 수 있습니다.
4
출근 완료
"🚀 출근 완료" 버튼을 클릭하여 출근을 처리합니다.

4.2 퇴근 처리

1
퇴근 버튼 클릭
출근 처리 후 "🔴 퇴근하기" 버튼이 활성화됩니다.
2
업무 정리 메모
오늘 업무 마무리 상황을 간단히 적을 수 있습니다.
3
퇴근 완료
퇴근 처리 후 자동으로 근무시간이 계산됩니다.

4.3 실시간 현황 확인

메인 화면에서 다음 정보를 실시간으로 확인할 수 있습니다:

💡 팁
주간 요약 섹션에서 이번 주 전체 근태 현황을 캘린더 형태로 확인할 수 있습니다.

5. 보고서 조회

5.1 보고서 페이지 접근

메인 화면의 "📊 보고서" 메뉴를 클릭하거나 reports.php로 직접 접근할 수 있습니다.

5.2 월간 보고서

1
조회 조건 설정
연도와 월을 선택합니다. (관리자는 다른 사용자 조회 가능)
2
보고서 생성
"📊 보고서 생성" 버튼을 클릭하여 월간 보고서를 생성합니다.
3
결과 확인
통계 요약, 출근 캘린더, 상세 기록 테이블을 확인합니다.

월간 보고서 구성 요소

5.3 주간 보고서

1
주간 시작일 선택
보고서를 생성할 주의 시작일(월요일)을 선택합니다.
2
보고서 생성
주간 근태 현황과 통계를 확인할 수 있습니다.

5.4 데이터 내보내기

📄
CSV 다운로드
Excel에서 열 수 있는 CSV 형태로 데이터를 다운로드합니다.
🖨️
인쇄
브라우저 인쇄 기능으로 보고서를 종이에 출력합니다.
✅ 자동 새로고침
보고서 페이지는 30초마다 자동으로 데이터가 업데이트됩니다.

6. 관리자 기능

6.1 관리자 패널 접근

관리자 권한(레벨 10 이상) 사용자만 접근 가능하며, admin.php로 접근하거나 메인 화면의 "👑 관리자" 메뉴를 클릭합니다.

6.2 대시보드

관리자 패널의 메인 화면에서 다음 정보를 확인할 수 있습니다:

6.3 회원 관리

시스템에 등록된 모든 회원의 목록을 확인할 수 있습니다. 그누보드의 회원 정보와 연동되어 표시됩니다.

6.4 부서 관리

1
부서 추가
부서명과 부서코드를 입력하여 새로운 부서를 추가합니다.
2
부서 목록 확인
등록된 부서 목록과 활성 상태를 확인할 수 있습니다.

6.5 직급 관리

1
직급 추가
직급명, 직급코드, 레벨, 관리자 권한 여부를 설정하여 추가합니다.
2
직급 체계 관리
레벨별로 정렬된 직급 체계를 확인하고 관리합니다.

6.6 IP 위치 관리

1
IP 위치 매핑 추가
특정 IP 주소에 대해 의미있는 위치명을 설정합니다. (예: 192.168.1.1 → 본사)
2
위치 매핑 관리
등록된 IP 위치 매핑을 확인하고 삭제할 수 있습니다.
💡 IP 위치 매핑의 활용
IP 주소에 위치명을 매핑하면 보고서에서 '192.168.1.1' 대신 '본사' 등으로 표시되어 가독성이 향상됩니다.

6.7 시스템 설정

근무시간, 지각 기준, 연장근무 기준 등 시스템 전반의 설정을 관리할 수 있습니다.

6.8 시스템 로그

시스템의 모든 활동이 기록되며, 문제 발생 시 원인 분석에 활용할 수 있습니다.

6.9 부서별 현황 (보고서)

관리자는 보고서 페이지에서 부서별 근태 현황을 월별로 조회할 수 있습니다.

7. 문제 해결

7.1 일반적인 문제

출퇴근 버튼이 동작하지 않는 경우

1
페이지 새로고침
브라우저에서 F5 키를 누르거나 새로고침 버튼을 클릭합니다.
2
JavaScript 활성화 확인
브라우저 설정에서 JavaScript가 활성화되어 있는지 확인합니다.
3
브라우저 호환성 확인
Chrome, Firefox, Safari, Edge 등 최신 브라우저를 사용합니다.

로그인 문제

⚠️ 로그인 관련 문제
근태관리 시스템은 그누보드의 로그인 시스템을 사용합니다. 로그인 문제가 있을 경우 그누보드 관리자에게 문의하세요.

데이터가 표시되지 않는 경우

  1. 시스템이 정상적으로 설치되었는지 확인
  2. 데이터베이스 연결 상태 확인
  3. 관리자에게 문의하여 테이블 설치 상태 확인
  4. 브라우저 캐시 삭제 후 재시도

7.2 디버그 기능

시스템에 내장된 디버그 기능을 활용할 수 있습니다:

// 브라우저 개발자 도구(F12)에서 실행 가능한 디버그 명령어들 // 시스템 상태 확인 testSystem(); // 근태관리 시스템 디버그 정보 debugAttendanceSystem(); // 데이터 새로고침 refreshData(); // 버튼 이벤트 재설정 resetButtonEvents();

7.3 로그 확인

관리자는 admin.php의 "시스템 로그" 섹션에서 상세한 로그를 확인할 수 있습니다. 모든 출퇴근 처리, 오류, 시스템 활동이 기록됩니다.

8. 자주 묻는 질문 (FAQ)

Q: 출근을 깜빡하고 늦게 처리했는데, 시간을 수정할 수 있나요?
A: 일반 사용자는 출퇴근 시간을 직접 수정할 수 없습니다. 관리자에게 문의하여 데이터베이스에서 직접 수정해야 합니다.
Q: 모바일에서도 사용할 수 있나요?
A: 네, 반응형 웹으로 제작되어 모바일, 태블릿에서도 최적화된 화면으로 사용할 수 있습니다. 모바일 브라우저에서 접속하세요.
Q: 위치 정보는 어떻게 기록되나요?
A: IP 주소가 자동으로 기록되며, 브라우저에서 GPS 위치 정보 사용을 허용하면 더 정확한 위치가 기록됩니다. 관리자가 IP별 위치명을 설정할 수 있습니다.
Q: 주말이나 공휴일에도 출근 처리가 가능한가요?
A: 네, 시스템은 24시간 365일 사용 가능합니다. 주말이나 공휴일 근무도 정상적으로 기록됩니다.
Q: 데이터를 Excel로 내보낼 수 있나요?
A: 보고서 페이지에서 "CSV 다운로드" 기능을 사용하면 Excel에서 열 수 있는 형태로 데이터를 다운로드할 수 있습니다.
Q: 시스템 백업은 어떻게 하나요?
A: 그누보드의 데이터베이스 백업에 근태관리 테이블들이 포함됩니다. 정기적으로 DB 백업을 수행하시기 바랍니다.
Q: 여러 사람이 같은 컴퓨터를 사용해도 되나요?
A: 네, 하지만 각자 그누보드 계정으로 로그인/로그아웃을 정확히 해야 합니다. 다른 사람의 계정으로 출퇴근 처리하지 않도록 주의하세요.

9. 기술 지원

9.1 지원 범위

🔧
설치 지원
시스템 설치 및 초기 설정 지원
❓
사용법 문의
기능 사용법 및 운영 관련 질문
🐛
버그 신고
시스템 오류 및 버그 신고 접수
💡
기능 개선
새로운 기능 제안 및 개선 요청

9.2 문의 전 확인사항

💡 문의 전 체크리스트
  1. 매뉴얼의 해당 섹션을 확인했는지
  2. FAQ에서 유사한 문제를 찾아봤는지
  3. 시스템 로그나 브라우저 콘솔 오류 메시지
  4. 사용 중인 브라우저와 버전
  5. PHP 버전 및 서버 환경

9.3 시스템 정보 수집

문제 해결을 위해 다음 정보를 제공해주세요:

// 브라우저 개발자 도구에서 실행하여 시스템 정보 수집 testSystem(); // 결과를 복사하여 문의 시 첨부

9.4 버전 정보

항목정보
시스템 버전v1.0.0
최초 릴리스2025년 6월 2일
최종 업데이트2025년 6월 3일
호환 그누보드5.4 이상
개발 언어PHP 7.3+, JavaScript ES6+, HTML5, CSS3

9.5 라이선스

이 근태관리 시스템은 그누보드 기반으로 개발되었으며, GPL 라이선스를 따릅니다. 상업적 사용 시에는 별도 라이선스가 필요할 수 있습니다.

✅ 지속적인 업데이트
시스템은 지속적으로 업데이트됩니다. 새로운 기능이나 보안 패치가 있을 때 공지사항을 확인하세요.

부록. 단축키 및 고급 기능

키보드 단축키 (보고서 페이지)

개발자 도구 명령어

// 근태관리 시스템 전용 JavaScript 명령어들 // 시스템 상태 테스트 testSystem() // 출근 모달 강제 표시 showCheckInModal() // 퇴근 모달 강제 표시 showCheckOutModal() // 강제 퇴근 처리 (디버그용) forceCheckOut() // 시스템 디버그 정보 debugAttendanceSystem() // 데이터 새로고침 refreshData() // 버튼 이벤트 재설정 resetButtonEvents()

데이터베이스 테이블 구조

설치 시 생성되는 주요 테이블들:

근태관리 시스템 v1.0.0 사용자 매뉴얼

© 2025 근태관리 시스템. 이 매뉴얼은 사용자 편의를 위해 제작되었습니다.

최종 업데이트: 2025년 6월 3일

🔄 페이지 새로고침
↑
단축키기능
Ctrl + R현재 보고서 새로고침
Ctrl + P보고서 인쇄
Ctrl + ECSV 내보내기
Esc모달 창 닫기