Bootstrap

Game

클릭 속도 테스트 & 학교 급식 메뉴

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

사용법

  1. index.html 파일을 웹 브라우저에서 열기
  2. 게임 시작 버튼 클릭
  3. 지정된 시간 동안 클릭 영역을 최대한 많이 클릭
  4. 게임 종료 후 랭킹 확인

게임 규칙

  • 기본 제한 시간: 10초
  • 클릭 영역 내에서만 유효한 클릭으로 인정
  • 최고 기록은 로컬 스토리지에 자동 저장
  • 랭킹은 상위 10개 기록만 표시

개발 상태

✅ 프로젝트 완성 - 모든 핵심 기능이 구현되어 즉시 사용 가능합니다.

실행 방법

🎮 클릭 속도 테스트 게임

  1. index.html 파일을 웹 브라우저에서 열기
  2. 원하는 제한 시간 선택 (5초, 10초, 15초, 30초)
  3. "게임 시작" 버튼 클릭
  4. 지정된 시간 동안 클릭 영역을 최대한 많이 클릭
  5. 게임 종료 후 결과 확인 및 랭킹 확인

🍽️ 학교 급식 메뉴 조회

  1. API 인증키 설정 (선택사항):
  2. 나이스교육정보개방포털에서 인증키 발급
  3. 발급받은 인증키를 입력하고 "키 설정" 클릭
  4. 인증키 없이도 샘플 데이터(5건 제한)로 조회 가능

  5. 학교 정보 입력:

  6. 지역 선택 (서울, 부산, 대구 등 17개 시도)
  7. 학교 코드 입력 (7자리 이상)
  8. 학교 코드는 학교기본정보 데이터셋에서 조회 가능
  9. "급식 메뉴 조회" 버튼 클릭

  10. 급식 메뉴 확인:

  11. 5일간의 급식 메뉴 확인 (조식, 중식, 석식)
  12. 학교 정보는 자동으로 저장되어 다음 방문 시에도 유지
  13. "학교 변경" 버튼으로 다른 학교로 변경 가능

추가 기능

게임 관련

  • 키보드 지원: 스페이스바를 눌러서도 클릭 가능
  • 새 기록 알림: 최고 기록 갱신 시 축하 메시지 표시
  • 기록 관리: 랭킹 초기화 기능 제공

급식 메뉴 관련

  • 실제 API 연동: NEIS 교육청 공식 API를 통한 실시간 급식 데이터
  • API 키 관리: 공공데이터포털 인증키 자동 저장 및 관리
  • 지역별 지원: 전국 17개 시도교육청 소속 학교 지원
  • 자동 저장: 학교 정보 자동 저장으로 편리한 재사용
  • 실시간 로딩: 데이터 조회 중 로딩 스피너 표시
  • 에러 처리: API 실패 시 샘플 데이터로 자동 전환
  • 백업 시스템: API 오류 시에도 샘플 데이터로 서비스 지속

전체 UI/UX

  • 반응형 UI: 모든 디바이스에서 최적화된 경험
  • 일관된 디자인: 게임과 급식 메뉴가 조화롭게 통합된 인터페이스

🔑 API 인증키 발급 방법

  1. 나이스교육정보개방포털 접속: https://open.neis.go.kr/
  2. 로그인: 회원가입 후 로그인
  3. 인증키 신청: 상단 메뉴의 "활용가이드 > 인증키 신청" 클릭
  4. API 선택: '학교급식 식단정보' API 선택
  5. 신청: API 사용 신청서 작성 후 제출
  6. 승인 대기: 관리자 승인 후 인증키 발급
  7. 키 설정: 발급받은 인증키를 웹 앱에 입력

🏫 학교 코드 조회 방법

  1. 학교기본정보 데이터셋 접속: 학교기본정보 데이터셋
  2. 검색: 학교명 또는 지역으로 검색
  3. 학교 선택: 해당하는 학교 선택
  4. 코드 확인: '행정표준코드' 필드의 값을 복사
  5. 입력: 복사한 코드를 웹 앱의 학교 코드 입력란에 입력

📋 지원 지역

  • 서울특별시 (B10)
  • 부산광역시 (C10)
  • 대구광역시 (D10)
  • 인천광역시 (E10)
  • 광주광역시 (F10)
  • 대전광역시 (G10)
  • 울산광역시 (H10)
  • 세종특별자치시 (I10)
  • 경기도 (J10)
  • 강원도 (K10)
  • 충청북도 (M10)
  • 충청남도 (N10)
  • 전라북도 (P10)
  • 전라남도 (Q10)
  • 경상북도 (R10)
  • 경상남도 (S10)
  • 제주특별자치도 (T10)
Preview

Attachments

  • config.js
  • index.html
  • README.md
  • script.js
  • style.css

Attachments