🏸 클럽 회원관리 앱 통합 사용 설명서
탁구·배드민턴·테니스 등 체육 시설의 회원·레슨·회비·리그전을 한곳에서 관리하는 올인원 웹 앱입니다.
PWA로 모바일에서도 앱처럼 사용할 수 있습니다.
01. 개요 · 기능 요약
🎯 올인원 클럽 관리
탁구클럽, 배드민턴클럽, 테니스클럽 등 체육시설의 회원 관리, 레슨 관리, 회비 관리, 리그전을 위한 올인원 웹 애플리케이션입니다. PWA 기술로 제작되어 별도 앱 설치 없이 모바일에서 앱처럼 사용할 수 있습니다.
📊 주요 기능
| 기능 | 설명 |
|---|---|
| 회원 관리 | 등록/수정/삭제, 사진 촬영, 수상경력, 분류(태그) 복수 지정 |
| 레슨 관리 | 일반/불규칙/없음 3단계 시스템, 주간 스케줄 뷰 |
| 스마트 타이머 | 자동 시간 측정, 알림음(기본/차임), Wake Lock 화면 꺼짐 방지 |
| 출석 관리 | 입실/퇴실/재출석, 일별 출석 테이블, 목표 횟수 누적 |
| 회비 관리 | 입금 내역 추가/삭제, 월회비 프리셋 버튼 |
| 입금 통계 | 연도/월별 리포트, 담당자 지정, 내보내기 |
| 권한 시스템 | 관리자/부관리자/일반회원/손님 4단계 |
| 엑셀 연동 | 백업/복원/일괄 등록, DB 백업(SQL) |
| 음성 검색 | 말로 회원 검색 (Chrome·Safari) |
| 일반회원 로그인 | 이름 + 전화번호 끝 4자리, 본인 카드 최상단 |
| 분류·부수 정렬 | 분류별/부수별 그룹·정렬 |
| 개인·팀 리그전 | 대진표, 결과 입력, 실시간 알림판·알림음 |
| 로그인 유지 | 최대 약 30일 세션 유지 |
| 광고/팝업 관리 | 회원 목록 상단 광고 문구, 시작 팝업 (V1.4) |
02. 시작하기 · 로그인
🌐 웹 브라우저 접속
- 출력된 QR 코드나, 기존 설치자의 앱 화면 구장명 클릭시 QR 코드 출력
- PC나 스마트폰 브라우저에서 제공된 URL 입력
- Chrome, Safari, Samsung Internet 등 최신 브라우저 권장
- 별도 로그인 없이도 회원 목록 조회 가능
🤖 안드로이드 (Chrome)
- QR 코드를 스마트폰의 사진기로 비추어 주소가 생성되면 클릭 하거나,
앱 주소로 접속하면 하단에 설치 안내 배너가 표시됩니다. - 설치를 누르면 홈 화면에 아이콘이 추가됩니다.
- 배너가 보이지 않으면 브라우저 메뉴(⋮) > 홈 화면에 추가를 이용하세요.
🍎 아이폰 (Safari)
- QR 코드를 스마트폰의 사진기로 비추어 주소가 생성되면 클릭 하거나,
Safari로 접속 후 하단 공유 아이콘(⬆️)을 누릅니다. - 홈 화면에 추가를 선택합니다.
- 추가된 아이콘으로 실행하면 주소창 없이 앱처럼 사용됩니다.
🔑 로그인하기
- 우측 상단 톱니바퀴(설정) 아이콘 클릭
- 「로그인」 또는 로그인 모달에서 입력
- 계정 유형에 맞게 입력
- 관리자/부관리자: 아이디 + 비밀번호 (기본 관리자:
admin/admin123) - 일반회원: 회원 이름 + 등록된 전화번호 끝 4자리
예)010-1234-5678→ 비밀번호5678
※ 「일반회원 로그인 허용」이 켜진 회원만 가능
- 관리자/부관리자: 아이디 + 비밀번호 (기본 관리자:
- 로그인 상태 유지는 기본 체크. 최대 약 30일 세션 유지·연장
03. 권한 등급 안내
| 기능 | 손님 | 일반회원 | 부관리자 | 관리자 |
|---|---|---|---|---|
| 회원 목록 조회 | ○ | ○ | ○ | ○ |
| 회원 등록/수정/삭제 | 설정 시 | ✕ | 담당 | ○ |
| 레슨·출석 체크 | ✕ | 본인 | 담당 | ○ |
| 대진·리그전 | ✕ | ✕ | ○ | ○ |
| 입금 통계 | ✕ | ✕ | 담당자 | 담당자 |
| 관리자 설정 | ✕ | ✕ | ✕ | ○ |
| 비밀 메모 | ✕ | ✕ | ○ | ○ |
* 관리자가 [일반로그인 회원 등록 허용]을 켜두면 비로그인 상태에서도 회원 등록이 가능합니다.
👑 관리자
모든 회원 관리, 설정 변경, 계정 관리, 백업/복원, 리포트, 비밀 메모 열람이 가능합니다.
🧑💼 부관리자
담당 코치 회원만 등록/수정/삭제·레슨 체크. 설정·계정 관리 불가. 리포트·비밀 메모는 정책에 따라 가능합니다.
🙋 일반회원
이름+전화 끝 4자리 로그인(허용 시). 목록·상세 조회, 본인 카드 최상단, 본인 출석, 본인 사진 수정. 타인 수정/삭제·설정 불가.
👤 손님(비로그인)
회원 목록 조회. 등록은 설정에서 허용 시에만. 수정/삭제·출석·설정·리포트 불가.
회원들의 정보 보호를 위해서 최소한의 정보만 출력 - 이름도 중간자는 O로 출력 (홍O동)
04. 회원 관리
➕ 회원 등록
- 상단 ➕ 회원 등록 폼 헤더를 눌러 폼을 엽니다.
- 이름(필수), 전화번호(숫자만 입력 시 하이픈 자동), 담당 코치, 성별, 생년, 부수, 분류(복수 선택 가능)를 입력합니다.
- 레슨 유형: 📅 일반 레슨 ⚡ 불규칙 레슨 🚫 스케줄 없음
- 일반 레슨은 요일·시작·종료 시간을 최대 7개까지 등록할 수 있습니다. 목표 횟수를
0으로 두면 레슨 관리 대상에서 제외됩니다. - 월회비와 입금 내역(입금일·금액)을 입력합니다. 자주 쓰는 금액은 관리자 설정의 월회비 기본값 버튼으로 한 번에 입력할 수 있습니다.
- 📷 카메라 촬영 또는 🖼️ 갤러리로 사진을 등록합니다. (최대 5MB, 자동 리사이즈)
- 수상경력, 기타 메모, 관리자만 보이는 비밀글(선택)을 입력합니다.
- 하단 등록을 누르면 저장됩니다. 전화번호가 있으면 환영 문자 발송 여부를 물을 수 있습니다.
010-1234-5678 형태로 하이픈(-)이 포함되어 표시됩니다.🔍 검색
- 검색창에 이름 또는 전화번호를 입력하면 즉시 필터링됩니다.
- 🎤 마이크 버튼으로 음성 검색(Chrome·Safari 최신, HTTPS·마이크 권한 필요)
↕️ 정렬
- 이름순 · 등록일순 · 코치별 ·부수별 · 분류별
✏️ 수정 · 삭제
회원 카드를 눌러 정보를 불러온 뒤 수정합니다. 삭제는 상세에서 삭제 아이콘 → 확인 시 영구 삭제됩니다.
🏷️ 분류(카테고리)
아침반 / 오후반 / 저녁반처럼 클럽에서 자유롭게 정의하는 태그입니다. 관리자 설정 > 회원 분류 설정에서 추가·수정하며, 회원 1명에게 여러 개를 동시에 지정할 수 있습니다.
✅ 카드 출석 (입실 / 퇴실 / 재출석)
- 카드에서 입실 체크 → 레슨 후 퇴실 체크
- 같은 날 다시 오면 재출석으로 추가 체크 (횟수 정상 누적)
- 일별 출석 테이블로 하루 여러 회 출석을 확인할 수 있습니다.
🔓 일반회원 로그인 허용
회원 수정 화면에서 「일반회원 로그인 허용」을 켜면, 해당 회원이 이름 + 전화번호 끝 4자리로 로그인할 수 있습니다. 로그인 후 본인 카드가 목록 최상단에 표시되고 본인 출석·사진 수정을 할 수 있습니다.
👤 상세 정보
이름 또는 프로필 사진 클릭 시 상세 카드가 열립니다. (설정에 따라 비로그인 시 제한될 수 있음)
05. 스케줄 · 레슨 타이머
📅 레슨 유형
- 일반 레슨 — 고정 스케줄(요일·시간)
- 불규칙 레슨 — 고정 스케줄 없이 개별 진행 (1~180분 지정 가능)
- 스케줄 없음 — 레슨 관리 대상 제외 (목표 횟수 0)
📅 스케줄 보기
상단 탭에서 스케줄을 선택하면 요일별로 예정된 레슨이 시간순으로 표시됩니다. 레슨 관리 대상 회원(레슨 목표 횟수를 설정한 회원)만 표시됩니다.
⏱️ 레슨 타이머(스탑워치)
- 스케줄에서 회원을 선택하거나 ⏱️ 배지로 타이머 창을 엽니다.
- ▶ 시작으로 타이머를 시작하고, ⏸ 일시정지 / ↺ 초기화로 조절합니다.
- 설정 시간이 끝나면 알림음이 울립니다. 알림음은 기본음 / 알림음 두 가지 중 선택할 수 있습니다.
- 정규 시간이 아닌 임시 레슨(불규칙 레슨)은 ⏱️ 시간 수정으로 1~180분 사이 원하는 시간을 지정할 수 있습니다.
- 레슨이 끝나면 ✅ 레슨 완료 및 체크를 눌러 출석/레슨 횟수를 기록합니다. 타이머 완료 시 자동 체크도 가능합니다.
- 타이머 사용 중에는 화면 꺼짐 방지(Wake Lock)가 동작할 수 있습니다.
🔁 재출석(다시 체크)
이미 출석 체크가 끝난 회원도 같은 날 다시 레슨을 진행했다면 재출석 처리를 통해 추가로 체크할 수 있습니다. 레슨 횟수는 재출석 시마다 정상적으로 누적됩니다.
🎯 레슨 목표 달성
회원별 목표 횟수를 설정하면 출석/레슨 체크가 누적됩니다. 목표 임박·달성 시 알림으로 안내할 수 있습니다.
06. 대진 관리
🏓 대진표 만들기
상단 탭의 대진 메뉴에서 그날 참여하는 회원을 선택해 대진표를 생성합니다. 부수(실력)에 맞춰 매칭하거나 원하는 조합으로 직접 구성할 수 있으며, 경기가 끝난 조는 결과를 체크해 다음 대진에 반영합니다.
07. 리그전 (개인전 · 팀전)
🏆 리그전 개요
상단 탭의 🏆 리그전에서 별도의 리그전 화면으로 이동합니다. 개인전과 팀전 두 가지 방식을 지원하며, 대진 생성부터 경기 진행, 결과 집계까지 한 화면에서 관리합니다.
🙋 개인전
- 참가 회원을 등록하고 대진(토너먼트/조편성)을 자동 또는 수동으로 생성합니다.
- 경기 화면에서 실시간으로 점수를 입력하면 알림판에 스코어가 즉시 반영됩니다.
- 세트 종료·경기 종료 시점에 알림음이 울려 다음 경기 진행을 알립니다.
👨👩👧👦 팀전
- 회원들을 팀으로 묶어 팀 대항 리그전을 진행합니다.
- 팀명 표시 시 뒤에 항상 「팀」이 붙습니다 (예: CM → CM팀). 이미 「팀」으로 끝나도 중복되지 않습니다.
- 팀 인원·합 부수 한도 등 참가 조건 설정 가능
- 팀전 현황 화면에서 팀별 경기 결과와 순위를 확인할 수 있습니다.
🔔 알림판 · 알림음 설정
경기 화면 하단의 알림음 토글로 🔊 켜짐 / 🔇 꺼짐을 전환할 수 있습니다. 알림 유지 시간·계속 표시 옵션을 설정할 수 있습니다. 시끄러운 체육관 환경에서도 잘 들리도록 별도 차임음으로 설계되어 있습니다.
08. 회비 관리
➕ 입금 내역 추가
- 회원 등록/수정 화면의 회비 입금 내역 섹션
- 입금일·금액 입력 후 추가 (월회비 프리셋 버튼 활용 가능)
- 목록에 누적 저장됩니다.
🗑️ 삭제
입금 목록에서 해당 항목을 삭제할 수 있습니다.
📋 확인
회원 상세·수정 화면에서 누적 입금 내역을 확인합니다.
09. 입금 통계
💰 입금 통계 열람
상단 탭 또는 회원 목록 위 입금 통계 버튼으로 열람합니다. 입금통계 담당자로 지정된 관리자 1명만 열람할 수 있으며, 다른 관리자는 담당자가 직접 권한을 넘겨줘야 볼 수 있습니다.
- 연도/월 선택 후 조회
- 수납 현황·통계를 한눈에 확인
- 필요 시 내보내기 기능으로 저장
10. 관리자 설정
🏠 기본 설정
- 구장명 · 코치 이름(최대 4명) 설정
- 회원 분류(태그) 항목 추가/편집
- 계좌 정보(은행명·예금주·계좌번호·관리자 전화번호)
- 월회비 기본값 5가지 등록
- 색상 테마 선택 (기본/퍼플/오렌지/에메랄드)
🔒 권한 · 표시 설정
- 비로그인 사용자의 회원 등록 허용 여부
- 회원 이름 클릭 시 상세정보 팝업 표시 여부
- 관리자 계정 목록 조회, 신규 관리자/부관리자 추가
- 입금통계 담당자 지정
💾 데이터 관리
- 엑셀 내보내기 / 템플릿 다운로드 / 가져오기 — 회원 데이터를 엑셀로 백업하거나 일괄 등록
- DB 백업 — 회원·대진·출석·결제 등 전체 데이터를 SQL 파일로 다운로드
- 회원 사진 관리 — 미사용 이미지 정리, 기존 사진 재압축(360px·품질 70%)
📢 광고 문구 · 팝업 관리 (V1.4)
회원 목록 상단에 표시되는 광고 문구(제목·내용·노출 기간)와, 접속 시 뜨는 시작 팝업을 관리자 설정의 광고/팝업 관리 탭에서 등록합니다. 광고 문구는 일반회원 및 비로그인 사용자에게만 노출됩니다.
11. 장점
✅ 사용자 경험
- 모바일 최적화 UI
- PWA 홈화면 추가
- 타이머 중 화면 꺼짐 방지 (Wake Lock)
- 음성·실시간 검색
✅ 업무 효율
- 타이머 완료 시 자동 출석
- 목표 임박·달성 알림
- 코치별·분류별 관리
- 엑셀 백업/복원 · 입금 통계
✅ 기능성
- 3단계 레슨 시스템 (일반/불규칙/없음)
- 스마트 타이머 (알림음 2종)
- 4단계 권한 체계 · 비밀 메모
- 개인·팀 리그전 (알림판·알림음)
- 재출석 처리 · 광고/팝업 관리
✅ 경제성 & 보안
- 라이선스 비용 없음
- 자체 호스팅 (데이터 직접 보관)
- 회원 수 제한 없음
- DB 백업(SQL) 및 엑셀 내보내기
12. 문제 해결
🔑 로그인
- 기본 계정
admin/admin123시도, 대소문자 확인 - 비밀번호 분실 → 다른 관리자 계정으로 재설정
- 자주 풀림 → 「로그인 상태 유지」 체크 후 재로그인 (최대 약 30일)
⏱️ 타이머 · 알림음
- 볼륨·무음 모드·브라우저 소리 권한 확인
- 일부 브라우저는 화면 꺼짐 방지가 제한적 → 가끔 화면 터치
🎤 음성 검색
- 최신 Chrome/Safari, HTTPS, 마이크 권한 필요
- 조용한 환경·인터넷 연결 확인
💾 데이터
- 회원이 안 보이면 F5·인터넷 확인
- 엑셀 가져오기 실패 시 템플릿 형식·10MB 이하 확인
13. 자주 묻는 질문
Q. 비밀번호(로그인)를 잊어버렸어요.
일반회원은 이름 + 등록된 전화번호 끝 4자리로 로그인합니다. 전화번호가 변경되었다면 관리자에게 회원 정보 수정을 요청하세요. 관리자·부관리자 계정 비밀번호는 관리자 설정의 계정 목록에서 재설정할 수 있습니다.
Q. 로그인이 자주 풀려요.
「로그인 상태 유지」를 체크한 뒤 다시 로그인하세요. 최대 약 30일 세션이 유지·연장됩니다.
Q. 팀명이 이상하게 표시돼요.
팀명은 앱 전체에서 항상 끝에 "팀"이 자동으로 붙어 표시됩니다(예: 독수리팀). 이미 "팀"으로 끝나는 이름을 입력해도 "팀팀"처럼 중복되지 않도록 자동 처리됩니다.
Q. 리그전 경기 중 알림음이 안 들려요.
기기 음소거/무음 모드를 먼저 확인하고, 경기 화면 하단의 알림음 토글이 🔊 켜짐 상태인지 확인하세요. 알림판·알림음은 대회 운영에 꼭 필요한 기능입니다.
Q. 회원을 실수로 삭제했어요.
삭제된 회원은 목록에서 복구되지 않습니다. 관리자 설정의 DB 백업을 정기적으로 받아두면 데이터를 복원할 수 있습니다.
Q. 회원 수 제한이 있나요?
없습니다. 무제한 등록 가능합니다.
Q. 코치는 몇 명까지?
최대 4명까지 등록할 수 있습니다.
Q. 문자가 자동 발송되나요?
문자 앱을 열어 주는 방식이며, 실제 발송은 직접 해야 합니다.
Q. 부관리자는 무엇을 하나요?
담당 코치의 회원만 관리할 수 있습니다.
Q. 일반회원 로그인은?
관리자가 「일반회원 로그인 허용」을 켠 뒤, 이름 + 전화번호 끝 4자리로 로그인합니다. 본인 카드가 최상단에 표시됩니다.
Q. 프로필을 눌렀는데 상세가 안 열려요
로그인 후 이용하세요. 이름 클릭과 동일하게 상세가 열립니다.
Q. 타이머 알림음·화면 꺼짐
볼륨·무음 모드·브라우저 소리 권한을 확인하세요. 일부 브라우저는 화면 꺼짐 방지가 제한적일 수 있어 가끔 화면을 터치해 주세요.
Q. 음성 검색이 안 돼요
최신 Chrome/Safari, HTTPS, 마이크 권한이 필요합니다. 조용한 환경·인터넷 연결을 확인하세요.
Q. 데이터는 안전한가요?
귀하의 웹서버에 저장되어 외부 클라우드 대비 유출 위험이 적습니다. 정기 백업을 권장합니다.
14. 용어 설명
| 용어 | 설명 |
|---|---|
| PWA | Progressive Web App, 앱처럼 설치되는 웹사이트 |
| Service Worker | 오프라인·캐시를 위한 백그라운드 스크립트 |
| Wake Lock | 화면 꺼짐 방지 |
| 일반 레슨 | 고정 스케줄이 있는 레슨 |
| 불규칙 레슨 | 고정 스케줄 없는 개별 레슨 |
| 부수 | 실력 등급 (0~11부, 선출, 희망) |
| 수납률 | 회비 납부 회원 비율 |
| 일반회원 | 이름+전화 끝 4자리 로그인 (허용 시) |
| 재출석 | 같은 날 퇴실 후 다시 입실하는 출석 |
| 분류 | 아침반·오후반 등 회원 카테고리 |
| 알림판 | 리그전 결과·진행 실시간 표시 영역 |
| 팀 리그전 | 팀 단위 대진·결과 (팀명에 「팀」 접미사) |