대한민국유권자총연맹 — 기관 홈페이지 워드프레스 전면 이전

의뢰 기관의 홈페이지는 Cafe24 빌더로 만들어진 PC 전용·비반응형 사이트였습니다. 게시판·회원·콘텐츠가 모두 빌더에 묶여 있어 담당자가 글 하나 직접 고칠 수 없었고, 모바일에서는 PC 화면이 그대로 축소돼 사실상 읽기 어려운 상태였습니다.

조건이 까다로웠습니다. 수년간 쌓인 게시물과 이미지, 그리고 이미 자리 잡은 검색 순위를 한 건도 잃지 않아야 했습니다.

먼저 빌더 사이트 전체를 크롤링해 URL 구조와 게시판 5종, 정적 페이지 17종을 목록화했습니다. 게시물 283건·페이지 30개·원본 이미지 625개(373MB)를 전량 회수해 워드프레스로 옮겼고, 유료 테마나 페이지빌더 없이 테마를 직접 개발했습니다. 운영 서버와 같은 구성(PHP 8.2 + MariaDB)을 Docker로 로컬에 만들어 두고 작업했습니다.

가장 큰 난제는 주소였습니다. 빌더의 게시글 주소가 쿼리스트링 형태라 워드프레스 구조로는 재현이 불가능했습니다. 옛 주소를 새 주소로 개별 매핑하는 301 처리를 테마에 직접 구현했고, 첨부파일 다운로드 링크까지 매핑해 기존 검색 유입과 외부 링크를 그대로 살렸습니다.

옛 서버에만 있던 이미지와 첨부파일은 전량 미러링하고 출력 시점에 경로를 새 위치로 바꾸도록 처리해, 원본 사이트를 내려도 새 사이트가 온전히 동작하는 것을 전수 검증했습니다. 작업 중에는 주소 파라미터만으로 회원 25명의 실명이 로그인 없이 조회되던 취약점을 발견해 차단했습니다.

최종 점검은 실제 브라우저(Puppeteer)로 24개 화면을 두 해상도에서 자동 렌더링해 깨진 이미지·혼합 콘텐츠·가로 넘침·콘솔 오류를 전수 확인했고 전 항목 0건이었습니다. 전체 313개 문서를 다시 크롤해 오류 0건, 옛 도메인 잔존 0건도 함께 확인했습니다. 페이지 응답은 홈 0.70초, 게시판 0.74초입니다.

비개발자인 담당자가 혼자 운영할 수 있어야 했기에, 실제 관리자 화면을 촬영해 만든 관리자 설명서(A4 8쪽)와 SSL·DNS·색인·301·보안·속도 실측치를 담은 점검 기록서(A4 5쪽), 언제든 다시 실행할 수 있는 자동 점검 스크립트를 함께 전달했습니다.