선을 넘는 개발 로그

"우리 회사 내부 문서를 학습한 AI 챗봇을 만들고 싶어요." 요즘 개발팀에서 가장 많이 나오는 요구사항 중 하나입니다. 사내 규정, 기술 문서, 과거 장애 대응 기록, 제품 스펙 — 이 모든 것을 꿰뚫고 답변하는 AI 어시스턴트. RAG(Retrieval-Augmented Generation)가 그 해답이라는 건 이제 많은 분들이 알고 있습니다.문제는 "어떻게 구축하느냐"입니다. ChatGPT API 하나 붙이는 것과, 프로덕션 수준의 사내 RAG 서버를 구축하는 것은 완전히 다른 이야기입니다. 어떤 벡터 DB를 선택할지, Java로 갈지 Python으로 갈지, 어떤 아키텍처로 설계할지, 보안은 어떻게 챙길지 — 결정해야 할 것이 한두 가지가 아닙니다.이 글에서는 사내 RAG 서버를 처음부터 끝까지 직..

매일 아침 뉴스를 볼 때마다 아쉬웠습니다. 연합뉴스, 한국경제만 보면 한국 관점만 편향되고, Reuters/BBC는 영어라 피곤하고, Google 뉴스 RSS는 요약이 없고, 네이버 뉴스는 국내 편집이 강합니다. "18개 글로벌 언론사 오늘의 헤드라인을 한국어 3줄 요약으로 + 관련 기사 클러스터링으로" 한 화면에 보고 싶다는 단순한 욕구에서 Pebbles는 시작되었습니다.그리고 한 사람이, 주말에, 저녁에, 몇 주 동안 만들면서 예상치 못한 곳에서 계속 막혔습니다. RSS 포맷 지옥, LLM 배치 응답 파싱 실패, 같은 회사 기사가 클러스터에 같이 묶이는 문제, 이미지 추출이 안 되는 피드, launchd 환경 변수, Vercel 배포 실패 — "간단한 뉴스 사이트"라고 생각했던 것이 실제로 만들어보니..

1. 개요다른 프로그래밍 언어(C, Java 등)를 경험한 뒤 파이썬으로 넘어온 개발자들이 가장 당황하는 순간 중 하나는 음수 나눗셈을 할 때입니다.양수일 때는 예상대로 동작하던 나누기가 음수가 되는 순간 직관과 다른 결과를 내놓기 때문입니다. 예를 들어 -5 // 2를 계산했을 때 -2를 기대했지만 파이썬은 -3을 반환합니다.이 글에서는 파이썬의 나눗셈이 왜 다르게 동작하는지, 그리고 이 특성을 어떻게 이해하고 활용해야 하는지 알아봅니다.2. 간단한 설명파이썬의 정수 나누기 연산자 //는 단순히 소수점을 버리는 것(Truncate)이 아니라, 바닥 함수(Floor Function)를 따릅니다.바닥 함수란 '자신보다 작거나 같은 정수 중 가장 큰 수'를 의미합니다. 수직선 상에서 생각하면 항상 왼쪽(작은..

1. 개요대부분의 웹 개발이나 데이터 처리에서는 정수와 실수만으로 충분합니다. 하지만 파이썬이 '과학 및 공학용 언어'로 불리는 이유 중 하나는 복소수(Complex Number)를 기본 자료형으로 지원하기 때문입니다. 복소수란?실수(Real Number)와 허수(Imaginary Number)가 합쳐진 수로, 보통 $a + bi$ 형태로 표현합니다. 여기서 $i$는 제곱해서 -1이 되는 수(허수 단위)를 뜻합니다. 실수가 수직선 위의 점이라면, 복소수는 2차원 평면 위의 점을 나타낼 수 있어 기하학이나 물리 계산에 필수적입니다. 허수 i 대신 j를 사용하는 파이썬의 독특한 문법부터, 복소수의 사칙연산이 실제로 어디에 쓰이는지 가볍게 살펴봅니다.2. 간단한 설명수학에서는 허수 단위를 $i$로 표기하지만..

1. 개요나머지 연산자 %는 단순히 나눗셈의 부산물을 구하는 기호가 아닙니다. 프로그래밍에서 나머지는 '주기성(Cycle)'과 '패턴'을 만들어내는 강력한 도구입니다.많은 초심자가 나머지 연산을 단순히 '홀수/짝수 구하기' 정도로만 알고 넘어가지만, 실제 소프트웨어 개발에서는 훨씬 다양한 곳에 쓰입니다.이 글에서는 파이썬 % 연산자가 만들어내는 마법 같은 패턴들과 그 활용법을 정리해 드립니다.2. 간단한 설명a % n 연산은 a를 n으로 나눈 나머지를 반환합니다. 이 결과값은 항상 0에서 n-1 사이의 범위를 가집니다.이 성질이 핵심입니다. 어떤 숫자가 들어오더라도 결과는 항상 정해진 범위 안에서만 뱅글뱅글 돕니다.숫자가 커지면 다시 0으로 돌아오는 이 특성 때문에, 나머지 연산은 순환하는 구조를 표현하..