-
결제 웹훅 핸들러 구현 완료 문서 업데이트
결제 플랫폼 연동 문서에서 웹훅 수신기 Controller가 완성되었음에도 TODO로 표기되어 있던 부분을 '구현완료'로 정정했다.
읽기 → -
웰컴 제거 진행 상황 실소스 기준으로 정정
며칠 전 이커머스 PG 플랫폼의 웰컴 기능 제거 작업을 진행하면서, 그동안 작성해둔 진행 문서들을 다시 읽어 보니 현재 상황과 맞지 않는 부분들이 있었다. 실제 코드베이스를 기준으로 다시 확인하고 문서를 정정했다. 함께 그 과정에서 느낀 것들을 공유한다.
읽기 → -
본인인증 정보 저장 범위 확대
결제 플랫폼에 연동된 본인인증 PG(제주)에서 제공하는 응답값을 전부 활용하지 못하고 있었다. 이번 작업은 기존에 저장하던 **이름, 휴대폰**에 더해 **생년월일·통신사·내외국인 여부** 3개 필드를 새로 저장하도록 시스템을 확장한 거다.
읽기 → -
인벤토리 메트릭 수치 갈등 정리
최근에 life/name.hedvion.com 서비스 인벤토리를 문서화하면서 흥미로운 문제를 마주했다. 여러 모니터링 시스템과 운영 문서에 기록된 메트릭 수치들이 서로 다르게 나타나고 있었던 것. 라이브 인스턴스 카운트, uptime 커버율, 조회수 통계 등 세 가지 주요 지표에서 불일치가 발생하고 있었고, 이를 정리하는 것이 이번 커밋의 목표였다.
읽기 → -
로컬 캐시 파일이 repo를 오염시키던 문제 해결
개발 도구의 로컬 session state 파일들이 실수로 git에 커밋되어 있던 걸 정리했다. .omc/ 디렉토리의 여러 상태 파일들(agent-replay, hud-stdin-cache, subagent-tracking 등)을 untrack 처리하고, .gitignore에 명시해 앞으로는 같은 실수가 반복되지 않도록 했다.
읽기 → -
개발 도구 임시 파일이 커밋되던 문제 해결
어느 날 저장소를 정리하다가 발견했다. .omc/ 디렉토리 아래로 뭔가 잔뜩 쌓여 있었다. agent replay 로그, hud 캐시, 세션 상태 파일들. 모두 로컬 개발 도중에 자동으로 생기는 임시 파일인데, 실수로 git이 추적하고 있었던 것. 이번 작업은 그 파일들을 저장소에서 제외하고, 향후 반복되지 않도록 .gitignore를 정리하는 chore였
읽기 → -
누락된 서비스 로깅 설정 추가
신규 웹 서비스가 추가되었는데 페이지뷰 분석 시스템(site-pv)에 로그 수집 설정이 빠져 있었다. 전용 로그 채널을 등록해서 이 서비스의 트래픽 추적을 활성화했다.
읽기 → -
조회수 대시보드 확장하며 배운 설계 포인트
사내 여러 서비스의 트래픽을 한눈에 보기 위해 조회수 대시보드를 운영 중인데, 최근 life/name 서비스를 새롭게 추적 대상으로 추가했다. 단순히 로그 수집만 늘리는 게 아니라, 로그 전용화(DEDICATED_LOGS)와 표시 순서 제어(DISPLAY_ORDER)라는 구조를 도입하면서 대시보드를 어떻게 확장할 것인가에 대해 한두 가지 배운 게 있다.
읽기 → -
서비스 접근 로그 독립 추적 체계 구축
특정 도메인의 사용자 접근 패턴을 더 정확히 추적하기 위해 기존 통합 로깅 시스템에서 전용 로그 채널을 등록했다.
읽기 → -
포트폴리오 섹션 순서를 언어별로 통일하다
개인 포트폴리오 사이트에서 한국어판과 영문판 간의 레이아웃 순서를 맞추는 작업을 했다. 구체적으로는 영문판에서 블로그 섹션을 About 섹션 위로 이동시켜 한국어판과 동일한 배치로 만들었다.
읽기 → -
개인 메모 파일이 저장소를 오염시키는 일 방지
개발하다 보면 생기는 임시 노트, 설계 메모, 체크리스트 같은 파일들이 있다. 내 경우 _notes/ 디렉토리에 issue-site-plan.md 파일을 작업 중 만들어서 이슈 분석이나 계획을 정리했는데, 실수로 저장소에 커밋해버렸다. 이번 커밋은 그 파일을 untrack하고 .gitignore에 _notes/를 추가해서 앞으로 비슷한 일이 일어나지 않도록
읽기 → -
영어 포스트 제목 독립 관리로 국제화 기초 다지기
블로그 국제화를 위해 포스트의 영어 제목을 별도 필드로 관리하는 title_en 을 도입했다. 슬렉스 영어 피드(/en) 가 한국어 제목이 아닌 영어 제목으로 노출되어야 하는 상황이 생기면서 그냥 원문을 번역기에 돌리거나 영어 사용자들이 "음, 이게 뭐 하는 포스트지?" 하며 헤매지 않도록 하기 위한 변화다.
읽기 → -
영어 블로그 피드 라벨 깨지던 버그 수정
최근 다국어 블로그 시스템 개편 중에 /en/ 경로의 피드 라벨이 제대로 렌더링되지 않는 버그를 발견했다. 사용자가 영어 블로그 보드의 RSS 피드나 동적 피드를 열었을 때 제목, 카테고리, 설명 같은 메타데이터 텍스트가 빈 채로 나타나거나 언어가 섞여 나왔던 문제였다. scripts/gen_blog_feed.py 스크립트를 수정해서 경로별로 정확한 언어
읽기 → -
팀 블로그 도메인 통합, 문서와 배포 스크립트까지 정정하기
동료 블로그가 새로운 도메인으로 이전되면서 우리 팀 문서 전체에 산재된 참조들을 정리하는 작업을 했다. 단순히 링크 몇 개를 바꾸는 수준이 아니라, 중앙 문서(CLAUDE.md)부터 자동화 스크립트까지 전반적으로 정정해야 했던 경험이다.
읽기 → -
도메인 이전, 통계 로깅도 함께 정비
도메인 마이그레이션 작업을 진행하면서 서버 통계 대시보드 스크립트를 업데이트했다. 구 도메인에서 새 도메인으로 넘어가는 과정에서 단순히 DNS를 변경하는 것만으로는 부족했다. 접근 로그 수집 파이프라인도 함께 정비해야 했는데, 이것이 생각보다 흥미로운 인프라 의사결정 지점이었다.
읽기 → -
도메인 변경에 따른 SEO 설정 통합
블로그의 도메인을 werebridge.com에서 새로운 주소로 이전했다. 단순히 호스팅 주소를 바꾸는 것이 아니라, 검색 엔진 최적화(SEO)부터 메타정보까지 일괄으로 정리해야 하는 일이었다.
읽기 → -
도메인 통합으로 배포와 SEO 설정 일원화
개인 블로그가 운영하는 독립 도메인을 회사 서브도메인으로 이전하는 작업을 완료했다. 한 개발자의 개인 프로젝트였던 블로그와 프로필이 조직의 일부로 흡수되면서, 이전에는 분산되어 있던 도메인과 배포 인프라를 정리한 것이다.
읽기 → -
글 보드의 무거운 시각 효과 제거
포트폴리오의 "오늘의 글" 섹션에 있던 파티클 캔버스 효과를 숨겼다. 작지만 의외로 중요한 결정이었는데, 이 글에서는 왜 이런 일이 생기는지, 어떤 것들을 고려해야 하는지 풀어보자.
읽기 → -
포트폴리오 카드 배경 정리로 시각 노이즈 제거
배경 파티클 애니메이션이 비쳐서 콘텐츠가 흐려지던 포트폴리오 페이지 문제를 불투명 배경 처리로 깔끔하게 정리했다.
읽기 → -
메인 상단 오늘의 글로 블로그 발견성 높이기
포트폴리오 방문자들이 내 글들을 쉽게 찾을 수 있도록 메인 페이지를 개편했다. 최신 포스트를 상단에 노출하고, 섹션별 보드 형태로 블로그를 정렬해서 카테고리별 관심 콘텐츠를 한눈에 볼 수 있게 만들었다.
읽기 →