Program description
제한 시간 동안 최대한 많이 클릭하고, 학교 급식 메뉴도 확인해보세요!
README
클릭 속도 테스트 & 학교 급식 메뉴 웹 앱
HTML, CSS, JavaScript로 구현된 제한 시간 내 클릭 횟수 측정 및 랭킹 웹 애플리케이션입니다. 추가로 학교 코드를 입력하여 해당 학교의 급식 메뉴를 확인할 수 있는 기능도 포함되어 있습니다.
프로젝트 개요
사용자가 지정된 시간 동안 얼마나 많은 클릭을 할 수 있는지 측정하고, 최고 기록을 랭킹으로 관리하는 게임입니다. 추가로 학교 코드를 입력하여 해당 학교의 급식 메뉴를 확인할 수 있는 기능도 포함되어 있습니다.
주요 기능
- [x] 프로젝트 구조 생성 및 README.md 작성
- [x] HTML 구조 생성 (타이머, 클릭 카운터, 랭킹 표시)
- [x] CSS 스타일링 (모던하고 반응형 디자인)
- [x] JavaScript 기능 구현 (타이머, 클릭 카운팅, 로컬 스토리지 랭킹)
- [x] 게임 로직 완성 및 테스트
구현된 기능들
🎮 게임 기능
- 게임 설정: 5초, 10초, 15초, 30초 중 선택 가능
- 실시간 타이머: 카운트다운 타이머와 경고 애니메이션
- 클릭 카운팅: 실시간 클릭 수 및 CPS(초당 클릭 수) 표시
- 랭킹 시스템: 상위 10개 기록을 로컬 스토리지에 저장
- 키보드 지원: 스페이스바로도 클릭 가능
- 시각적 피드백: 클릭 애니메이션, 새 기록 알림
🍽️ 급식 메뉴 기능
- 실제 NEIS API 연동: 교육청 공식 급식 API를 통한 실시간 데이터 조회
- API 인증키 지원: 공공데이터포털에서 발급받은 인증키로 무제한 조회 가능
- 지역별 학교 조회: 전국 17개 시도교육청 소속 학교 지원
- 급식 메뉴 표시: 조식, 중식, 석식 메뉴를 날짜별로 표시
- 학교 정보 저장: 입력한 학교 정보를 로컬 스토리지에 자동 저장
- 학교 변경: 언제든지 다른 학교로 변경 가능
- 로딩 상태: 데이터 조회 중 로딩 스피너 표시
- 에러 처리: API 실패 시 샘플 데이터로 자동 전환
🎨 UI/UX
- 반응형 디자인: 모바일과 데스크톱 모두 지원
- 모던 디자인: 그라데이션과 애니메이션을 활용한 세련된 인터페이스
- 직관적 조작: 간단하고 명확한 사용자 인터페이스
기술 스택
- HTML5
- CSS3 (Flexbox, Grid, 애니메이션)
- Vanilla JavaScript (ES6+)
- Local Storage (랭킹 데이터 저장)
파일 구조
pedamint-hcoding/
├── README.md
├── index.html
├── style.css
└── script.js
사용법
index.html파일을 웹 브라우저에서 열기- 게임 시작 버튼 클릭
- 지정된 시간 동안 클릭 영역을 최대한 많이 클릭
- 게임 종료 후 랭킹 확인
게임 규칙
- 기본 제한 시간: 10초
- 클릭 영역 내에서만 유효한 클릭으로 인정
- 최고 기록은 로컬 스토리지에 자동 저장
- 랭킹은 상위 10개 기록만 표시
개발 상태
✅ 프로젝트 완성 - 모든 핵심 기능이 구현되어 즉시 사용 가능합니다.
실행 방법
🎮 클릭 속도 테스트 게임
index.html파일을 웹 브라우저에서 열기- 원하는 제한 시간 선택 (5초, 10초, 15초, 30초)
- "게임 시작" 버튼 클릭
- 지정된 시간 동안 클릭 영역을 최대한 많이 클릭
- 게임 종료 후 결과 확인 및 랭킹 확인
🍽️ 학교 급식 메뉴 조회
- API 인증키 설정 (선택사항):
- 나이스교육정보개방포털에서 인증키 발급
- 발급받은 인증키를 입력하고 "키 설정" 클릭
-
인증키 없이도 샘플 데이터(5건 제한)로 조회 가능
-
학교 정보 입력:
- 지역 선택 (서울, 부산, 대구 등 17개 시도)
- 학교 코드 입력 (7자리 이상)
- 학교 코드는 학교기본정보 데이터셋에서 조회 가능
-
"급식 메뉴 조회" 버튼 클릭
-
급식 메뉴 확인:
- 5일간의 급식 메뉴 확인 (조식, 중식, 석식)
- 학교 정보는 자동으로 저장되어 다음 방문 시에도 유지
- "학교 변경" 버튼으로 다른 학교로 변경 가능
추가 기능
게임 관련
- 키보드 지원: 스페이스바를 눌러서도 클릭 가능
- 새 기록 알림: 최고 기록 갱신 시 축하 메시지 표시
- 기록 관리: 랭킹 초기화 기능 제공
급식 메뉴 관련
- 실제 API 연동: NEIS 교육청 공식 API를 통한 실시간 급식 데이터
- API 키 관리: 공공데이터포털 인증키 자동 저장 및 관리
- 지역별 지원: 전국 17개 시도교육청 소속 학교 지원
- 자동 저장: 학교 정보 자동 저장으로 편리한 재사용
- 실시간 로딩: 데이터 조회 중 로딩 스피너 표시
- 에러 처리: API 실패 시 샘플 데이터로 자동 전환
- 백업 시스템: API 오류 시에도 샘플 데이터로 서비스 지속
전체 UI/UX
- 반응형 UI: 모든 디바이스에서 최적화된 경험
- 일관된 디자인: 게임과 급식 메뉴가 조화롭게 통합된 인터페이스
🔑 API 인증키 발급 방법
- 나이스교육정보개방포털 접속: https://open.neis.go.kr/
- 로그인: 회원가입 후 로그인
- 인증키 신청: 상단 메뉴의 "활용가이드 > 인증키 신청" 클릭
- API 선택: '학교급식 식단정보' API 선택
- 신청: API 사용 신청서 작성 후 제출
- 승인 대기: 관리자 승인 후 인증키 발급
- 키 설정: 발급받은 인증키를 웹 앱에 입력
🏫 학교 코드 조회 방법
- 학교기본정보 데이터셋 접속: 학교기본정보 데이터셋
- 검색: 학교명 또는 지역으로 검색
- 학교 선택: 해당하는 학교 선택
- 코드 확인: '행정표준코드' 필드의 값을 복사
- 입력: 복사한 코드를 웹 앱의 학교 코드 입력란에 입력
📋 지원 지역
- 서울특별시 (B10)
- 부산광역시 (C10)
- 대구광역시 (D10)
- 인천광역시 (E10)
- 광주광역시 (F10)
- 대전광역시 (G10)
- 울산광역시 (H10)
- 세종특별자치시 (I10)
- 경기도 (J10)
- 강원도 (K10)
- 충청북도 (M10)
- 충청남도 (N10)
- 전라북도 (P10)
- 전라남도 (Q10)
- 경상북도 (R10)
- 경상남도 (S10)
- 제주특별자치도 (T10)