사용 설명서

01로그인과 가입

이름과 비밀번호로 로그인해요. 선생님도 같은 화면에서 로그인해요.
선생님이 내 이름을 미리 등록해 두었다면, 처음 로그인할 때 입력한 비밀번호가 내 비밀번호가 돼요.
‘가입하기’ 탭이 보이면 선생님께 받은 가입 코드로 직접 가입할 수 있어요.
비밀번호를 잊었으면 선생님께 말씀드리세요. 선생님이 초기화해 주면, 다음에 입력하는 비밀번호가 새 비밀번호가 돼요.

⚠️ 비밀번호를 5번 틀리면 5분 동안 로그인이 막혀요. 친구 이름으로 로그인을 시도하지 마세요. 한 번 로그인하면 같은 기기에서는 계속 로그인된 상태로 남아요.

02공부하는 순서

첫 화면에서 단원 카드를 누르면 개념 페이지가 열려요.
개념을 읽으면서 예제 아래의 ▶ 실행을 눌러 보세요. 코드를 고쳐서 다시 실행해도 괜찮아요(기록이 남지 않아요).
‘❓ 확인 퀴즈’는 내 답을 먼저 써 보고 [확인]을 눌러 정답과 비교해요.
개념 페이지의 ‘문제 풀러 가기’로 문제 목록에 가서 차례로 풀어요.
상단 메뉴의 ‘내 학습’에서 진도와 다시 볼 문제를 확인해요.

💻 첫 화면 위의 과목 탭(파이썬 / C / 자바 / 웹)으로 과목을 바꿔요. C·자바 문제는 제출하면 먼저 컴파일하고 채점해요. 자바는 클래스 이름을 꼭 Main으로 써요. 웹 문제는 HTML 파일 하나에 <style>·<script>까지 쓰고, 오른쪽 미리보기가 바로 바뀌어요(스크립트는 ▶ 실행). 제출하면 '검사 항목'(예: 버튼을 누르면 글자가 바뀐다)마다 ✅/❌로 채점해요. 문법이 틀리면 '컴파일 오류'와 함께 💡 도우미가 몇 번째 줄이 왜 틀렸는지 알려 줘요.

📌 첫 화면 맨 위에 공지나 지금 풀 문제(선생님이 수업 중에 정한 문제)가 보이면 먼저 확인하세요. 선생님이 낸 📚 숙제도 첫 화면과 '내 학습'에 진행률·마감일과 함께 보여요.

💾 에디터에 쓴 코드는 자동 저장돼요. 다른 기기에서 로그인해도 이어서 풀 수 있고, 첫 화면의 ‘이어서 풀기’로 마지막 문제에 바로 갈 수 있어요.

03실행과 제출은 달라요

▶ 실행 Ctrl+Enter	내 코드를 한 번 돌려 보고 공개 예제와 비교해 보여 줘요. 입력이 있는 문제는 ‘입력값’ 칸의 값이 `input()`으로 들어가요. 기록이 남지 않으니 마음껏 눌러 보세요.
제출 Ctrl+Shift+Enter	숨은 테스트까지 전부 채점해서 점수를 매기고 제출 기록에 남겨요. 공개 예제가 맞아도 숨은 테스트에서 틀릴 수 있어요.
초기화	처음 코드로 되돌려요.

같은 코드를 연달아 누르면 한 번만 채점해요. 이미 정답인 코드는 고친 뒤에만 다시 제출할 수 있어요.
‘한 줄 수정’·‘빈칸 완성’ 문제는 정해진 줄 수만 고칠 수 있어요. 더 많이 고치면 에디터에 표시돼요.
에디터 위 해/달 버튼으로 에디터를 밝게·어둡게 바꿀 수 있어요.

04채점 결과 읽기

정답	모든 테스트를 통과했어요. 🎉 해설이 열려요.
오답	결과가 기대값과 달라요. ‘몇 개 통과’와 틀린 테스트의 기대값·내 결과를 비교해 보세요. 띄어쓰기·줄바꿈도 결과에 포함돼요.
컴파일 오류	(C·자바) 실행하기 전에 문법이 틀렸어요. 세미콜론(`;`), 괄호·중괄호 짝, `#include`·`import`, 자료형을 확인하세요. 도우미가 줄 번호를 알려 줘요.
실행 오류	코드가 중간에 멈췄어요. 오류 아래의 💡 에러 도우미가 한국어로 이유를 알려 주고, 에디터에 문제가 된 줄이 빨갛게 표시돼요.
시간 초과	정해진 시간 안에 끝나지 않았어요. 끝나지 않는 반복(`while` 조건)을 확인하세요.

📋 결과 칸의 ‘제출 기록’ 탭에서 내가 낸 코드와 결과를 다시 볼 수 있어요.

05막혔을 때

힌트: 같은 문제를 5번 틀리면 힌트가 열려요. 힌트는 정답 대신 생각할 방향을 알려 줘요.
관련 개념: 힌트 옆 링크로 그 문제에 필요한 개념 페이지의 해당 부분에 바로 가요.
정답 보기는 없어요. 직접 맞혀야 해설이 열려요. 그래야 실력이 늘어요.
개념 페이지와 문제 글은 복사가 안 돼요. 직접 따라 쳐 보면 더 오래 기억나요.

📝 오답 노트: '내 학습'의 다시 볼 문제(두 번 넘게 틀린 문제)에서 [오답 노트: 차례로 다시 풀기]를 누르면, 그 문제들을 '다음 ›'으로 하나씩 다시 풀 수 있어요.
선생님과 함께 고치기: 선생님이 내 코드를 보고 고친 코드를 보내 주거나, 실시간으로 함께 편집할 수 있어요. 함께 편집 중에는 툴바에 ‘🤝 선생님과 함께 편집 중’이 보이고, 선생님 커서가 노란색으로 보여요. 언제든 [끝내기]를 누를 수 있어요.

06피드백 보내기

상단의 💬 피드백 버튼으로 채점이 이상하거나, 문제 설명이 헷갈리거나, 원하는 기능이 있으면 알려 주세요.
문제 화면에서 보내면 그 문제가 함께 전송돼요.
‘내 피드백’ 탭에서 처리 상태와 선생님 답변을 볼 수 있어요.

00권한과 로그인

학생과 같은 로그인 화면에서 로그인하면 관리자 화면으로 가요. 학생 화면에서도 상단 [관리자] 버튼으로 오갈 수 있고, 관리자도 문제를 풀 수 있어요.
왼쪽 메뉴는 내 권한에 맞는 것만 보여요. 권한: 학습 현황 · 문제 관리 · 회원 관리 · 튜터링 · 피드백 · 수업 운영 · DB 백업 · 계정 관리(최고 관리자).
관리자 로그인은 일정 시간이 지나면 자동으로 끝나요. 메뉴 아래에 지금 사이트 버전이 보여요.

01📊 현황

많이 막힌 문제 TOP 5: 오답이 많이 쌓인 문제. 수업에서 다시 짚을 문제를 고를 때 보세요.
문제별 현황: 문제마다 시도·해결한 학생 수.
학생별 현황: 학생 × 문제 표. 칸을 누르면 그 학생의 제출 기록과 코드가 열려요. 반·수업 그룹으로 거를 수 있어요.
코드 수정 기록: 학생이 코드를 어떻게 고쳐 왔는지 시간순으로 다시 볼 수 있어요(바뀐 줄 표시, 🤝 함께 편집 구간 포함).

02📝 문제

문제 목록에서 문제를 열면 편집기(problem.md 문제·시작 코드 / answer.md 정답 코드·테스트·해설·힌트)가 열려요.
[저장]을 누르면 형식을 검사하고 서버에 바로 반영한 뒤 정답 코드로 검증해요. 저장할 때마다 이전 버전이 보관되고, ‘이전 버전 불러오기’로 되돌릴 수 있어요.
[정답 코드 검증]으로 모든 문제를 한 번에 검사할 수 있어요.

⚠️ 테스트에 output을 적지 않으면 정답 코드의 실행 결과가 채점 기준이에요. 정답 코드를 바꾸면 채점 기준도 바뀌므로, 저장 전에 달라지는 테스트를 보여 주고 확인을 받아요. 이미 제출한 학생들의 결과는 다시 채점되지 않아요.

✏️ 힌트는 answer.md의 ## 힌트에 쓰고, 정답 코드를 그대로 드러내지 않게 써 주세요(학생에게는 5번 틀린 뒤에 보여요).

03👥 회원

학생 등록: 이름을 한 줄에 하나씩 붙여 넣으면 한 번에 등록돼요. 학생이 처음 로그인할 때 입력한 비밀번호가 그 학생의 비밀번호가 돼요.
가입 코드: 코드를 정해 두면 로그인 화면에 ‘가입하기’가 생겨 학생이 직접 가입해요. 코드를 지우면 가입이 닫혀요.
학생 목록: 비밀번호 초기화(다음 로그인 때 새로 정함) · 이름 변경 · 강제 로그아웃 · 삭제(제출 기록도 지워짐).
반 · 수업 그룹: 그룹을 만들고 학생을 묶으면 현황·튜터링에서 그룹별로 볼 수 있어요.
로그인 차단 현황: 비밀번호를 5번 틀리면 5분 동안 막혀요. 여기서 바로 풀어 줄 수 있어요.
차단 예외 IP: 학원·집처럼 믿을 수 있는 곳의 IP는 차단하지 않게 등록해요. 지금 접속한 곳의 IP는 [내 IP 추가] 버튼으로 바로 넣을 수 있어요.

04💬 피드백

학생이 보낸 오류 신고·문제 내용·건의가 모여요. 문제 화면에서 보낸 것은 어느 문제인지 함께 보여요.
상태(접수 · 처리 중 · 완료)를 바꾸고 답변을 쓰면 학생의 ‘내 피드백’에 보여요.

05🧑‍🏫 튜터링

👀 문제 화면에서 바로(가장 빠름): 학생 화면의 문제를 열면 툴바에 [👀 학생 코드]가 보여요. 누르면 이 문제를 푸는 학생이 최근 순으로 나오고(초록 점 = 10분 안에 고침), 고르면 같은 화면에서 그 학생 코드를 열어 실행·보내기·실시간 함께 편집을 할 수 있어요. 그동안 내 코드는 저장되지 않고 제출도 꺼지며, [✕ 내 코드로]를 누르면 돌아와요. 이전·다음 문제로 가도 그 학생 코드로 열려요.
지금 푸는 중: 최근 2시간 안에 코드를 고친 학생과 문제가 위에 떠요. 학생을 고르면 그 학생이 쓰고 있는 코드가 보여요(5초마다 새로 고침).
고쳐서 보내기: 코드를 고쳐 [학생에게 보내기]를 누르면, 학생 화면에 알림이 뜨고 학생이 [적용]을 눌러 받아요.
🤝 실시간 함께 편집: 누르면 학생 화면이 몇 초 안에 따라 들어와 같은 코드를 동시에 고쳐요. 서로의 커서가 보이고, 고친 내용은 학생 쪽에 자동 저장돼요. 학생이 문제 화면을 열고 있어야 시작되고, 학생은 언제든 끝낼 수 있어요.

💡 ‘함께 편집을 열 수 없어요’가 뜨면 서버 실시간 연결이 막힌 것이에요. 그동안은 ‘고쳐서 보내기’를 쓰세요.

06📌 수업 (수업 운영 권한)

수업 모드 — 지금 풀 문제: 그룹(또는 전체 학생)에 문제 하나를 정하면 학생 첫 화면 맨 위에 크게 뜨고, 다른 문제를 풀던 학생 화면에도 5초 안에 알림이 가요. 문제 화면 왼쪽 위 [📌 지금 풀 문제로]로 바로 정할 수도 있어요.
공지: 그룹이나 전체에 한 줄 공지. 학생 첫 화면·내 학습 위쪽 띠에 최근 3개가 보이고, 학생은 하나씩 닫을 수 있어요.
숙제: 문제 몇 개를 골라 그룹에 마감일과 함께 내요. [학생별]에서 학생 × 문제 표(✓ 맞힘 · 늦음 · 시도 수)로 완료 현황을 봐요. 숙제 문제를 모두 맞히면 완료예요.

07📄 리포트 · 🧩 코드 비교 (학습 현황 권한)

학생별 리포트: 학생 한 명이나 그룹 전체를 고르고 기간(7·14·30일)을 정하면 새로 푼 문제·막힌 문제(힌트 열림 표시)·공부한 날·숙제를 정리해 줘요. [인쇄](학생마다 쪽 나눔)나 [글로 복사](문자·메신저로 보내기)로 상담 자료로 써요.
정답 코드 비교: 코드 문제 화면 왼쪽 위 [🧩 정답 코드 비교] — 학생들이 맞힌 코드를 나란히 보여 주고, 주석·빈 줄만 다른 코드는 한 풀이로 묶어요. 수업 화면에 띄울 땐 [이름 가리기]를 켜세요.

08⚙️ 설정 · 백업

내 비밀번호 변경(8자 이상).
관리자 계정과 권한(계정 관리 권한): 선생님 계정을 추가하고 메뉴별 권한을 골라 줘요. 최고 관리자는 한 명 이상 남아 있어야 해요.
DB 백업: 매일 새벽 3시에 자동 백업되고, [지금 백업]으로 바로 만들 수도 있어요. 서버 전체도 매일 따로 NAS에 백업돼요.