🎓 한대장 — 한국 대학교 장학금, 한 번에

한국 대학생이 흩어져 있는 교내·교외 장학금을 자기 조건으로 자동 매칭하고, 토스처럼 원클릭으로 신청 준비할 수 있게 하는 서비스의 MVP입니다. (최종 제출은 한국장학재단·학교 등 공식 채널에서 이루어지며, 제휴 연동 후 완전한 원클릭 제출로 확장합니다.) 전국 대학을 지원하며, 설치형 PWA로 동작합니다.

주요 기능 (v0.2)

• 전국 대학 지원 — 학교 검색 선택(주요 55개 대학 자동완성 + 직접 입력), 전공 계열 기반 매칭
• 1분 온보딩 — 학교·계열·학년·직전학기 평점·학자금 지원구간·특별자격(수급자/다자녀/보훈 등) 입력
• 맞춤 매칭 엔진 — 교외(국가장학금 Ⅰ·Ⅱ유형, 국가근로, 인문100년, 대통령과학, 재단 등 9종) + 재학 대학 기준 교내 장학금(6~7종) 자격요건을 규칙 기반으로 진단
  • 신청 가능 / 지원 가능·선발 심사 / 정보 입력 필요 / 요건 미충족 4단계 판정
  • 요건별 충족/미충족 사유를 상세 화면에서 투명하게 표시
• 원클릭 신청 — 증명서 자동 첨부 개념, 가능한 장학금 N건 일괄 신청
• 신청 현황 추적 — 신청완료 → 서류검토 → 심사 → 선정발표 진행 표시
• PWA — 홈 화면에 설치 가능, 오프라인 캐시 지원 (앱스토어 진출의 기반)

실행 / 배포

빌드 과정이 없는 정적 웹앱입니다.

# 로컬 실행
python3 -m http.server 8000
# http://localhost:8000 접속 (모바일 뷰 권장, max-width 480px)

GitHub Pages 배포: 이 저장소는 Pages가 main 브랜치 배포 모드로 설정되어 있어 main에 push하면 자동 배포됩니다 (별도 워크플로 불필요). 접속 주소: https://seonju5543-web.github.io/hanggonggan/

앱스토어 진출 경로:

1. (현재) PWA — 브라우저에서 "홈 화면에 추가"로 설치
2. Android: Bubblewrap으로 TWA 패키징 → Google Play 등록 (개발자 계정 $25 1회)
3. iOS: Capacitor로 래핑 → App Store 등록 (개발자 계정 $99/년, macOS + Xcode 필요)

구조

파일	역할
index.html	화면 구조 (온보딩 · 홈 · 장학금 탐색 · 신청내역 · MY)
style.css	프리미엄 모바일 우선 UI (Pretendard, 딥 네이비 팔레트)
data.js	교외 장학금 데이터 + 교내 장학금 템플릿 + 자격요건 규칙 (시연용)
app.js	매칭 엔진 · 화면 렌더링 · 신청 플로우 · localStorage 상태
manifest.json / sw.js / icons/	PWA (설치·오프라인)
BUSINESS.md	수익화 전략

로드맵

• 대학·한국장학재단 공고 크롤링/API 연동으로 실데이터 대체 (공식 공고 우선, 출처 링크·검증일 필드)
• 학교 포털 SSO 연동 (성적·재학 정보 자동 조회)
• 전자서류 제출 연동 (정부24, 웹발급 증명서)
• 마감 푸시 알림 (PWA Web Push)
• Play Store(TWA) → App Store(Capacitor) 출시

데이터 운영 규칙

• 현재 장학금 데이터(교외 9종 + 교내 템플릿 6~7종)는 실제 제도를 모델로 한 시연용 샘플입니다.
• 장학금 추가·공통서류 항목 변경은 개발자(저장소 소유자) 컨펌 후에만 진행합니다.
• 신규 장학금 추가 시 필수 필드: 출처 공고 링크(source_url), 검증일, 공식 제출 채널.

⚠️ 현재 포함된 장학금 정보는 시연용 예시 데이터입니다. 실제 공고는 각 학교 홈페이지와 한국장학재단(kosaf.go.kr)을 확인하세요.