😸 하냥냥

한양대학교 ERICA 학생들을 위한 캠퍼스 라이프스타일 유틸리티 앱입니다. Capacitor 기반 하이브리드 앱으로 Android / iOS를 동시에 지원합니다.

👥 개발자

역할	이름	GitHub	Email
프론트엔드	김예은	@yaeunjess	manlcoff@hanyang.ac.kr
백엔드	김동준	@kdjidkr	kdjidkr@hanyang.ac.kr

문의사항이 있다면 hanyangnyang01@gmail.com 으로 연락주세요!

📖 서비스 소개

에리카생에게 필요한 정보와 기능을 꾹꾹 눌러담은 서비스, 하냥냥입니다! 학식·셔틀버스·지하철·날씨·도서관 혼잡도 등 매일 확인해야 하는 캠퍼스 정보를 한곳에 모아 더 슬기롭고 귀여운 에리카 캠퍼스 라이프를 즐길 수 있도록 도와줍니다.

✨ 주요 기능

• 🍚 식당별 학식 조회
• 🚌 셔틀버스 & 지하철 시간표
• 🏫 단과대별 제휴 정보 모음
• ☁️ 날씨와 학정(도서관) 혼잡도
• 🔔 학식·날씨 맞춤 푸시 알림 (FCM)
• 🎓 그 외 편리한 학교 생활을 위한 기타 기능

🏗 프로젝트 아키텍처

앱은 외부 API를 직접 호출하지 않고, Vercel BFF(Serverless Functions)를 경유합니다. Supabase는 Auth·DB·RPC 목적으로 클라이언트에서 직접 연결합니다.

소스 코드 구조 (Clean Architecture)

src/
├── presentation/      # UI (React 컴포넌트, Hook, Context)
├── domain/            # 비즈니스 로직 (Entity, UseCase, Repository 인터페이스)
├── data/              # 데이터 레이어 (DataSource, Repository 구현체)
├── infrastructure/    # 플랫폼 종속 (HttpClient, SecureStorage)
├── lib/               # 외부 SDK 초기화 (firebase.js, supabase.js, platform.js)
└── di.js              # 의존성 주입 컨테이너

Vercel API 엔드포인트

엔드포인트	역할	외부 호출 대상	캐시 TTL
/api/menu	학식 HTML 스크래핑 + 파싱	한양대 홈페이지	1일
/api/subway	4호선·수인분당선 시간표	서울 열린데이터	30일 (로컬 번들)
/api/portal?type=weather	날씨·대기질 + Gemini 코멘트	Open-Meteo, Gemini	1시간(매 정각) 갱신
/api/portal?type=library	도서관 좌석 현황	한양대 도서관 API	no-cache
/api/insta-proxy	인스타 계정 프로필 사진	Instagram API	30일

Supabase 테이블

테이블	용도
devices	FCM 토큰 등록 (기기 식별)
subscriptions	알림 구독 설정 (학식·날씨 알람 시간/조건)
banners	앱 내 공지 배너
feedbacks	사용자 피드백 수집
app_config	앱 레벨 설정값 (점검 메시지, 최소 버전 등)

🛠 기술 스택

구분	사용 기술
프론트엔드	React 19 + Vite (Capacitor WebView로 래핑)
스타일링	Tailwind CSS
Android	Capacitor + Java (Kotlin 전환 예정)
iOS	Capacitor (Codemagic으로 빌드)
BFF / API	Vercel Serverless Functions
DB / Auth	Supabase (익명 Auth, DB, RPC)
푸시 알림	Firebase Cloud Messaging (FCM) — 네이티브(Android/iOS) + Web 동시 지원
에러 모니터링	Sentry (@sentry/capacitor, @sentry/react)
사용자 분석	PostHog
테스트	Playwright (E2E), Vitest
컴포넌트 문서화	Storybook
외부 API	Open-Meteo(날씨·대기질), 서울 열린데이터(지하철), 공공데이터포털(공휴일), 한양대 도서관 API, Google Gemini(날씨 코멘트 AI), Instagram API