mazara-cloud

배경

REST·GraphQL·SOAP 등 이질적 백엔드를 하나의 게이트웨이로 묶고, BFF로 다중 서비스를 오케스트레이션하며, 레거시와 AI(파이썬 LLM·RAG·검색)를 잇는 폴리글랏 통합을 보여주는 Spring Cloud MSA 플랫폼입니다.

핵심 기능

• Eureka 서비스 디스커버리(자동 등록·로드밸런싱)
• Spring Cloud Gateway(경로 라우팅·CORS·JWT 체인)
• BFF 집계(Feign 다중 서비스 팬아웃)
• 다중 프로토콜: a(REST)·b(GraphQL)·c(SOAP/XML)
• JWT 인증 서비스(Spring Security + PostgreSQL)
• AI 브리지: RAG(d)·NLP(e)·LLM Ollama·Flutter
• 검색 스택: Elasticsearch + Kafka 색인
• Config 서버 + 단일 파라미터화 Dockerfile

동작 방식

클라이언트 요청은 Gateway(8080)에서 경로 접두사로 분기되어 Eureka가 해석한 서비스명(lb://)으로 전달되고, BFF(8084)가 집계 엔드포인트의 다중 서비스 팬아웃을 수행합니다. 각 서비스는 단일 파라미터화 Dockerfile(빌드 인자 MODULE)로 컨테이너화되고, MongoDB·PostgreSQL·Redis와 ELK 스택을 백킹 스토어로 씁니다.

사용 방법

1. 전체 모듈을 Maven으로 빌드한다
2. docker compose로 코어 스택을 기동한다
3. Eureka 대시보드(8761)와 Gateway 엔드포인트로 검증한다
4. 필요 시 ELK compose로 검색·로그 스택을 띄운다

구성

API Gateway(8080) 뒤로 15개 Spring Boot 모듈이 Eureka(8761)에 등록되어 REST/GraphQL/SOAP/검색/AI 브리지를 라우팅합니다.

로컬 실행

1. docker-compose up -d 로 전체 스택 기동
2. 검색/로그 스택은 docker-compose.elk.yml 로 별도 기동
3. 각 모듈 상세는 저장소 docs/ 의 23개 가이드 참고