B2B 화상 회의 + AI 요약 + 알림 서비스 (MSA w/ Spring Boot 3 & Kotlin)

Current Version: v0.4.9 | Deployed: api.onmeet.cloud

• Language: Kotlin (Auth/Gateway), Java (AI/Video/Notification/Email), Go (File)
• Framework: Spring Boot 3.3.5, Spring Cloud 2023.x, Gin (Go)
• Build Tool: Gradle (Kotlin DSL), Go Modules
• Shared Libraries: onmeet-common, common-security (Kotlin)

• Architecture: 마이크로서비스 아키텍처 (MSA)
• Gateway: Spring Cloud Gateway (WebFlux)
• Communication: REST API, Kafka (이벤트 기반)
• Database: MySQL 9.0 (대부분), PostgreSQL 16 (File Service), Redis (인증/캐싱)
• File Storage: MinIO (S3 호환) + Nginx 프록시 서빙
• Deployment: GCP VM (e2-standard-4) + Docker Compose + GitHub Actions CI/CD
• DNS/CDN: Cloudflare (DNS 프록시, Pages)

• Gradle 빌드 최적화: Parallel Build, Configuration Cache 적용 (기본 31.5s -> 8.5s로 약 73% 개선)
• Google Jib 도입: Dockerfile 없이 변경된 레이어만 효율적으로 빌드하여 이미지 생성 시간을 혁신적으로 단축
• Go & PostgreSQL 전환: I/O 집약적인 file-service를 Go로 전환하고, PostgreSQL JSONB를 통해 비정형 메타데이터를 효율적으로 관리합니다.
• Cache: Redis (인증, 세션 관리)

• Authentication: JWT (Access/Refresh Token) + Cookie (HttpOnly)
• Authorization: 역할 기반 접근 제어 (Admin, User)

참고: File Service는 성능 최적화를 위해 Kotlin에서 Go로 전환되었으며, 약 100배 이상 빠른 API 응답 속도를 달성했습니다.

• Auth Service API: 인증, 사용자, 팀, 기업 관리 API
• AI Service API: AI 요약 생성 API
• Video Service API: 화상 회의 관리 API
• Notification Service API: 실시간 알림 API
• File Service API: 파일 업로드/다운로드 API
• Email Service API: 이메일 발송 API

• 로그인 & 테스트 가이드: 로컬 인증 테스트 방법
• File Service 사용 가이드: 파일 업로드/다운로드 사용법
• 공통 모듈 가이드: onmeet-common 사용법
• Gateway 라우팅 설정: API Gateway 라우팅 규칙
• Git 워크플로우: 브랜치 전략 및 배포 프로세스

• JDK 21 이상
• Docker & Docker Compose

최신 빌드 방식(Jib)이 적용되어, 이미지 빌드 후 실행해야 합니다.

# 1. Docker 이미지 빌드 (Jib) - 약 30초 소요
./gradlew jibDockerBuild --parallel

# 2. 전체 서비스 실행 (이미지 Pull 없이 로컬 이미지 사용)
docker compose up -d

# 3. 로그 확인
docker compose logs -f auth-service gateway-service

특정 서비스만 실행할 때도 이미지 빌드가 선행되어야 합니다.

# 1. 특정 서비스만 빌드 (예: Auth Service)
./gradlew :auth-service:jibDockerBuild

# 2. 필요한 서비스 실행 (의존성 포함 자동 실행)
docker compose up -d gateway-service auth-service

IntelliJ에서 개발할 때는 인프라만 Docker로 띄우고, 서비스는 IDE에서 실행하는 것이 디버깅에 유리합니다.

1. 기반 인프라 실행 데이터베이스, Kafka, Redis 등 필수 인프라를 실행합니다.

docker compose up -d mysql-auth redis-auth kafka zookeeper mysql-ai mysql-video mysql-notification postgres-file

2. 서비스 실행 (IntelliJ)

• 프로젝트 창에서 각 서비스의 Application.kt (예: AuthApplication.kt)를 우클릭하여 **Run 'AuthApplication'**을 선택합니다.
• 환경 변수(EnvFile 플러그인 또는 Run Configuration)가 필요한 경우 설정합니다.

3. (선택) IntelliJ에서 Docker 이미지 빌드 터미널 명령어 대신 IDE UI를 사용할 수 있습니다.

• 우측 Gradle 탭 > Tasks > jib > jibDockerBuild 더블 클릭

이 프로젝트는 민감한 정보와 환경별 설정을 위해 **환경 변수(Environment Variables)**를 사용합니다. application.yml의 기본값은 로컬 개발 환경에 맞춰져 있습니다.

루트 디렉토리에 .env 파일을 생성하여 관리할 수 있습니다. (로컬 개발 시 선택 사항)

# 전역 설정
SERVER_PORT=8080
SPRING_PROFILES_ACTIVE=local

# 보안 (Security)
JWT_SECRET_KEY=your-secret-key-must-be-long-enough
AUTH_ENCRYPTION_KEY=encryption-key
GATEWAY_SHARED_SECRET=shared-secret-for-internal-auth

# 쿠키 설정
COOKIE_SAMESITE=Lax          # 크로스사이트 환경(프로덕션)에서는 None으로 설정
COOKIE_SECURE=true

# 데이터베이스 (전역 또는 서비스별)
DB_ROOT_PASSWORD=root
DB_USERNAME=root

# AWS (S3/CloudFront - file-service)
AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...

# Gmail OAuth2 (email-service)
GMAIL_CLIENT_ID=...
GMAIL_CLIENT_SECRET=...
GMAIL_REFRESH_TOKEN=...
SPRING_MAIL_USERNAME[email protected]

각 서비스의 상세한 API 명세는 아래 링크 및 Swagger UI를 참조하세요.

• GET /actuator/health (모든 서비스 공통)

• fix(auth): 비밀번호 변경 500 에러 수정 (DTO 필드명 불일치)
• fix(gateway): 비밀번호 찾기 API 화이트리스트 추가
• fix(video): 회의 생성/예약 500 에러 수정 (@EnableJpaAuditing 누락, auth URL config 키 수정)
• fix(notification): actuator 경로 이중화 해소, Gateway 라우트 추가
• fix(notification): 미읽음 알림 수 응답을 타입별 분류 Map으로 변경

• 전 서비스 응답 포맷 통일 ({ success: true, data: T })
• GCP VM 업그레이드 (e2-standard-4)

• AI 회의록 요약 기능
• STT 연동

• 화상 회의 기능 (LiveKit WebRTC)
• 실시간 채팅

• 초기 MVP (인증, 기업/팀 관리)