개발하면서 마주친 문제와 인프라 운영 중 겪은 시행착오를 기록합니다. 기술 문서와 강의에서 배운 내용도 함께 정리해, 필요할 때 다시 찾아볼 수 있는 개발 노트로 남깁니다.https://dobidugi.github.io/https://dobidugi.github.io/log/sbom-cyclonedx-gradle/https://dobidugi.github.io/log/sbom-cyclonedx-gradle/SBOM 은 "이 소프트웨어에 어떤 부품(라이브러리)이 어떤 버전으로 들어 있나"를 기계가 읽을 수 있게 적은 목록이다. Spring Boot + Gradle 이면 CycloneDX 플러그인 한 줄…Mon, 26 Oct 2026 00:00:00 GMThttps://dobidugi.github.io/log/dicom-worklist-communication/https://dobidugi.github.io/log/dicom-worklist-communication/MWL은 C-FIND로 촬영 예약을 조회한다. TCP 연결, AE Title과 서비스 협상, 실제 검색 조건을 구분하면 요청과 응답의 구조를 이해할 수 있다.Mon, 12 Oct 2026 00:00:00 GMThttps://dobidugi.github.io/log/rag-basics/https://dobidugi.github.io/log/rag-basics/RAG는 질문과 관련된 자료를 검색하고, 그 내용을 LLM에 함께 전달해 답변의 근거로 활용하는 방식이다. 벡터 검색으로 자료를 찾는 과정과, 찾은 자료를 바탕으로 답변을 만드는 과정을 나누어 이해…Fri, 09 Oct 2026 00:00:00 GMThttps://dobidugi.github.io/log/normalization-cosine-similarity/https://dobidugi.github.io/log/normalization-cosine-similarity/두 벡터의 길이를 각각 1로 맞춘 뒤 내적하면, 길이 차이의 영향을 없애고 방향이 얼마나 비슷한지 비교할 수 있다. 이 값이 코사인 유사도이며, 사용자 취향과 콘텐츠 특징을 비교하는 추천 점수로 활…Mon, 05 Oct 2026 00:00:00 GMThttps://dobidugi.github.io/log/dot-product-recommendation-score/https://dobidugi.github.io/log/dot-product-recommendation-score/내적은 두 벡터의 대응하는 항목을 곱해 모두 더한 숫자 하나를 구하는 연산이다. 수량과 단가로 합계 금액을 구하거나, 관심도와 주제 점수로 추천 점수를 구하는 데 사용할 수 있다.Wed, 30 Sep 2026 00:00:00 GMThttps://dobidugi.github.io/log/vector-change-euclidean-distance/https://dobidugi.github.io/log/vector-change-euclidean-distance/변화량은 각 항목의 차이를 담은 벡터이다. 벡터의 길이는 원점에서 그 벡터의 끝점까지의 거리이고, 두 점 사이 거리는 차이 벡터의 길이이다.Wed, 30 Sep 2026 00:00:00 GMThttps://dobidugi.github.io/log/audit-and-access-log-design/https://dobidugi.github.io/log/audit-and-access-log-design/기존 서비스에는 Logger로 남기는 파일 로그가 있었지만, 변경이나 조회 이력을 따로 기록하는 기능은 없었다.Mon, 28 Sep 2026 00:00:00 GMThttps://dobidugi.github.io/log/pnpm-vs-npm/https://dobidugi.github.io/log/pnpm-vs-npm/npm과 pnpm의 차이는 패키지 파일의 재사용 방식과 의존성을 노출하는 구조에 있다. 프로젝트의 요구와 팀의 실행 환경을 기준으로 선택하고, 버전과 lock 파일을 함께 관리한다.Mon, 07 Sep 2026 00:00:00 GMThttps://dobidugi.github.io/log/winsw-windows-service/https://dobidugi.github.io/log/winsw-windows-service/아무 실행 파일이나 윈도우 서비스로 감싸주는 래퍼. 설정이 exe 옆 XML 한 장이라 git으로 관리되고, 그게 레지스트리에 설정을 묻어두는 NSSM과의 결정적 차이다.Wed, 26 Aug 2026 00:00:00 GMThttps://dobidugi.github.io/log/sarif/https://dobidugi.github.io/log/sarif/도구마다 다른 결과 형식을 표준 JSON 하나로 통일해서, 도구 N개 × 소비처 M개였던 변환 코드를 N+M으로 줄인다.Tue, 25 Aug 2026 00:00:00 GMThttps://dobidugi.github.io/log/semgrep/https://dobidugi.github.io/log/semgrep/grep은 코드를 글자로 보고 Semgrep은 문법 트리로 본다. 그래서 규칙을 정규식이 아니라 찾고 싶은 코드 그 자체로 쓴다.Tue, 25 Aug 2026 00:00:00 GMThttps://dobidugi.github.io/log/kotlin-compiler-plugin-allopen-noarg/https://dobidugi.github.io/log/kotlin-compiler-plugin-allopen-noarg/코틀린 클래스는 기본이 final이고 기본 생성자도 없다. 그런데 Spring은 상속으로 프록시를 만들고 JPA는 빈 객체를 만들어 리플렉션으로 채운다. all-open과 no-arg 플러그인이 이…Thu, 06 Aug 2026 00:00:00 GMThttps://dobidugi.github.io/log/cornerstone3d-black-first-render/https://dobidugi.github.io/log/cornerstone3d-black-first-render/Cornerstone3D 뷰포트가 첫 렌더에서만 통째로 검게 나오는 현상. render()·resize()를 같은 크기로 몇 번 불러도 안 살아나고, 캔버스 크기가 실제로 바뀔 때만 복구된다. 마운…Wed, 05 Aug 2026 00:00:00 GMThttps://dobidugi.github.io/log/cornerstone3d-custom-image-loader/https://dobidugi.github.io/log/cornerstone3d-custom-image-loader/Cornerstone3D는 DICOM 로더만 기본으로 준다. JPG·PNG를 같은 뷰어에서 보려면 이미지 로더(주소 → 픽셀)와 메타데이터 프로바이더(이 영상이 몇 픽셀인지) 두 개를 직접 등록해야…Wed, 05 Aug 2026 00:00:00 GMThttps://dobidugi.github.io/log/cornerstone3d-getting-started/https://dobidugi.github.io/log/cornerstone3d-getting-started/Cornerstone3D는 브라우저에서 의료영상을 그리는 렌더링 라이브러리다. <img> 와 달리 원본 픽셀 값을 그대로 들고 있어서 윈도잉·계측·3D 재구성이 된다. 핵심은 네 가지 — image…Wed, 05 Aug 2026 00:00:00 GMThttps://dobidugi.github.io/log/expo/https://dobidugi.github.io/log/expo/Expo는 React Native로 앱을 만들 때 필요한 것들을 미리 묶어놓은 도구 모음이다. React Native의 대체재가 아니라 그 위에 얹히는 층으로, 네이티브 프로젝트(Xcode/Andr…Wed, 05 Aug 2026 00:00:00 GMThttps://dobidugi.github.io/log/design-md-agent-design-system/https://dobidugi.github.io/log/design-md-agent-design-system/CLAUDE.md가 에이전트에게 "이 프로젝트에서 일하는 법"을 알려주듯, DESIGN.md는 "이 프로젝트가 어떻게 생겨야 하는지"를 알려주는 파일 포맷이다. 위쪽에는 정확한 값(색상·타이포 토큰…Tue, 04 Aug 2026 00:00:00 GMThttps://dobidugi.github.io/log/kotlinllm-intellij-plugin/https://dobidugi.github.io/log/kotlinllm-intellij-plugin/"이 변환은 LLM이 알아서 구현해줘"라고 코드에 한 줄 적어두면, 앱을 실행하다가 그 지점에서 막혔을 때 LLM이 실제 데이터를 보고 코드를 짜서 실행 중인 앱에 즉시 끼워넣고, 그 코드는 프로젝…Sun, 02 Aug 2026 00:00:00 GMThttps://dobidugi.github.io/log/kopring-in-ai-era/https://dobidugi.github.io/log/kopring-in-ai-era/AI 에이전트가 개발 주체가 되는 시대에는 언어의 표현력보다 에이전트가 빠르게 이해·실행·검증·복구할 수 있는 시스템이 중요해진다. 코프링(Kotlin+Spring)의 생존은 열린 도구 생태계(LS…Mon, 20 Jul 2026 00:00:00 GMThttps://dobidugi.github.io/log/oauth-social-login/https://dobidugi.github.io/log/oauth-social-login/소셜 로그인은 외부 서비스가 확인한 사용자 정보를 우리 서비스의 회원과 연결하는 과정이다. OAuth 2.0과 OIDC의 역할, 토큰의 용도, 로그인 상태를 관리하는 위치를 구분해 살펴본다.Mon, 20 Jul 2026 00:00:00 GMThttps://dobidugi.github.io/log/spring-sse-emitter/https://dobidugi.github.io/log/spring-sse-emitter/Spring MVC의 SseEmitter로 서버에서 이벤트를 보내고, 연결 종료와 재연결을 관리하는 방법을 정리한다. 요청 대기와 실제 전송의 차이, 하트비트와 이벤트 복구에 필요한 조건도 살펴본다…Mon, 20 Jul 2026 00:00:00 GMThttps://dobidugi.github.io/log/value-object/https://dobidugi.github.io/log/value-object/같은 연산을 가변 객체와 불변 객체로 각각 구현해 비교한다.Thu, 09 Jul 2026 00:00:00 GMThttps://dobidugi.github.io/log/reference-vs-value-object/https://dobidugi.github.io/log/reference-vs-value-object/→ 다음 시간: 값 객체를 이용해 참조 객체의 복잡성을 낮추는 방법.Tue, 07 Jul 2026 00:00:00 GMThttps://dobidugi.github.io/log/composed-method-refactoring/https://dobidugi.github.io/log/composed-method-refactoring/리팩토링의 첫 단계는 비슷한 목적의 코드를 묶고 그 위에 주석을 다는 것.Thu, 02 Jul 2026 00:00:00 GMThttps://dobidugi.github.io/log/extract-method-refactoring/https://dobidugi.github.io/log/extract-method-refactoring/섞여 있을 때의 문제 (게임 클래스 run 메서드 예시)Tue, 30 Jun 2026 00:00:00 GMThttps://dobidugi.github.io/log/ecs-deploy-rollback/https://dobidugi.github.io/log/ecs-deploy-rollback/myapp 운영 배포 파이프라인(GitHub Actions → ECS Rolling)과 자동/수동 롤백 절차. 인프라 현황은 운영 인프라 현황, 셋업은 ECS Fargate 셋업 가이드, 문제는 E…Mon, 22 Jun 2026 00:00:00 GMThttps://dobidugi.github.io/log/ecs-fargate-setup-guide/https://dobidugi.github.io/log/ecs-fargate-setup-guide/Spring Boot / Next.js 서비스를 ECS Fargate에 운영 배포하기 위한 재현 가능한 SOP. myapp-be(BE), myapp-fe(FE)를 실제로 셋업한 경험을 바탕으로 정리…Mon, 22 Jun 2026 00:00:00 GMThttps://dobidugi.github.io/log/ecs-troubleshooting/https://dobidugi.github.io/log/ecs-troubleshooting/ECS Fargate 셋업·운영에서 마주친 함정과 해결책 종합. 셋업은 ECS Fargate 셋업 가이드, 인프라 현황은 운영 인프라 현황, 배포/롤백은 ECS 배포·롤백.Mon, 22 Jun 2026 00:00:00 GMThttps://dobidugi.github.io/log/hermes-agent-install-guide/https://dobidugi.github.io/log/hermes-agent-install-guide/Hermes Agent는 Nous Research가 개발하여 GitHub에 오픈소스로 공개한 고급 자율형 AI 에이전트다. 사용자의 서버나 노트북에서 항상 실행되면서, 사용할수록 스스로 학습하고 성…Tue, 19 May 2026 00:00:00 GMThttps://dobidugi.github.io/log/long-polling-sse-websocket-quic/https://dobidugi.github.io/log/long-polling-sse-websocket-quic/이 영상은 두 기계 간의 데이터 교환을 위한 4가지 기법—Long Polling, Server-Sent Events(SSE), WebSockets, QUIC—을 각각의 동작 원리, 실제 코드 데모,…Wed, 06 May 2026 00:00:00 GMThttps://dobidugi.github.io/log/ddd-concepts/https://dobidugi.github.io/log/ddd-concepts/개인적으로 공부하며 이해한 DDD 핵심 개념 레퍼런스.Thu, 30 Apr 2026 00:00:00 GMThttps://dobidugi.github.io/log/woowacon2024-ddd/https://dobidugi.github.io/log/woowacon2024-ddd/발표자는 우아한형제들 소속 8년차 서버 개발자 박재성으로, 우아한테크코스에서 코틀린 강의를 담당하고 있다. 7년간 도메인 주도 설계(DDD)를 독학하고 팀에 전파하면서 쌓은 경험을 공유하는 자리다.Thu, 30 Apr 2026 00:00:00 GMThttps://dobidugi.github.io/log/woowacon2025-sse-realtime-notification/https://dobidugi.github.io/log/woowacon2025-sse-realtime-notification/발표자는 배달의민족 주문접수 채널 팀의 한우석이다. 이 팀은 수십만 파트너(가맹점)가 주문을 빠르게 처리할 수 있도록 돕는 프로그램을 개발한다. PC, 앱, 안드로이드 포스 등 다양한 환경을 지원한…Sun, 26 Apr 2026 00:00:00 GMThttps://dobidugi.github.io/log/bff-pattern/https://dobidugi.github.io/log/bff-pattern/BFF는 특정 클라이언트에 맞게 여러 API의 데이터를 조합하는 백엔드 계층이다. 데이터 조합의 반복과 요구사항 차이가 추가 운영 비용보다 큰지 살펴보고 도입을 결정한다.Sat, 25 Apr 2026 00:00:00 GMThttps://dobidugi.github.io/log/gpt55-vs-opus47/https://dobidugi.github.io/log/gpt55-vs-opus47/OpenAI가 새 플래그십 모델 GPT 5.5를 출시했다. 코드명은 "Spud". 이전 버전은 GPT 5.4였으며, GPT 5.5는 OpenAI의 "가장 스마트하고 직관적인 모델"로 포지셔닝됐다. …Sat, 25 Apr 2026 00:00:00 GMThttps://dobidugi.github.io/log/kent-beck-ai-coding/https://dobidugi.github.io/log/kent-beck-ai-coding/TDD(테스트 주도 개발)와 XP(익스트림 프로그래밍)를 만든 40년 경력의 전설적인 개발자. 그런 그도 Claude를 이용해 활발히 개발하고 있다. 그런데 그런 대가조차도 AI 코딩을 잘못 사용하…Sat, 25 Apr 2026 00:00:00 GMThttps://dobidugi.github.io/log/msa-api-gateway/https://dobidugi.github.io/log/msa-api-gateway/MSA에서 클라이언트는 서비스마다 다른 주소로 직접 요청하지 않는다. API Gateway 하나가 진입점이 되고, URL prefix를 보고 어느 서비스로 보낼지 결정한다.Sat, 25 Apr 2026 00:00:00 GMThttps://dobidugi.github.io/log/tecotalk-dependency-injection/https://dobidugi.github.io/log/tecotalk-dependency-injection/우아한테크코스 7기 모찌의 발표. 목차는 Intro → DI → DIP → 마무리 순서로 진행된다.Sat, 25 Apr 2026 00:00:00 GMThttps://dobidugi.github.io/log/tecotalk-good-api-design/https://dobidugi.github.io/log/tecotalk-good-api-design/우아한테크코스 백엔드 7기 미미의 발표. 목차는 주제 선정 이유 → API 개념 → GitHub API 설계 원칙 → 성능 최적화와 API 분리의 관계 → 마무리 순서로 진행된다.Sat, 25 Apr 2026 00:00:00 GMThttps://dobidugi.github.io/log/spring-oauth2-client/https://dobidugi.github.io/log/spring-oauth2-client/Spring Security가 제공하는 OAuth2 Authorization Code Flow 구현체.Sun, 12 Apr 2026 00:00:00 GMThttps://dobidugi.github.io/log/oauth/https://dobidugi.github.io/log/oauth/리소스 소유자(사용자 또는 서비스)가 자신의 자원에 대한 접근 권한을 제3자에게 위임하기 위한 인가(Authorization) 프로토콜.Fri, 03 Apr 2026 00:00:00 GMThttps://dobidugi.github.io/log/access-control-rbac-abac/https://dobidugi.github.io/log/access-control-rbac-abac/인증(Authentication)이 완료된 후, 특정 리소스에 대한 접근 권한이 있는지 확인하는 절차Sun, 29 Mar 2026 00:00:00 GMThttps://dobidugi.github.io/log/encryption-decryption/https://dobidugi.github.io/log/encryption-decryption/암복호화Sat, 28 Mar 2026 00:00:00 GMThttps://dobidugi.github.io/log/virtual-thread-nonblocking-io/https://dobidugi.github.io/log/virtual-thread-nonblocking-io/Thread가 I/O를 기다리지 않는다. 서버 내부의 thread 관리 방식이지, 유저에게 response를 나중에 준다는 뜻이 아니다.Sat, 28 Mar 2026 00:00:00 GMThttps://dobidugi.github.io/log/wanted-preonboarding-internship-retrospective/https://dobidugi.github.io/log/wanted-preonboarding-internship-retrospective/인턴쉽을 진행하면서 많은것을 느껴 이 회고록을 작성해본다.Tue, 28 Mar 2023 00:00:00 GMT