a38fcc204c
- Updated PLAN.md to reflect Step 8 completion - Added OAuth service to current services list - Renumbered subsequent steps - Updated PROGRESS.md with Step 8 details and outcomes - Added new service ports and problem resolutions 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
147 lines
4.7 KiB
Markdown
147 lines
4.7 KiB
Markdown
# 프로젝트 진행 상황
|
|
|
|
## 완료된 단계
|
|
|
|
### Step 1: 기본 프로젝트 구조 생성 ✅
|
|
- Docker Compose 설정
|
|
- Console 서비스 (API Gateway) 기본 구현
|
|
- 프로젝트 문서 (CLAUDE.md, PLAN.md) 작성
|
|
|
|
### Step 2: Users 마이크로서비스 구현 ✅
|
|
- Users 서비스 CRUD API
|
|
- MongoDB 연동 (Beanie ODM)
|
|
- 서비스 간 통신 설정
|
|
|
|
### Step 3: MongoDB 통합 ✅
|
|
- MongoDB 컨테이너 설정
|
|
- Beanie ODM 설정
|
|
- Users 모델 및 데이터베이스 연결
|
|
- PyMongo 버전 호환성 문제 해결
|
|
|
|
### Step 4: Redis 통합 ✅
|
|
- Redis 컨테이너 설정
|
|
- 캐싱 시스템 준비
|
|
- 향후 세션 관리 및 캐싱 구현 예정
|
|
|
|
### Step 5: Frontend 스켈레톤 ✅
|
|
- React + Vite + TypeScript 설정
|
|
- Material-UI 통합
|
|
- Console Frontend 기본 구조
|
|
- npm ci → npm install 문제 해결
|
|
|
|
### Step 6: 환경 변수 및 인증 ✅
|
|
- .env 파일 설정
|
|
- JWT 인증 시스템 구현
|
|
- Console이 인증 처리 담당
|
|
- 포트 충돌 해결 (8000 → 8011)
|
|
|
|
### Step 6.5: Images 서비스 통합 ✅
|
|
- site00의 image-service 마이그레이션
|
|
- 프록시 및 캐싱 기능 유지
|
|
- WebP 변환 기능 포함
|
|
- Console에서 Images 서비스로 라우팅
|
|
|
|
### Step 7: Kafka 이벤트 시스템 ✅
|
|
- Kafka 및 Zookeeper 컨테이너 추가
|
|
- 공유 Kafka 라이브러리 생성 (Producer/Consumer)
|
|
- 이벤트 타입 정의 (USER_CREATED, USER_UPDATED, USER_DELETED 등)
|
|
- Users 서비스에 이벤트 발행 기능 추가
|
|
- aiokafka 통합
|
|
|
|
### Step 8: OAuth 2.0 인증 시스템 및 프로필 기능 ✅
|
|
- OAuth 2.0 서비스 구현
|
|
- Authorization Code, Client Credentials, Refresh Token 플로우
|
|
- 애플리케이션 등록 및 관리 (CRUD)
|
|
- 토큰 introspection 및 revocation
|
|
- PKCE 지원
|
|
- SSO 설정 지원
|
|
- Google, GitHub, SAML 프로바이더 설정
|
|
- 도메인 기반 접근 제어
|
|
- 스코프 시스템 구현
|
|
- 실용적인 스코프 카테고리 (기본 인증, 사용자, 앱, 조직, API)
|
|
- picture 스코프 추가 (프로필 사진 접근)
|
|
- Users 서비스 프로필 기능 확장
|
|
- 프로필 사진 및 썸네일 필드
|
|
- bio, location, website 필드
|
|
- 이메일 인증 및 계정 활성화 상태
|
|
- Docker 통합 완료 (포트 8003)
|
|
|
|
## 현재 실행 중인 서비스
|
|
|
|
- **Console Frontend**: http://localhost:3000
|
|
- **Console Backend**: http://localhost:8011
|
|
- **Users Service**: http://localhost:8001
|
|
- **Images Service**: http://localhost:8002
|
|
- **OAuth Service**: http://localhost:8003
|
|
- **MongoDB**: localhost:27017
|
|
- **Redis**: localhost:6379
|
|
- **Kafka**: localhost:9092
|
|
- **Zookeeper**: localhost:2181
|
|
|
|
## 다음 단계 (예정)
|
|
|
|
### Step 9: 고급 이벤트 처리
|
|
- 이벤트 소비자 구현
|
|
- 이벤트 기반 워크플로우
|
|
- 에러 처리 및 재시도 로직
|
|
|
|
### Step 10: 태스크 큐 시스템
|
|
- Kafka 기반 백그라운드 작업 처리
|
|
- 이미지 프로세싱 작업 큐
|
|
- 이메일 전송 큐
|
|
|
|
### Step 11: 고급 기능
|
|
- 실시간 알림 (WebSocket)
|
|
- 파일 업로드 시스템
|
|
- 검색 기능 (Elasticsearch)
|
|
|
|
### Step 12: 프로덕션 준비
|
|
- 로깅 시스템 (ELK Stack)
|
|
- 모니터링 (Prometheus/Grafana)
|
|
- CI/CD 파이프라인
|
|
- 테스트 자동화
|
|
|
|
## 기술 스택
|
|
|
|
- **Backend**: FastAPI (Python)
|
|
- **Frontend**: React + TypeScript + Vite + Material-UI
|
|
- **Database**: MongoDB
|
|
- **Cache**: Redis
|
|
- **Message Queue**: Apache Kafka
|
|
- **Container**: Docker & Docker Compose
|
|
- **Authentication**: JWT
|
|
|
|
## 주요 환경 변수
|
|
|
|
```env
|
|
COMPOSE_PROJECT_NAME=site11
|
|
CONSOLE_BACKEND_PORT=8011
|
|
USERS_BACKEND_PORT=8001
|
|
OAUTH_BACKEND_PORT=8003
|
|
JWT_SECRET_KEY=your-secret-key-change-in-production-12345
|
|
KAFKA_BOOTSTRAP_SERVERS=kafka:9092
|
|
```
|
|
|
|
## 문제 해결 기록
|
|
|
|
1. **PyMongo 호환성**: motor와 pymongo 버전 충돌 → pymongo==4.6.1로 고정
|
|
2. **npm ci 실패**: package-lock.json 부재 → npm install로 변경
|
|
3. **포트 충돌**: 8000 포트 사용 중 → Console을 8011로 변경
|
|
4. **WebP 변환 문제**: 검정색 이미지 출력 → convert_to_webp 임시 비활성화
|
|
5. **httpx 미사용 import**: OAuth 서비스 초기 구현시 불필요한 import → 제거
|
|
6. **Kafka producer 파라미터 오류**: max_in_flight_requests_per_connection → 제거
|
|
7. **Users 서비스 포트 누락**: docker-compose.yml에 포트 매핑 추가
|
|
|
|
## 컨텍스트 복구 정보
|
|
|
|
Claude가 재시작되면 이 정보를 참조:
|
|
|
|
- 작업 디렉토리: `/Users/jungwoochoi/Desktop/prototype/site11`
|
|
- Git 저장소: 각 단계마다 커밋됨
|
|
- Docker 개발 원칙: 모든 개발은 Docker 내에서 진행
|
|
- 문서 형식: 모든 마크다운 파일은 대문자 (CLAUDE.md, PLAN.md, PROGRESS.md)
|
|
- Console 서비스가 중앙 API Gateway 역할
|
|
- Kafka를 메인 이벤트 시스템으로 사용
|
|
- Redis는 캐싱 전용
|
|
- OAuth 2.0 서비스로 인증/인가 관리
|
|
- 모든 서비스는 독립적으로 배포 가능 |