github-link

프로젝트 구성원

👨‍💻 담당 업무

• 전체 시스템 아키텍처 설계
• FastAPI 전체 API 서버 개발
• FastAPI SMTP 연동 및 이메일 인증
• FastAPI & MongoDB 채팅방 CRUD 기능
• SpringBoot 오피스(Office) & 케릭터(Character) 채팅방에 관한 MySQL의 유저와 MongoDB CRUD 기능
• SpringBoot 채팅방 API를 AI서버 API 연동
• 간트 차트, Hybrid ERD, 다이어그램 및 문서화 작업

📁 프로젝트 디렉토리 구조

파일을 클릭하면 해당 GitHub에 main 브런치 기준 파일로 이동합니다. 해당 디렉토리 구조는 서정훈이 개발한 파일들만 표기되어 있습니다.

📦 루트 디렉토리 구조

 ┣ 📜[.env](None)
 ┣ 📜CODE_OF_CONDUCT.md
 ┣ 📜docker-compose.yml
 ┣ 📜LICENSE
 ┣ 📜readme.md
 ┣ 📜react_build.bat
 ┗ 📜rebuild.bat

📦 fastapi 디렉토리 구조

 ┣ 📂batch
 ┃ ┣ 📜venv_install.bat
 ┃ ┗ 📜venv_setup.bat
 ┣ 📂src
 ┃ ┣ 📂api
 ┃ ┃ ┣ 📂mongo_controller
 ┃ ┃ ┃ ┣ 📜character_controller.py
 ┃ ┃ ┃ ┣ 📜office_controller.py
 ┃ ┃ ┃ ┗ 📜__init__.py
 ┃ ┃ ┣ 📜smtp_controller.py
 ┃ ┃ ┗ 📜__init__.py
 ┃ ┣ 📂core
 ┃ ┃ ┣ 📜app_state.py
 ┃ ┃ ┣ 📜dependencies.py
 ┃ ┃ ┗ 📜__init__.py
 ┃ ┣ 📂docs
 ┃ ┃ ┗ 📜api_specification.md
 ┃ ┣ 📂logs
 ┃ ┣ 📂schemas
 ┃ ┃ ┣ 📜schema.py
 ┃ ┃ ┗ 📜__init__.py
 ┃ ┣ 📂server
 ┃ ┃ ┣ 📜Dockerfile
 ┃ ┃ ┗ 📜server.py
 ┃ ┣ 📂services
 ┃ ┃ ┣ 📜email_client.py
 ┃ ┃ ┣ 📜mongodb_client.py
 ┃ ┃ ┣ 📜mysql_client.py
 ┃ ┃ ┗ 📜__init__.py
 ┃ ┣ 📂utils
 ┃ ┃ ┣ 📜error_tools.py
 ┃ ┃ ┗ 📜__init__.py
 ┃ ┗ 📜[.env](None)
 ┣ 📜.dockerignore
 ┣ 📜requirements.txt
 ┗ 📜wait-for-it.sh

📦 mysql 디렉토리 구조

 ┣ 📂logs
 ┣ 📂migrations
 ┃ ┣ 📜V1.1.0__init.sql
 ┃ ┣ 📜V1.1.1__init.sql
 ┃ ┗ 📜V1.1.5__init.sql
 ┣ 📜Dockerfile
 ┣ 📜flyway-migrate.sh
 ┣ 📜init.sql

📦 springboot 디렉토리 구조

• ./springboot

 ┣ 📂src
 ┃ ┣ 📂docs
 ┃ ┃ ┣ 📜RoomController.md
 ┗ 📜wait-for-it.sh

• ./springboot/src/main/java/com/TreeNut

 ┗ 📂ChatBot_Backend
 ┃ ┣ 📂controller
 ┃ ┃ ┣ 📜RoomController.kt
 ┃ ┣ 📂repository
 ┃ ┃ ┣ 📜ChatroomRepository.kt
 ┃ ┃ ┣ 📜OfficeroomRepository.kt
 ┃ ┣ 📂service
 ┃ ┃ ┣ 📜RoomService.kt

🏗️ 전체 아키텍처

• nginx: API Gateway 및 웹 서버 (443 포트, HTTPS 지원)
  • React 프론트엔드 정적 파일 서빙
  • FastAPI/Spring Boot 백엔드 프록시 역할
• FastAPI: Python 백엔드 API 서버 (8000 포트)
  • Google SMTP 연동 및 MySQL로 이메일 인증 정보 저장
  • 채팅방 CRUD 기능 MongoDB 사용
• SpringBoot: Java 백엔드 API 서버 (8080 포트)
  • AI용 API(FastAPI)와 채팅방, SMTP용 API(FastAPI) 통합 관리
  • 소셜 로그인 및 사용자 인증 처리
  • 케릭터 챗봇 CRUD 기능
• admincontroller: Node.js 관리자 컨트롤러 (5785 포트)
  • GCP 연결, 클라우드에 저장된 이미지 관리
• mysql: 관계형 데이터베이스 (3308 포트)
  • 유저, 유저의 채팅방 정보, 유저의 캐릭터, SMTP 이메일 인증 정보 저장
• mongodb: NoSQL 데이터베이스 (27017 포트)
  • 채팅방 메시지 저장
• flyway: 데이터베이스 마이그레이션 도구
  • MySQL 스키마 버전 관리

📋 시스템 아키텍처 다이어그램

📋 Hybrid ERD

🌐 API Gateway (nginx) 구조

• 정적 파일 서빙: React 빌드 결과물과 정적 리소스 제공
  • /static/ → 정적 파일 (7일 캐시)
  • CSS, JS, 이미지 파일 등 (30일 캐시)
• API 라우팅:
  • / → React SPA (index.html 폴백)
  • /sub/ → FastAPI 서버(8000)로 프록시
  • /server → Spring Boot 서버(8080)로 프록시
• OAuth 인증 처리:
  • /auth/ → 인증 관련 요청 처리
  • Google, Facebook 등 외부 인증 제공자와 연동
  • JWT 토큰 발급 및 검증
• CORS 설정:
  • 모든 도메인에서의 요청 허용
  • 인증 정보 포함 요청에 대한 처리
• 에러 핸들링:
  • 404 에러 페이지 설정
  • 서버 에러 시 일반화된 에러 메시지 반환

🖼️ 시연 영상

📅 개발 로드맵 및 버전 릴리즈 일정

간트 차트 (ChatBot 버전 릴리즈)

주요 마일스톤

개발 통계

• 총 개발 기간: 12개월 (2024.07 ~ 2025.07)
• 메이저 버전: 7개 (v0.1.x ~ v1.1.x)
• 릴리즈 횟수: 27회
• 주요 기술 전환: 6회 (단일→다중→AI통합→풀스택→클린→엔터프라이즈→모바일)

🗓️ 버전별 명세

📄 v0.1.x

• First Commit Days : 2024-08-27 (화) 15:35:49 (한국 표준시)
• Last Commit Days : 2024-09-03 (화) 17:08:48 (한국 표준시)

📄 v0.2.x

• First Commit Days : 2024-09-10 (화) 01:50:24 (한국 표준시)
• Last Commit Days : 2024-10-26 (토) 16:58:55 (한국 표준시)

📄 v0.3.x

• First Commit Days : 2024-10-31 (목) 14:10:45 (한국 표준시)
• Last Commit Days : 2025-03-13 (목) 15:58:41 (한국 표준시)

📄 v0.4.x

• First Commit Days : 2025-03-15 (토) 17:08:51 (한국 표준시)
• Last Commit Days : 2025-05-10 (토) 09:05:10 (한국 표준시)

📄 v0.5.x

• First Commit Days : 2025-05-10 (토) 13:59:33 (한국 표준시)
• Last Commit Days : 2025-05-10 (토) 19:36:21 (한국 표준시)

📄 v1.0.x

• First Commit Days : 2025-05-10 (토) 20:44:08 (한국 표준시)
• Last Commit Days : 2025-06-19 (목) 20:20:14 (한국 표준시)

📄 v1.1.x

• First Commit Days : 2025-06-19 (목) 21:16:29 (한국 표준시)
• Last Commit Days : 2025-07-10 (목) 13:40:59 (한국 표준시)