BE/.env.example at develop · Finders-Official/BE · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
# ========================================
# Finders API 환경 변수 템플릿
# ========================================
#
# 사용법:
#   로컬 개발: cp .env.example .env
#   개발 서버: cp .env.example .env.dev
#   운영 서버: cp .env.example .env.prod
#
# ========================================

# ========================================
# Spring Profile
# ========================================
# local: 로컬 개발 (Docker MySQL + Docker Redis)
# dev: 개발 서버 (GCP Cloud SQL + Docker Redis)
# prod: 운영 서버 (GCP Cloud SQL + Upstash Redis)
SPRING_PROFILES_ACTIVE=local

# ========================================
# Database (MySQL)
# ========================================
# Spring Boot 자동 매핑: SPRING_DATASOURCE_* → spring.datasource.*
#
# [로컬] Docker MySQL (기본값 - 설정 안해도 됨)
# [배포] GCP Cloud SQL - 아래 값 변경
SPRING_DATASOURCE_URL=jdbc:mysql://localhost:3306/finders?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Seoul
SPRING_DATASOURCE_USERNAME=finders
SPRING_DATASOURCE_PASSWORD=finders123

# ========================================
# Redis (캐싱)
# ========================================
# [로컬] Docker Redis (docker-compose.yml로 자동 실행)
# [dev] Docker Redis (docker-compose.dev.yml에 포함)
# [prod] Upstash Redis (SSL 필수)
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=

# ========================================
# JWT
# ========================================
# 배포 시 반드시 변경! 생성: openssl rand -base64 48
JWT_SECRET=your-jwt-secret-key-must-be-at-least-256-bits-long-for-hs256

# ========================================
# Kakao API (REST API 키 사용)
# ========================================
# 카카오 로그인 + 주소→좌표 변환 (Kakao Local API)
KAKAO_CLIENT_ID=
KAKAO_CLIENT_SECRET=
KAKAO_ADMIN_KEY=
KAKAO_REDIRECT_URI=http://localhost:8080/api/auth/kakao/callback

# ========================================
# OAuth2 - Apple (현재 미사용)
# ========================================
# APPLE_CLIENT_ID=
# APPLE_TEAM_ID=
# APPLE_KEY_ID=
# APPLE_REDIRECT_URI=http://localhost:8080/api/auth/apple/callback

# ========================================
# Google Cloud
# ========================================
GOOGLE_CLOUD_PROJECT=
# GCS 버킷 설정
GCS_PUBLIC_BUCKET=
GCS_PRIVATE_BUCKET=
GCS_SIGNED_URL_EXPIRY=60
# GCE 환경에서 Signed URL 생성 시 사용할 서비스 계정 이메일
# 로컬에서 JSON 키 파일 사용 시 생략 가능
GCS_SERVICE_ACCOUNT_EMAIL=

# ========================================
# JPA 설정
# ========================================
# 로컬/dev: update (엔티티 변경 시 자동 반영)
# prod: validate (스키마 검증만)
SPRING_JPA_HIBERNATE_DDL_AUTO=update

# ========================================
# PortOne V2 (포트원)
# ========================================
# API 키 발급: https://admin.portone.io (관리자콘솔 → 결제연동 → API Keys)
PORTONE_API_SECRET=

# ========================================
# Replicate AI (사진 복원)
# ========================================
# API 키: https://replicate.com/account/api-tokens
REPLICATE_API_KEY=
# Inpainting 모델 버전 (FLUX.1 Fill [pro] - 마스크 기반 이미지 인페인팅)
# https://replicate.com/black-forest-labs/flux-fill-pro
# 비용: $0.05/image (₩70), 속도: 빠름, 품질: 최신 모델
REPLICATE_MODEL_VERSION=c96684b78bc3e49cf4c8e4bc03d3cea723a1942042b9d016ca6fbf3fd478c93e
# 웹훅 콜백 URL (로컬: ngrok 사용, 배포: 실제 도메인)
WEBHOOK_BASE_URL=http://localhost:8080/api
# 웹훅 시크릿 (Replicate 콘솔에서 설정)
REPLICATE_WEBHOOK_SECRET=

# ========================================
# CORS (허용 도메인)
# ========================================
# 쉼표로 구분, 배포 시 실제 도메인으로 변경
CORS_ALLOWED_ORIGINS=http://localhost:3000,http://localhost:5173

# ========================================
# 개발용 토큰 발급
# ========================================
LOGIN_SECRET_KEY=local-dummy-key

# ========================================
# Sentry (에러 모니터링)
# ========================================
# DSN 확인: Sentry → Project Settings → Client Keys (DSN)
# 로컬에서는 비활성화됨 (application-local.yml)
SENTRY_DSN=

# ========================================
# Sendon (카카오톡 알림톡 대행사)
# ========================================
SENDON_ID=
SENDON_API_KEY=
SENDON_SENDER_KEY=
SENDON_PHONE_TEMPLATE_CODE=

# ========================================
# Discord (에러 알림)
# ========================================
# Webhook URL: Discord 서버 설정 → 연동 → 웹후크 만들기
# prod에서만 활성화 (application-prod.yml)
DISCORD_WEBHOOK_URL=

# ========================================
# 배포 서버 전용 (로컬에서는 불필요)
# ========================================
# Cloudflare Tunnel 토큰 (docker-compose.infra.yml에서 사용)
# TUNNEL_TOKEN=
# 리버스 프록시 뒤에서 X-Forwarded-* 헤더 신뢰
# SERVER_FORWARD_HEADERS_STRATEGY=framework