👨‍🏫
학생 기초조사 도우미
담임 교사를 위한 기초조사 설문 및 AI 상담 질문 생성 도구
⚠️ CLIENT_ID가 설정되지 않았습니다. 아래 설정 안내를 확인해주세요.
🔒 다시 로그인이 필요합니다
자동 로그인이 되지 않았어요. (브라우저의 Google 로그인이 풀렸거나, Google이 권한을 다시 확인하는 경우예요)
✅ 작성하신 질문 목록·생성된 폼·AI 상담 자료는 모두 그대로 보존되어 있습니다. 아래 버튼만 다시 한 번 눌러주세요.
✅ Google 계정만 있으면 바로 시작할 수 있어요. 따로 사용 신청은 필요 없어요.
처음 로그인할 때 Google이 "확인하지 않은 앱" 경고를 보여 줘요. 현직 교사가 만든 개인 앱이라 아직 Google 검증 전이어서 뜨는 화면이니, 🔐 확인 화면 안내대로 진행하세요.
| 🎮 데모 체험하기 (새 탭)

AI 모델 및 API 키는 로그인 후 상단 ⚙️ AI 설정 버튼에서 구성

🔐 처음 로그인 시 Google 확인 화면 3개가 나와요
⚠️ 큰 파란 [안전한 환경으로 돌아가기]는 '취소'! 왼쪽 아래 작은 [계속] 또는 [고급]을 누르세요
① "확인하지 않은 앱" → 왼쪽 아래 작은 [계속]
([계속] 대신 [고급]이 보이면 → 펼쳐진 맨 아래 "학생 기초조사 도우미(으)로 이동(안전하지 않음)")
② 로그인 확인 → [계속]
③ 권한 요청 → 체크 2개를 모두 켠 채 [계속] (하나라도 끄면 폼 생성·응답 불러오기가 안 돼요)
✅ 검증 전인 개인 개발자 앱이라 뜨는 정상 화면입니다. 자체 서버가 없어 학생 정보는 선생님 브라우저와 본인 Google Drive에만 저장돼요. (AI 상담 질문을 만들 때만, 이름·학번·연락처를 뺀 응답 내용이 선택한 AI 회사로 전송됩니다)
이 코드를 본인 도메인에 직접 올리고 싶다면, 아래 6단계로 Google Cloud 설정이 필요합니다.
※ 2025~2026 콘솔 개편 기준 — OAuth 설정이 Google 인증 플랫폼으로 통합됐습니다.
  1. Google Cloud Console에서 새 프로젝트 생성
  2. API 라이브러리에서 Google Forms API, Google Drive API 사용 설정
    (폼 생성·응답 조회는 Forms API, drive.file 스코프 선언에 Drive API가 필요)
  3. Google 인증 플랫폼 → 시작하기: 앱 이름·지원 이메일·개발자 연락처 입력, 대상은 외부(External) 선택
    (이걸 먼저 해야 다음 단계의 클라이언트를 만들 수 있습니다)
  4. 클라이언트 → 클라이언트 만들기 (유형: 웹 애플리케이션)
    승인된 JavaScript 원본에 배포 주소 추가
    GitHub Pages: https://사용자명.github.io · 로컬 테스트: http://localhost:포트
  5. 발급된 클라이언트 ID를 이 파일 const CLIENT_ID = '...'에 교체
  6. Google 인증 플랫폼 → 대상 → 테스트 사용자에 본인 계정 추가
🎮 데모 모드 — 실제 데이터가 아닙니다. 가상 학생 5명으로 둘러보기용 화면입니다. 🚀 마음에 드시나요? 바로 시작하기
👨‍🏫 학생 기초조사 도우미
📝 기초조사 질문 목록
질문을 수정한 뒤 폼 생성 탭에서 구글 폼을 만들면 학생들이 응답할 수 있습니다.
#질문선택지 유형필수관리
📋 Google Form 생성
✏️ 폼 제목·안내문
수정 ▼
📄

질문 목록을 기반으로 학생용 구글 폼을 생성합니다.

✅
설문지가 생성되었습니다!
아래 링크를 학생들에게 공유하세요.
⚠️ 이 폼은 아직 '게시'되지 않아 학생들이 응답할 수 없습니다.
Google 정책 변경으로 2026년 7월 이후 만든 폼은 게시해야 응답을 받을 수 있어요.
📌 학생 배포 링크
🔧 교사 수정 링크
👤 학생 응답 확인
⚠️ 먼저 폼 생성 탭에서 구글 폼을 만들어주세요.
⚠️ 폼이 '게시'되지 않아 학생들이 응답할 수 없는 상태입니다. (2026년 7월 이후 만든 폼은 게시가 필요해요)
📭
아직 응답이 없습니다
🤖 AI 상담 질문 생성
⚠️ API 키가 설정된 모델이 없습니다. API 키 설정 버튼을 눌러 키를 입력하세요.
⚠️ 학생 선택 드롭다운에서 학생을 고른 뒤 ✨ 선택 학생 질문 생성을 눌러주세요. (또는 👥 전체 학생 일괄 질문 생성)
학생 미선택
학생 응답을 분석하여 상담 질문을 자동 생성합니다 · 🔒 이름·학번·연락처는 빼고, 반 친구 이름은 가려서 AI에 전송
🤖
AI 상담 질문이 여기에 표시됩니다
학생을 선택하고 "선택 학생 질문 생성" 버튼을 클릭하세요
선생님의 소중한 퇴근 시간을 응원합니다  |  교무실 옆 작업실  |  jerry5026@gmail.com  |  개인정보처리방침
마지막 업데이트 2026.10.07. · v1.26.0 · 계속 다듬어 나가는 중입니다
🗑️ 앱 데이터 초기화
⚠️ 이건 이 브라우저(로컬) 데이터만 지웁니다. Google 폼·학생 응답·(체크 안 한) API 키는 그대로 유지됩니다. 삭제 후 되돌릴 수 없습니다.
삭제할 항목을 선택하세요:
💾 백업 · 복원
질문·AI 상담 질문·폼 연결·모델 설정을 파일 하나로 저장하고 복원합니다.
※ 학생 응답은 Google에 안전히 보관되어, 복원 후 로그인하면 자동으로 다시 불러옵니다. (브라우저 데이터 삭제 대비용)
질문 추가
⚙️ AI 모델 설정
1. AI 제공사 선택
2. 모델 선택
3. API 키 입력
현재 설정 요약
📖 사용 방법 안내

💭 1. 이 도구가 해결하는 것

"새 학기 첫 주, 30명 학생을 어떻게 파악해야 하지…"
담임 선생님의 학기 초 부담을 줄이기 위해 만들었습니다.
보통 학기 초 풍경 이 도구를 쓰면
종이 설문지 출력→배부→수거→입력→정리 (며칠) 구글 폼 자동 생성 → 단톡방으로 링크 공유 (반나절)
30명 응답을 엑셀에 일일이 정리 클릭 한 번으로 카테고리별 자동 분류 + 엑셀 내려받기
상담 전 "이 학생에게 무슨 질문 해야 할까…" AI가 응답 분석해 개인 맞춤 상담 질문 10~30개 자동 생성
작년 자료 어디 갔는지 못 찾음 폼·학생 응답은 본인 Google 계정에, 질문·AI 상담 질문은 이 브라우저에 보관 (💾 백업·복원으로 파일 보관)
💡 핵심 가치 — 행정 업무에 쓸 시간을 학생을 진짜로 보는 시간으로 돌려드립니다.

🔑 2. 시작하기 — Google 계정으로 바로 로그인

따로 사용 신청할 필요 없이, 로그인 화면에서 Google 계정으로 시작하기를 누르면 됩니다.
이 앱은 개인 개발자(현직 교사)가 만든 도구라 아직 Google 검증 전이어서, 처음 로그인할 때 경고 화면이 한 번 나와요. 아래 안내대로 진행하시면 됩니다. (문의: jerry5026@gmail.com)
🔐 처음 로그인 시 Google 확인 화면 3개 — ① "확인하지 않은 앱"에서 왼쪽 아래 작은 [계속] 클릭 (또는 [고급] → 맨 아래 "…(으)로 이동(안전하지 않음)") (⚠️ 큰 파란 [안전한 환경으로 돌아가기]는 '취소'!) → ② 로그인 확인 [계속] → ③ 권한 요청에서 체크 2개를 모두 켠 채 [계속](하나라도 끄면 폼 생성·응답 불러오기 실패). 검증 전인 개인 개발자 앱이라 뜨는 정상 화면입니다.
🔒 학생 데이터는 어디에 있나요? — 자체 서버가 없는 앱이라 학생 응답은 본인 Google Drive(구글 폼)에, 질문 목록·AI 상담 질문은 이 브라우저에만 저장됩니다. 단, AI 상담 질문을 만들 때는 응답 내용이 선택한 AI 회사(OpenAI·Anthropic·Google)로 전송되며, 이때 이름·학번·연락처·보호자 성명은 자동으로 빼고, 답변 속 반 친구 이름·전화번호도 가려서 보냅니다.
🎮 먼저 둘러보고 싶으시다면 — 로그인 화면의 🎮 데모 체험하기 버튼으로 가상 학생 5명의 데이터로 모든 기능을 미리 체험해볼 수 있습니다 (로그인 불필요).

🚀 3. 5분 안에 첫 설문 만들기

처음 쓰시는 분도 5분이면 학생들에게 설문 링크를 보낼 수 있습니다.
  1. Step 1. 질문 검토 (📝 질문 관리 탭)
    • 고등학교 담임용 42개 기본 질문이 미리 준비되어 있어요 (개인·가족·생활습관·교우·학습·진로 두루)
    • 우리 반에 안 맞는 건 삭제, 더 묻고 싶은 건 추가 — 질문마다 안내 설명도 달 수 있어요
    • 드래그로 순서도 자유롭게
  2. Step 2. Google Form 자동 생성 (📋 폼 생성 탭)
    • 버튼 한 번이면 끝. 객관식·서술형·복수선택 모두 자동으로 만들어집니다
    • 설문 맨 위의 제목·안내문(인사말)은 ✏️ 폼 제목·안내문에서 바꿀 수 있어요 — 이미 만든 폼은 📤 지금 폼에 반영으로 바로 바뀝니다
    • 만든 폼은 학생이 바로 응답할 수 있게 자동으로 게시돼요
    • 생성된 학생 배포 링크를 학생 단톡방·클래스룸에 공유
  3. Step 3. 학생 응답 대기 ☕
    • 학생들은 평소 쓰던 구글 폼처럼 응답하면 끝
📢 '게시되지 않아 학생들이 응답할 수 없습니다' 경고가 보이면 — Google 정책이 바뀌어 2026년 7월 이후 예전 버전으로 만든 폼은 '게시 안 됨' 상태일 수 있어요. 경고 아래 📢 지금 게시하기를 한 번 누르면 바로 응답을 받을 수 있습니다.

📊 4. 응답이 모이면 — 자동 정리

학생 응답이 들어오면 (👤 학생 응답 탭) 클릭 한 번으로:
  • 이름 가나다순 자동 정렬
  • 카테고리별 분류 — 진로·가족·학습·성격·학교생활·기타 영역별로 자동 그룹핑
  • 엑셀 다운로드 — 학생부 작성·동료 교사 공유·문서 보관에 활용
  • 잘못 낸 응답 빼기 — 학생 응답 화면의 🚫 이 응답 제외를 누르면 목록·엑셀·AI 일괄 생성에서 빠집니다. Google 폼 원본은 남아 있어 언제든 ↩️ 되살리기 가능 (원본 삭제 방법도 함께 안내돼요)
💎 학생조회 시트의 비밀 — 다운받은 엑셀 시트1에서 학생 이름만 입력하면 그 학생의 모든 응답이 한눈에 정리됩니다(응답이 많으면 1~2쪽). 상담 직전 5초 만에 학생 정보 파악 가능. 아주 긴 답은 앞부분만 보이니, 전체 내용은 전체응답 시트에서 확인하세요.

🤖 5. 진짜 가치 — AI 맞춤 상담 질문

이 도구의 하이라이트입니다 (🤖 AI 상담 질문 탭).
학생의 기초조사 응답을 AI(ChatGPT / Claude / Gemini)가 분석해서, 그 학생에게만 어울리는 상담 질문 10~30개를 자동으로 만들어줍니다.
예시
MBTI가 INFP인 학생이 "스트레스 받을 때 그림 그린다"고 답했다면 →
"그림을 통해 어떤 감정을 표현할 때 가장 마음이 편안해지나요? 최근에 그린 그림이 있다면 어떤 의미가 담겨 있었는지 들려줄 수 있나요?"
사용 흐름
  1. 헤더의 ⚙️ AI 설정에서 키 1회 등록 (무료로 시작하려면 Gemini 추천 — 무료 한도 내 사용 가능)
  2. AI 탭에서 학생 선택 → ✨ 선택 학생 질문 생성
  3. 30명 학생을 한꺼번에 → 👥 전체 학생 일괄 질문 생성 (한 명씩 차례로 처리 — 빠른 모델은 한 반 5분 안팎, 고성능 모델은 더 걸려요)
상담 카드로 인쇄 — 두 가지 방법
① 엑셀(응답 + AI 한 번에) — 📊 엑셀 다운로드 (AI 포함) 후 학생조회 시트에 이름만 입력하면 그 학생의 응답 → AI 상담 질문이 위아래로 정리됩니다. 그대로 Ctrl+P → A4 세로로 출력하면 응답(1~2쪽) 다음 쪽부터 AI 상담 질문이 나옵니다(별도 설정 불필요).
② 앱에서 바로 — AI 탭의 🖨️ 인쇄(선택 학생, 1쪽 맞춤) 또는 🖨️ 전체 인쇄(전체 학생, 1명당 1쪽)로 즉석 출력. 종이 카드로 들고 상담하거나 태블릿으로 보며 진행 가능.
💰 비용 안내 — Gemini는 무료 한도 안에서 사용 가능. 유료 모델은 학생 30명 1회 분석 기준 대략 빠른 모델(Haiku·Luna) 수십~수백 원, 추천 모델(Sonnet·Sol) 2~3천 원, 최고품질 모델은 Opus 4천 원·Astra 1만 원 안팎입니다. (답변 길이·AI의 사고 과정에 따라 달라져요)

⭐ 6. 한 번 만들어두면 매년 쓰는 — 내 기본값

우리 반 사정에 맞게 질문을 다듬었다면 ⭐ 내 기본값으로 저장 한 번 눌러두세요.
다음 학년·다음 해에도 🔄 기본값으로 초기화만 누르면 작년에 다듬어둔 그 질문 그대로 시작합니다. 매년 처음부터 만들 필요 없어요. (같은 브라우저 기준 — PC를 바꾸거나 브라우저 데이터를 지우면 사라지니 💾 백업·복원으로 파일을 보관해두세요)
📥 질문 엑셀 다운 / 📤 질문 엑셀 업로드(📝 질문 관리 탭)도 가능 — 엑셀에서 고쳐 다시 올리거나, 동료 선생님과 질문 세트를 공유하기 좋습니다.

💡 7. 더 편하게 쓰는 작은 팁

  • 드래그로 질문 순서 변경 — 행 왼쪽 ⋮⋮ 잡고 끌기
  • 상담 카드 인쇄 — 엑셀 학생조회에서 이름 입력 후 Ctrl+P(응답+AI 한 번에 A4 세로), 또는 AI 탭 🖨️ 인쇄로 학생당 1쪽 출력
  • 새로고침해도 그대로 — 보던 탭과 선택한 학생이 유지됩니다 (F5 눌러도 'AI 상담 질문' 탭·선택 학생 그대로)
  • AI 결과 저장 — 한 번 생성한 질문은 이 브라우저에 저장돼 다시 접속해도 그대로 (일괄 생성은 이미 만든 학생을 건너뜀)
  • 다시 생성 — 마음에 안 드는 결과는 ✨ 선택 학생 질문 생성을 다시 누르면 확인 후 새 결과로 교체 (또는 🗑️ 삭제 후 생성)
  • 💾 가끔 백업하기 — 학교 PC 초기화·브라우저 데이터 삭제에 대비해 헤더의 💾 백업·복원으로 파일을 저장해두세요
  • 여러 AI 모델 동시 보유 — ChatGPT·Claude·Gemini 키 모두 등록해두면 드롭다운에서 즉시 전환
  • 자동 한국어 에러 메시지 — API 오류 발생 시 영문 대신 친절한 한국어 안내

🤝 8. 자주 묻는 질문 (FAQ)

Q. 학생 개인정보가 외부 서버로 전송되나요?
A. 이 앱은 자체 서버가 없어, 데이터는 선생님 브라우저 ↔ Google 서버(폼·드라이브) 사이만 오갑니다. 다만 AI 상담 질문을 만들 때는 응답 내용이 선택한 AI 회사(ChatGPT·Claude·Gemini)로 직접 전송됩니다. 이때 이름·학번·연락처·보호자 성명은 자동으로 빼고, 답변 속 반 친구 이름·전화번호도 가려서 보냅니다. 가족·건강 등 민감한 내용이 걱정되시면 유료 API를 권장합니다 (Gemini 무료 등급은 약관상 제품 개선에 쓰일 수 있어요).
Q. 매번 로그인 버튼을 눌러야 하나요?
A. 처음 한 번만 직접 로그인하시면 됩니다. 이후엔 같은 브라우저에서 페이지를 다시 열 때 자동으로 백그라운드 로그인이 시도됩니다. 브라우저의 Google 로그인이 풀렸거나 Google이 권한을 다시 확인할 때만 버튼을 한 번 더 누르시면 돼요 (데이터는 그대로 보존).
Q. AI가 만든 질문이 마음에 안 들어요.
A. 학생을 고른 뒤 ✨ 선택 학생 질문 생성을 다시 누르면 확인 후 새 결과로 바뀝니다 (또는 🗑️ 삭제 후 다시 생성). 모델을 바꿔서 다시 시도하는 것도 추천드려요 (ChatGPT는 균형 잡힌 톤, Claude는 통찰력 있는 질문, Gemini는 비교적 부드러운 톤).
Q. 다른 학교 동료와 같이 쓰고 싶어요.
A. 앱 주소만 알려주세요. 따로 신청 없이 Google 계정으로 바로 쓸 수 있어요 (처음 로그인 때 ②번 경고 화면 안내 참고). 각자 자기 Google 계정·브라우저에 저장되니 서로의 학생 정보는 보이지 않아요. (아직 Google 검증 전이라, 이 앱을 쓸 수 있는 선생님 수는 누적 100명까지로 제한돼 있어요)
처리 중...