-
블로그 시드 데이터를 라이브와 일치시킨 이유
최근에 초기화 SQL 파일(sql/01_init.sql)을 수정해서 블로그의 SEO 메타정보(site_title, description)를 개발 환경 시드에 반영했다. 한 줄로는 "시드 데이터 동기화"처럼 들리지만, 이 작업이 드러내는 문제와 의사결정 과정이 흥미로워서 풀어 써 본다.
읽기 → -
홈페이지 SEO title, 하드코딩에서 DB 관리로
홈 페이지의 메타 title을 하드코딩된 값에서 CMS 데이터베이스(cms_site.meta.seo.title)로 가져오도록 변경했다. BaseHead.astro와 Base.astro 두 컴포넌트를 수정했고, 이제 홈 타이틀도 나머지 SEO 메타데이터처럼 관리자가 운영 도구에서 자유롭게 수정할 수 있다.
읽기 → -
홈 title이 CMS 설정을 반영하지 않던 SEO 버그
검색 엔진이 수집하는 홈 페이지의 <title> 태그가 관리자가 CMS에서 설정한 값(cms_site.meta.seo.title)과 달라서 발생하던 버그를 수정했다. Base.astro라는 전사 레이아웃 파일의 한 줄 배선 작업이었지만, 그 영향은 꽤 크다.
읽기 → -
홈 페이지 타이틀이 DB에서 안 나가던 SEO 버그 해결
홈페이지 SEO 타이틀이 CMS에서 설정한 값 대신 다른 곳에서 나가고 있던 문제를 발견했다. 레이아웃 파일에서 DB의 메타 정보를 제대로 참조하도록 배선을 다시 정리한 작업이다.
읽기 → -
홈 화면 SEO 타이틀 DB 배선 버그 수정
홈 페이지의 <title> 태그가 DB의 CMS 설정값(cms_site.meta.seo.title)이 아닌 고정된 값을 사용하고 있던 버그를 수정했다. Astro 기반 레이아웃 컴포넌트에서 메타 데이터 배선을 제대로 연결하는 작업이었다.
읽기 → -
홈 SEO title 이 CMS 설정값 반영 못하던 버그 해결
홈 페이지의 <title> 태그가 DB의 CMS 설정(cms_site.meta.seo.title)에서 가져오지 못하고 있었다. Astro의 Base.astro 레이아웃을 수정해서 이 문제를 해결했다.
읽기 → -
홈 페이지 SEO title이 CMS에서 제대로 로드되도록 수정
홈 페이지의 <title> 태그가 DB의 CMS 메타데이터(cms_site.meta.seo.title)에서 가져오도록 배선했다. 동적 콘텐츠를 다루는 시스템에서 메타데이터까지 하드코딩해두면 운영 변경이 어렵고, SEO 효과도 감소하니까 이런 수정이 자주 필요하다.
읽기 → -
SEO 타이틀을 DB 기반 설정으로 통합
홈 페이지의 SEO 타이틀이 CMS 데이터베이스에서 제대로 로드되지 않던 문제를 수정했다. 간단해 보이는 변경이지만, 검색 엔진 최적화(SEO)와 콘텐츠 관리의 일관성에 꽤 중요한 수정이었다.
읽기 → -
홈 페이지 SEO title이 CMS 설정값을 반영하도록 수정
홈 페이지의 <title> 태그가 CMS에서 관리하는 설정값(cms_site.meta.seo.title)을 제대로 로드하지 않던 버그를 고쳤다. 처음엔 작은 수정처럼 보였지만, 이걸 통해 SEO 전략과 콘텐츠 관리 아키텍처를 다시 생각해보게 됐다.
읽기 → -
CMS 기반 타이틀로 홈 페이지 SEO 메타 신뢰성 확보
홈 페이지의 title 태그가 실제로 CMS에서 관리하는 SEO 메타 데이터(cms_site.meta.seo.title)를 반영하지 못하고 있던 버그를 발견했다. Base.astro 라는 루트 레이아웃 파일에서 타이틀을 직접 DB에서 가져오도록 배선을 수정했는데, 이게 생각보다 깊이 있는 선택 문제더라.
읽기 → -
홈 페이지 SEO 타이틀이 고정값으로 나오던 버그 수정
홈 페이지의 <title> 태그가 하드코딩된 고정값으로만 나가고 있었다. CMS에서 SEO 타이틀을 업데이트해도 반영이 안 되는 문제였는데, 이걸 cms_site.meta.seo.title에서 동적으로 가져오도록 src/layouts/Layout.astro를 수정했다.
읽기 → -
홈 페이지 SEO 타이틀이 CMS 설정을 따르도록 수정
홈 페이지의 <title> 태그를 하드코딩된 값에서 데이터베이스 값(cms_site.meta.seo.title)으로 연동하는 작업을 했다. 작은 변경처럼 보이지만 콘텐츠 팀이 SEO 설정을 독립적으로 관리할 수 있게 만든 중요한 배선이다.
읽기 → -
홈 페이지 title을 CMS 데이터에서 읽도록 배선
홈 페이지의 <title> 태그가 하드코딩되어 있던 것을 CMS 데이터베이스(cms_site.meta.seo.title)에서 동적으로 가져오도록 변경했다. Base.astro 하나의 파일 수정이었지만, 이건 꽤 중요한 SEO 배선의 문제였다.
읽기 → -
홈 페이지 제목을 CMS에서 관리하도록 수정
홈 페이지의 SEO 제목을 하드코딩된 고정값이 아니라 CMS 데이터베이스에서 동적으로 가져오도록 변경했다. src/layouts/Base.astro 에서 cms_site.meta.seo.title 을 참조하는 배선 작업인데, 이게 생각보다 흥미로운 버그였고 팀 커뮤니케이션 관점에서도 배운 게 많아서 정리해본다.
읽기 → -
동적 URL 페이지의 SEO 신호 정상화
레이아웃 파일에 canonical 태그와 og:url 메타 정보를 추가했다. 사소해 보이지만 검색 엔진과 소셜 미디어 플랫폼이 우리 페이지를 올바르게 인식하도록 하는 핵심 신호다.
읽기 → -
페이지 검색 노출성 개선한 메타 태그 추가
검색 엔진과 소셜 미디어 플랫폼이 우리 페이지를 올바르게 인식하도록 canonical 과 og:url 메타 태그를 추가했다. 작은 변경이지만 SEO 전략 전체에서 생각보다 중요한 부분이었다.
읽기 → -
검색 순위와 소셜 공유에 혼동 주던 도메인 메타태그 통일
운영 도메인이 growthebutton.com 으로 정해졌는데, 콘텐츠의 canonical 태그와 og:url이 여전히 구 도메인이나 불명확한 주소를 가리키고 있던 상황이었다. layout.tsx 에서 이 메타태그들을 통일하는 작업을 했다.
읽기 → -
검색·소셜 메타데이터 누락 해결
요즘 웹서비스의 검색 엔진 노출과 소셜 쉐어 도달률은 메타데이터 품질에 직결된다. 이번 작업은 사이트에 거의 없었던 SEO 메타데이터들을 전면 보강한 경험을 기록해본다.
읽기 → -
JSON 경로 부재 시 DB 업데이트 결과 누락되던 버그
자동화 워커 스크립트에서 JSON 필드를 갱신할 때, 부모 요소가 없으면 실제로는 데이터베이스 변경이 일어나지 않았는데도 영향 받은 행 수를 제대로 추적하지 못하는 버그를 발견했다. 이 글에선 왜 이런 일이 생기고, 실무에서 어떤 영향을 미치는지 풀어본다.
읽기 → -
도메인 변경 후 문서 참조 일괄 수정
서비스의 도메인 주소가 변경됨에 따라 문서에 하드코딩되어 있던 URL 참조를 일괄 업데이트했다. CLAUDE.md 파일에 분산된 4곳의 도메인 링크를 새로운 주소로 수정하는 작업이었는데, 생각보다 "찾기"가 핵심이었다.
읽기 →