Feat/be: HTTPS/도메인 설정 (Nginx + certbot)

[jiyoungjae]

📝 작업 내용

EC2 API 서버에 HTTPS 적용 및 도메인 연결

• Nginx 리버스 프록시 설정 (80/443 → 8080)
• Let's Encrypt certbot으로 TLS 인증서 발급 및 자동 갱신 설정
• HTTP → HTTPS 리다이렉트 적용
• 도메인 DNS A 레코드 → EC2 Elastic IP 연결
• ALB 구성 시 Idle timeout 90s 설정 (SSE 타임아웃 60s + Nginx proxy_read_timeout 90s 기준, PR feat(payment/queue): 대기열 SSE·이탈·Access Ticket 발급 구현 (#26) #37 체크리스트에서 확정)

Definition of Done (DoD)

• 핵심 비즈니스 로직에 대한 테스트 코드를 작성했는가?
• 동시성 테스트를 통과했는가? (재고·주문·결제 경로 해당 시)
• SSOT 문서(api-spec, invariants, erd-design 등)를 동시 갱신했는가?
• RestDocs API 문서를 업데이트했는가? (API 추가·수정 시)
• 로컬 환경에서 엔드투엔드 시나리오를 직접 확인했는가?
• 소스코드 내 민감 정보(API Key, 패스워드 등)가 없는가?
• https://<도메인>/actuator/health 200 응답 확인했는가?
• 인증서 자동 갱신 크론잡이 설정되어 있는가?

📅 마감 기한

• 2026-06-02

Related

• 담당자 계획: docs/ai/personas/jiyoungjae.md

[jiyoungjae]

🔗 이 이슈 완료 시 EC2 환경변수 추가 필요 — PR #66 연동

배경

PR #66 (feat: user-infrastructure 실 구현체 완성)에서 다음 기능이 구현됩니다.

• 비밀번호 재설정 메일 발송 (EmailNotificationPortImpl)
• 재설정 링크 형식: {FRONTEND_URL}/reset-password?token={token}

FRONTEND_URL의 기본값이 http://localhost:3000으로 설정되어 있어, 도메인이 확정되기 전까지는 운영 환경에서 비밀번호 재설정 메일 링크가 localhost를 가리킵니다.

이 이슈(#29) 완료 시 해야 할 작업

도메인 연결 + Nginx HTTPS 설정이 완료되면 EC2 환경변수 파일에 아래 3가지를 추가해야 합니다.

# SSM Session Manager로 EC2 접속 후
sudo vi /etc/fandrops/fandrops-prod.conf

# 아래 항목 추가
FRONTEND_URL=https://<확정된 프론트엔드 도메인>
MAIL_USERNAME=<발신용 Gmail 주소>
MAIL_PASSWORD=<Gmail 앱 비밀번호 (2단계 인증 후 발급)>

# 저장 후 서비스 재시작
sudo systemctl restart fandrops

각 항목 설명

환경변수	용도	미설정 시 증상
FRONTEND_URL	비밀번호 재설정 메일의 링크 도메인	메일 링크가 http://localhost:3000/...으로 발송됨 — 사용자가 클릭해도 아무것도 열리지 않음
MAIL_USERNAME	Gmail SMTP 발신 계정	메일 전송 요청 시 SMTP 인증 실패 (런타임 오류)
MAIL_PASSWORD	Gmail 앱 비밀번호	동일 — SMTP 인증 실패

Gmail 앱 비밀번호 발급 방법

1. Google 계정 → 보안 → 2단계 인증 활성화
2. 앱 비밀번호 → 앱 선택: 메일, 기기: 기타(직접 입력) → FANDROPS 입력
3. 생성된 16자리 비밀번호를 MAIL_PASSWORD에 사용

관련 PR

• PR feat: user-infrastructure 실 구현체 완성 (스텁 → JPA·JWT·OAuth·Mail) (#57) #66 — feat: user-infrastructure 실 구현체 완성 (EmailNotificationPortImpl 포함)
  feat: user-infrastructure 실 구현체 완성 (스텁 → JPA·JWT·OAuth·Mail) (#57) #66