Home

🚀 RAIO Backend Wiki

Hexagonal Architecture · DDD · Multi Module 기반 라이브 스트리밍 백엔드

RAIO Backend는 Hexagonal Architecture, Multi Module, Domain-Driven Design 기반으로 설계된 라이브 스트리밍 플랫폼 백엔드입니다. 이 Wiki는 프로젝트의 아키텍처, 코어 모듈, 도메인, 개발 컨벤션을 문서화합니다.

---

🧭 Getting Started

프로젝트를 처음 접한다면 아래 문서부터 읽어주세요.

Document	Description
📦 Project Structure	프로젝트 전체 구조
🛠️ Development Environment	개발 환경 구성
📑 Coding Convention	개발 컨벤션

---

🏛️ Architecture

RAIO Backend의 설계 철학

Document	Description
🏗️ Hexagonal Architecture	헥사고날 아키텍처
🧩 Multi Module	멀티모듈 구조
🔄 CQRS	CQRS 적용 방식
🌐 gRPC	서비스 간 통신
⚙️ Batch Architecture	Batch Core 설계

---

🧱 Core Modules

공통 모듈 설명

Module	Description
⚙️ Batch Core	Batch Builder / Scheduler / Engine
📡 gRPC Core	gRPC Server & Client
🗄️ JPA Core	공통 JPA
🌍 Common	공통 유틸리티
🚨 Exception	공통 예외 처리

---

💳 Domain

각 도메인 설명

Domain	Description
💰 Payment Guide	결제 · 지갑 · 정산
👤 User	회원
🎁 Donation	후원
💬 Chat	채팅 · 모더레이션
📺 Stream	방송

---

📚 Guides

개발자를 위한 가이드

Guide	Description
📘 Batch Guide	Batch 개발 가이드
💳 Payment Guide	결제 도메인 구조 · API · 프로세스
🔥 Payment Load Test	Mock PG로 찾은 커넥션 풀 데드락
🚀 Deployment	Railway 배포
🛡️ Security	보안 정책

---

📊 Project Principles

✔️ Hexagonal Architecture	✔️ Domain-Driven Design	✔️ Multi Module
✔️ Spring Boot 3 · Java 21	✔️ gRPC 서비스 간 통신	✔️ Spring Batch
✔️ PostgreSQL	✔️ Docker	✔️ Railway

---

❤️ Philosophy

"No Silver Bullet"

최신 기술을 사용하는 것보다, 비즈니스 변화에 유연하게 대응할 수 있는 구조를 만드는 것을 목표로 합니다. RAIO는 기능보다 Architecture를 먼저 고민합니다.