-
데이터 소유권 모델 정의로 팀 간 혼선 해결
동료 팀과 공유하는 데이터에 대해 명확한 소유 모델을 정의하고, 이를 문서에 기록했다. .md=진실 / DB=단방향미러 라는 단순하지만 명시적인 규칙을 세우면서, 동시에 특정 마이그레이션(/p/{id})을 하지 않기로 결정한 그 배경도 함께 남겼다.
읽기 → -
자체 칼럼 시스템으로 콘텐츠 운영 자동화
자체 칼럼(articles) 플랫폼을 구축하고, 디스코그래피 콘텐츠를 자동으로 생성하는 봇을 만들었다. 기존에는 콘텐츠 업데이트가 주로 수동 작업이거나 외부 소스에 의존했는데, 팀 규모가 커지면서 이런 반복적인 운영 비용이 계속 늘어나고 있었다.
읽기 → -
글 저장소 이중 기록 방식 기록 완성
동료가 작성한 데이터 레이어 설명 문서를 검토하다가 놓친 부분을 발견했다. 글이 단순히 하나의 데이터 저장소에만 쌓이는 줄 알았던 기록이 있었는데, 실제로는 두 곳에 중복으로 기록되는 하이브리드 방식이었다. cms_post DB에 별도로 id를 부여하고 적재되는 구조였는데, 그 부분의 설명이 누락되어 있었다. 91건 규모의 데이터가 이 방식으로 처리되고 있
읽기 → -
사이트맵 통합으로 검색 엔진 크롤링 효율 높이기
검색 엔진 최적화(SEO) 관점에서 크롤러가 우리 사이트를 얼마나 효율적으로 발견하는지는 매우 중요하다. 최근에 sitemap.xml을 중앙집중식 인덱스로 통합하고, robots.txt에 명시적으로 선언하는 작업을 했다. 단순해 보이지만 이 변경이 왜 필요했고, 어떤 영향을 미치는지 풀어본다.
읽기 → -
인프라 설정 문서를 동료와 정합했다
개인 저장소에서 팀 저장소로 전환하면서 마주하는 문제 중 하나가 **문서와 현실의 괴리**다. 특히 여러 사이트가 각기 다른 설정을 갖고 있을 때, 누가 언제 어떤 설정을 적용했는지, 그 설정이 왜 필요한지가 명확하지 않으면 나중에 유지보수하는 사람은 그야말로 지뢰밭을 걷게 된다. 이번엔 한 사이트의 인프라 설정 정보를 동료와 맞추고, 그 과정을 사이트 상
읽기 → -
레거시 도메인 참조 제거로 통계 정확성 복구
site-pv.py 에서 비활성화된 도메인의 매핑을 정정했다. 서비스 이관 과정에서 구 도메인 참조가 남아 있던 것을 발견하고 현재 라이브하는 도메인으로 수정한 작업이다.
읽기 → -
서버 봇 지침 관리 일관성 확보
예전부터 여러 서버 인스턴스에 올려진 자동화 봇들이 각자 로컬 CLAUDE.md를 가지고 있었는데, 실제로는 전체 봇이 따라야 할 공통 규칙들이 있다. 이번에 그 공통 규칙을 ops 리포의 중앙화된 docs/server-global-CLAUDE.md에 한데 모으고, 각 서버의 /home/hedvion/.claude/CLAUDE.md를 symlink로 가리키
읽기 → -
폰트 CDN 경로 변경으로 콘솔 404 에러 제거
상황: 숨겨진 폰트 로드 에러 발견
읽기 → -
폰트 로딩 실패 콘솔 에러 npm CDN 으로 제거
개발 브라우저를 띄우다 보면 콘솔에 간간이 떠 있는 404 에러들이 있다. 네트워크 탭에서 보면 대부분 폰트 파일이 원인인데, 보통 무시하고 넘어가기 쉽다. 하지만 사용자 화면에는 폰트가 안 로드된 상태로 보일 테고, 자칫 성능 저하로도 느껴질 수 있다. 이번에 Pretendard 웹폰트를 GitHub 릴리스에서 npm CDN으로 전환하면서, 이 문제가 단
읽기 → -
폰트 로딩 404 에러 콘솔 노이즈 제거
한 가지 작은 외웠던 문제를 고쳤다. 콘솔에 계속 떠오던 Pretendard 폰트 로딩 404 에러를 제거했다. GitHub CDN에서 npm CDN으로 경로를 바꾼 것인데, 꽤 흥미로운 소재다. 사소한 변경 같지만 여기에는 CDN 선택의 트레이드오프, 의존성 버전 관리, 그리고 런타임 에러 추적이 엮여 있다.
읽기 → -
폰트 로딩 CDN 404 에러 제거로 콘솔 정리
웹 서비스를 운영하다 보면 브라우저 콘솔에 남는 작은 에러들이 쌓인다. 이번엔 폰트 라이브러리의 CDN 경로 문제로 발생하는 404 에러를 정리했다.
읽기 → -
폰트 CDN 변경으로 콘솔 404 에러 제거
Pretendard 한글 폰트 라이브러리의 CDN 경로를 GitHub에서 npm 기반으로 변경해서 콘솔의 파일 누락 에러를 제거했다. 작아 보이는 작업이지만 의존성 관리와 배포 구조 사이의 미묘한 충돌을 다루는 경험이었다.
읽기 → -
웹폰트 CDN 마이그레이션으로 404 에러 제거
간단한 수정 같지만 꽤 흔한 문제를 건드렸다. Pretendard 폰트를 GitHub Pages 기반 CDN에서 npm CDN으로 변경했고, 그 결과 콘솔에 떠있던 404 에러를 깔끔하게 없앨 수 있었다.
읽기 → -
웹폰트 CDN 경로 변경으로 콘솔 404 에러 제거
외부 라이브러리 버전 업그레이드 후 갑자기 폰트 파일이 로딩되지 않으면서 콘솔에 404 에러가 떴던 상황이 있었다. Pretendard v1.3.9가 GitHub CDN을 통해 배포되면서 woff2 파일이 누락되어 있었던 거였다. 결국 npm CDN으로 경로를 변경해서 문제를 해결했다.
읽기 → -
웹폰트 CDN 404로 콘솔 뻘건 에러 제거
Pretendard 폰트를 GitHub CDN에서 npm 기반 CDN으로 변경했다. v1.3.9 릴리스에서 GitHub에 woff2 파일이 누락된 탓에 브라우저 콘솔이 404 에러로 찼는데, 단순하지만 사용자 경험을 저하하는 문제였다.
읽기 → -
폰트 로드 실패로 콘솔 404 에러 제거
Pretendard 폰트를 GitHub CDN에서 npm CDN으로 변경하는 작업을 했다. v1.3.9 버전의 GitHub CDN에 woff2 파일이 없어서 계속 브라우저 콘솔에 404 에러가 찍히던 문제를 해결한 것.
읽기 → -
폰트 로딩 404 에러, CDN 경로 마이그레이션으로 정리
Pretendard 웹폰트의 CDN 경로를 GitHub Pages에서 npm 레지스트리로 변경했다. v1.3.9 버전이 GitHub 저장소에 woff2 파일을 포함하지 않아서 브라우저 콘솔에 404 에러가 떨어지고 있었는데, npm 기반 CDN으로 옮기니 자동 해결됐다.
읽기 → -
3년 쌓인 백업 파일 한 번에 정리한 기록
이번엔 인프라 정리 작업에 대한 회고다. 서버 스토리지를 둘러본 어느 날, 2.9GB를 차지하고 있는 .bak 디렉토리와 구식 archive 파일들을 발견했다. 단순히 디스크를 회수하는 것을 넘어서, 팀의 백업 정책과 레거시 관리 프로세스를 재점검하는 기회가 됐다.
읽기 → -
레거시 자동화 도구는 문서로 정리한다
docs/seo-infra.md에 archived 상태의 money-bot을 추가하고, orphan CLAUDE.md 커밋이 정상 케이스임을 명시했다. 작은 변경 같지만 팀 문서화 정책과 프로젝트 생명주기 관리에서 꽤 중요한 패턴이라 생각해서 기록해본다.
읽기 → -
팀 가이드 문서에서 평문 비번 제거
pdf2api 프로젝트의 CLAUDE.md 에 평문으로 작성되어 있던 DB 비번을 제거하고, secrets.env 참조로 변경했다. 한줄짜리 수정이지만, 온보딩부터 배포까지 전 라이프사이클에 걸친 보안 관행의 차이가 담긴 작업이다.
읽기 →