WhereIsMyHome-Final

목차

1. 웹 서비스 소개
2. 기술 스택
3. 주요 기능
4. 페이지별 실행 화면
5. 실행 방법
6. ERD
7. 팀원 소개
8. 개발 일정

✨ 웹 서비스 소개

WIMH은 실시간 부동산 거래 정보를 조회할 수 있는 서비스입니다.
시도/구군/키워드에 따라 매물을 검색할 수 있으며 지도상에서 바로 확인이 가능합니다.
또한 차트를 통해 사용자에게 인기있는 매물 및 평균 거래가격을 제공합니다.

🛠️ 기술 스택

Front-end

HTML5	CSS3	JavaScript

Tailwind	Vuejs

Back-end

Java	Spring-Boot	MySQL

💡 주요 기능

기능	내용
실거래가 목록 조회	시도/ 구군/ 동/ 키워드로 검색한 매물을 지도와 함께 조회할 수 있습니다. 기본적인 정보를 포함한 리스트형식으로 마커와 함께 제공합니다.
실거래가 상세 조회	매물의 상세한 정보를 제공합니다. 또한 최근 5년간 평균 거래가격을 차트를 통해 확인할 수 있습니다.
커뮤니티	사용자 지역기반 커뮤니티로 다양한 필터링과 검색을 통해 확인할 수 있습니다.
공지사항	관리자가 올린 각종 공지사항과 공고 및 새로운 소식을 페이지 네비게이션을 통해 확인할 수 있습니다.
인기있는 매물 통계	매물의 조회수를 통해 가장 인기있는 동과 아파트 통계를 메인페이지에서 확인할 수 있습니다.

📚 페이지별 실행 화면

1. 메인화면

2. 실거래가 조회

3. 커뮤니티

4. 공지사항

---

🔍 실행 방법

Dependencies

Name	Version	Link
Node.js	^18.17.1	https://nodejs.org/en
Java	1.8	https://adoptium.net/en-GB/temurin/releases/
Maven	3.9	https://maven.apache.org/download.cgi
MySQL	8.0.34	https://dev.mysql.com/downloads/mysql/

Database Setup

1. MySQL 8.0.34 버전 설치 확인.
2. MySQL Workbench 실행, DB 연결 후 01.schema.sql, 02.data.sql, *.20220315_aptcrawl.*.sql 파일 순서대로 실행.

Run locally

1. 프로젝트 클론 후 디렉토리로 이동

   git clone https://github.com/cheesecat47/whereismyhome-final.git
   cd whereismyhome-final

2. API 서버 실행

   1. backend 디렉토리로 이동

      cd backend

   2. .env 파일의 환경 변수 확인

      SERVER_PORT=YOUR_SERVER_PORT
      
      DB_HOST=YOUR_DB_HOST
      DB_PORT=YOUR_DB_PORT
      DB_SCHEMA=YOUR_DB_NAME
      DB_USER=YOUR_USER
      DB_PASSWORD=YOUR_PASSWORD
      
      JWT_SALT=YOUR_SECRET

   3. 실행

      # 환경변수 적용
      set -a; source .env; set +a
      
      # Maven 패키징
      ./mvnw package
      
      # 실행
      java -jar target/whereismyhome_gumi_sjy_lsh-0.0.1-SNAPSHOT.jar

   4. IDE에서 실행 시 참고

      • 이클립스 환경 변수 등록 https://proni.tistory.com/127

3. Frontend 개발 서버 실행

   cd frontend
   npm i
   npm run dev

---

🖥 Entity Relation Diagram (ERD)

---

🐢 팀원 소개

이승현	신주용

📅 개발 기간

23.11.10. ~ 23.11.24 (2주)