WELCOME TO THE LAB

Code, Create,
and Keep Learning.

코드와 기술을 탐구하고 경험을 기록하는 개발 연구실.
AI · Backend · Cloud · Engineering

PUPBANI'S LAB / DEV JOURNAL
FIND YOUR INTEREST

Explore Topics ✳

All Categories →
BROWSE ARTICLES

전체 글

총 343개의 글 · AI·LLM, 백엔드, 클라우드, 데이터베이스, 개발 자동화까지. 기술을 탐구하고 실무 경험과 최신 IT 트렌드를 기록하는 개발자 기술 블로그, Pupbani’s Lab입니다.

AI/정보보안

GitHub 무료 보안 점검 자동화: API 키 유출·코드 취약점 확인과 대응 방법

GitHub Team 조직에서는 이제 보안 위험 평가(Security Risk Assessment)가 자동으로 실행됩니다. 2026년 11월 18일 GitHub가 발표한 변경으로, 조직 관리자와 보안 관리자는 노출된 API 키·토큰 등의 자격 증명과 코드 취약점 위험을 확인하고 대응 우선순위를 결정할 수 있습니다. 다만 무료 위험 평가는 지속적인 시크릿 모니터링이나 Push Protection과 동일한 기능이 아닙니다.공식 발표일: 2026-11-18 | 문서 확인일: 2026-11-19 | 대상: GitHub Team 조직 관리자 및 보안 관리자 | 본문은 공식 문서 기반 실무 가이드이며 실제 조직 계정에서 기능을 실행한 결과는 아닙니다.1. GitHub가 발표한 자동 보안 위험 평가란?GitHub는 ..

↗
AI/LLM

GPT-6.2 출시: Astra·Sol 차이와 Responses API 마이그레이션 방법

2026년 11월 17일 OpenAI API 변경 이력에 GPT-6.2 Astra와 Sol이 추가됐습니다. 기존 Python·FastAPI 애플리케이션을 업그레이드하려면 모델 이름만 교체해서는 안 됩니다. 특히 도구 호출(Tool Calling)은 Responses API를 사용해야 하며, 추론 설정과 일부 요청 파라미터도 재검토해야 합니다.1. GPT-6.2 발표에서 확인된 내용OpenAI 공식 API 변경 이력(2026-11-17)에 따르면 gpt-6.2-astra는 복잡한 추론과 코딩, gpt-6.2-sol은 일상적인 코딩과 에이전트 워크플로를 대상으로 안내됩니다. 두 모델 모두 Responses API와 Chat Completions를 지원하지만, 도구 호출은 Responses API가 필요합니다..

↗
AI/Computer Vision

VLM vs OCR 차이: PDF·영수증·표 인식에 적합한 문서 AI 선택법

문서에서 글자만 정확하게 추출하려면 OCR이 기본 선택이고, 표·도표·화면 배치의 의미까지 해석해야 한다면 VLM(Vision-Language Model)을 고려할 수 있습니다. 다만 VLM이 OCR보다 언제나 정확한 것은 아닙니다. 계약서·영수증·연구보고서 자동화에서는 OCR로 원문과 좌표를 확보하고, 필요한 부분만 VLM으로 해석한 뒤 규칙과 사람의 검증을 거치는 하이브리드 방식이 실용적입니다.1. OCR과 VLM은 무엇이 다른가?OCR(광학 문자 인식)은 이미지나 스캔 PDF에 있는 문자를 기계가 처리할 수 있는 텍스트로 변환합니다. 문서 전용 OCR은 단어·줄·문단의 위치와 신뢰도 같은 구조 정보를 함께 제공할 수 있습니다. VLM은 이미지와 언어 입력을 함께 처리해 화면 속 대상, 관계, 문맥을..

↗
Container/Docker

Docker HEALTHCHECK 사용법: FastAPI 배포·헬스체크·장애 대응 가이드

Docker Compose에서 FastAPI를 배포할 때 컨테이너가 실행 중이라는 사실만으로 서비스가 정상이라고 판단하면 안 됩니다. FastAPI의 상태 확인 엔드포인트와 Docker HEALTHCHECK를 연결하고, 데이터베이스 의존성은 depends_on: condition: service_healthy로 제어하는 것이 기본입니다. 다만 헬스체크 실패가 자동 재시작이나 무중단 배포를 보장하지는 않습니다.Docker 헬스체크가 필요한 이유프로세스가 살아 있어도 이벤트 루프 정체, DB 연결 장애, 초기화 실패로 요청을 처리하지 못할 수 있습니다. Docker의 HEALTHCHECK는 컨테이너 내부에서 주기적으로 명령을 실행해 starting, healthy, unhealthy 상태를 표시합니다. 이는..

↗
Back-end & Server/FastAPI

JWT Access Token vs Refresh Token 차이: FastAPI 토큰 회전·재사용 탐지 구현 가이드

JWT 기반 로그인에서 Access Token과 Refresh Token을 나누는 이유는 접근 권한의 유효 시간을 짧게 유지하면서 사용자가 매번 로그인하지 않도록 하기 위해서입니다. 하지만 Refresh Token을 장기간 재사용하도록 구현하면 탈취된 토큰도 계속 사용할 수 있습니다. 실무에서는 Refresh Token Rotation(회전), 서버 측 세션 상태, 재사용 탐지와 로그아웃 시 폐기를 함께 설계해야 합니다.1. JWT와 Refresh Token은 무엇이 다른가?JWT(JSON Web Token)는 클레임을 전달하는 토큰 형식입니다. Access Token은 보호된 API 접근에 쓰이는 자격 증명이고, Refresh Token은 새로운 Access Token을 발급받기 위한 자격 증명입니다...

↗
DB/PostgreSQL

RAG 하이브리드 검색 구현: PostgreSQL pgvector·키워드 검색·RRF 완벽 가이드

RAG 하이브리드 검색(Hybrid Search)은 키워드 검색과 벡터 검색을 각각 실행한 뒤 결과를 결합하는 방식입니다. 제품 코드·계약번호처럼 정확히 일치해야 하는 표현과 의미가 비슷한 자연어 질문을 함께 처리할 때 유용합니다. PostgreSQL에서는 내장 전문 검색(Full Text Search), pgvector, RRF(Reciprocal Rank Fusion)를 조합해 별도의 검색 서버 없이 구현할 수 있습니다.기술 문서 확인: 2026-11-14. 예제는 학습용이며 실제 PostgreSQL 서버에서 실행·성능 검증하지 않았습니다.1. 벡터 검색만 사용하면 무엇이 부족할까?임베딩은 문장 사이의 의미적 유사성을 찾는 데 강하지만, 정확한 모델명·문서번호·고유명사 일치까지 보장하지는 않습니다. ..

↗
DB/PostgreSQL

PostgreSQL EXPLAIN ANALYZE 사용법: 느린 SQL 실행계획 분석과 인덱스 최적화

PostgreSQL에서 느린 SQL을 분석하려면 EXPLAIN (ANALYZE, BUFFERS)로 실행계획과 실제 실행 통계를 확인하세요. 가장 먼저 예상 행 수와 실제 행 수의 차이, 테이블 스캔 방식, 반복 횟수, 버퍼 읽기, 전체 실행 시간을 살펴보는 것이 좋습니다. 단, ANALYZE 옵션은 쿼리를 실제 실행하므로 운영 데이터에 영향을 줄 수 있습니다.작성·공식 문서 확인: 2026-11-13 · PostgreSQL 18 문서 기준 · 아래 실습 SQL은 설명용이며 실제 DB에서 실행 검증하지 않았습니다.1. EXPLAIN과 EXPLAIN ANALYZE의 차이PostgreSQL의 쿼리 플래너는 테이블 통계와 비용 추정을 이용해 실행계획을 선택합니다. EXPLAIN은 선택된 계획과 예상 비용을 보여..

↗
AI/정보보안

마스킹 vs 암호화 vs 토큰화 차이: 개인정보 보호 방법과 Python 구현 가이드

마스킹은 정보를 화면에서 가리는 처리, 암호화는 키를 이용해 원문을 복원할 수 있는 형태로 보호하는 처리, 토큰화는 원문을 별도의 대체값으로 치환하고 대응 관계를 안전하게 관리하는 방식입니다. 세 기술은 목적이 다르므로 개인정보를 다루는 API·데이터베이스·AI 시스템에서는 상황에 맞게 조합해야 합니다.1. 마스킹·암호화·토큰화 차이 한눈에 보기구분마스킹암호화토큰화목적표시·노출 제한기밀성 보호원문 사용 최소화예시010-****-1234인증된 암호문고객 식별자 대신 임의 토큰원문 복원표시 결과만으로는 일반적으로 불가올바른 키로 복호화별도 매핑 저장소를 통해 조회 가능핵심 위험원본 DB·로그가 그대로 노출키 유출·nonce 재사용토큰 저장소·매핑 권한 유출여기서 토큰화는 JWT 같은 인증 토큰 발급과 다른 ..

↗
AI/딥러닝(Deep Learning)

Cross Attention vs Self Attention 차이: PyTorch 구현으로 이해하기

Self Attention은 같은 시퀀스에서 Query·Key·Value를 만들고, Cross Attention은 Query와 Key·Value의 출처가 서로 다른 어텐션입니다. PyTorch에서는 두 방식 모두 torch.nn.MultiheadAttention으로 구현할 수 있으며, 핵심 차이는 forward(query, key, value)에 전달하는 텐서입니다. 이 글에서는 동일한 어텐션 레이어로 두 구조를 실행하고, 가중치 차원과 패딩 마스크를 직접 검증합니다. Self Attention과 Cross Attention의 핵심 차이 어텐션은 Query(Q)가 Key(K)와 얼마나 관련 있는지 점수를 계산하고, 그 결과로 Value(V)를 가중합합니다. 두 방식은 계산식 자체보다 정보를..

↗
FROM THE NOTEBOOK

Latest Articles ✳

View all →
AI/정보보안

GitHub 무료 보안 점검 자동화: API 키 유출·코드 취약점 확인과 대응 방법

GitHub Team 조직에서는 이제 보안 위험 평가(Security Risk Assessment)가 자동으로 실행됩니다. 2026년 11월 18일 GitHub가 발표한 변경으로, 조직 관리자와 보안 관리자는 노출된 API 키·토큰 등의 자격 증명과 코드 취약점 위험을 확인하고 대응 우선순위를 결정할 수 있습니다. 다만 무료 위험 평가는 지속적인 시크릿 모니터링이나 Push Protection과 동일한 기능이 아닙니다.공식 발표일: 2026-11-18 | 문서 확인일: 2026-11-19 | 대상: GitHub Team 조직 관리자 및 보안 관리자 | 본문은 공식 문서 기반 실무 가이드이며 실제 조직 계정에서 기능을 실행한 결과는 아닙니다.1. GitHub가 발표한 자동 보안 위험 평가란?GitHub는 ..

↗
AI/LLM

GPT-6.2 출시: Astra·Sol 차이와 Responses API 마이그레이션 방법

2026년 11월 17일 OpenAI API 변경 이력에 GPT-6.2 Astra와 Sol이 추가됐습니다. 기존 Python·FastAPI 애플리케이션을 업그레이드하려면 모델 이름만 교체해서는 안 됩니다. 특히 도구 호출(Tool Calling)은 Responses API를 사용해야 하며, 추론 설정과 일부 요청 파라미터도 재검토해야 합니다.1. GPT-6.2 발표에서 확인된 내용OpenAI 공식 API 변경 이력(2026-11-17)에 따르면 gpt-6.2-astra는 복잡한 추론과 코딩, gpt-6.2-sol은 일상적인 코딩과 에이전트 워크플로를 대상으로 안내됩니다. 두 모델 모두 Responses API와 Chat Completions를 지원하지만, 도구 호출은 Responses API가 필요합니다..

↗
AI/Computer Vision

VLM vs OCR 차이: PDF·영수증·표 인식에 적합한 문서 AI 선택법

문서에서 글자만 정확하게 추출하려면 OCR이 기본 선택이고, 표·도표·화면 배치의 의미까지 해석해야 한다면 VLM(Vision-Language Model)을 고려할 수 있습니다. 다만 VLM이 OCR보다 언제나 정확한 것은 아닙니다. 계약서·영수증·연구보고서 자동화에서는 OCR로 원문과 좌표를 확보하고, 필요한 부분만 VLM으로 해석한 뒤 규칙과 사람의 검증을 거치는 하이브리드 방식이 실용적입니다.1. OCR과 VLM은 무엇이 다른가?OCR(광학 문자 인식)은 이미지나 스캔 PDF에 있는 문자를 기계가 처리할 수 있는 텍스트로 변환합니다. 문서 전용 OCR은 단어·줄·문단의 위치와 신뢰도 같은 구조 정보를 함께 제공할 수 있습니다. VLM은 이미지와 언어 입력을 함께 처리해 화면 속 대상, 관계, 문맥을..

↗
Container/Docker

Docker HEALTHCHECK 사용법: FastAPI 배포·헬스체크·장애 대응 가이드

Docker Compose에서 FastAPI를 배포할 때 컨테이너가 실행 중이라는 사실만으로 서비스가 정상이라고 판단하면 안 됩니다. FastAPI의 상태 확인 엔드포인트와 Docker HEALTHCHECK를 연결하고, 데이터베이스 의존성은 depends_on: condition: service_healthy로 제어하는 것이 기본입니다. 다만 헬스체크 실패가 자동 재시작이나 무중단 배포를 보장하지는 않습니다.Docker 헬스체크가 필요한 이유프로세스가 살아 있어도 이벤트 루프 정체, DB 연결 장애, 초기화 실패로 요청을 처리하지 못할 수 있습니다. Docker의 HEALTHCHECK는 컨테이너 내부에서 주기적으로 명령을 실행해 starting, healthy, unhealthy 상태를 표시합니다. 이는..

↗
Back-end & Server/FastAPI

JWT Access Token vs Refresh Token 차이: FastAPI 토큰 회전·재사용 탐지 구현 가이드

JWT 기반 로그인에서 Access Token과 Refresh Token을 나누는 이유는 접근 권한의 유효 시간을 짧게 유지하면서 사용자가 매번 로그인하지 않도록 하기 위해서입니다. 하지만 Refresh Token을 장기간 재사용하도록 구현하면 탈취된 토큰도 계속 사용할 수 있습니다. 실무에서는 Refresh Token Rotation(회전), 서버 측 세션 상태, 재사용 탐지와 로그아웃 시 폐기를 함께 설계해야 합니다.1. JWT와 Refresh Token은 무엇이 다른가?JWT(JSON Web Token)는 클레임을 전달하는 토큰 형식입니다. Access Token은 보호된 API 접근에 쓰이는 자격 증명이고, Refresh Token은 새로운 Access Token을 발급받기 위한 자격 증명입니다...

↗
DB/PostgreSQL

RAG 하이브리드 검색 구현: PostgreSQL pgvector·키워드 검색·RRF 완벽 가이드

RAG 하이브리드 검색(Hybrid Search)은 키워드 검색과 벡터 검색을 각각 실행한 뒤 결과를 결합하는 방식입니다. 제품 코드·계약번호처럼 정확히 일치해야 하는 표현과 의미가 비슷한 자연어 질문을 함께 처리할 때 유용합니다. PostgreSQL에서는 내장 전문 검색(Full Text Search), pgvector, RRF(Reciprocal Rank Fusion)를 조합해 별도의 검색 서버 없이 구현할 수 있습니다.기술 문서 확인: 2026-11-14. 예제는 학습용이며 실제 PostgreSQL 서버에서 실행·성능 검증하지 않았습니다.1. 벡터 검색만 사용하면 무엇이 부족할까?임베딩은 문장 사이의 의미적 유사성을 찾는 데 강하지만, 정확한 모델명·문서번호·고유명사 일치까지 보장하지는 않습니다. ..

↗
DB/PostgreSQL

PostgreSQL EXPLAIN ANALYZE 사용법: 느린 SQL 실행계획 분석과 인덱스 최적화

PostgreSQL에서 느린 SQL을 분석하려면 EXPLAIN (ANALYZE, BUFFERS)로 실행계획과 실제 실행 통계를 확인하세요. 가장 먼저 예상 행 수와 실제 행 수의 차이, 테이블 스캔 방식, 반복 횟수, 버퍼 읽기, 전체 실행 시간을 살펴보는 것이 좋습니다. 단, ANALYZE 옵션은 쿼리를 실제 실행하므로 운영 데이터에 영향을 줄 수 있습니다.작성·공식 문서 확인: 2026-11-13 · PostgreSQL 18 문서 기준 · 아래 실습 SQL은 설명용이며 실제 DB에서 실행 검증하지 않았습니다.1. EXPLAIN과 EXPLAIN ANALYZE의 차이PostgreSQL의 쿼리 플래너는 테이블 통계와 비용 추정을 이용해 실행계획을 선택합니다. EXPLAIN은 선택된 계획과 예상 비용을 보여..

↗
AI/정보보안

마스킹 vs 암호화 vs 토큰화 차이: 개인정보 보호 방법과 Python 구현 가이드

마스킹은 정보를 화면에서 가리는 처리, 암호화는 키를 이용해 원문을 복원할 수 있는 형태로 보호하는 처리, 토큰화는 원문을 별도의 대체값으로 치환하고 대응 관계를 안전하게 관리하는 방식입니다. 세 기술은 목적이 다르므로 개인정보를 다루는 API·데이터베이스·AI 시스템에서는 상황에 맞게 조합해야 합니다.1. 마스킹·암호화·토큰화 차이 한눈에 보기구분마스킹암호화토큰화목적표시·노출 제한기밀성 보호원문 사용 최소화예시010-****-1234인증된 암호문고객 식별자 대신 임의 토큰원문 복원표시 결과만으로는 일반적으로 불가올바른 키로 복호화별도 매핑 저장소를 통해 조회 가능핵심 위험원본 DB·로그가 그대로 노출키 유출·nonce 재사용토큰 저장소·매핑 권한 유출여기서 토큰화는 JWT 같은 인증 토큰 발급과 다른 ..

↗
AI/딥러닝(Deep Learning)

Cross Attention vs Self Attention 차이: PyTorch 구현으로 이해하기

Self Attention은 같은 시퀀스에서 Query·Key·Value를 만들고, Cross Attention은 Query와 Key·Value의 출처가 서로 다른 어텐션입니다. PyTorch에서는 두 방식 모두 torch.nn.MultiheadAttention으로 구현할 수 있으며, 핵심 차이는 forward(query, key, value)에 전달하는 텐서입니다. 이 글에서는 동일한 어텐션 레이어로 두 구조를 실행하고, 가중치 차원과 패딩 마스크를 직접 검증합니다. Self Attention과 Cross Attention의 핵심 차이 어텐션은 Query(Q)가 Key(K)와 얼마나 관련 있는지 점수를 계산하고, 그 결과로 Value(V)를 가중합합니다. 두 방식은 계산식 자체보다 정보를..

↗