[25.06.25 / TASK-200] Feature - 주간 뉴스레터 배치 프로세스 (#33)

* feature: html2text 라이브러리 추가
* feature: 이메일 발송 관련 환경변수 추가
* feature: 주간 뉴스레터 템플릿 추가 v1.0
* feature: 주간 뉴스레터 발송 배치 v0.5
* revert: Django 어드민용 템플릿 되살리기
* featrue: newsletter logger 설정 추가
* feature: 주간 뉴스레터 발송 배치 v1.0
* feature: 주간 뉴스레터 발송 배치 v2.0
* feature: 주간 뉴스레터 발송 배치 v2.5
* modify: 코드래빗 리뷰 짜잘이들 반영
* refactor: 뉴스레터 렌더링 하는 작업 분리
* refactor: 메서드명을 명확하게 수정 및 SESClient 의존성 주입 패턴 적용
* modify: 주석 업데이트
* modify: pre-commit 적용 및 자잘한 개선
* modify: html2text 라이브러리 삭제 및 html 태그 삭제 유틸 함수 추가
  메일 발송시 보기 좋은 text를 위해 추가한 라이브러리였으나,
  text로 받는 경우가 적음 &&  전체 서비스에 메일 발송은 작은 부분을 차지
  관련 의존성을 삭제하고 정규표현식으로 대체함
* modify: 리뷰 반영 및 사소한 수정
* feature: 주간 뉴스레터 템플릿 v2.0
  작성자 표시, 글 바로가기, 썸네일 추가
  글 아이템 박스로 표시 및 스타일 전체적으로 통일

Author: ooheunda

.env.sample

@@ -35,4 +35,7 @@ OPENAI_API_KEY=sk-proj-...
 # AWS SES
 AWS_ACCESS_KEY_ID=ID
 AWS_SECRET_ACCESS_KEY=AccEssKeY
-AWS_REGION=ap-northeast-2
+AWS_REGION=ap-northeast-2
+
+# Newsletter Info
+DEFAULT_FROM_EMAIL='no-reply@velog-dashboard.kro.kr'

.github/workflows/test-ci.yaml

@@ -74,6 +74,7 @@ jobs:
           echo "AWS_ACCESS_KEY_ID=ID" >> .env
           echo "AWS_SECRET_ACCESS_KEY=AccEssKeY" >> .env
           echo "AWS_REGION=ap-northeast-2" >> .env
+          echo "DEFAULT_FROM_EMAIL=no-reply@velog-dashboard.kro.kr" >> .env
           echo "AES_KEY_0=${{ secrets.AES_KEY_0 }}" >> .env
           echo "AES_KEY_1=${{ secrets.AES_KEY_1 }}" >> .env
           echo "AES_KEY_2=${{ secrets.AES_KEY_2 }}" >> .env

backoffice/settings/base.py

@@ -217,6 +217,21 @@
             "encoding": "utf-8",
             "filename": os.path.join(BASE_DIR, "logs", "scraping.log"),
         },
+        "newsletter_console": {
+            "level": "INFO",
+            "class": "logging.StreamHandler",
+            "formatter": "default_formatter",
+        },
+        "newsletter_file": {
+            "level": "INFO",
+            "class": "logging.handlers.TimedRotatingFileHandler",
+            "when": "midnight",
+            "interval": 1,
+            "backupCount": 7,
+            "formatter": "default_formatter",
+            "encoding": "utf-8",
+            "filename": os.path.join(BASE_DIR, "logs", "newsletter.log"),
+        },
     },
     "loggers": {
         "django": {
@@ -229,6 +244,11 @@
             "level": "INFO",
             "propagate": False,
         },
+        "newsletter": {
+            "handlers": ["newsletter_console", "newsletter_file"],
+            "level": "INFO",
+            "propagate": False,
+        },
     },
 }
 

insight/schemas.py

@@ -0,0 +1,34 @@
+from dataclasses import dataclass
+
+from insight.models import WeeklyTrendInsight
+from modules.mail.schemas import EmailMessage
+
+
+# templates/insight/index.html 데이터 스키마
+@dataclass
+class NewsletterContext:
+    s_date: str
+    e_date: str
+    is_expired_token_user: bool
+    weekly_trend_html: str | None = None
+    user_weekly_trend_html: str | None = None
+
+
+# templates/insight/weekly_trend.html 데이터 스키마
+@dataclass
+class WeeklyTrendContext:
+    insight: WeeklyTrendInsight
+
+
+# templates/insight/user_weekly_trend.html 데이터 스키마
+@dataclass
+class UserWeeklyTrendContext:
+    user: dict[str, str]  # username
+    user_weekly_stats: dict[str, int]  # posts, views, likes
+    insight: WeeklyTrendInsight
+
+
+@dataclass
+class Newsletter:
+    user_id: int
+    email_message: EmailMessage

insight/tasks/__init__.py

@@ -0,0 +1,9 @@
+import os
+import sys
+
+sys.path.append(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))))
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "backoffice.settings.local")
+
+import django
+
+django.setup()