이메일 인증과 비밀번호 재설정 추가

docs/deploy.md

@@ -29,6 +29,9 @@ JWT_SECRET=32자_이상의_랜덤_문자열
 ADMIN_EMAIL=관리자_이메일
 ADMIN_PASSWORD=8자_이상의_비밀번호
 WEB_PORT=44082
+APP_BASE_URL=http://localhost:44082
+RESEND_API_KEY=Resend_API_Key
+RESEND_FROM_EMAIL=UNIARE <인증된_발신주소>
 ```
 
 랜덤 문자열은 `openssl rand -hex 32`로 만들 수 있다.
@@ -59,15 +62,27 @@ ADMIN_PASSWORD=8자_이상의_비밀번호
 ADMIN_USERNAME=admin
 WEB_PORT=44082
 CORS_ORIGINS=https://uniare.sori.studio
+APP_BASE_URL=https://uniare.sori.studio
+RESEND_API_KEY=Resend_API_Key
+RESEND_FROM_EMAIL=UNIARE <account@인증된_발신도메인>
 ```
 
+Resend에서 소유한 도메인 또는 발신용 하위 도메인을 먼저 추가하고 DNS 인증을 완료해야 한다. API Key에는 메일 발송 권한이 필요하며 `.env` 외에는 기록하지 않는다.
+
 Docker 실행: `docker compose -f docker-compose.prod.yml up -d --build`
 
 상태 확인: `docker compose -f docker-compose.prod.yml ps`
 
 API 확인: `curl -fsS http://localhost:44082/api/v1/health`
 
-정상이면 `{"ok":true,"version":"4.0.11"}`이 표시된다.
+정상이면 `{"ok":true,"version":"4.0.12"}`이 표시된다.
+
+이메일 기능 확인:
+
+1. 실제 수신 가능한 주소로 신규 가입한다.
+2. 인증 메일 링크를 누르기 전 로그인이 차단되는지 확인한다.
+3. 인증 후 로그인되는지 확인한다.
+4. 로그인 화면의 `비밀번호를 잊으셨나요?`에서 재설정 메일과 새 비밀번호 로그인을 확인한다.
 
 NAS 리버스 프록시는 `https://uniare.sori.studio`을 `http://<NAS_IP>:44082`로 연결한다.
 
@@ -142,6 +157,8 @@ curl -s http://127.0.0.1:44082/script/deck-favorites.js | tail -1
 
 HTML·`style/`·`script/`만 바뀐 경우 API 컨테이너 재시작은 필요 없다.
 
+이메일 기능은 API와 Compose 환경 변수가 함께 바뀌므로 `git pull`만으로 반영되지 않는다. 반드시 `.env` 설정 후 전체 스택을 다시 빌드한다.
+
 ## 4. 전체 업데이트
 
 `api/`, `nginx/`, Dockerfile, Compose 설정을 변경했다면 NAS 프로젝트 폴더에서 다음 명령을 실행한다.