# Microservice Patterns

> Event-driven microservice architecture patterns guide. Use when the user requests implementing microservices, event bus, SAGA pattern, orchestration, compensating transactions, or distributed system coordination.

- Skill: `revfactory/microservice-patterns` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add revfactory/microservice-patterns`
- Raw SKILL.md: https://api.skillmd.com/api/skills/revfactory/microservice-patterns/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: revfactory (https://skillmd.com/u/revfactory)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/revfactory/microservice-patterns

---


# Microservice Patterns Skill

이벤트 드리븐 마이크로서비스 아키텍처 패턴 가이드

## 서비스 아키텍처

```
          EventBus (pub/sub)
         /    |    \      \
OrderService  InventoryService  PaymentService  NotificationService
    |              |                  |                |
  orders[]     inventory{}        payments[]      notifications[]
         \       |        /
       SAGA Orchestrator
    (주문 생성 플로우 조율)
```

### 핵심 규칙
- 서비스 간 직접 참조 금지 (이벤트로만 통신)
- 각 서비스는 자체 상태만 관리
- correlation ID로 이벤트 흐름 추적
- 타임아웃: SAGA 단계별 5초 제한

## SAGA 플로우

```
정상: order.created → inventory.reserved → payment.completed → order.confirmed
재고실패: order.created → inventory.failed → order.cancelled
결제실패: order.created → inventory.reserved → payment.failed → inventory.released → order.cancelled
```

보상 트랜잭션은 실행된 단계의 역순으로 수행.

## 이벤트 네이밍 규칙

- `order.created`, `order.confirmed`, `order.cancelled`
- `inventory.reserved`, `inventory.released`, `inventory.failed`
- `payment.completed`, `payment.failed`, `payment.refunded`
- `notification.sent`

## 파일 구조

```
src/
  event-bus.js           - 이벤트 버스 (pub/sub, 와일드카드, 비동기)
  saga-orchestrator.js   - SAGA 패턴 오케스트레이터
  services/
    order-service.js     - 주문 CRUD + 상태 관리
    inventory-service.js - 재고 관리 (reserve/release/deduct, 낙관적 잠금)
    payment-service.js   - 결제 처리 (charge/refund, 멱등성)
    notification-service.js - 알림 이력
  utils/
    correlation-id.js    - 상관관계 ID 생성
    logger.js            - 이벤트 추적 로거
tests/
  event-bus.test.js
  saga.test.js
  integration.test.js    - 5개 시나리오 통합 테스트
```

## 테스트 시나리오 (5개 필수)

1. **정상 플로우**: 주문→재고예약→결제→확정, 모든 서비스 상태 검증
2. **재고 부족**: 주문→재고실패→취소, 주문 상태 CANCELLED
3. **결제 실패**: 주문→재고예약→결제실패→재고해제→취소, 재고 원복 확인
4. **동시 주문**: 2개 주문이 동시에 같은 상품 주문, 하나만 성공
5. **타임아웃**: SAGA 단계가 시간 초과 시 보상 트랜잭션