README.md

Cavendish 소개

프로젝트 소개

• 프로젝트명: Cavendish(컴퓨터 추천 시스템)

• 프로젝트 기간: 2023-8-23 ~ 2023-10-06

• 주요 기능

  • 빅데이터를 이용한 컴퓨터 추천 시스템
  • 컴퓨터 견적서 저장
  • 컴퓨터 관련 소통 커뮤니티

• 참조 리소스

  • https://www.danawa.com/
  • https://kjwwang.com/
  • https://codepen.io/
  • https://react.dev/
  • https://docs.docker.com/

• 배포 환경

  • https://j9c105.p.ssafy.io/

• API 연동 규격서

  • https://j9c105.p.ssafy.io/api/swagger-ui/index.html

Cavendish: 컴퓨터 추천 시스템

Cavendish Logo

추천 시스템 플로우 소개

1-1. 부품 확인	1-2. 부품 선택
가지고 있거나, 미래에 구매할 컴퓨터 부품을 선택합니다.	부품 검색 및 선택

2. 용도 선택	3. 세부 용도 선택
사용할 용도를 선택합니다.	게임 등 상세한 용도를 선택합니다.

4. 예산 선택 및 보유 여부 확인	5. 우선순위 선택
예산 선택 및 보유 여부 확인	최대 3가지의 우선순위를 정합니다.

6-1. 추천 결과 확인	6-2. 추천 결과 상세
선택한 조건에 맞는 추천 결과를 확인합니다.	추천 결과를 조회 및 저장을 할 수 있습니다.

팀원 소개

팀장/Data	Backend	CI/CD	Frontend/Data	Frontend	Data
jhy1812	imbeom35	wnsdlf925	Jeongp4939	park-js515	yangJin-H
정호윤	김범창	권준일	박정훈	박주성	양진형

Cavendish 포팅 메뉴얼

컨테이너 이미지

spring: backend 폴더 내 cavendish-spring.Dockerfile로 생성
fastAPI: recommend 폴더 내 cavendish-python.Dockerfile로 생성
mariadb: mariadb:latest로 생성, root의 비밀번호는 ssafy로 한다.

필수 환경 변수

spring-server

• SPRING_DATASOURCE_URL: MariaDB 서버 주소
• SPRING_DATASOURCE_USERNAME: root
• SPRING_DATASOURCE_PASSWORD: ssafy

fastAPI-server

• fastAPI_DATASOURCE_URL: DB 컨테이너 ip주소
• fastAPI_DATASOURCE_USERNAME: root
• fastAPI_DATASOURCE_PASSWORD: ssafy

spring 빌드 및 설정

빌드 파일이 있기때문에 위에서 만든 spring 이미지를 이용해 5000번 포트로 컨테이너를 실행시킨다.

fastAPI 빌드 및 설정

빌드 파일이 있기때문에 위에서 만든 fastAPI 이미지를 이용해 8000번 포트로 컨테이너를 실행시킨다.

mariadb 및 설정

위에서 만든 mariadb 이미지를 이용해 3306번 포트로 컨테이너를 실행시킨다. mariadb 컨테이너 내에서 exec/dump 폴더 내 sql문을 동작시킨다.

프로젝트 종속성

• MariaDB: 11.1.2
• JDK: 11.0.19
• Gradle: 8.2.1
• Spring Boot: 2.7.15
• python: 3.9.13
• Node.js: 18.17.1 LTS
• npm: 10.1.0
• React: 18.2.0