# 요가다 사용 설명서

> 이 문서는 요가원 관리 서비스 **요가다(yogada.kr)**의 공식 사용 설명서입니다. 2026-10-17 기준 화면과 기능을 설명합니다. 요가원 원장님과 직원이 읽는 문서이며, AI가 이 문서를 읽고 요가다 사용법 질문에 답할 때도 이 내용을 기준으로 삼으면 됩니다.

## 요가다가 하는 일

요가다는 요가원의 출석, 수강권, 예약을 휴대폰과 태블릿으로 관리하는 웹 서비스입니다. 앱 설치 없이 웹 주소로 사용합니다.

- 입구 태블릿에서 회원이 직접 출석 (터치, 전화번호 뒷자리, 얼굴 인식 중 선택)
- 횟수권·기간권 차감과 만료일 자동 계산
- 수업 예약과 대기 관리
- 카카오 알림톡·문자로 만료 안내, 예약 안내, 이벤트 안내
- 체험 신청 접수와 체험 회원 관리
- 엑셀 회원 명단 가져오기
- AI agent 연동 (읽기 전용)

## 시작하기

### 요가원 만들기와 로그인

1. https://yogada.kr 에서 **무료로 시작하기**를 누릅니다.
2. **카카오로 시작하기** 또는 **이메일로 가입**을 고릅니다.
   - 카카오: 카카오 로그인 후 요가원 이름을 입력하면 바로 만들어집니다. 카카오 계정 하나당 요가원 하나를 만들 수 있습니다.
   - 이메일: 이메일로 온 인증 링크를 누르면 요가원 이름 입력으로 이어집니다. 메일이 안 보이면 스팸함을 확인해 주세요.
3. 요가원을 만들면 기본 수강권(10회권 · 20회권 · 1개월권 · 3개월권)이 함께 만들어집니다.
4. 다음부터는 같은 방법(카카오 또는 이메일)으로 로그인하면 됩니다.

### 주소 구조

모든 화면은 `https://yogada.kr/app/` 아래에 있고, 요가원마다 고유한 주소(슬러그)가 있습니다.

| 화면 | 주소 모양 | 누가 쓰나 |
|---|---|---|
| 홈 | `https://yogada.kr/app/#/s/요가원주소` | 모두 |
| 관리자 | `…#/s/요가원주소/admin` | 원장님·직원 |
| 출석 (입구 태블릿) | `…#/s/요가원주소/kiosk` | 입구 태블릿 |
| 회원용 | `…#/s/요가원주소/member` | 회원 |
| 강사용 | `…#/s/요가원주소/instructor` | 강사 |
| 체험 신청 | `…#/s/요가원주소/trial` | 체험 희망자 |

회원 링크와 출석 링크는 화면에서 복사 버튼으로 복사해 카카오톡 등으로 공유할 수 있습니다.

## 홈 화면

요가원 주소로 들어가면 4개의 카드가 보입니다.

- **관리자**: 회원 명단, 초성검색, 만료 표시, 수업 관리 등 모든 관리 기능
- **출석 (입구 태블릿)**: 큰 글씨 터치 체크인 화면
- **회원용**: 내 수강권 확인과 수업 예약
- **강사용**: 내 출강 현황

아래의 **사장님(오너) 화면**은 요가다 운영사 전용입니다.

## 관리자 화면

관리자 화면은 탭으로 나뉩니다: **현황 · 회원 · 명단 · 수업 · 강사 · 수강권 · 알림톡 · 건의 · 이벤트 · 약관 · 가져오기**

### 현황

한눈에 보는 요가원 상태입니다.

- 오늘 신규 회원, 오늘 출석, 체험 예정
- 체험 신청 목록과 체험 등록 처리 (아래 "체험 신청 받기" 참고)
- 만료예정 회원 (7일 이내, 8~14일)
- 출석 추이 (최근 12주), 월별 출석·매출 (최근 6개월)
- 이탈률 (만료 후 30일 안에 재등록이 없는 비율)과 재등록률
- **태블릿 출석 방식 (요가원 기본값)**: 번호 패드만 / 얼굴 인식 + 번호 패드 / 얼굴 인식만 중 기본 출석 방식을 고릅니다. 태블릿에서 따로 고른 방식이 있으면 그 태블릿은 태블릿 설정을 따릅니다.
- **AI agent 연동 (읽기 전용)**: AI agent 키를 만들고 관리합니다. (아래 "AI agent 연동" 참고)

명단의 회원 이름을 누르면 회원 상세로 이동합니다.

### 회원

회원 명단과 회원별 상세 관리입니다.

- **검색**: 이름, 초성(예: ㄱㅇㅎ), 또는 전화번호로 찾습니다.
- **만료 표시**: 회원 이름 옆에 D-day 배지가 붙습니다. 휴회 중이면 휴회 배지, 만료면 만료 배지가 붙습니다.
- **회원 추가**: 이름과 전화번호만 입력하면 바로 등록됩니다. 수강권을 고르면 결제 기록도 함께 남길 수 있습니다.
- **회원 상세**에서 할 수 있는 것:
  - 수강권 추가 (재등록 보너스 +횟수/+일을 ON/OFF로 적용)
  - 수강권 해제, 횟수 조정
  - 결제 기록 추가·수정·삭제 (삭제하면 현황 매출에서도 빠집니다)
  - 휴회 처리·해제, 수강권 양도
  - 얼굴 인식 등록·삭제
  - 카카오 로그인 연결 상태 확인과 해제
  - 전화번호 수정, 메모, 변경 이력 확인

**휴회**: 회원 상태가 '휴회'로 바뀌고 목록에 휴회 배지가 붙습니다. 휴회 중에는 입구 태블릿에서 검색·체크인이 안 됩니다. 기간권은 휴회를 해제할 때 실제 휴회 기간만큼 만료일이 자동으로 늘어나고, 횟수권의 잔여 횟수는 그대로입니다. 당일 해제하면 만료일은 바뀌지 않습니다.

**양도**: 한 회원의 이용권을 다른 회원에게 그대로 옮깁니다 (잔여 횟수·시작일·만료일 유지). 두 회원의 변경 이력에 '양도함/양도받음'으로 기록되고, 되돌리려면 다시 양도해야 합니다.

### 명단

관리가 필요한 회원을 모아 보여주는 화면입니다.

- **장기 미출석**: 마지막 출석 후 7~13일, 14~29일, 30일 이상 지난 회원
- **만료 후 미등록**: 수강권이 끝났는데 새 수강권을 등록하지 않은 회원
- **미전환 체험**: 체험권만 쓰고 정규 수강권이 없는 회원, 체험권이 있지만 아직 출석 기록이 없는 회원

### 수업

코스와 수업(시간표)을 관리합니다.

- **코스**: 수강권 묶음의 이름입니다 (예: 요가 1개월 (주2회)).
- **수업 추가**: 수업 이름, 요일, 시작 시간, 수업 길이, 정원, 담당 강사, 색상을 정합니다.
- **예약 필수**: 켜면 회원이 예약해야 출석할 수 있는 수업이 됩니다.
- 수업을 바꾸거나 없앨 때 예약 기록이 있으면 삭제 대신 **폐강**으로 처리되고, 예약한 회원에게 안내를 보낼 수 있습니다 (알림톡 연결 후).
- 담당 강사 사정으로 다른 강사가 들어가면 **대강**으로 기록할 수 있습니다.

### 강사

강사 목록과 출강 기록을 관리합니다.

- 강사를 추가하면 입구 태블릿에서 이름을 눌러 출강 시각이 자동으로 기록됩니다.
- **대강·결강**: 빠뜨린 기록이나 대강·결강을 여기서 바로잡을 수 있습니다.
- **강사 로그인 연결**: 6자리 연결 코드를 만들어 강사에게 전달하면, 강사가 카카오 로그인 후 코드를 한 번 입력해 연결됩니다. 코드는 7일 동안 쓸 수 있습니다. 연결된 강사는 강사용 화면에서 **내 출강 현황**을 볼 수 있습니다.
- **강사 얼굴 인식**: 강사 본인 동의를 받아 등록하면 태블릿에서 얼굴로 출강 확인을 할 수 있습니다. 삭제하면 얼굴 특징값이 바로 지워집니다.

### 수강권

수강권 종류를 만들고 관리합니다.

- **종류**: 횟수권(총 횟수와 유효 일수), 기간권(유효 일수와 주 횟수), 체험권. 매장에 체험권이 없으면 1일 체험권(1회 · 유효 1일 · 0원)이 자동으로 만들어집니다.
- **카테고리**: 요가, 바레처럼 수강권을 묶는 분류입니다. 새 카테고리를 만들 수 있고, 이름을 바꾸면 그 카테고리의 수강권과 수업도 함께 바뀝니다.
- **가격과 가격 적용일**: 가격을 바꿀 때만 적용됩니다. 미래 날짜로 정하면 그 날짜부터 새 가격이 적용됩니다.
- **비활성화**: 수강권을 쓰는 회원이 있으면 삭제할 수 없습니다. 비활성화하면 새 등록에서만 숨겨지고 기록은 남습니다.
- **결제 채널 (포트원)**: 매장이 포트원에서 발급받은 스토어 ID와 채널 키를 등록하면 회원용 앱에서 온라인 수강권 구매가 열립니다.

### 알림톡

회원에게 보내는 카카오 알림톡·브랜드 메시지·문자(LMS)를 관리합니다. 발송 1건당 경로별 단가가 발송 잔액에서 차감되고, 충전은 매장 입금 확인 후 금액을 더하는 방식입니다.

- **템플릿**: 카카오가 심사해서 승인한 문안만 발송할 수 있습니다. 기본 템플릿이 준비되어 있고, 나만의 문안을 만들어 심사를 요청할 수 있습니다. 심사는 보통 1~3영업일 걸리고, 반려되면 문구를 고쳐 다시 신청합니다. 승인된 문안은 고칠 수 없고 새 버전으로 만들어야 합니다.
- **자동 발송**: 템플릿마다 켜고 끌 수 있습니다.
  - 수강권 만료 7일 전 안내 (매일 오전 9시, 정보성)
  - 수강권 만료 1일 전 안내
  - 횟수권 잔여 1회 이하 안내
  - 체험 당일 팔로업 (매일 밤 9시, 그날 체험 수업에 출석한 회원)
  - 장기 미출석 복귀 안내
  - 수업 변경·폐강 안내
- **잔액 부족**: 자동 발송이 멈추고 매장에 알림이 갑니다. 충전하면 다시 이어집니다.
- 카카오 채널 연결 전에는 실제로 발송되지 않고 대기열에서 기다립니다.
- **브랜드 메시지**: 프로모션·권유 문구를 보낼 수 있는 광고성 메시지입니다. 맨 앞 (광고) 표기와 수신거부 문구가 법적 의무이고, 채널 친구에게만 도착합니다. 친구가 아닌 회원에게는 문자(LMS)를 선택하세요.

카카오 채널 연결 절차는 아래 "카카오 알림톡 설정 4단계"를 참고하세요.

### 건의

요가다에 보내는 개선 건의·문제 알리기입니다. 불편한 점이나 바라는 기능을 적고, 문제가 생긴 화면을 캡처해서 사진(최대 3장)으로 올리면 됩니다. 보낸 건의와 답변을 같은 화면에서 확인할 수 있습니다.

### 이벤트

회원용 화면에 보여주는 이벤트 카드를 관리합니다. 여러 이벤트를 동시에 켜둘 수 있고, 혜택은 원장님이 직접 적용합니다 (알림톡이 자동으로 발송되지는 않습니다).

- **재등록 이벤트**: 이벤트 기간 안에 수강권이 남은 회원의 화면 맨 위에 보입니다. 제목, 할인율, 기간, 안내 문구, '만료 며칠 전부터' 보일지를 정합니다.
- **장기 미출석 복귀 이벤트**: 마지막 출석 후 정한 기간이 지난 회원의 화면에 '돌아오면 보너스' 안내가 뜹니다.

### 약관

회원 가입 시 받는 약관 동의와 서명을 관리합니다.

- **약관 (항목별)**과 **개인정보 수집·이용 동의 문구**를 입력합니다. 예시 문구를 불러와 고쳐 쓸 수 있습니다 (예시는 법률 검토를 거친 문구가 아니니 요가원에 맞게 수정하세요).
- 켜면 켠 이후에 등록된 **신규 회원**이 입구 태블릿에서 첫 출석할 때 약관 확인과 서명을 받습니다. 기존 회원은 영향이 없습니다.
- 약관을 고치면 새 버전으로 저장되고, 이미 서명한 회원의 기록은 서명 당시 내용 그대로 남습니다.
- **서명 기록**: 이름과 전화번호로 조회해 PDF로 저장할 수 있습니다.
- **QR 인쇄**: 가입용 QR은 바뀌지 않으니 인쇄해서 붙여 두면 됩니다. 회원이 휴대폰 카메라로 QR을 찍어 가입하고 서명합니다.
- 옵션: 가입 때 주소도 받기, 얼굴 인식 등록 (선택 동의).

### 가져오기

엑셀로 정리한 회원 명단을 한 번에 옮기는 기능입니다.

1. **링크 만들기**를 누르면 매장 전용 올리기 링크가 만들어집니다. 처음 한 번 만들면 14일 동안 같은 화면을 다시 열 수 있고, 14일 뒤 자동으로 닫힙니다.
2. 링크를 아는 사람은 누구나 올릴 수 있으니 필요한 분께만 보내 주세요. 직원이나 도와주는 분이 대신 명단을 올릴 때도 이 링크를 보내면 됩니다.
3. csv나 xlsx 파일을 올립니다. 컬럼 형식: `이름, 전화번호, 수강권, 잔여횟수, 시작일, 만료일, 상태`. 한 번에 500명까지 올릴 수 있습니다.
4. 기존에 쓰던 프로그램의 명단 형식이 다르면, 명세 페이지에 있는 AI 변환 안내문을 Claude 같은 AI에 붙여 넣어 요가다 형식으로 변환할 수 있습니다.

## 출석 (입구 태블릿)

입구에 놓는 태블릿용 출석 화면입니다. 큰 글씨와 터치 체크인으로 되어 있습니다.

### 출석 방식

요가원 기본값(현황 탭에서 설정)과 태블릿별 개별 설정이 있습니다. 태블릿에서 고른 방식은 그 태블릿에만 적용됩니다.

- **번호 패드만**: 회원이 전화번호 뒤 4자리를 눌러 출석합니다.
- **얼굴 인식 + 번호 패드**: 얼굴로 출석하거나, 번호로 출석할 수 있습니다.
- **얼굴 인식만**: 얼굴 인식으로만 출석합니다.

번호로 찾을 때는 이름이나 초성으로도 검색할 수 있습니다. 오늘 이미 출석한 회원이면 "오늘 이미 출석하셨어요"라고 안내합니다. 출석이 되면 소리로 확인해 주고, 화면에서 소리를 켜거나 끌 수 있습니다.

### 얼굴 인식 출석

- 회원이 동의한 경우에만 쓰는 선택 기능입니다. 동의하지 않아도 이름 터치나 번호로 똑같이 출석할 수 있습니다.
- 등록할 때 정면 → 왼쪽 → 오른쪽 순서로 얼굴을 3번 촬영합니다. 얼굴 사진은 저장하지 않고 얼굴 특징값(숫자값)만 저장합니다. 14세 미만은 등록할 수 없습니다.
- 인식이 안 되면 밝은 곳에서 얼굴이 화면에 크게 보이게 한 뒤 다시 시도하거나, 번호로 출석하면 됩니다.
- 회원이 동의를 철회하거나 탈퇴하면 얼굴 특징값은 즉시 삭제됩니다.

### 신규 회원 가입과 서명

- 태블릿 화면의 가입 QR을 회원 휴대폰 카메라로 찍으면 휴대폰에서 가입과 서명을 마칩니다.
- 약관 서명을 켜 둔 요가원은 신규 회원이 첫 출석 때 약관 확인과 손가락 서명을 합니다. 서명 직후 얼굴 인식 등록(선택)도 이어서 할 수 있습니다.

### 강사 출강

- 강사는 태블릿에서 이름을 눌러 출강을 확인합니다. 수업 시작 1시간 전부터 선택할 수 있습니다.
- 다른 강사 수업을 대신 들어가면 **대강**, 쉬는 날은 **결강**으로 기록합니다.
- 얼굴 인식을 등록한 강사는 얼굴로 출강 확인을 할 수 있습니다.

## 회원용 앱

회원이 쓰는 화면입니다 (`…/member`).

- **처음 한 번 연결**: 카카오 로그인 후 등록된 이름과 전화번호(뒷 4자리 또는 전체)를 입력하면 내 회원 정보와 연결됩니다. 다음부터는 카카오 로그인만 하면 바로 들어옵니다.
- **내 수강권**: 남은 횟수와 만료일을 확인합니다.
- **수업 예약**: 주간 시간표에서 수업을 골라 예약합니다. 예약하면 횟수권 1회가 차감되고, 수업 3시간 전까지 취소하면 복원됩니다. 예약 후 출석하면 추가 차감은 없습니다. 정원이 마감되면 대기를 신청하고, 자리가 나면 예약으로 바꿀 수 있습니다.
- **내 예약 확인 · 오시는 길**: 예약한 수업과 요가원 위치(네이버 플레이스)를 확인합니다.
- **수강권 구매**: 매장에 결제 채널(포트원)이 등록되어 있으면 온라인으로 수강권을 살 수 있습니다. 결제가 완료되면 확인을 거쳐 수강권이 등록되고, 등록 전에는 출석·예약에 사용할 수 없습니다.
- **재등록 이벤트**: 진행 중인 이벤트가 있으면 화면 맨 위에 카드로 보입니다.

## 강사용

강사가 쓰는 화면입니다 (`…/instructor`). 관리자가 만들어 준 6자리 연결 코드를 처음 한 번 입력해 카카오 계정과 연결하면, **내 출강 현황**에서 이번 달 출강 기록을 볼 수 있습니다.

## 체험 신청 받기

- 요가원마다 체험 신청 링크(`…/trial`)가 있습니다. 관리자 화면 현황 탭에서 링크를 복사해 공유합니다.
- 신청자는 이름, 전화번호, 희망 수업·날짜, 궁금한 점을 남깁니다. 개인정보 동의(필수)와 이벤트·소식 안내 동의(선택)를 함께 받습니다.
- 관리자는 현황 탭의 체험 신청 목록에서 **연락 완료**로 표시하거나 **체험 등록**을 눌러 체험 회원으로 등록합니다 (체험권 자동 부여). 같은 번호의 회원이 이미 있으면 그 회원에게 체험권을 추가할지 물어봅니다.
- 등록하지 않은 신청은 2주 뒤 자동으로 삭제됩니다.
- 체험권이 있고 아직 출석하지 않은 회원, 체험만 하고 정규 등록하지 않은 회원은 명단 탭의 미전환 체험에서 관리합니다.

## 카카오 알림톡 설정 4단계

알림톡 발송을 시작하려면 4단계가 모두 끝나야 합니다. 4단계가 끝나기 전에는 실제 발송 없이 상태만 기록됩니다.

1. **카카오 채널 개설**: 카카오비즈니스 파트너센터(business.kakao.com)에 카카오 계정으로 로그인 후 '+ 새 비즈니스 만들기'로 매장 채널을 만듭니다. 채널 이름, 검색용 아이디, 프로필 사진, 소개 문구가 필요합니다.
2. **비즈니스 채널 인증**: 사업자등록증(또는 고유번호증), 대표자 신분증 또는 재직증명서로 채널이 실제 사업장 것임을 인증합니다. 보통 1~3영업일 걸리고, 관리자센터 채널 정보에 '비즈니스 채널' 배지가 보이면 완료입니다.
3. **발신 프로필 등록**: 발송 서비스에 이 채널을 발신 프로필로 연결합니다. 이 단계는 요가다가 진행하니 원장님이 따로 할 일은 없습니다.
4. **알림톡 템플릿 승인**: 회원에게 보낼 문안(템플릿)을 카카오가 심사합니다. 승인된 문안만 보낼 수 있습니다.

카카오톡에서 채널 이름으로 검색했을 때 채널이 나오면 개설이 완료된 것입니다. 알림톡은 정보성 안내만 승인되고, 할인·이벤트·재등록 권유가 있으면 반려됩니다. 광고성 안내는 브랜드 메시지를 이용하세요.

## AI agent 연동

원장님이 Claude 같은 AI agent에게 우리 요가원 정보를 물어볼 수 있는 기능입니다 (읽기 전용).

- 관리자 화면 현황 탭의 **AI agent 연동 (읽기 전용)**에서 키를 만듭니다. 키는 숫자 코드로, 사용 중인 키는 최대 5개이고 90일 동안 유효합니다.
- 키를 가진 AI agent는 출석, 만료 임박 회원 같은 정보를 **조회만** 할 수 있습니다. 전화번호 끝자리만 보이는 등 민감한 정보는 가려져서 나갑니다.
- 키를 폐기하면 더 이상 쓸 수 없고, 폐기된 키는 숨겨집니다.

**Claude에 연결하는 방법**

1. 키 만들기 후 **Claude용 복사**
2. Claude 설정 > 커넥터 > 커스텀 추가 > 주소 붙여넣기
3. 인증은 '로그인 없음' 선택

연결하면 Claude에게 "이번 주 만료 임박 회원 알려줘"처럼 물어볼 수 있습니다.

**앱 사용법을 AI에게 물어보고 싶다면**

이 사용 설명서를 AI에게 보여주고 물어보면 됩니다. https://yogada.kr/guide.md 주소를 알려주거나, 문서 내용을 통째로 붙여 넣은 뒤 "요가다에서 수강권 휴회는 어떻게 해?"처럼 질문하면 이 문서를 기준으로 답합니다.

## 자주 묻는 질문

**로그인이 풀렸어요.** 같은 방법(카카오 또는 이메일)으로 다시 로그인하면 됩니다.

**회원이 출석이 안 돼요.** 휴회 중인 회원은 입구 태블릿에서 검색·체크인이 안 됩니다. 관리자 화면 회원 탭에서 휴회를 해제해 주세요.

**얼굴 인식이 안 돼요.** 카메라 권한을 허용했는지 확인하고, 밝은 곳에서 얼굴이 화면에 크게 보이게 해 주세요. 계속 안 되면 번호로 출석할 수 있습니다.

**수강권 횟수가 실제와 달라요.** 관리자 화면 회원 상세에서 횟수 조정으로 바로잡을 수 있습니다. 변경 이력에 기록이 남습니다.

**알림톡이 안 나가요.** ① 4단계 설정이 모두 끝났는지, ② 발송 잔액이 있는지, ③ 해당 템플릿의 자동 발송이 켜져 있는지 확인해 주세요. 채널 연결 전에는 대기열에만 쌓입니다.

**회원이 카카오 연결이 안 된다고 해요.** 이미 다른 카카오 계정에 연결된 회원일 수 있습니다. 관리자 화면 회원 상세에서 연결 상태를 확인하고, 잘못 연결된 경우 해제해 주세요. 해제 후 회원이 다시 연결하면 됩니다.

**같은 이름·번호의 회원이 여러 명이에요.** 중복 등록된 경우입니다. 관리자 화면에서 확인 후 정리해 주세요.

**강사 연결 코드가 안 돼요.** 코드는 7일 동안만 쓸 수 있습니다. 강사 탭에서 새 코드를 만들어 전달해 주세요.

**결제 기록을 지우면 어떻게 되나요?** 되돌릴 수 없고, 현황 탭의 매출에서도 빠집니다. 회원의 현재 수강권·잔여 횟수·만료일은 그대로 유지됩니다.

## 개인정보와 얼굴 정보

- 회원의 이름·전화번호는 수강 관리 목적으로만 쓰이며, 회원 가입과 명단 등록 때 개인정보 수집·이용 동의를 받습니다.
- 광고성 알림톡·문자는 회원에게 마케팅 수신 동의를 명시적으로 받은 경우에만 보낼 수 있습니다.
- 얼굴 인식은 별도의 선택 동의를 받으며, 얼굴 사진이 아닌 특징값(숫자값)만 저장합니다. 동의 철회나 탈퇴 시 즉시 삭제되고, 수강 종료 후 1년 뒤 파기됩니다.
- 요가원별로 데이터가 완전히 분리되어 다른 요가원의 정보는 볼 수 없습니다.

---

요가다 | 주식회사 내몸에딱 | https://yogada.kr