From 1ff9afe6f43712b65f9321b19198af8228fd33ac Mon Sep 17 00:00:00 2001
From: jungwoo choi <jungwoochoi@iMac192.local>
Date: Sun, 28 Sep 2025 20:48:59 +0900
Subject: [PATCH] fix: Correct README with actual service names and
 configurations
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 실제 docker-compose.yml 서비스 이름으로 수정
- 정확한 포트 매핑 정보 업데이트
- 환경 변수 설정 방법 구체화
- Pipeline 설정 파일 생성 방법 추가
- 존재하지 않는 서비스 제거 (korea-backend, usa-backend 등)
---
 README.md | 119 ++++++++++++++++++++++++++++++++++--------------------
 1 file changed, 76 insertions(+), 43 deletions(-)

diff --git a/README.md b/README.md
index fcc3a66..8dbdf83 100644
--- a/README.md
+++ b/README.md
@@ -34,15 +34,24 @@ Site11은 다국어 뉴스 콘텐츠를 자동으로 수집, 번역, 생성하
 
 ### 포트 사용
 ```
-- 80: Nginx (Reverse Proxy)
-- 8000-8100: 마이크로서비스 백엔드
-- 3000-3100: 프론트엔드 서비스
-- 27017: MongoDB
-- 6379: Redis
-- 9092: Kafka
-- 2181: Zookeeper
-- 9000: MinIO
-- 8983: Solr
+- 3000: Console Frontend
+- 8011: Console Backend (API Gateway)
+- 8012: Users Backend
+- 8013: Notifications Backend
+- 8014: OAuth Backend
+- 8015: Images Backend
+- 8016: Google Search Backend
+- 8017: RSS Feed Backend
+- 8018: News Aggregator Backend
+- 8019: AI Writer Backend
+- 8100: Pipeline Monitor
+- 8983: Solr Search Engine
+- 9000: MinIO Object Storage
+- 9001: MinIO Console
+- 27017: MongoDB (내부)
+- 6379: Redis (내부)
+- 9092: Kafka (내부)
+- 2181: Zookeeper (내부)
 ```
 
 ## 빠른 시작 (Quick Start)
@@ -61,10 +70,13 @@ cd site11
 # .env 파일 생성
 cp .env.example .env
 
-# 필수 환경 변수 설정
-echo "COMPOSE_PROJECT_NAME=site11" >> .env
-echo "DEEPL_API_KEY=your-deepl-api-key" >> .env
-echo "OPENAI_API_KEY=your-openai-api-key" >> .env
+# 필수 환경 변수 편집 (실제 API 키로 교체 필요)
+vim .env
+# 다음 항목들을 추가:
+# DEEPL_API_KEY=your-deepl-api-key
+# OPENAI_API_KEY=your-openai-api-key
+# CLAUDE_API_KEY=your-claude-api-key
+# SERP_API_KEY=your-serp-api-key
 ```
 
 ### 3. 전체 시스템 시작
@@ -81,11 +93,17 @@ docker-compose logs -f
 
 ### 4. 서비스 확인
 ```bash
-# 헬스 체크
-curl http://localhost:8000/health
+# Console API 헬스 체크
+curl http://localhost:8011/health
 
 # MongoDB 연결 확인
 docker exec -it site11_mongodb mongosh --eval "db.serverStatus()"
+
+# Pipeline 모니터 확인
+curl http://localhost:8100/health
+
+# Console UI 접속
+open http://localhost:3000
 ```
 
 ## 상세 설치 가이드 (Detailed Installation)
@@ -104,39 +122,47 @@ sleep 30
 docker-compose ps mongodb redis kafka
 ```
 
-#### 2단계: Pipeline 서비스
+#### 2단계: 핵심 백엔드 서비스
+```bash
+# 핵심 서비스 시작
+docker-compose up -d console-backend users-backend \
+  oauth-backend images-backend files-backend \
+  statistics-backend search-backend
+
+# 서비스 상태 확인
+docker-compose ps | grep backend
+```
+
+#### 3단계: Pipeline 서비스
 ```bash
 # Pipeline 서비스 시작
 docker-compose up -d pipeline-scheduler pipeline-monitor \
   pipeline-rss-collector pipeline-google-search \
-  pipeline-ai-generator pipeline-translator \
-  pipeline-image-generator
+  pipeline-ai-article-generator pipeline-translator \
+  pipeline-image-generator pipeline-language-sync
 
 # Pipeline 모니터 확인
-curl http://localhost:8100/status
+curl http://localhost:8100/health
 ```
 
-#### 3단계: 뉴스 서비스
+#### 4단계: 뉴스 생성 서비스
 ```bash
-# 국가별 뉴스 서비스
-docker-compose up -d korea-backend korea-frontend \
-  usa-backend usa-frontend \
-  japan-backend japan-frontend \
-  china-backend china-frontend
+# 뉴스 관련 서비스
+docker-compose up -d news-aggregator-backend \
+  ai-writer-backend ai-writer-worker \
+  google-search-backend rss-feed-backend
 
-# 기업 뉴스 서비스
-docker-compose up -d samsung-backend samsung-frontend \
-  apple-backend apple-frontend \
-  google-backend google-frontend
+# AI Writer 상태 확인
+curl http://localhost:8019/health
 ```
 
-#### 4단계: 아티스트 서비스
+#### 5단계: 프론트엔드 서비스
 ```bash
-# K-POP 아티스트 서비스
-docker-compose up -d k-culture-backend \
-  blackpink-backend blackpink-frontend \
-  ive-backend ive-frontend \
-  twice-backend twice-frontend
+# Console 프론트엔드
+docker-compose up -d console-frontend
+
+# 웹 UI 접속
+# http://localhost:3000
 ```
 
 ## 서비스 구조 (Service Architecture)
@@ -161,10 +187,11 @@ pipeline-monitor (8100)          # 실시간 모니터링
 ```
 
 ### 콘텐츠 서비스
-- **Media Empire** (8200/3200): 통합 다국어 뉴스 포털
-- **국가별 서비스**: Korea, USA, Japan, China
-- **기업 서비스**: Samsung, Apple, Google, LG, Musk, WSJ
-- **아티스트 서비스**: K-Culture, Blackpink, IVE, Twice 등
+- **Console** (8011/3000): 관리 콘솔
+- **AI Writer** (8019): AI 콘텐츠 생성
+- **News Aggregator** (8018): 뉴스 수집
+- **Google Search** (8016): 검색 서비스
+- **RSS Feed** (8017): RSS 피드 수집
 
 ## 서비스 관리 (Service Management)
 
@@ -235,10 +262,16 @@ SERP_API_KEY=your-serp-api-key          # Google 검색
 
 ### Pipeline 설정
 ```bash
-# services/pipeline/.env
-WORKER_COUNT=3                           # 워커 프로세스 수
-BATCH_SIZE=10                           # 배치 처리 크기
-TRANSLATION_DELAY=1.0                   # 번역 지연 시간
+# services/pipeline/.env 파일 생성
+cat > services/pipeline/.env << EOF
+DEEPL_API_KEY=your-deepl-api-key
+OPENAI_API_KEY=your-openai-api-key
+CLAUDE_API_KEY=your-claude-api-key
+SERP_API_KEY=your-serp-api-key
+WORKER_COUNT=3
+BATCH_SIZE=10
+TRANSLATION_DELAY=1.0
+EOF
 ```
 
 ## 개발 가이드 (Development Guide)