이용안내

1. 무엇을 할 수 있나

DirectSurvey 는 강사가 수업 직전 5분 만에 설문이나 퀴즈를 만들고, 학생들에게 QR/링크로 배포해 즉시 응답을 모으는 도구입니다. 응답이 모이면 자동으로 차트가 그려지고, AI 가 자유서술 답을 요약·클러스터링 해 한 번에 인사이트를 보여줍니다.

• 설문 — 의견·평가 수집. 6가지 문항 유형 (단답·서술·단일·복수·척도·메시지).
• 라이브 퀴즈 — 정답·점수·시간제한이 있는 게임형. 빔에 띄우고 학생 폰으로 동시 풀이.
• AI 리포트 — 자유서술 요약, 응답자 클러스터링, 교차 인사이트, 산점도 자동 생성.
• 비식별화 모드 — 이름/전화/이메일 자동 마스킹, PDF 출력 시에도 적용.

2. 가입과 첫 화면

강사 가입 후 관리자 승인을 거치면 사용 가능합니다. 가입과 동시에 +100 크레딧 환영 보너스가 자동 적립되어 곧바로 설문/퀴즈를 만들 수 있습니다.

1. 강사 로그인 페이지에서 가입 → 관리자 승인 대기.
2. 승인 메일 확인 후 로그인.
3. 대시보드 우측 상단의 💎 100 크레딧 표시 확인.

3. 크레딧 — 충전·소진·환불

크레딧은 사용량 단위입니다. 가입 시 +100 (10건 만들 수 있는 분량) 무료로 시작합니다.

• 설문/퀴즈 1건 생성 = −10 크레딧
• 설문 30일 / 퀴즈 10일 후 자동 마감. 기간 연장 또는 재활성화 = −10 크레딧
• 충전: 1만원 = 100 크레딧 (토스 결제)
• 잔액 한도 = 1000 크레딧 (한도 초과 시 추가 충전 차단)

환불

• 결제 당일: 강사가 직접 [결제 취소] 가능 (크레딧이 환불액 이상 남아있어야 함).
• 결제 후 1~7일: [환불 신청] → 관리자 승인 후 처리.
• 결제 후 7일 초과: 환불 신청 불가.

결제 키가 test_ 로 시작하면 테스트 모드 — 실제 카드사 청구가 발생하지 않습니다 (베타 테스터 기간).

4. 설문 만들기

대시보드에서 📋 새 설문 만들기 카드를 누릅니다. 세 가지 입력 방식 중 선택:

1. AI 대화형 생성 — 자연어로 "Python 사전 경험·강의 만족도·자유 의견" 같이 적으면 마크다운이 자동 생성.
2. 마크다운 직접 작성 — frontmatter (메타) + Q블록 형태. 샘플 콘텐츠 [불러오기] 또는 [👁️ 미리보기] 로 양식 익히기.
3. 수동 폼 — 제목·설명·진행 모드만 입력하고 빈 설문으로 시작 후 GUI 편집기에서 문항 추가.

지원되는 문항 유형

• text — 한 줄 단답
• textarea — 여러 줄 서술. AI 가 워드클라우드 + 요약
• radio — 단일 선택
• checkbox — 복수 선택
• slider — 1~5 또는 1~10 척도 (라이커트형)
• message — 응답 받지 않는 안내 문구

5. 문항 편집기 (GUI)

설문이 생성되면 GUI 편집기에서 문항을 자유롭게 추가·수정·재정렬할 수 있습니다. 응답이 들어온 뒤에는 데이터 무결성을 위해 일부 동작이 제한됩니다 (필요 시 [응답 모두 삭제] 후 재편집).

6. 설문 운영 — 배포·진행·마감

설문 상세 페이지에서 참여 URL 과 QR 코드 를 즉시 사용할 수 있습니다. 학생은 폰 카메라로 QR 만 찍으면 곧바로 응답 페이지로 이동.

진행 모드

• 비동기(async) — 학생이 자기 페이스로. 반복 실습·과제용.
• 동기(live) — 강사가 한 문항씩 띄우고 모두 동시에 답함. 라이브 강의용.
• 혼합(hybrid) — 기본값. 둘 다 허용.

7. 라이브 동기 진행

설문 상세에서 [라이브 시작] 진입. 운영자 뷰와 빔용 사용자 뷰가 분리됩니다.

• 운영자 뷰에서 문항을 띄우면 학생 폰 화면이 그 문항으로 동기화.
• 응답이 들어올 때마다 차트가 실시간 갱신.
• [👥 대기실] 토글로 누가 접속했는지 확인.

8. 라이브 퀴즈

대시보드의 🎯 새 퀴즈 만들기 진입. 설문과 비슷하지만 각 문항에 정답 / 시간 제한 / 점수 메타가 추가됩니다. 4지선다(radio) 또는 단답(text) 만 지원.

점수 산정 (Kahoot 식)

• 정답 + 빠른 응답 = 100% 점수
• 시간 절반 사용 = 70%
• 시간 ¾ 사용 = 50%
• 막판 = 30%
• 오답 또는 시간 초과 = 0점

9. 결과 / 리포트

설문/퀴즈 상세에서 [결과] 또는 [리포트] 진입.

결과 페이지 — 빠른 요약

리포트 — AI 분석

리포트에는 결과 페이지의 모든 차트 + AI 가 만든 다음 항목이 추가:

• 자유서술 문항별 요약 (불릿 포인트)
• 전체 교차 인사이트 (1문단)
• 응답자 클러스터링 — 답변 패턴이 비슷한 사람들을 3~6개 페르소나로 묶고 이름·요약·대표 인용 제시. 슬라이더 문항이 2개 이상이면 산점도까지 자동 생성.

운영자는 [PDF 다운로드] 로 리포트를 그대로 저장할 수 있고, 비식별화 모드도 PDF 에 그대로 적용됩니다.

10. 개별 응답 / 비식별화

리포트 우상단의 [비식별화] 토글로 모든 이름·전화·이메일을 즉시 마스킹합니다.

• 참여자 표시 이름: 홍길동 → 홍*동
• 답변 안의 전화: 010-1234-5678 → 010-****-5678
• 이메일: user@example.com → u***@example.com
• 주민등록번호 같은 패턴: ******-*******

설문 자체의 이름 표시 정책 (실명/비식별/익명) 은 만들 때 메타로 미리 정해도 되고, 운영자만 보는 화면에서 토글해도 됩니다.

11. 그룹·공유

• 그룹 — 한 학기·반 단위로 설문/퀴즈를 묶어 관리. 그룹은 폴더처럼 동작합니다.
• 공유 — 동료 강사에게 읽기 또는 편집 권한으로 공유. 공유 받은 사람은 [내게 공유된 설문] 섹션에서 볼 수 있고, 읽기 권한은 결과/리포트만, 편집 권한은 문항·진행 상태도 변경 가능.

12. 자주 묻는 질문

Q. 자동 마감된 설문의 응답 데이터는 어떻게 되나요?

그대로 보존됩니다. 마감은 신규 응답 차단 + 운영자 편집 차단이지, 데이터 삭제가 아닙니다. 결과/리포트는 그대로 볼 수 있습니다.

Q. 학생이 두 번 응답하면 어떻게 되나요?

같은 브라우저(쿠키 토큰) 에서는 마지막 응답으로 덮어쓰기. 다른 브라우저로 바꾸면 별개의 참여자로 잡힙니다.

Q. 학생 이름은 강제로 받아야 하나요?

아니요. 설문 메타의 require_name: false 로 두면 익명 (#xxxx 형식 자동 부여), masked 로 두면 비식별 (홍*동) 표시, visible 로 두면 실명.

Q. 라이브 퀴즈 중 학생이 새로고침하면 점수를 잃나요?

아니요. 정답 제출 직후 점수가 DB 에 저장되며, 새로고침해도 동일 참여자로 잇기 위한 토큰이 쿠키에 남습니다. 카운트다운 타이머도 서버 측 기준 elapsedMs 로 정확히 복원됩니다.

Q. 자동 마감된 항목은 다시 살릴 수 있나요?

네. [다시 열기] 버튼으로 −10 크레딧을 차감하고 30일/10일 새 만료일을 받습니다. 만료 전에도 동일 비용으로 [기간 연장] 가능.