Files

T

DongHyeonka d71669eb59 fix: 하네스 제거 및 keycloak 문서 보강

2026-07-25 12:53:13 +09:00

10 KiB

Raw Blame History

title, source_type, url, archive_url, status, confidence, tags, related_projects, related_branches, created, last_reviewed

title

source_type

url

archive_url

status

confidence

우아한형제들 — Outbox 패턴 사례

Layer: raw/company-tech-blogs/ — 우아한형제들 기술블로그의 outbox 패턴 사례 원문 발췌·출처 기록. ca-tmpl 이 채택한 DB polling + SKIP LOCKED 방식과 가장 가까운 한국 사례 후보. 같은 결정을 한 조직이 어떤 trade-off 를 인정하고 갔는지 확인하는 corroboration 자료.

Parent / 활용 branch (필수)

Branch	이 자료가 정당화하는 결정
raw/branch-notes/feature-domain-event-outbox-contract	Topic 3 — Outbox Pattern baseline (SKIP LOCKED polling) 의 한국 사례 corroboration — 단 인용 wording 미확인 시 corroboration 강도 제한
raw/branch-notes/feature-background-job-async-contract	Background job 발행에서 JPA + Spring Boot + Kafka publisher 조합의 사례 자료 (정확 URL 보강 필요)
raw/project-notes/ca-skeleton-operational-contract	§18 / §19 의 outbox 채택 — 한국 production 환경에서 동일 결정을 한 사례 reference

컨텍스트

ca-tmpl 이 채택한 DB polling + SKIP LOCKED 방식과 가장 가까운 한국 사례 후보. 같은 결정을 한 조직이 어떤 trade-off 를 인정하고 갔는지 확인. 단, 본 raw 의 인용은 2026-05-22 작성 시점에 정확한 글 URL 을 확정하지 못한 상태로 다수 글의 공통 메시지 요약 형태이며, 2026-05-27 재검증에서도 정확 wording 확인이 불가하여 company-tech-blog 사례로서의 가치보다 corroboration 한계가 더 크다.

출처 / Source

원본 URL (블로그 메인): https://techblog.woowahan.com/
대상 글 URL: 미확정 — "MSA 환경에서의 이벤트 발행 / 트랜잭션 아웃박스" 류 글 다수에서 반복되는 메시지를 요약한 형태
아카이브 URL: (미수집)
저자 / 조직: 우아한형제들 기술블로그 (Woowahan Tech Blog)
발행일: 미확인 (글 URL 미확정)
마지막 확인일 (capture): 2026-05-22
마지막 재검증 시도: 2026-05-27
[2026-05-25 capture]: user 가 2026-05-22 수집한 paraphrase 요약 원형 유지.
재검증 결과 [2026-05-27 verified attempt]: 블로그 landing page https://techblog.woowahan.com/ WebFetch 성공. 그러나 landing 에 노출된 최신 featured 글 (RAG chatbot / AI harness / multilingual / React 19 / review LLM / MCP stdio / incident lifecycle) 중 outbox / 도메인 이벤트 발행 / SKIP LOCKED / Kafka publisher / 이벤트 발행 키워드와 직접 매칭되는 글 없음. 단일 글 URL 확정 실패 — 카테고리 archive (Backend / Infra) 또는 검색 API 필요.
재검증 한계 + Strength 정책: 원본 글 URL 여전히 미확정 → 본 자료는 source_type 을 company-tech-blog 로 분류하지만 단일 글 인용으로 corroborate 불가. 추출된 모든 claim 은 needs-confirmation Strength 유지 (Strength 상향 없음). 본 자료는 ca-tmpl 결정의 official 정당화로 사용 불가 — microservices.io / Postgres 공식이 1차, 본 자료는 단일 글 + verbatim 확보 전까지 보조 corroboration 으로도 사용 보류.
company-tech-blog evidence 는 official best practice 가 아님: 본 자료는 official-standard / official-vendor-doc / official-reference 가 아니므로 "우아한형제들이 채택했으므로 best practice" 라는 추론 금지.

핵심 인용 / Key quotes (paraphrase / 요약, 2026-05-22 user 수집본 — verbatim 아님)

주의: 아래는 verbatim 인용이 아니라 우아한형제들 기술블로그 다수 글에서 반복되는 메시지의 user paraphrase 요약. wiki 승급 전 단일 글 URL + verbatim 확보 필수.

(paraphrase) "단일 트랜잭션 안에서 비즈니스 변경과 이벤트 저장을 묶어 두고, 별도 publisher 가 그 이벤트를 외부로 발행한다."

(paraphrase) "Kafka 에 직접 publish 하지 않는 이유는 dual-write 문제 때문이다."

(paraphrase) "polling 주기와 SKIP LOCKED 기반 다중 publisher 인스턴스로 처리량을 확보한다."

Claims Extracted / 추출된 주장

중요: 본 raw 는 verbatim 인용이 아니라 paraphrase 요약만 보유. 모든 claim 은 needs-confirmation. 단일 글 URL + verbatim 확보 전까지 corroboration 으로 사용 불가.

Claim ID	Claim (이 자료가 직접 말하는 것)	Evidence quote	Strength	Applies to	Does not prove
OUTBOX-WW-C1	우아한형제들의 일부 도메인은 단일 트랜잭션에서 비즈니스 변경 + 이벤트 저장 (outbox) 을 묶고 별도 publisher 가 외부 발행하는 패턴을 사용한다 (paraphrase)	(paraphrase) "단일 트랜잭션 안에서 비즈니스 변경과 이벤트 저장을 묶어 두고, 별도 publisher 가 그 이벤트를 외부로 발행한다."	`needs-confirmation`	우아한형제들 일부 도메인 (정확한 글 / 시스템 범위 미확인)	"우아한형제들 전사 표준" 이라는 일반화는 본 자료로 보장 안 됨 — 단일 글 paraphrase 단계
OUTBOX-WW-C2	Kafka 직접 publish 를 피한 이유로 dual-write 문제를 언급 (paraphrase)	(paraphrase) "Kafka 에 직접 publish 하지 않는 이유는 dual-write 문제 때문이다."	`needs-confirmation`	outbox 도입 결정 논리	dual-write 문제의 정의 / 실제 incident 가 있었는지 본 paraphrase 에 없음 — 일반적 reasoning 으로 추정
OUTBOX-WW-C3	polling interval + SKIP LOCKED 기반 다중 publisher 인스턴스로 처리량을 확보 (paraphrase)	(paraphrase) "polling 주기와 SKIP LOCKED 기반 다중 publisher 인스턴스로 처리량을 확보한다."	`needs-confirmation`	polling Message Relay 변형	정확한 interval / 인스턴스 수 / TPS 수치는 본 paraphrase 에 없음

Strength 정책

본 문서의 모든 claim 은 needs-confirmation. 추가로 다음 두 제약:

verbatim 인용이 아닌 paraphrase → corroboration 강도가 일반 company-case-study 보다 약함
단일 글 URL 미확정 → "우아한형제들이 X 라고 말했다" 라는 단정 자체가 불가, "다수 글의 공통 메시지로 보인다" 수준의 약한 진술만 가능

company-tech-blog evidence 는 official best practice 가 아님 — 본 자료는 ca-tmpl 의 SKIP LOCKED polling 채택을 official 로 정당화하지 않으며, microservices.io / Postgres 공식 등 official-vendor-doc 으로 별도 정당화 필요.

Usage Boundaries / 적용 경계

이 자료가 직접 증명하는 것 (단일 글 URL + verbatim 확보 시):
- 한국 production 환경의 일부 조직이 SKIP LOCKED polling 패턴을 채택한 사례가 존재한다는 약한 corroboration
이 자료가 증명하지 않는 것:
- "우아한형제들 전사 표준" 또는 "한국 fintech / commerce 일반 표준" 같은 일반화
- 정확한 polling interval / 인스턴스 수 / TPS / lag 수치
- 우아한형제들이 dual-write 문제를 실제 incident 로 겪었는지 (이론적 reasoning vs 운영 경험 구분 불가)
- SKIP LOCKED polling 이 best practice 라는 명제 (company-tech-blog 는 official best practice 가 아님)
내 프로젝트에 적용하려면 추가 확인이 필요한 것:
- 본 raw 를 corroboration 으로 활용하려면 단일 글 URL + verbatim 인용 확보 가 선행 — 현 상태로는 wiki 승급 불가
- corroboration 이 확보되더라도 official 정당화는 microservices.io / Postgres 공식 자료가 1차, 본 자료는 한국 사례 보조

메모 / Notes (내 프로젝트 해석 — 직접 인용 아님)

적용 시나리오 (사례 가설): Kafka 도입은 했으나 Debezium / Kafka Connect 까지는 운영하지 않는 조직. JPA / Spring Boot 기반 도메인이 많은 환경.
장점 (한국 기술블로그들이 공통적으로 강조 — paraphrase):
- 기존 RDB + JPA 스택 그대로 활용
- 운영 인력이 SQL 로 outbox 상태를 직접 진단 가능 (장애 시 큰 이점)
- Kafka Connect 운영 부담 없음
단점:
- polling lag (보통 수백 ms ~ 수 s — 사례 미검증 추정)
- outbox 테이블 hot row 관리 (archive, partition, vacuum)
- publisher 인스턴스 장애 시 lag 가시화 필요
ca-tmpl (SKIP LOCKED polling) 과의 차이: 사실상 동일 패턴 추정. ca-tmpl 이 같은 진영의 결정을 따르고 있다는 약한 corroboration (verbatim 확보 시).
운영 복잡도: 낮음~중간.
exactly-once / at-least-once 보장 수준: at-least-once. consumer 측 idempotency 필수.
외부 의존성 추가 여부: Kafka (broker) 만. Kafka Connect / Debezium 불필요.
주의: 본 raw 는 인용 wording 이 paraphrase / needs-confirmation 이므로, /ingest 전에 실제 글 URL 1-2개를 찾아 verbatim 으로 보강 필요.
대안 그룹 (Topic 3 — Outbox Pattern, 대안 6종): SKIP LOCKED polling / Debezium CDC / Kafka Connect SMT / Dual-write [금지] / Event sourcing / Spring @TransactionalEventListener
본 source 의 위치: ca-tmpl baseline 사례 후보 — 우아한형제들 polling (단, verbatim 미확보로 약한 corroboration)

같은 주제 official-doc (이쪽이 1차 근거):
- raw/official-docs/outbox-skip-locked-microservices-io (baseline 정의)
- raw/official-docs/skip-locked-postgres-docs (메커니즘)
- raw/official-docs/outbox-debezium-official-docs (대안: CDC)
- raw/official-docs/dual-write-antipattern-microservices-io (negative reference)
인용하는 branch / project:
인용한 wiki 요약: (미작성)

10 KiB Raw Blame History