From 147f074043e5e528f70699fae46a307dd4b7f3f7 Mon Sep 17 00:00:00 2001
From: happybell80 <goeun2dcc@gmail.com>
Date: Mon, 22 Sep 2025 01:56:17 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20=EC=A0=90=EC=8B=AC=20=EC=9B=94=EB=93=9C?=
 =?UTF-8?q?=EC=BB=B5=20=EA=B0=9C=EB=B0=9C=20=ED=8A=B8=EB=9F=AC=EB=B8=94?=
 =?UTF-8?q?=EC=8A=88=ED=8C=85=20=EB=AC=B8=EC=84=9C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../250922_happybell80_lunch_worldcup.md      | 88 +++++++++++++++++++
 1 file changed, 88 insertions(+)
 create mode 100644 troubleshooting/250922_happybell80_lunch_worldcup.md

diff --git a/troubleshooting/250922_happybell80_lunch_worldcup.md b/troubleshooting/250922_happybell80_lunch_worldcup.md
new file mode 100644
index 0000000..55b7deb
--- /dev/null
+++ b/troubleshooting/250922_happybell80_lunch_worldcup.md
@@ -0,0 +1,88 @@
+# 점심 월드컵 기능 개발 및 슬랙 연동
+
+## 개발 일시
+2025-09-22
+
+## 요구사항
+- 100가지 한국 음식으로 점심 메뉴 월드컵 게임 구현
+- 매일 12시 Company-X 슬랙 채널 자동 알림
+
+## 작업 내용
+
+### 1. 프론트엔드 (frontend-customer)
+
+#### 컴포넌트 생성
+```
+src/pages/LunchWorldcup.tsx
+```
+- 100개 한국 음식 데이터 배열
+- 32강/16강/8강 선택 가능
+- 토너먼트 방식 구현
+
+#### 라우팅 설정
+```typescript
+// src/App.tsx
+<Route path="/lunch-worldcup" component={LunchWorldcup} />
+```
+
+#### 이미지 처리
+- 위치: `public/images/foods/NNN_메뉴명.jpg`
+- 100개 한국 음식 이미지 (위키백과/나무위키)
+- 형식: 001_비빔밥.jpg ~ 100_샐러드.jpg
+
+### 2. 백엔드 (rb8001)
+
+#### 알림 모듈 생성
+```
+app/notifications/
+├── __init__.py
+└── lunch.py
+```
+
+#### lunch.py 구조
+```python
+async def send_lunch_worldcup_notification(channel_id: str = None):
+    # Slack WebClient 사용
+    # COMPANYX_SLACK_BOT_TOKEN 환경변수
+    # 채널 ID: C09CP4MDX71 (Company-X)
+    # 랜덤 메시지 + 버튼 링크
+```
+
+#### main.py 스케줄 등록
+```python
+from app.notifications import send_lunch_worldcup_notification
+scheduler.add_job(
+    send_lunch_worldcup_notification,
+    CronTrigger.from_crontab("0 12 * * 1-5", timezone='Asia/Seoul'),
+    id='lunch_worldcup',
+    replace_existing=True
+)
+```
+
+## 배포 정보
+- URL: https://ro-being.com/lunch-worldcup
+- 슬랙 채널: Company-X (C09CP4MDX71)
+- 실행 시간: 평일 12:00 (Asia/Seoul)
+
+## 교훈
+1. **main.py 역할 명확화**: 스케줄 등록만, 로직은 별도 모듈
+2. **파일 구조 설계**: 알림은 notifications/, 스킬은 skills/
+3. **라우팅 경로 확인**: 404 에러시 App.tsx Route 확인
+4. **이미지 파일명**: 한글 파일명도 웹에서 동작하지만 영문 권장
+5. **환경변수 vs 하드코딩**: 크론 시간은 요구사항 확인 후 설정
+
+## 파일 변경 목록
+- frontend-customer:
+  - src/pages/LunchWorldcup.tsx (생성)
+  - src/App.tsx (라우팅 추가)
+  - public/images/foods/*.jpg (100개 이미지)
+
+- rb8001:
+  - app/notifications/lunch.py (생성)
+  - app/notifications/__init__.py (생성)
+  - main.py (스케줄 등록)
+
+## 트러블슈팅
+- 이미지 다운로드: Unsplash API 실패 → 나무위키 성공
+- 라우팅 404: /lunch → /lunch-worldcup 경로 수정
+- main.py 복잡도: 로직 분리하여 notifications 모듈 생성
\ No newline at end of file