기능경기대회 결과 대시보드

전국기능경기대회 순위를 조회할 수 있는 Node.js 기반 웹 대시보드입니다.

HRD Korea(한국산업인력공단) 기능경기대회 데이터를 실시간으로 크롤링하여, 연도·직종별 전국 순위와 시도별 결과를 웹 UI에서 바로 확인할 수 있습니다.

🔗 배포 주소: https://meister-dashboard.vercel.app

---

📌 주요 기능

• 연도 선택 (2020 ~ 2030)
• 직종 선택
• 전국 순위 조회 (등수 · 지역 · 시도등수 · 수상 · 점수 · 선수정보)
• HRD Korea 데이터 실시간 크롤링
• 로딩 스피너 UI
• 에러 처리 (데이터 없음 / 요청 실패)
• 반응형 테이블 UI

---

🧩 지원 직종

• 클라우드컴퓨팅
• IT네트워크시스템
• 사이버보안

직종은 서버의 크롤링 매핑에 따라 추가·확장할 수 있습니다.

---

🛠 사용 기술

구분	기술
런타임	Node.js
서버	Express
HTTP 통신	Axios
HTML 파싱	Cheerio
배포	Vercel

---

📥 설치 방법

git clone https://github.com/<your-username>/meister-dashboard.git

cd meister-dashboard

npm install

<your-username> 부분을 본인의 GitHub 계정으로 바꿔주세요.

---

▶️ 실행 방법

node server.js

브라우저에서 접속:

http://localhost:3000

---

📁 프로젝트 구조

meister-dashboard/
│
├── server.js          # Express 서버 + 크롤링 로직
├── package.json
├── package-lock.json
├── .gitignore
├── README.md
│
└── node_modules/

---

🔌 API

결과 조회

GET /api/results

Query Parameters

이름	타입	필수	설명
year	Number	✅	조회 연도 (예: 2026)
job	String	✅	직종명 (예: 사이버보안)

요청 예시

/api/results?year=2026&job=사이버보안

응답 예시

[
  {
    "전국등수": 1,
    "지역": "서울특별시",
    "시도등수": 1,
    "수상": "금[1등]",
    "점수": 98.5,
    "선수번호": "08",
    "이름": "이주안",
    "소속": "선린인터넷고등학교"
  }
]

실제 응답 필드명은 server.js의 파싱 로직에 맞춰 조정될 수 있습니다.

---

🖼 스크린샷

---

⚠️ 참고 사항

• 본 프로젝트는 HRD Korea 공개 데이터를 크롤링합니다. 원본 사이트의 구조가 바뀌면 크롤링이 동작하지 않을 수 있습니다.
• 데이터의 저작권은 **한국산업인력공단(HRD Korea)**에 있으며, 본 대시보드는 학습·조회 목적의 비상업적 프로젝트입니다.

---

📄 라이선스

MIT License