Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
voka authored Nov 7, 2023
1 parent ebe9728 commit 79c2d0c
Showing 1 changed file with 91 additions and 96 deletions.
187 changes: 91 additions & 96 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,126 +1,121 @@
# Emopic-BE
Emopic-BE 저장소에는 Emopic 프로젝트에 사용에서 주요 데이터에 대한 CRUD 기능을 하는 코드가 작성되어 있습니다.

## Table Of content


## ERD
<img width="1557" alt="Screen Shot 2022-07-08 at 15 27 12" src="https://github.com/Memento-Makers/Emopic-BE/assets/80192612/cae8c1f4-443e-4f4f-9e3f-80584c4df8f0">

## 프로젝트 구조
![image](https://github.com/Memento-Makers/Emopic-BE/assets/38587274/030cc919-19cd-49ab-be72-14f8165a780c)

## 팀원 소개
<div align="center">
<br />
<table>
<tr>
<a href="https://github.com/Memento-Makers">
<img src="https://github.com/Memento-Makers/Emopic-FE/assets/74234333/906aa020-4fb6-433b-a375-22c3a8ad380b" height="100px" />
</a>
</tr>
<tr>
<td align="center">
<img src="https://avatars.githubusercontent.com/dar-jeeling" width="160px;" alt="김다은"/>
</td>
<td align="center">
<img src="https://avatars.githubusercontent.com/voka" width="160px;" alt="오재석"/>
</td>
<td align="center">
<img src="https://avatars.githubusercontent.com/SSH9753" width="160px;" alt="송승훈"/>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/dar-jeeling">
<div>김다은</div>
</a>
</td>
<td align="center">
<a href="https://github.com/voka">
<div>오재석</div>
</a>
</td>
<td align="center">
<a href="https://github.com/SSH9753">
<div>송승훈</div>
</a>
</td>
</tr>
<tr>
<td align="center">
<div>Frontend</div>
</td>
<td align="center">
<div>Bacekend, AI</div>
</td>
<td align="center">
<div>Bacekend, AI</div>
</td>
</tr>
</table>
<br />
</div>
- [기술 스택](#기술-스택)
- [준비 하기](#준비하기)
- [실행 하기](#실행하기)
- [참고 내용](#참고내용)
- [기여 하기](#기여하기)

## 기술 스택

### 언어

![Java](https://img.shields.io/badge/java-11-%233178C6)


### 라이브러리

![querydsl](https://img.shields.io/badge/querydsl-5.0.0-blue)

### 프레임워크

![Springboot](https://img.shields.io/badge/springboot-2.7.14-%236DB33F)
![Pytorch](https://img.shields.io/badge/pytorch-2.0.0+cu118-%23EE4C2C)
![Fastapi](https://img.shields.io/badge/fastapi-0.103.0-%23009688)

### Infra
![Nginx](https://img.shields.io/badge/nginx-1.25.2-%23009639)

### DataBase
## 준비하기
- spring boot와 연결할 Database를 구성해주세요
- Google Cloud Platform의 이미지 저장소를 만들고 credential.json 파일을 준비해 주세요
- Caption 결과 번역을 위해 DeepL key 혹은 papago key를 준비해주세요
- GPS 정보로 시도군 정보를 받아오기 위해 KakaoMap API Key를 준비해주세요
- AI 서버와 연결을 위해 [Emopic-AI 저장소](https://github.com/Memento-Makers/Emopic-AI.git)를 참고해 AI 서빙 서버를 구축해주세요


![Mysql](https://img.shields.io/badge/Mysql-8.0.33-%234479A1)
![Redis](https://img.shields.io/badge/Redis-7.2-%23DC382D)

### 검색
## 실행하기

![elasticsearch](https://img.shields.io/badge/elasticsearch-8.9.1-%23005571)
![logstash](https://img.shields.io/badge/logstash-8.9.1-%23005571)
환경변수 설정

## API 명세
[Swagger API 명세](https://test.emopic.shop/swagger-ui/index.html)
![화면 캡처 2023-09-07 212846](https://github.com/Memento-Makers/Emopic-BE/assets/80192612/45fcbb3d-942c-4fe8-b41e-9f072e14f1a0)
#### 1. 레포지토리 클론
```shell
git clone https://github.com/Memento-Makers/Emopic-AI.git
```

# 시작하기
## 설치
프로젝트의 원격 저장소를 Fork 하여 깃허브 내계정으로 복사하기.
#### 2. 환경변수 설정하기

Fork된 저장소를 git clone 명령으로 로컬 환경에 복사.
<details>

환경변수 설정
```
#Database
MYSQL_URL=<database_url>
MYSQL_USERNAME=<database_username>
MYSQL_PASSWORD=<database_password>
JWT_SECRET_KEY=<secret key>
JWT_ACCESS_TOKEN_EXPIRE_TIME=<token expire time>
JWT_REFRESH_TOKEN_EXPIRE_TIME=<token expire time>
#GCP
DURATION=<signed_url life time (minutes)>
PROJECT_ID=<project_id>
BUCKET_NAME=<bucket_name>
KEY_PATH=credential.json (gcs access key)
#inference-server
INFERENCE_URL=<ai-serving url>
## 기여하기
#LOG
LOG_PATH=<log_path>
### 이슈생성
이슈를 생성 하기 전에 최신 버전의 프로젝트를 사용하고 있는지 확인하세요.
#DeepL
DEEPL_AUTH_KEY=<>
관련 이슈가 이미 존재하지 않는 경우 관련 [이슈 양식](.github/ISSUE_TEMPLATE)을 사용하여 새 이슈를 열 수 있습니다.
#Swagger
REQUEST_URL=<your domain>
REQUEST_URL_DESCRIPTION=개발 서버
#CORS
CORS_LIST=http://localhost:*,http://your-domain.com
#PAPAGO
PAPAGO_AUTH_ID=<>
PAPAGO_AUTH_KEY=<>
# 스케줄러 동작 -> 하루에 1번씩 예시
SCHEDULE=0/0 0 0 1 * *
#File upload max size
MAX_FILE_SIZE = 20MB
MAX_REQUEST_SIZE = 20MB
#Kakao Map API # Kakao Map API Key
KAKAO_REST_API_KEY = <>
KAKAO_COORD_TO_REGION_URL = https://dapi.kakao.com/v2/local/geo/coord2regioncode
### 브랜치(Branch) 만들기
기능 개선이나 추가,버그 수정 등의 작업을 위해 별도의 브랜치를 만들어 진행할 수 있습니다.
```bash
git branch [branch명]
git checkout [branch명]
```
### 커밋 메시지 작성
브랜치에 작업한 내용이 만족스러우면 커밋 메시지를 작성하고 push 할 수 있습니다.
커밋 메시지 작성시 작성 양식을 따라 주세요.
</details>
<div markdown="1">

### Pull Request 작성
변경이 완료되면 Pull Request 요청을 생성할 수 있습니다.
#### 3. docker image 빌드하기
```shell
docker build -t <imagename> .
```

#### 4. docker image 실행시키기
```shell
docker run --env-file .env -v credential.json:/key.json -p 8080:8080 -d <imagename>
```


## 참고내용

### ERD
<img width="1557" alt="Screen Shot 2022-07-08 at 15 27 12" src="https://github.com/Memento-Makers/Emopic-BE/assets/80192612/cae8c1f4-443e-4f4f-9e3f-80584c4df8f0">

Pull Request 작성시 [작성 양식](.github/pull_request_template.md)을 따라 주세요.
### API 명세
[Swagger API 명세](https://dev.emopic.shop/swagger-ui/index.html)

작성 시 주의사항은 다음과 같습니다.
1. 제목은 해결하려는 이슈가 무엇인지 누구나 파악할 수 있도록 간명하게 작성한다.
2. 관련된 이슈가 있을 경우 해당 이슈의 게시물 번호를 함께 명시해준다.
3. 해결하려는 이슈의 간략한 내용, 수정/개선 방향등의 내용을 요약해서 작성한다.
4. 가급적 공손한 어투로, 무례하거나 공격적으로 느껴지지 않도록 작성한다.
## [기여하기](emopic/docs/contribute.md)

0 comments on commit 79c2d0c

Please sign in to comment.