-
여러 기능을 한 배포에 담으며 배운 것들
한 번에 6개 기능이 나갔다. 졸업, 퀵팩트, freshness, 필터, 모바일, 라이크. 각자 다른 요청에서 비롯한 일들이지만, 결국 한 마이그레이션과 한 번의 문서 정비로 수렴했다. 단순히 기능들을 코드로 마무리하는 것과 "이걸 어떻게 체계적으로 기록할 것인가" 는 다른 차원의 문제였다.
읽기 → -
팀 문서 업데이트와 마이그레이션 호환성 정정
최근 배포된 여러 신기능들을 팀의 공식 문서(CLAUDE.md)에 한 번에 반영하는 작업을 했다. 동시에 데이터베이스 마이그레이션 스크립트의 MySQL 8.4 호환성 문제도 정정했다. 사소해 보일 수 있는 이 작업이 사실은 팀의 일관성 유지와 새로운 환경에서의 안정성을 보장하는, 꽤 중요한 정리 업무였다.
읽기 → -
팀 탐색 기능 정책을 공식 문서에 기록하다
CLAUDE.md에 팀/그룹 발견(discover_groups) 기능의 강화 사항을 문서로 남겼다. 개발 코드는 한 줄도 짜지 않은 작업이지만, 팀 리딩 입장에서는 꽤 중요한 일이었다.
읽기 → -
새 덱스, 초기 설정으로 팀 협업 기초 다지기
새로운 컬렉터블 인덱싱 서비스(blindboxdex)를 론칭하면서 프로젝트 초기 설정을 완료했다. 단순해 보이는 설정 단계지만, 이것이 나중 팀 협업과 서비스 확장의 질을 크게 좌우한다는 걸 이번에 다시금 느꼈다.
읽기 → -
연도 범위 한계 극복과 문서화 강화
discover_groups 봇이 그룹 데이터를 수집할 때 연도 범위가 고정돼 있었다. 이번 작업에서 그 범위를 확대하고 동시에 문서를 정리했다.
읽기 → -
첫 조회자도 인기글처럼 느껴지도록 라이크 초기값 고정
kpop 섹션 포스트의 라이크 개수 초기값을 slug 기반으로 결정적(deterministic)이게 설정하는 기능을 추가했다. 간단한 변경처럼 보이지만 "cold start" 문제를 해결하면서 사용자 행동에 영향을 미치는 작업이었다.
읽기 → -
API 응답 오류, 팀 문서로 공유하기
서비스 연동 중 429(Too Many Requests) 에러를 만났고, 이를 해결한 기록을 팀의 공동 지침 문서에 남겼다. 단순 버그 fix 를 넘어, 팀이 함께 배워야 할 경험을 명시적으로 남기는 과정이었다.
읽기 → -
모바일 네비 가로스크롤, 컴팩트 레이아웃으로 해결
vtuberprofile 의 모바일 네비게이션에서 링크 17개가 화면 폭에 맞지 않아 가로로 스크롤되거나 여러 줄로 늘어나던 문제를 레이아웃 최적화로 정리했다.
읽기 → -
발견 기능 품질 필터 기준 문서 교정
문서와 실제 운영 정책이 따로 노는 상황을 발견했다. VTuber 프로필 서비스의 인디(independent) 발견(discover) 기능에 적용하는 품질 임계값이 팀 지침 문서에는 "medium"이라고 적혀 있는데, 실제 정책은 "high"였다. 그래서 CLAUDE.md 파일의 해당 부분을 정정했다. 코드 한 줄 안 건드리고 문서만 고친 작은 변경이지만,
읽기 → -
모바일 네비게이션 링크 오버플로우 가로스크롤로 막기
한 이커머스 플랫폼의 기본 레이아웃 컴포넌트를 다루면서 자주 마주치는 숙제가 있다. 바로 네비게이션 링크 개수가 많아질수록 모바일 화면에서 깨져 보이는 문제다. 이번엔 26개의 네비게이션 링크가 좁은 모바일 화면에 다 들어가지 않으면서 레이아웃이 찌그러지는 상황을 마주쳤고, 가로스크롤로 풀어낸 경험을 기록해본다.
읽기 → -
Retention 위젯 5곳의 한국어 텍스트 누수 버그 수정
이번에 다국어 환경에서 한국어 텍스트가 노출되는 버그를 발견하고 수정했다. PostMetrics, ReadingProgress, RecentlyViewed, RelatedPosts, TableOfContents 등 5개의 retention 관련 위젯에서 하드코딩된 한국어 문자열이 다른 언어 로케일에도 그대로 노출되고 있었다. 비록 작은 변경처럼 보이지만,
읽기 → -
API 속도 제한으로 느려지던 자동화 봇 안정화
멤버 정보를 외부 API에서 수집해 enriching 하는 봇(enrich_member_bio.py)이 Wikipedia 의 429 Too Many Requests 에러로 자주 중단되곤 했다. 이번에 요청 방식을 개별 fetch 에서 group-level fetch 로 개선해서 API 속도 제한을 회피하게 했다.
읽기 → -
자동화 작업 관리 규칙 문서화
CLAUDE.md에 discover_talents 잡과 cron 인벤토리를 반영했다. 겉보기론 단순한 문서 업데이트지만, 프로젝트의 자동화 작업을 어떻게 체계적으로 관리할지를 팀에 명시하는 작업이었다.
읽기 → -
버튜버 발견 자동화, 검증 게이트로 품질 보증하기
신규 버튜버를 수동으로 찾고 등록하는 프로세스에 자동화 기능을 들였다. discover_talents 잡을 새로 만들어서 공식 채널과 인디 크리에이터를 구분해 처리하고, 인디 경로에는 검증 게이트를 달아 오류를 줄이려고 했다.
읽기 → -
쿼리 매개변수 바인딩의 숨은 함정
mysql2 라이브러리에서 LIMIT ? 플레이스홀더로 페이지네이션을 구현할 때, 잘못된 결과가 나오고 있었다. /debuts 와 /generation 엔드포인트에서 대량의 레코드를 조회할 때마다 offset과 limit 값이 제대로 적용되지 않아, 같은 데이터만 반복되거나 원래 의도와 다른 범위의 결과가 돌아오고 있었다. 조사해 보니 mysql2 의 ex
읽기 → -
멤버 카드에 퀵팩트 정보 추가하기
멤버나 그룹의 흥미로운 사실들을 데이터베이스에서 가져와 카드 형태로 보여주는 기능을 구현했다. 커밋 메시지에 B1+B2+B3 로 표기한 건, 이 작업이 세 계층으로 명확히 분리됐다는 의도를 담은 것. 데이터베이스 스키마 설계부터 봇의 enrichment 로직, 마지막으로 프론트엔드 UI 렌더링까지 순서대로 쌓은 거다.
읽기 → -
크리에이터 정보 신선도 강화, 졸업 추적, 신규 발견 추가
세 가지 기능 개선을 한 번에 배포했다. 구독자 수를 최신으로 유지하고(A1), 졸업자를 아카이브하며(A2), 신규 데뷔자를 발견하는 피드를 추가했다(A3). 8개 언어로 동시 지원한다.
읽기 → -
배치 정산 리포트 알림 노이즈 제거
일일 정산 리포트를 생성하는 배치 작업에서 모든 완료 메시지가 디스코드로 나가고 있었다. 문제는 이 리포트가 정산 시스템 내부에서 자동 처리되는 데이터일 뿐이라는 점이었다. 팀이 매번 그 결과를 디스코드에서 눈으로 확인해야 할 필요가 없었고, 오히려 정말 중요한 알림들 사이에 묻혀 신호대잡음비가 떨어지고 있었다.
읽기 → -
색인요청이 support 팀 손에 닿지 않던 이유
지난주 한 서비스의 검색엔진 최적화(SEO) 운영 흐름을 점검하다가 흥미로운 병목을 찾았다. Google Search Console(GSC) 색인요청이라는 정기적인 작업이 특정 계정(dev.slecs, authuser=1)에만 가능했고, support 팀은 이 작업을 수행할 권한이 없었던 것이다. 그간 이 부분이 구두로만 전달되다 보니 새로운 팀원들이 합류
읽기 → -
고아 페이지를 허브로 연결해 색인 개선
최근에 K-pop 데이터 플랫폼에서 앨범, 엔터테인먼트사, 팬덤 같은 주요 엔티티들의 인덱스 페이지를 새로 만들고, 멤버/그룹 페이지와 상호 링크로 연결하는 작업을 했다. 한두 줄로 보면 단순한 기능 추가지만, 사실 이건 사이트 구조 설계 관점에서 꽤 중요한 변화였다.
읽기 →