42 Seoul과 기업이 협력하여 애플리케이션을 만드는 프로젝트입니다.
Munetic이라는 음악 레슨 매칭앱의 MVP(Minimum Viable Product)를 구현하는 것을 목적으로 하며 3 명이 한 팀이 되어 약 1달간의 개발 기간을 가지며 총 3개의 개발 팀이 릴레이 방식으로 개발하는 프로젝트입니다.
Munetic 앱의 프로젝트는 docker-compose로 구성되어 있습니다. 이 프로젝트는 github actions를 통한 배포를 상정하여 구현이 되어 있습니다.
프로젝트를 실행시키는 방법은 다음과 같습니다.
- .env_template 파일을 통해 .env를 설정해줍니다.
SERVER_HOST=localhost가 아닌 경우 자동으로 https가 설정됩니다. 설정해야 하는 항목은 다음과 같습니다.- MARIADB_USER : MariaDB 유저 ID
- MARIADB_PASSWORD : MariaDB 유저 PW
- MARIADB_ROOT_PASSWORD : MariaDB ROOT PW
- EXPRESS_USER : express에서 MariaDB에 접속할 때 사용하는 유저 ID (MARIADB_USER와 동일해야 함)
- EXPRESS_USER : express에서 MariaDB에 접속할 때 사용하는 유저 PW (MARIADB_PASSWORD와 동일해야 함)
- ACCESS_SECRET : express에서 JWT Token을 생성할 때 사용하는 임의의 문자열
- REFRESH_SECRET : express에서 JWT Refrash Token을 생성할 때 사용하는 임의의 문자열
- SERVER_HOST : 서버의 호스트 네임 (localhost일 경우 ssl 설정은 하지 않습니다.)
- MODE : 서버의 배포 모드를 선택합니다. (dev / serve)
- munetic_admin, munetic_app, munetic_express 내에서
npm i를 실행하여 package-lock.json 파일을 생성합니다. docker-compose -f docker-compose.yaml -f network.yaml up를 통해 실행시킵니다. docker-compose를 이용해 실행시킬 경우 munetic_admin, munetic_app, munetic_express에 직접 접근하지 못하고 nginx proxy를 통해 접근하게 됩니다.- 브라우저를 통해 http://hostname 에 접속합니다. 호스트 네임이 localhost가 아닐 경우 자동으로 https로 리다이렉트 시킵니다. (SSL 인증서 경로는 munetic_proxy에서 설정합니다.)
이 프로젝트는 모바일 전용 앱 (관리자 페이지는 PC 전용 앱) 으로 구현되었으며 크롬과 사파리 브라우저에서 테스트되었습니다.
munetic_admin 상세 설명 링크
React 기반으로 구현된 Munetic 앱의 관리자가 이용하는 어드민 페이지의 PC 뷰입니다.
munetic_app 상세 설명 링크
React 기반으로 구현된 Munetic 앱의 사용자가 이용하는 일반 앱의 모바일 뷰입니다.
munetic_express 상세 설명 링크
express.js 기반으로 구현된 프론트앤드 앱에 정보를 제공하고 전달받는 munetic의 백앤드입니다.
munetic_database 상세 설명 링크
MariaDB 기반의 munetic의 사용자, 레슨, 카테고리 등의 정보를 저장하는 database입니다.
munetic_proxy 상세 설명 링크
nginx를 이용해 munetic 프로젝트를 한 포트에서 접근할 수 있게 리버스 프록시를 제공하는 웹서버입니다.
- 시나리오 : https://github.com/innovationacademy-kr/slabs-munetic/blob/develop/docs/scenario.md
- figma 와이어프레임 (~2022.04.20) : 초안 구성
- figma 와이어프레임 (2022.04.21 ~) : 새로 정리
- https://munetic.dev.42cadet.kr (develop branch)
- https://munetic.42cadet.kr (main branch)