🎶 Encorely (앵콜리)

“공연의 여운을 기록하는 공간”
Encore(앙코르) + ly = 앙코르처럼 기록하다

공연의 여운을 기록하고 팁을 공유하며,
모두의 공연 생활을 응원하는 앱입니다.

---

🔧 기술 스택 (Tech Stack)

Backend

Database

Deployment

Version Control

---

☁️ AWS 서비스 구성도 (Architecture)

---

📂 프로젝트 구조 (Project Structure)

src
└── main
    └── java
        └── spring.encorely
            ├── apiPayload
            │   ├── code
            │   ├── exception
            │   └── ApiResponse
            ├── component
            ├── config
            │   ├── jwt
            │   └── security
            │       ├── RedisConfig
            │       ├── RestTemplateConfig
            │       ├── S3Config
            │       ├── SchedulingConfig
            │       ├── SwaggerConfig
            │       └── WebConfig
            ├── controller
            │   ├── addressController
            │   ├── authController
            │   ├── hallController
            │   ├── noticeController
            │   ├── notificationController
            │   ├── reviewController
            │   ├── s3Controller
            │   ├── scrapFileController
            │   ├── showController
            │   └── userController
            ├── domain
            │   ├── comment
            │   ├── common
            │   ├── enums
            │   ├── hall
            │   ├── like
            │   ├── notification
            │   ├── review
            │   ├── scrap
            │   ├── show
            │   └── user
            ├── dto
            │   ├── commentDto
            │   ├── hallDto
            │   ├── kakaoLocalDto
            │   ├── noticeDto
            │   ├── notificationDto
            │   ├── reviewDto
            │   ├── s3Dto
            │   ├── scrapDto
            │   ├── showDto
            │   └── userDto
            ├── exception
            │   └── NotFoundException
            ├── listener
            │   ├── ListenerUtil
            │   └── UserEntityListener
            ├── notice
            │   └── Notice
            ├── repository
            │   ├── commentRepository
            │   ├── hallRepository
            │   ├── likeRepository
            │   ├── noticeRepository
            │   ├── notificationRepository
            │   ├── reviewRepository
            │   ├── scrapRepository
            │   ├── showRepository
            │   └── userRepository
            ├── service
            │   ├── addressService
            │   ├── authService
            │   ├── commentService
            │   ├── hallService
            │   ├── likeService
            │   ├── noticeService
            │   ├── notificationService
            │   ├── reviewService
            │   ├── s3Service
            │   ├── scrapService
            │   ├── showService
            │   └── userService
            └── EncorelyApplication

---

🤝 협업 규칙 (Collaboration Rules)

브랜치 전략 (Branching Strategy)

• main 브랜치에서 develop 브랜치를 분기
• 개발자들은 develop 브랜치에 자유롭게 커밋
• 신규 기능 구현 시 develop에서 feature/* 브랜치 분기
• 기능 개발 및 테스트 완료 후 release 브랜치를 main과 develop에 병합

---

📝 코드 컨벤션 (Code Convention)

• 패키지명: 소문자로 시작 (com.example.encorely)
• 변수명/메서드명: camelCase 사용 (예: upperCase)
• 클래스명: 페이지명·기능명 직접 사용 지양
• 주석: 앞뒤로 공백 추가 (// 주석 내용), 불필요한 주석 지양

---

📥 PR 규칙 (Pull Request Rules)

• 제목 형식: [타입] 내용 (예: [Feature] 로그인 기능 구현)
• 설명 템플릿:

  ## 작업 내용
  - 주요 기능 설명
  
  ## 테스트 결과
  - 테스트 방법 및 결과

• 리뷰어: 최소 1명 이상 승인 필수
• 코멘트: 문제점·개선 방향 명확히 기재

---

💬 커밋 메시지 (Commit Message)

• 형식: type: subject
• 예시: feat: 로그인 API 엔드포인트 추가

Type 종류

• feat : 새로운 기능 추가
• fix : 버그 수정
• docs : 문서 수정
• style : 코드 포맷팅/세미콜론 누락 등
• refactor : 코드 리팩토링
• test : 테스트 코드
• chore : 빌드·패키지 설정 변경
• comment : 주석 변경
• add : 파일 추가

---

👨‍👩‍👧‍👦 팀원

로기 / 김다은

파울로 / 박시윤

안젤라 / 이소현

현 / 이승현