Build and Learn

전체 글 511

REST API 설계와 HTTP 요청·응답 처리

1. 학습 배경지난 사이드 학습에서는 비동기 Worker와 PostgreSQL의 SKIP LOCKED, Outbox 패턴을 살펴봤다.해당 학습에서는 작업을 어떻게 안전하게 선점하고, 비동기적으로 처리하며, 실패 시 재시도할 수 있는지가 핵심이었다.이번에는 조금 다른 방향으로 백엔드의 기본 구조를 학습해 보려고 한다.바로 REST API와 HTTP 요청·응답 처리다.Python으로 데이터를 수집하거나 외부 API를 호출하는 작업은 익숙하지만, 반대로 클라이언트가 사용할 API를 직접 설계하는 관점에서는 생각해야 할 요소가 달라진다.단순히 URL 하나를 만들고 데이터를 반환하는 것뿐 아니라 다음과 같은 부분을 고려해야 한다.어떤 URL로 리소스를 표현할 것인가?조회, 생성, 수정, 삭제를 어떤 HTTP 메서..

Backend 2026.11.19

Game Data Project #26 - Discord 패치노트 자동 발송 구현

1. 개발 배경이전 #25에서는 Discord 서버에서 구독 중인 게임의 신규 패치를 감지하고, 발송할 알림을 PostgreSQL의 Outbox 테이블에 등록하는 기능까지 구현했다.하지만 Outbox에 알림이 쌓인다고 해서 Discord 채널에 메시지가 전달되는 것은 아니다.실제로 알림을 보내려면 다음 과정이 필요했다.Outbox에서 발송할 작업을 가져온다.여러 Worker가 동일한 알림을 중복 처리하지 않도록 제어한다.발송 직전 구독 상태와 한국어 번역 데이터를 다시 확인한다.Discord API를 통해 패치노트를 전송한다.전송 결과에 따라 성공, 재시도, 실패 상태를 기록한다.여기서 단순히 Discord API를 호출하는 것보다 중요하게 생각한 부분은 전송 중 문제가 발생해도 알림 작업을 추적하고 복..

Project 2026.11.18

Game Data Project #25 - Discord 패치 알림 Outbox 파이프라인 구축

지난 #24에서는 Discord 서버에서 패치 알림 채널을 설정하고, 게임별 알림 구독을 관리하는 기능을 구현했다./patch-channel로 알림 채널을 지정하고, /patch-subscribe와 /patch-unsubscribe로 게임을 구독하거나 해제할 수 있게 됐다.하지만 여기까지는 어디까지나 알림을 받을 준비를 하는 단계였다.실제 패치가 수집됐을 때 어떤 Discord 서버에 알림을 생성해야 하는지, 번역이 끝나지 않은 패치는 어떻게 처리할지, 같은 패치를 여러 번 수집하더라도 알림이 중복되지 않게 하려면 어떻게 해야 하는지 등은 아직 해결하지 못했다.이번 #25에서는 이 문제를 해결하기 위해 Discord 패치 알림 Outbox 파이프라인을 구축했다.실제 Discord 메시지를 보내기 전에 발..

Project 2026.11.17

비동기 Worker와 PostgreSQL SKIP LOCKED, Outbox 설계

1. 비동기 Worker를 다시 공부하게 된 이유Game Data Project에서 Discord 서버 공용 패치 채널과 게임 구독 기능을 구현했다.현재는 Discord 서버가 Overwatch와 PUBG의 패치 알림을 구독할 수 있고, 채널을 등록하거나 변경할 수 있는 상태다.하지만 실제 알림을 전송하려면 별도의 작업이 필요하다.새로운 패치가 수집되고 한국어 본문이 준비되면, 구독 중인 Discord 서버를 찾아 알림을 생성하고 해당 채널에 메시지를 보내야 한다.단순하게 생각하면 다음과 같이 구현할 수도 있다.def process_patch(patch): save_patch(patch) send_discord_message(patch)그러나 실제 환경에서는 여러 문제가 발생한다.Discord..

System Design 2026.11.10

Game Data Project #24 - Discord 서버 공용 패치 채널 및 게임 구독 관리

1. 기존 개인 DM 구조에서 서버 공용 채널로이전 #23에서는 Discord 패치 알림 기능의 기존 구조를 점검했다.당시에는 사용자가 게임을 구독하면 새로운 패치가 등록될 때마다 개인 DM으로 알림을 보내도록 구성되어 있었다.전체 흐름은 다음과 같았다.게임 패치 수집 ↓game_patches INSERT ↓PostgreSQL Trigger ↓patch_notification_outbox ↓Discord Notification Worker ↓사용자 개인 DM개인에게 관심 게임의 정보를 전달한다는 점에서는 자연스러운 구조였지만, 프로젝트를 실제로 사용하려는 목적을 다시 생각하면서 알림 방식을 변경하기로 했다.패치노트는 서버 구성원들이 함께 확인하는 정보이기 때문에 개인마다 같은 ..

Project 2026.11.09

Game Data Project #23 - Discord 패치 알림 구조 재설계와 기존 시스템 분석

1. 기존 Discord 알림 구조를 다시 검토한 이유이전 #22에서는 Discord Bot에 게임 구독 기능을 추가하고, Transactional Outbox와 Worker를 이용해 신규 패치 알림을 자동으로 전송하는 기능까지 구현했다.당시 구조는 다음과 같았다.신규 패치 수집 ↓game_patches INSERT ↓PostgreSQL Trigger ↓patch_notification_outbox ↓Discord Worker ↓구독자 개인 DM실제로 Outbox 작업 선점, 재시도, Lease, Discord DM 전송까지 검증했다.기술적으로는 정상 동작했지만, 구현 결과를 처음 구상했던 서비스와 비교하면서 한 가지 문제를 발견했다.패치노트와 가격 알림의 제공 방식이 서로 달..

Project 2026.11.06

Game Data Project #22-4 - Transactional Outbox와 Discord 자동 패치 알림 시스템 구현

1. 게임 구독에서 실제 알림 시스템으로이전 #22-3에서는 Discord에서 게임을 구독하고 관리하는 기능을 구현했다.사용자가 /subscribe 명령어로 게임을 등록하면 PostgreSQL에 구독 정보가 저장되고, /subscriptions와 /unsubscribe를 통해 조회하거나 해제할 수 있게 됐다.Discord 사용자 ↓/subscribe game:Overwatch ↓구독 서비스 ↓PostgreSQL ↓discord_game_subscriptions하지만 아직 구독 정보만 저장할 뿐, 새로운 패치가 발생했을 때 자동으로 알림을 보내는 기능은 없었다.이번 #22-4에서는 기존 Airflow 패치 수집 파이프라인과 Discord Bot을 연결하기로 했다.초기 구현의 목표는 다..

Project 2026.11.05

Game Data Project #22-3 - PostgreSQL 기반 게임 구독 관리와 멱등성 구현

1. Discord에서 게임 구독 관리하기이전 #22-2에서는 Discord Bot을 PostgreSQL과 연결하고 /game 명령어로 게임을 검색하는 기능을 구현했다.Discord 사용자 ↓/game name:Overwatch ↓Discord Bot ↓PostgreSQL ↓게임 검색 결과 반환이제 Discord에서 게임을 조회할 수 있게 되었으므로, 사용자가 관심 있는 게임을 구독하고 관리하는 기능을 추가하려고 한다.이번 단계에서는 다음 세 가지 기능을 구현했다./subscribe — 게임 구독 등록/unsubscribe — 게임 구독 해제/subscriptions — 현재 구독한 게임 목록 조회단순히 명령어만 추가하는 것이 아니라, 구독 정보를 PostgreSQL에 저장하고 중복..

Project 2026.11.04

Game Data Project #22-2 - Docker와 PostgreSQL을 연결해 Discord 게임 검색 구현하기

1. Discord Bot에 데이터베이스 연결하기이전 #22-1에서는 Discord Bot을 생성하고 /ping 명령어를 구현했다.Discord 사용자 ↓/ping ↓Game Data Bot ↓Pong! 🏓이 단계에서는 Discord 연결과 Slash Command의 기본 동작을 확인하는 것이 목적이었다.하지만 실제로 만들고 싶은 기능은 단순히 정해진 문자열을 반환하는 Bot이 아니다.기존 Game Data Project에서 수집한 데이터를 Discord에서도 조회하고, 이후에는 게임별 알림 설정까지 관리할 수 있도록 확장하려고 한다.따라서 이번에는 PostgreSQL과 Discord Bot을 연결해 /game 명령어로 게임을 검색하는 기능을 구현했다.동시에 Discord Bot을 기존..

Project 2026.11.03

Game Data Project #22-1 - Discord Bot 만들고 Slash Command 연결하기

1. Discord Bot을 추가하려는 이유이전 #21에서는 Airflow를 이용해 게임 패치노트를 정기적으로 수집하는 파이프라인을 구성했다.현재 데이터 흐름은 다음과 같다.Airflow ↓Steam / PUBG / Overwatch 패치 수집 ↓패치 감지 및 공통 데이터 동기화 ↓LLM 기반 번역 및 요약 ↓PostgreSQL이제 패치 데이터를 수집하고 저장하는 단계에서 한 걸음 더 나아가, 사용자에게 정보를 전달하는 기능이 필요해졌다.이를 위해 Discord Bot을 추가하기로 했다.처음부터 알림 시스템 전체를 구현하기보다는 다음 순서로 진행하기로 했다.Discord Bot 생성 ↓Bot 연결 확인 ↓Slash Command 구현 ↓데이터베이스 연결 ↓게임 ..

Project 2026.11.03