나에게 맞는 청약 공고와 순위를 한눈에 확인하세요

하우스캔은 청년을 위한 개인 맞춤형 청약 정보를 쉽고 빠르게 제공합니다.
AI를 통해 나의 정보를 분석하여 지원 자격에 해당하는지 알 수 있습니다.
자격이 충족된다면 몇 순위에 해당하는지, 충족되지 않는다면 그 이유를 함께 설명해드립니다.

⚙ FE Technology Stacks

Library
Styling
Data Fetching
Deployment

📸 Demo Video

• 시연 영상

🚀 Getting Started

git clone https://github.com/Houscan-dev/houscan-frontend.git
cd houscan-frontend
npm install
npm start

🔥 Commit Convention

"태그:제목"의 형태이며, : 뒤에만 space가 있음에 유의합니다. ex) Feat: 메인페이지 추가

• Feat: 새로운 기능을 추가할 경우
• Fix: 버그를 고친 경우
• Design: CSS 등 사용자 UI 디자인 변경
• Docs: 문서 수정
• !BREAKING CHANGE: 커다란 API 변경의 경우 (ex API의 arguments, return 값의 변경, DB 테이블 변경, 급하게 치명적인 버그를 고쳐야 하는 경우)
• !HOTFIX: 급하게 치명적인 버그를 고쳐야하는 경우
• Style: 코드 포맷 변경, 세미 콜론 누락, 코드 수정이 없는 경우
• Refactor: 프로덕션 코드 리팩토링, 새로운 기능이나 버그 수정없이 현재 구현을 개선한 경우
• Comment: 필요한 주석 추가 및 변경
• Test: 테스트 추가, 테스트 리팩토링(프로덕션 코드 변경 X)
• Chore: 빌드 태스트 업데이트, 패키지 매니저를 설정하는 경우(프로덕션 코드 변경 X)
• Rename: 파일 혹은 폴더명을 수정하거나 옮기는 작업만인 경우
• Remove: 파일을 삭제하는 작업만 수행한 경우

🗂️ Directory Structure

📦houscan-frontend
 ┣ 📂node_modules
 ┣ 📂public
 ┃ ┣ 📂fonts
 ┃ ┣ 📜favicon.ico
 ┃ ┗ 📜index.html
 ┣ 📂src
 ┃ ┣ 📂apis
 ┃ ┣ 📂assets
 ┃ ┃ ┣ 📂icons
 ┃ ┃ ┗ 📂images
 ┃ ┣ 📂components
 ┃ ┃ ┣ 📂main
 ┃ ┃ ┣ 📂modal
 ┃ ┃ ┣ 📂personalInformation
 ┃ ┃ ┗ 📂subscription
 ┃ ┣ 📂constant
 ┃ ┣ 📂context
 ┃ ┣ 📂layout
 ┃ ┣ 📂pages
 ┃ ┃ ┣ 📂errorPage
 ┃ ┃ ┣ 📂mainPage
 ┃ ┃ ┣ 📂subscriptionPage
 ┃ ┃ ┗ 📂userPage
 ┃ ┣ 📂styles
 ┃ ┃ ┣ 📜global.js
 ┃ ┃ ┗ 📜theme.js
 ┃ ┣ 📜App.js
 ┃ ┗ 📜index.js
 ┣ 📜.env
 ┣ 📜.gitignore
 ┣ 📜package-lock.json
 ┣ 📜package.json
 ┗ 📜README.md

📆 Development Period

2025.03 - 2025.12

본 프로젝트는 2025년 성신여자대학교 AI융합학부 캡스톤디자인 프로젝트입니다.