Skip to content

trustspirit/checkin

Repository files navigation

CheckIn 앱 시작하기

참가자 체크인 관리를 위한 간편한 데스크톱 앱입니다.


목차

  1. 앱 설치하기
  2. Firebase 데이터베이스 설정
  3. 앱 초기 설정
  4. 기능별 사용법
  5. Key Generator 웹사이트 ⭐ NEW
  6. 자주 묻는 질문

1. 앱 설치하기

Windows

  1. CheckIn Setup 1.0.0.exe 파일을 다운로드합니다
  2. 다운로드한 파일을 더블클릭하여 실행합니다
  3. 설치 마법사의 안내에 따라 설치를 완료합니다
  4. 바탕화면 또는 시작 메뉴에서 CheckIn 앱을 실행합니다

macOS

  1. CheckIn-1.0.0.dmg 파일을 다운로드합니다
  2. DMG 파일을 더블클릭하여 엽니다
  3. CheckIn 앱을 Applications 폴더로 드래그합니다
  4. Launchpad 또는 Applications 폴더에서 앱을 실행합니다

⚠️ macOS 보안 경고: "확인되지 않은 개발자" 경고가 표시되면:

  1. 시스템 설정 > 개인정보 보호 및 보안으로 이동
  2. "CheckIn 앱이 차단되었습니다" 옆의 확인 없이 열기 클릭

Linux

  1. CheckIn-1.0.0.AppImage 파일을 다운로드합니다
  2. 파일에 실행 권한을 부여합니다: chmod +x CheckIn-1.0.0.AppImage
  3. 파일을 더블클릭하거나 터미널에서 실행합니다

2. Firebase 데이터베이스 설정

CheckIn 앱은 Firebase Firestore를 데이터베이스로 사용합니다. 아래 단계를 따라 무료로 설정할 수 있습니다.

2.1 Firebase 프로젝트 만들기

  1. Firebase Console에 접속합니다
  2. Google 계정으로 로그인합니다
  3. 프로젝트 추가 버튼을 클릭합니다
  4. 프로젝트 이름을 입력합니다 (예: my-checkin-app)
  5. Google 애널리틱스는 비활성화해도 됩니다
  6. 프로젝트 만들기를 클릭하고 완료될 때까지 기다립니다

2.2 Firestore 데이터베이스 활성화

  1. 왼쪽 메뉴에서 빌드 > Firestore Database 클릭
  2. 데이터베이스 만들기 버튼 클릭
  3. 위치 선택: asia-northeast3 (서울) 권장
  4. 보안 규칙: 테스트 모드에서 시작 선택
  5. 만들기 클릭

⚠️ 중요: 테스트 모드는 30일 후 만료됩니다. 프로덕션 사용 시 보안 규칙을 설정해야 합니다.

2.3 설정 파일 다운로드

  1. 프로젝트 개요 페이지로 이동 (왼쪽 상단 홈 아이콘)
  2. 프로젝트 설정 (톱니바퀴 아이콘) 클릭
  3. 일반 탭에서 아래로 스크롤하여 내 앱 섹션 찾기
  4. </> (웹) 아이콘 클릭
  5. 앱 닉네임 입력 (예: checkin-web)
  6. 앱 등록 클릭
  7. 표시되는 firebaseConfig 객체를 복사합니다:
const firebaseConfig = {
  apiKey: "AIzaSy...",
  authDomain: "my-checkin-app.firebaseapp.com",
  projectId: "my-checkin-app",
  storageBucket: "my-checkin-app.appspot.com",
  messagingSenderId: "123456789",
  appId: "1:123456789:web:abc123"
};
  1. 메모장이나 텍스트 편집기를 열고 아래 형식으로 저장합니다:
{
  "apiKey": "AIzaSy...",
  "authDomain": "my-checkin-app.firebaseapp.com",
  "projectId": "my-checkin-app",
  "storageBucket": "my-checkin-app.appspot.com",
  "messagingSenderId": "123456789",
  "appId": "1:123456789:web:abc123"
}
  1. 파일을 firebase-config.json으로 저장합니다

3. 앱 초기 설정

3.1 Firebase 연결하기

  1. CheckIn 앱을 실행합니다
  2. 왼쪽 사이드바에서 ⚙️ Settings 클릭
  3. Database Configuration 섹션에서 Import Config File 클릭
  4. 위에서 저장한 firebase-config.json 파일 선택
  5. 연결 성공 시 ✅ Connected 상태가 표시됩니다

3.2 사용자 선택

앱을 실행할 때마다 사용자 선택 화면이 나타납니다. 이 기능은 여러 명이 같은 앱을 사용할 때 누가 어떤 작업을 했는지 추적하기 위함입니다.

기존 사용자 선택하기

이전에 사용한 적이 있다면 저장된 사용자 목록에서 선택할 수 있습니다:

  1. 목록에서 본인 이름을 클릭합니다
  2. 바로 앱이 시작됩니다

새 사용자 추가하기

처음 사용하거나 새 사용자를 추가하려면:

  1. + 새 사용자 추가 버튼 클릭
  2. 본인의 이름을 입력합니다
  3. 계속 버튼 클릭
  4. 이름이 저장되고 앱이 시작됩니다

사용자 삭제하기

더 이상 사용하지 않는 사용자를 삭제하려면:

  1. 삭제할 사용자에 마우스를 올립니다
  2. 오른쪽에 나타나는 × 버튼 클릭
  3. 사용자가 목록에서 제거됩니다

💡 : 사용자 목록은 Firebase 데이터베이스에 저장됩니다. 같은 데이터베이스를 사용하는 모든 기기에서 동일한 사용자 목록을 공유합니다.

💡 중요: 선택한 사용자 이름은 모든 변경 이력(Audit Log)에 기록됩니다. 여러 명이 같은 데이터베이스를 사용할 때, 각자 다른 이름으로 로그인하면 누가 어떤 변경을 했는지 추적할 수 있습니다.

사용자 전환하기

앱 사용 중에 다른 사용자로 전환하려면:

  1. ⚙️ Settings 페이지로 이동
  2. 현재 사용자 섹션에서 사용자 전환 버튼 클릭
  3. 사용자 선택 화면으로 돌아갑니다

3.3 언어 설정

앱은 한국어와 영어를 지원합니다. 기본 언어는 한국어입니다.

  1. ⚙️ Settings 페이지로 이동
  2. 언어 섹션에서 원하는 언어 선택:
    • 🇰🇷 한국어 - 한국어 인터페이스
    • 🇺🇸 English - 영어 인터페이스
  3. 언어 변경 즉시 적용됩니다

💡 : 언어 설정은 브라우저에 저장되어 다음 실행 시에도 유지됩니다.


4. 기능별 사용법

4.1 참가자 검색 및 체크인

홈 화면에서 참가자를 빠르게 찾고 체크인/체크아웃할 수 있습니다.

참가자 검색하기

  1. 검색창에 이름, 이메일, 또는 전화번호 입력
  2. 고유 키 (8자리 대문자+숫자)로도 검색 가능 ⭐ NEW
  3. 입력과 동시에 검색 결과가 표시됩니다
  4. 원하는 참가자를 클릭하면 상세 페이지로 이동

QR 코드로 체크인 ⭐ NEW

  1. QR 코드로 체크인 버튼 클릭
  2. 카메라로 참가자의 QR 코드 스캔
  3. 참가자 정보가 표시되면 Check In 버튼 클릭

빠른 체크인

  1. 검색 결과에서 참가자 찾기
  2. 오른쪽의 Check In 버튼 클릭
  3. 체크인 완료! (초록색 상태 표시)

빠른 체크아웃

  1. 이미 체크인된 참가자 검색
  2. Check Out 버튼 클릭
  3. 체크아웃 완료!

4.2 참가자 관리

왼쪽 사이드바에서 👥 Participants를 클릭합니다.

참가자 목록 보기

전체 참가자 목록이 표시됩니다. 다음 기능을 사용할 수 있습니다:

기능 설명
필터 전체 / 체크인됨 / 체크인 안됨
검색 이름, 이메일, 전화번호, 와드, 스테이크로 검색
정렬 각 열 헤더 클릭으로 정렬
보기 모드 📋 리스트 / 📱 그리드 전환

새 참가자 추가하기

  1. Add Participant 버튼 클릭
  2. 정보 입력:
    • 이름 (필수)
    • 이메일 (필수)
    • 전화번호, 성별, 나이, 와드, 스테이크 (선택)
  3. 그룹/객실 배정 (선택)
  4. Add Participant 클릭

여러 참가자 일괄 배정

  1. 각 참가자 왼쪽의 체크박스 선택
  2. 상단에 나타나는 Move to Group 또는 Move to Room 클릭
  3. 대상 그룹/객실 선택
  4. 일괄 배정 완료!

데이터 내보내기 (Export)

참가자, 그룹, 객실 데이터를 CSV 파일로 내보낼 수 있습니다.

  1. Export 버튼 클릭
  2. 내보내기 옵션 선택:
옵션 설명
Participants (Current View) 현재 필터링된 참가자만 내보내기
All Participants 전체 참가자 내보내기
With Check-in History 체크인/아웃 이력 포함 내보내기
Check-in Summary 체크인 현황 요약 내보내기
Groups 전체 그룹 내보내기
Rooms 전체 객실 내보내기
  1. CSV 파일이 자동으로 다운로드됩니다
  2. Excel, Google Sheets 등에서 열 수 있습니다

4.3 참가자 상세 정보

참가자를 클릭하면 상세 페이지로 이동합니다.

정보 수정하기

  1. 오른쪽 상단의 Edit 버튼 클릭
  2. 원하는 정보 수정
  3. Save 버튼으로 저장 또는 Cancel로 취소

결제 상태 빠르게 변경

Edit 모드 없이 바로 결제 상태를 변경할 수 있습니다:

  1. Payment Status 섹션의 Paid/Unpaid 버튼 클릭
  2. 확인 팝업에서 Mark as Paid (또는 Unpaid) 클릭
  3. 즉시 반영됩니다!

메모 추가/수정

Edit 모드 없이 바로 메모를 작성할 수 있습니다:

  1. Memo 섹션의 Add memo 또는 Edit 클릭
  2. 내용 입력
  3. Save 클릭

그룹/객실 배정 변경

  1. Group 또는 Room 섹션에서 Assign (또는 Change) 클릭
  2. 기존 목록에서 선택 또는 새로 생성
  3. 자동 저장됩니다

체크인/체크아웃 이력

페이지 하단에서 모든 체크인/체크아웃 기록을 확인할 수 있습니다:

  • 📅 각 세션의 체크인/체크아웃 시간
  • ⏱️ 체류 시간 (Duration)
  • 🟢 현재 활성 세션 표시

4.4 그룹 관리

왼쪽 사이드바에서 👨‍👩‍👧‍👦 Groups를 클릭합니다.

그룹 목록

  • 모든 그룹과 현재 인원/예상 인원 표시
  • 태그가 있는 경우 색상 배지로 표시
  • 클릭하면 그룹 상세 페이지로 이동
  • 마우스 오버 시 그룹 멤버 미리보기

새 그룹 만들기

  1. 그룹 추가 버튼 클릭
  2. 그룹 이름 입력 (필수)
  3. 예상 인원 입력 (선택)
  4. 태그 추가 (선택):
    • 기본 태그: 남성/여성 버튼 클릭으로 선택
    • 커스텀 태그: 직접 입력 후 + 버튼 클릭
  5. 추가 클릭

그룹 태그 시스템

그룹에 태그를 달아 분류하고 필터링할 수 있습니다.

태그 유형 설명 색상
🔵 남성 (male) 남성 그룹 파란색 배지
🩷 여성 (female) 여성 그룹 분홍색 배지
⚪ 커스텀 직접 입력한 태그 회색 배지

태그 활용 예시:

  • male - 남성 그룹
  • female - 여성 그룹
  • youth - 청소년 그룹
  • family - 가족 그룹
  • staff - 스태프 그룹

그룹 필터링 및 정렬

그룹 목록 상단의 필터/정렬 바를 사용합니다:

필터링:

  • 태그 필터: 특정 태그가 있는 그룹만 표시
    • 전체 태그 / 남성 / 여성 / 커스텀 태그

정렬:

정렬 기준 설명
이름 그룹 이름 가나다순
인원수 참가자 수 기준
태그 첫 번째 태그 기준
  • ↑/↓ 버튼: 오름차순/내림차순 전환
  • 초기화 버튼: 모든 필터/정렬 해제

그룹 CSV 가져오기

여러 그룹을 한 번에 추가할 수 있습니다:

  1. Import CSV 버튼 클릭
  2. CSV 형식으로 입력:
    그룹이름,태그
    1조,male
    2조,female
    스태프팀,staff;male
    
  3. 여러 태그는 ; 또는 |로 구분

그룹 명단 인쇄 ⭐ NEW

그룹 멤버 목록을 인쇄할 수 있습니다:

  1. 명단 인쇄 버튼 클릭
  2. 새 창에서 인쇄 미리보기 확인
  3. 브라우저 인쇄 기능으로 인쇄 또는 PDF 저장

그룹 상세 페이지

  • 그룹에 속한 참가자 목록 확인
  • 그룹 이름/예상 인원/태그 수정
  • 참가자를 그룹에서 제거 또는 다른 그룹으로 이동
  • 그룹 삭제 (참가자는 미배정 상태로 변경)
  • 뒤로가기 버튼으로 이전 페이지로 돌아가기

그룹 리더 설정 ⭐ NEW

그룹에 리더를 지정하여 책임자를 명확히 할 수 있습니다.

리더 설정 방법:

  1. 그룹 상세 페이지에서 참가자 목록 확인
  2. 리더로 지정할 참가자의 리더 지정 버튼 클릭
  3. 확인 팝업에서 확인 클릭
  4. ⭐ 아이콘으로 리더 표시

빠른 리더 변경 (호버 카드):

  1. 그룹 목록에서 그룹에 마우스 호버
  2. 호버 카드에서 리더 정보 확인
  3. 다른 멤버를 클릭하여 리더 변경
  4. 리더 해제 버튼으로 리더 해제

💡 : 리더는 홈 검색 결과와 참가자 상세 페이지에서도 표시됩니다.


4.5 객실 관리

왼쪽 사이드바에서 🚪 Rooms를 클릭합니다.

객실 목록

각 객실의 수용 현황이 색상으로 표시됩니다:

색상 상태
🟢 초록 여유 있음
🟡 노랑 거의 참 (75% 이상)
🔴 빨강 만실

추가로 객실 유형 정보가 배지로 표시됩니다:

  • 성별 유형 (남성/여성/혼성)
  • 객실 유형 (게스트/리더십)

새 객실 만들기

  1. 객실 추가 버튼 클릭
  2. 객실 번호 입력 (예: 101, A동 201)
  3. 최대 수용 인원 입력
  4. 성별 유형 선택 (선택):
성별 유형 설명 색상
🔵 남성 (Male) 남성 전용 객실 파란색
🩷 여성 (Female) 여성 전용 객실 분홍색
🟣 혼성 (Mixed) 혼성 객실 보라색
  1. 객실 유형 선택 (선택):
객실 유형 설명 색상
일반 (General) 일반 참가자용 (표시 안됨)
🟡 게스트 (Guest) 외부 게스트용 황색
🟢 리더십 (Leadership) 리더/스태프용 초록색
  1. 추가 클릭

객실 필터링 및 정렬

객실 목록 상단의 필터/정렬 바를 사용합니다:

필터링:

  • 성별 유형: 전체 / 남성 / 여성 / 혼성
  • 객실 유형: 전체 / 일반 / 게스트 / 리더십

정렬:

정렬 기준 설명
객실 번호 호수 기준 (숫자 인식)
성별 유형 성별 유형별 그룹화
객실 유형 객실 유형별 그룹화
수용률 현재 수용률 기준
  • ↑/↓ 버튼: 오름차순/내림차순 전환
  • 초기화 버튼: 모든 필터/정렬 해제

💡 활용 팁: "성별 유형: 남성" + "정렬: 수용률 ↑"로 설정하면 여유 있는 남성 객실을 빠르게 찾을 수 있습니다.

객실 배정표 인쇄 ⭐ NEW

객실 배정 현황을 인쇄할 수 있습니다:

  1. 배정표 인쇄 버튼 클릭
  2. 새 창에서 인쇄 미리보기 확인
  3. 브라우저 인쇄 기능으로 인쇄 또는 PDF 저장

객실 CSV 가져오기

여러 객실을 한 번에 추가할 수 있습니다:

  1. Import CSV 버튼 클릭
  2. CSV 형식으로 입력:
    객실번호,최대인원,성별유형,객실유형
    101,4,male,general
    102,4,female,general
    201,2,mixed,guest
    301,2,male,leadership
    
  3. 성별 유형: male, female, mixed (또는 한글: 남성, 여성, 혼성)
  4. 객실 유형: general, guest, leadership (또는 한글: 일반, 게스트, 리더십)

객실 상세 페이지

  • 객실에 배정된 참가자 목록
  • 객실 번호/최대 인원/성별 유형/객실 유형 수정
  • 참가자를 객실에서 제거 또는 다른 객실로 이동
  • 객실 삭제
  • 뒤로가기 버튼으로 이전 페이지로 돌아가기

방장 설정 ⭐ NEW

객실에 방장을 지정하여 책임자를 명확히 할 수 있습니다.

방장 설정 방법:

  1. 객실 상세 페이지에서 참가자 목록 확인
  2. 방장으로 지정할 참가자의 방장 지정 버튼 클릭
  3. 확인 팝업에서 확인 클릭
  4. 👑 아이콘으로 방장 표시

빠른 방장 변경 (호버 카드):

  1. 객실 목록에서 객실에 마우스 호버
  2. 호버 카드에서 방장 정보 확인
  3. 다른 멤버를 클릭하여 방장 변경
  4. 방장 해제 버튼으로 방장 해제

💡 : 방장은 홈 검색 결과와 참가자 상세 페이지에서도 표시됩니다.


4.6 버스 관리 ⭐ NEW

왼쪽 사이드바에서 🚌 Buses를 클릭합니다.

버스 목록

버스 관리 페이지에서 두 가지 보기 모드를 지원합니다:

보기 모드 설명
타임라인 뷰 (기본) 도착 시간 순으로 버스 정렬
📍 지역별 뷰 출발 지역별로 버스 그룹화

페이지 상단에 요약 카드가 표시됩니다:

  • 🚌 총 버스 수 (도착 완료 포함)
  • 👥 총 승객 수
  • 📍 출발 지역 수

새 버스 추가하기

  1. 버스 추가 버튼 클릭
  2. 필수 정보 입력:
    • 버스 이름 (예: 1호차, 서울버스)
    • 지역 (예: 서울, 부산)
  3. 선택 정보 입력:
    • 출발 장소, 도착 예정 시간
    • 인솔자 이름, 인솔자 연락처
    • 메모
  4. 추가 클릭

💡 : 전화번호는 자동으로 010-0000-0000 형식으로 포맷됩니다.

버스 도착 표시

버스가 도착하면 상태를 표시할 수 있습니다:

  1. 버스 목록에서 도착 표시 버튼 클릭
  2. 확인 팝업에서 확인 클릭
  3. 버스가 초록색으로 표시되고 도착 시간 기록

도착한 버스 관리:

  • 도착 취소 버튼으로 미도착 상태로 변경
  • 도착한 버스 숨기기 토글로 미도착 버스만 표시

버스 상세 페이지

버스를 클릭하면 상세 페이지로 이동합니다:

버스 정보:

  • 버스 이름, 지역, 출발 장소
  • 도착 예정 시간, 인솔자 정보
  • 현재 승객 수, 도착 상태

승객 관리:

  • 버스에 배정된 참가자 목록
  • 여러 승객 선택 후 다른 버스로 이동
  • 개별 승객 버스에서 제거

버스 배치표 인쇄

버스 승객 명단을 인쇄할 수 있습니다:

  1. 배치표 인쇄 버튼 클릭 (버스 목록 또는 상세 페이지)
  2. 새 창에서 인쇄 미리보기 확인
  3. 브라우저 인쇄 기능으로 인쇄 또는 PDF 저장

4.7 CSV로 참가자 가져오기

Excel이나 스프레드시트에서 만든 참가자 목록을 한 번에 가져올 수 있습니다.

CSV 파일 준비하기

  1. Excel 또는 Google Sheets에서 참가자 목록 작성
  2. 첫 번째 행에 열 이름 입력:
name email gender age stake ward phoneNumber groupName roomNumber
홍길동 hong@email.com male 25 서울스테이크 강남와드 010-1234-5678 1조 101
김철수 kim@email.com male 30 서울스테이크 서초와드 010-2345-6789 1조 101
  1. CSV 형식으로 저장 (파일 > 다른 이름으로 저장 > CSV)

필수/선택 필드

필드 설명 필수
name 이름
email 이메일
gender 성별 (male/female)
age 나이
birthDate 생년월일 (YYYY-MM-DD) ⭐ NEW
stake 스테이크
ward 와드
phoneNumber 전화번호
groupName 그룹명 (없으면 자동 생성)
roomNumber 객실 번호 (없으면 자동 생성)

💡 : birthDate를 입력하면 참가자별 고유 키가 자동 생성되어 빠른 검색이 가능합니다.

가져오기 방법

  1. 왼쪽 사이드바에서 📥 Import 클릭
  2. Select CSV File 버튼 클릭
  3. 준비한 CSV 파일 선택
  4. 미리보기에서 데이터 확인
  5. 필드 매핑이 올바른지 확인
  6. Import 버튼 클릭
  7. 결과 확인:
    • ✅ 새로 생성된 참가자 수
    • 🔄 업데이트된 참가자 수 (이메일이 같으면 업데이트)

4.8 인쇄 기능 ⭐ NEW

그룹 명단, 객실 배정표, 버스 배치표를 인쇄할 수 있습니다.

인쇄 방법

대상 페이지 버튼
📋 그룹 명단 Groups 명단 인쇄
🚪 객실 배정표 Rooms 배정표 인쇄
🚌 버스 배치표 Buses 배치표 인쇄
  1. 해당 페이지로 이동
  2. 인쇄 버튼 클릭
  3. 새 창에서 인쇄용 미리보기 확인
  4. 브라우저 인쇄 기능 사용 (Ctrl+P 또는 Cmd+P)
  5. 프린터 또는 PDF로 저장

인쇄 내용

그룹 명단:

  • 그룹별 참가자 목록
  • 참가자 이름, 와드, 연락처
  • 그룹 리더 표시 (⭐)

객실 배정표:

  • 객실별 배정 현황
  • 객실 번호, 성별 유형, 수용률
  • 방장 표시 (👑)

버스 배치표:

  • 버스별 승객 명단
  • 버스 정보 (지역, 출발 장소, 인솔자)
  • 도착 예정 시간

💡 : 버스 상세 페이지에서 개별 버스만 인쇄할 수도 있습니다.


4.9 통계 보기

상단 네비게이션 바에서 📊 Statistics를 클릭합니다.

한눈에 보는 요약 카드

페이지 상단에 4개의 요약 카드가 표시됩니다:

카드 내용
📋 Total Registered 전체 등록 인원 수
Currently Checked In 현재 체크인된 인원 수와 비율
🏠 Room Occupancy 객실 수용 현황 (현재/최대)
💳 Payment Status 결제 완료/미완료 인원 수

차트로 보는 통계

원형 차트 (도넛):

차트 설명
Check-in Status 체크인됨 vs 미체크인 비율
Gender Distribution 남성/여성/기타/미지정 분포
Payment Status 결제 완료 vs 미결제 비율

막대 차트:

차트 설명
Registration vs Check-in by Gender 성별 등록 인원 대비 체크인 인원 비교
Top 5 Groups 참가자가 가장 많은 상위 5개 그룹

선 차트:

차트 설명
Daily Check-in/Check-out 최근 7일간 일별 체크인/체크아웃 추이

상세 통계 테이블

페이지 하단에서 상세 통계를 표로 확인할 수 있습니다:

  • 전체/남성/여성별 등록 수
  • 전체/남성/여성별 체크인 수
  • 각 카테고리별 체크인 비율 (%)
  • 그룹 수 및 객실 수용 현황

💡 : 통계는 실시간으로 업데이트됩니다. 체크인/체크아웃이 발생하면 즉시 차트에 반영됩니다.

PDF로 통계 내보내기

통계 자료를 PDF 파일로 저장할 수 있습니다.

  1. Export PDF 버튼 클릭 (페이지 우측 상단)
  2. 잠시 기다리면 PDF 파일이 자동으로 다운로드됩니다
  3. 파일명: CheckIn_Statistics_2026-01-13.pdf (오늘 날짜)

PDF에 포함되는 내용:

  • 📊 요약 카드 (등록 인원, 체크인 현황, 객실, 결제)
  • 🍩 원형 차트 (체크인 상태, 성별 분포, 결제 상태)
  • 📊 막대 차트 (성별 체크인 비교, 상위 그룹)
  • 📈 선 차트 (7일간 체크인/아웃 추이)
  • 📋 상세 통계 테이블

💡 활용 팁: 일일/주간 보고서로 활용하거나, 이벤트 종료 후 최종 통계 자료로 보관하세요.


4.10 변경 이력 확인

왼쪽 사이드바에서 📋 Audit Log를 클릭합니다.

기록되는 내용

모든 변경 사항이 자동으로 기록됩니다:

아이콘 작업 설명
🟢 Created 새로 생성됨
🔵 Updated 정보 수정됨
🔴 Deleted 삭제됨
🔵 Checked In 체크인됨
🟠 Checked Out 체크아웃됨
🟣 Assigned 그룹/객실 배정됨
🟢 Imported CSV로 가져옴

변경 이력 보기

  • 실시간 업데이트: 다른 사용자의 변경도 즉시 반영
  • 필터: 참가자/그룹/객실 별로 필터링
  • 상세 내용: 무엇이 어떻게 바뀌었는지 확인 가능

이력 삭제

  1. Clear All 버튼 클릭
  2. 확인 팝업에서 확인 클릭
  3. 모든 이력이 삭제됩니다

⚠️ 삭제된 이력은 복구할 수 없습니다.


4.11 고유 키 및 QR 코드 ⭐ NEW

참가자별로 고유한 8자리 키를 생성하여 빠른 검색과 체크인에 활용할 수 있습니다.

고유 키란?

  • 형식: 8자리 대문자 + 숫자 조합 (예: A7K2X9BM)
  • 생성 조건: 이름과 생년월일이 등록된 참가자만
  • 특징: 같은 정보로 항상 같은 키 생성

참가자 상세 페이지에서 확인

  1. 참가자 상세 페이지로 이동
  2. QR 코드 섹션에서 고유 키 확인
  3. 생년월일이 없으면 "생년월일을 입력하세요" 메시지 표시

생년월일 등록 방법

개별 등록:

  1. 참가자 상세 페이지에서 Edit 클릭
  2. 생년월일 필드에 날짜 선택
  3. Save 클릭

CSV 가져오기:

name,email,birthDate
홍길동,hong@email.com,1990-05-15

고유 키로 검색

  1. 홈 화면 검색창에 8자리 키 입력 (예: A7K2X9BM)
  2. 해당 참가자가 검색됨

QR 코드 스캔으로 체크인

  1. QR 코드로 체크인 버튼 클릭
  2. Key Generator에서 발급받은 QR 코드 스캔
  3. 참가자가 자동으로 검색됨
  4. Check In 버튼으로 체크인

5. Key Generator 웹사이트 ⭐ NEW

별도의 웹사이트에서 참가자가 직접 자신의 QR 코드를 발급받을 수 있습니다.

5.1 용도

  • 사전 등록 시 참가자에게 개별 QR 코드 발급
  • 명찰이나 참가증에 QR 코드 부착
  • 현장에서 빠른 체크인 지원

5.2 사용 방법

  1. Key Generator 웹사이트 접속
  2. 정보 입력:
    • 성 (Last Name): 예) 홍
    • 이름 (First Name): 예) 길동
    • 생년월일: 날짜 선택
  3. 키 생성하기 버튼 클릭
  4. 팝업으로 QR 코드가 표시됨

5.3 QR 코드 활용

팝업에서 제공하는 기능:

  • 📋 키 복사: 8자리 고유 키를 클립보드에 복사
  • 📥 QR 다운로드: QR 코드 이미지(PNG) 다운로드

5.4 CheckIn 앱과 연동 방법

  1. 참가자 등록: CheckIn 앱에 동일한 이름과 생년월일로 참가자 등록
  2. QR 발급: 참가자가 Key Generator에서 QR 코드 발급
  3. 체크인: CheckIn 앱에서 QR 스캔 시 참가자 자동 검색

⚠️ 중요: CheckIn 앱과 Key Generator의 정보(이름, 생년월일)가 일치해야 검색됩니다.


6. 자주 묻는 질문

Q: 앱을 열었는데 데이터가 안 보여요

A: Firebase 설정이 필요합니다.

  1. Settings > Import Config File로 설정 파일을 가져오세요
  2. "Connected" 상태가 표시되는지 확인하세요

Q: 다른 컴퓨터에서도 같은 데이터를 볼 수 있나요?

A: 네! 같은 Firebase 설정 파일을 사용하면 모든 기기에서 동일한 데이터를 공유합니다.

Q: 인터넷 연결이 끊기면 어떻게 되나요?

A: 인터넷 연결이 필요합니다. 연결이 끊기면 데이터 조회/저장이 되지 않습니다.

Q: CSV 파일을 가져왔는데 일부 참가자가 업데이트됐어요

A: 이메일이 같은 참가자가 이미 있으면 정보가 업데이트됩니다. 새로 추가하려면 다른 이메일을 사용하세요.

Q: 실수로 참가자를 삭제했어요. 복구할 수 있나요?

A: 현재 버전에서는 삭제된 데이터를 복구할 수 없습니다. 중요한 데이터는 정기적으로 백업하세요.

Q: 체크인 이력은 얼마나 보관되나요?

A: 모든 체크인/체크아웃 이력은 참가자 데이터와 함께 영구 보관됩니다.

Q: 여러 명이 동시에 사용할 수 있나요?

A: 네! 실시간 동기화가 되어 여러 명이 동시에 사용할 수 있습니다. 한 사람이 변경하면 다른 사람에게도 즉시 반영됩니다.

Q: 사용자 이름을 변경하고 싶어요

A: Settings 페이지에서 "사용자 전환" 버튼을 클릭하면 사용자 선택 화면으로 돌아갑니다. 새 이름을 추가하거나 기존 사용자를 선택할 수 있습니다.

Q: 앱을 켤 때마다 사용자를 선택해야 하나요?

A: 네, 보안과 변경 이력 추적을 위해 앱을 실행할 때마다 사용자를 선택해야 합니다. 한 번 클릭으로 간편하게 선택할 수 있습니다.

Q: 사용자 목록이 다른 컴퓨터에서도 보이나요?

A: 네! 사용자 목록은 Firebase 데이터베이스에 저장되므로, 같은 Firebase 설정을 사용하는 모든 기기에서 동일한 사용자 목록을 볼 수 있습니다.

Q: 사용자를 삭제하면 그 사용자의 변경 이력도 삭제되나요?

A: 아니요, 변경 이력(Audit Log)은 그대로 유지됩니다. 사용자 목록에서만 제거됩니다.

Q: 그룹에 태그를 여러 개 달 수 있나요?

A: 네! 기본 태그(남성/여성)와 커스텀 태그를 조합해서 여러 개 추가할 수 있습니다. 예: male, youth, staff 모두 달기 가능.

Q: 객실의 성별 유형과 객실 유형의 차이가 뭔가요?

A:

  • 성별 유형: 객실에 배정될 참가자의 성별을 구분합니다 (남성/여성/혼성)
  • 객실 유형: 객실의 용도를 구분합니다 (일반/게스트/리더십)

두 가지 유형을 조합해서 "남성 리더십 객실", "여성 게스트 객실" 등으로 관리할 수 있습니다.

Q: 필터를 적용하면 내보내기(Export)에도 영향을 주나요?

A: Participants 페이지에서 "Participants (Current View)"를 선택하면 현재 필터링된 결과만 내보내집니다. "All Participants"를 선택하면 필터와 관계없이 전체 데이터가 내보내집니다.

Q: 리스트 뷰와 카드 뷰의 차이는 뭔가요?

A:

  • 리스트 뷰 (📋): 표 형식으로 많은 정보를 한눈에 볼 수 있습니다
  • 카드 뷰 (🃏): 카드 형식으로 시각적으로 보기 좋습니다

오른쪽 상단의 뷰 모드 토글 버튼으로 언제든 전환할 수 있습니다.

Q: 버스 관리는 어떻게 사용하나요? ⭐ NEW

A: 버스 관리 기능으로 참가자들의 버스 배정을 관리할 수 있습니다:

  1. Buses 페이지에서 버스를 추가합니다
  2. 참가자 상세 페이지에서 버스를 배정합니다
  3. 버스가 도착하면 "도착 표시" 버튼으로 상태를 업데이트합니다
  4. 버스 배치표를 인쇄하여 인솔자에게 전달할 수 있습니다

Q: 그룹 리더나 방장은 어떻게 설정하나요? ⭐ NEW

A: 그룹 또는 객실 상세 페이지에서 설정할 수 있습니다:

  1. 해당 그룹/객실 상세 페이지로 이동
  2. 참가자 목록에서 "리더 지정" 또는 "방장 지정" 버튼 클릭
  3. 확인 팝업에서 확인

또는 목록 페이지에서 호버 카드를 통해 빠르게 변경할 수도 있습니다.

Q: 인쇄 기능이 작동하지 않아요

A: 인쇄 기능은 새 창을 열어 인쇄용 페이지를 표시합니다:

  1. 팝업 차단이 활성화되어 있다면 허용해주세요
  2. 새 창이 열리면 브라우저의 인쇄 기능(Ctrl+P 또는 Cmd+P)을 사용하세요
  3. 프린터로 인쇄하거나 PDF로 저장할 수 있습니다

Q: 버스 도착 상태는 자동으로 업데이트되나요?

A: 아니요, 버스 도착 상태는 수동으로 업데이트해야 합니다. 버스가 도착하면 "도착 표시" 버튼을 클릭하여 상태를 변경하세요. 실수로 표시한 경우 "도착 취소" 버튼으로 되돌릴 수 있습니다.

Q: 고유 키가 표시되지 않아요 ⭐ NEW

A: 고유 키는 생년월일이 등록된 참가자만 생성됩니다:

  1. 참가자 상세 페이지에서 Edit 클릭
  2. 생년월일 필드에 날짜 입력
  3. Save 클릭
  4. 고유 키가 자동으로 생성됩니다

Q: Key Generator에서 만든 QR 코드가 스캔되지 않아요 ⭐ NEW

A: 다음 사항을 확인해주세요:

  1. CheckIn 앱에 참가자가 등록되어 있는지 확인
  2. 참가자의 이름생년월일이 Key Generator에 입력한 것과 정확히 일치하는지 확인
  3. 한글 이름의 경우, 성과 이름이 올바르게 입력되었는지 확인

💡 : 같은 정보(성, 이름, 생년월일)를 입력하면 항상 같은 키가 생성됩니다.

Q: 고유 키와 QR 코드의 차이점은 뭔가요? ⭐ NEW

A:

  • 고유 키: 8자리 대문자+숫자 조합 (예: A7K2X9BM). 검색창에 직접 입력 가능.
  • QR 코드: 고유 키 정보가 담긴 이미지. 스마트폰이나 QR 스캐너로 스캔 가능.

두 가지 모두 같은 참가자를 찾는 데 사용됩니다.


도움이 필요하신가요?

추가 질문이나 문제가 있으시면 관리자에게 문의해 주세요.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages