Merge branch 'dev' into main

Author: JjungminLee

.github/ISSUE_TEMPLATE/feature-report.md

@@ -0,0 +1,14 @@
+---
+name: Feature Report
+about: 추가할 사항들
+title: 'feature: '
+labels: feat
+assignees: ''
+
+---
+
+# Feature Report
+
+## 추가 할 사항들
+
+## 첨부자료

.github/ISSUE_TEMPLATE/fix-report.md

@@ -0,0 +1,14 @@
+---
+name: Fix Report
+about: 고쳐야 할 사항들
+title: 'fix: '
+labels: fix
+assignees: ''
+
+---
+
+# Fix Report
+
+## 고쳐야 할 사항
+
+## 첨부자료

.github/README.md

@@ -1,13 +1,28 @@
 ![eatssu_main](https://github.com/user-attachments/assets/ae21de9d-8333-46fb-b0ad-d8578f572fda)
 
 # EAT-SSU: 숭실대 학식 리뷰 앱
+
 **EAT-SSU는 숭실대학교 학생들의 즐겁고 편리한 학식 이용을 꿈꾸는 프로젝트입니다.**
+
 - `학생식당`, `도담식당`, `푸드코트`, `스낵코너`, `기숙사 식당`의 모든 메뉴를 비교할 수 있어요.
 - 학식에 대한 리뷰를 통해 숭실대 학우들과 정보를 공유할 수 있어요.
 - 식당의 운영시간과 위치를 확인할 수 있어요!
 - [More & Contact](https://hi-jin-1514.notion.site/EAT-SSU-b04aaec9b7814a628c6ef6b3e08c74a3)
 
 ## 다운로드
+
 2023.11.27~ 서비스 중
+
 - [App Store](https://apps.apple.com/kr/app/eat-ssu-%EC%88%AD%EC%8B%A4%EB%8C%80-%ED%95%99%EC%8B%9D-%EB%A6%AC%EB%B7%B0-%EC%95%B1/id6472618331)
-- [Play Store](https://play.google.com/store/apps/details?id=com.eatssu.android)
+- [Play Store](https://play.google.com/store/apps/details?id=com.eatssu.android)
+
+## 개발 환경
+
+### Application 환경
+
+- `application.yml` 파일은 팀 내부에서만 공유합니다.
+
+### Java SDK 17
+
+- `build.gradle`을 확인해도 알겠지만, Java 17을 사용합니다.
+- Vendor는 어느 것을 사용해도 무방합니다.

.github/workflows/gradle.yml

@@ -93,7 +93,6 @@ jobs:
             sudo docker pull ${{ secrets.DOCKER_REPO }}/eatssu-prod
             sudo docker run -d -p 8080:8080 ${{ secrets.DOCKER_REPO }}/eatssu-prod
             sudo docker image prune -f
-      
 
       ## deploy to develop
       - name: Deploy to dev server

.junie/guidelines.md

@@ -0,0 +1,130 @@
+# EAT-SSU 프로젝트 가이드라인
+
+## 프로젝트 개요
+
+<<<<<<< HEAD
+EAT-SSU는 숭실대학교 학생들이 캠퍼스 내 식당 메뉴를 리뷰하고 비교할 수 있는 모바일 애플리케이션입니다. 이 앱은 메뉴 리뷰, 운영 시간, 위치 등 다양한 식사 옵션에 대한 종합적인 정보를 제공하여 식사 경험을 향상시키는 것을 목표로 합니다.
+=======
+EAT-SSU는 숭실대학교 학생들이 캠퍼스 내 식당 메뉴를 리뷰하고 비교할 수 있는 모바일 애플리케이션입니다. 이 앱은 메뉴 리뷰, 운영 시간, 위치 등 다양한 식사 옵션에 대한 종합적인 정보를 제공하여 식사 경험을
+향상시키는 것을 목표로 합니다.
+>>>>>>> bbb0601 (docs: Java SDK 17 명세)
+
+### 주요 기능
+
+- 캠퍼스 내 모든 식당 시설의 메뉴 보기 및 비교:
+<<<<<<< HEAD
+  - 학생식당
+  - 도담식당
+  - 푸드코트
+  - 스낵코너
+  - 기숙사 식당
+=======
+    - 학생식당
+    - 도담식당
+    - 푸드코트
+    - 스낵코너
+    - 기숙사 식당
+>>>>>>> bbb0601 (docs: Java SDK 17 명세)
+- 식사에 대한 리뷰 작성 및 읽기
+- 식당 운영 시간 및 위치 확인
+- 사용자 인증 시스템
+
+## 기술 스택
+
+### 백엔드
+<<<<<<< HEAD
+=======
+
+>>>>>>> bbb0601 (docs: Java SDK 17 명세)
+- **프레임워크**: Spring Boot 3.0.4
+- **언어**: Java 17
+- **데이터베이스**: MySQL (프로덕션), H2 (테스팅)
+- **ORM**: Spring Data JPA와 QueryDSL
+- **보안**: Spring Security와 JWT
+- **API 문서화**: OpenAPI (Springdoc)
+- **빌드 도구**: Gradle
+- **클라우드 스토리지**: AWS S3
+- **알림**: Slack API 통합
+
+### 모바일 애플리케이션
+<<<<<<< HEAD
+=======
+
+>>>>>>> bbb0601 (docs: Java SDK 17 명세)
+- iOS(App Store)와 Android(Play Store) 모두에서 이용 가능
+
+## 프로젝트 구조
+
+이 프로젝트는 다음과 같은 구조로 도메인 주도 설계 접근 방식을 따릅니다:
+
+```
+src/main/java/ssu/eatssu/
+├── domain/
+│   ├── menu/
+│   │   ├── entity/
+│   │   ├── persistence/
+│   │   ├── presentation/
+│   │   │   ├── dto/
+│   │   │   ├── rest/
+│   │   └── service/
+│   ├── restaurant/
+│   │   ├── entity/
+│   │   ├── persistence/
+│   │   ├── presentation/
+│   │   └── service/
+│   └── [기타 도메인]
+├── global/
+│   ├── config/
+│   ├── error/
+│   └── security/
+└── [기타 패키지]
+```
+
+## 개발 가이드라인
+
+### 코드 스타일
+<<<<<<< HEAD
+=======
+
+>>>>>>> bbb0601 (docs: Java SDK 17 명세)
+- Java 코딩 규칙 준수
+- 의미 있는 변수 및 메소드 이름 사용
+- 복잡한 로직에 대한 포괄적인 주석 작성
+- 모든 새로운 기능에 대한 단위 테스트 작성
+
+### Git 워크플로우
+<<<<<<< HEAD
+=======
+
+>>>>>>> bbb0601 (docs: Java SDK 17 명세)
+- 메인 브랜치에서 기능 브랜치 생성
+- 설명적인 커밋 메시지 사용
+- 병합 전 코드 리뷰를 위한 풀 리퀘스트 제출
+- 커밋을 집중적이고 원자적으로 유지
+
+### 보안
+<<<<<<< HEAD
+=======
+
+>>>>>>> bbb0601 (docs: Java SDK 17 명세)
+- 민감한 정보(API 키, 자격 증명)를 절대 커밋하지 않음
+- `application.yml` 파일은 팀 내에서만 공유
+- 항상 사용자 입력 검증
+- 최소 권한 원칙 준수
+
+### 테스팅
+<<<<<<< HEAD
+=======
+
+>>>>>>> bbb0601 (docs: Java SDK 17 명세)
+- 모든 서비스에 대한 단위 테스트 작성
+- API 엔드포인트에 대한 통합 테스트 사용
+- 중요 구성 요소에 대한 테스트 커버리지 유지
+
+## 배포
+
+애플리케이션은 Docker 컨테이너로 배포됩니다. 빌드 프로세스는 `eat-ssu.jar`라는 JAR 파일을 생성합니다.
+
+## 연락처
+
+프로젝트에 대한 자세한 정보는 [프로젝트 페이지](https://hi-jin-1514.notion.site/EAT-SSU-b04aaec9b7814a628c6ef6b3e08c74a3)를 방문하세요.