목차

1. 서비스 소개
2. 주요 기능
3. 기술 스택
4. 시스템 구성도
5. 실행 방법
6. 팀원 소개

1. 서비스 소개

살만할지도는 신혼부부를 위한 주거 지역 추천 서비스 입니다.
신혼부부가 주거 지역을 고를 때 해당 지역을 직접 가보기에는 시간과 정보가 부족하기 때문에 인터넷에 의존적이라는 문제점에 착안하여 쉽고 편하게 이용할 수 있는 웹 서비스를 개발하였습니다.
좋은 주거 환경을 찾고 있거나 기호에 맞는 주거 지역을 구하는 신혼부부들이 사용할 수 있습니다.

🔗 노션 바로가기

2. 주요 기능

✅ 카테고리 추천 기능

사용자 유형을 선택하면 비슷한 환경의 사람들이 선택한 카테고리를 추천해주는 기능 입니다.
기혼, 자가용, 반려동물, 자녀 유무를 선택하면 검색 횟수 기준과 평점 기준 중 원하는 것을 골라 추천받을 수 있습니다.

✅ 주거 지역 추천 기능

지역, 선호하는 환경, 평균 전세/매매 가격을 설정하면 그에 맞춰 주거 지역을 추천해주는 기능 입니다.
선호하는 환경은 카테고리 중요도를 선택함으로써 설정할 수 있습니다. 교통, 재난, 안전, 의료, 반려동물, 교육, 문화, 생활의 8가지 카테고리가 있으며 각각의 세부 카테고리에 대한 중요도를 상, 중, 하로 설정할 수 있습니다.
최대 8개의 주거 지역을 시군구 단위로 추천해주며, 이에 대한 순위를 볼 수 있습니다. 각 지역의 8가지 카테고리에 대한 점수와 상세 데이터 또한 확인할 수 있습니다.

✅ 게시판 기능

임신/출산, 육아/교육, 생활/건강, 사회/정책, 부동산 관련 뉴스를 조회할 수 있는 기능 입니다.
각 카테고리에서 신혼부부에게 유용한 정보를 확인할 수 있으며, 검색을 통해 원하는 뉴스만을 조회할 수 있습니다.

3. 기술 스택

backend

local

intellij	jdk 11	spring boot	docker

server (ec2)

docker	jenkins	nginx	mariaDB	apache spark	apache hadoop

frontend

HTML	CSS	JavaScript

React	Redux	Sass	Mui	Mapbox

4. 시스템 구성도

5. 실행 방법

backend

CI/CD

gitlab(back branch) push or merge -> jenkins webhook -> auto build

MobaXterm

docker logs

docker logs
ex ) docker logs --tail 300 salmanhaljido_server_bluedocker logs --tail 300 salmanhaljido_server_blue

에러 대처 방법

path 에러가 발생할 경우 로컬 path로 변경 후 실행

src/main/resources/data -> local path

frontend

1. 레포지토리를 clone 받는다.

git clone https://lab.ssafy.com/s07-bigdata-dist-sub2/S07P22D110.git

2. front 폴더에서 package.json에 정의된 모듈을 설치한다.

npm install

3. 환경 변수를 설정한다.

• 이를 위해 Mapbox API의 access token을 발급받아야 한다.
• front 폴더에서 .env 파일을 생성하고 아래 내용을 기입한다.

REACT_APP_MAPBOX_ACCESS_TOKEN={발급받은 Mapbox API access token}

4. 프로그램을 실행시킨다.

npm start

6. 팀원 소개

김주영	박진경	이기종	이상민	이재영
front(팀장)	front	back	back(팀장)	front