한 소스에서 제조사별 쇼핑몰 3곳 만들기 — 파생 테마 생성기 패턴

관리자 2026-11-01 22:34 조회 25
## 목표 TP-Link·Synology 를 함께 파는 통합 스토어와, 제조사별 전용 상점 두 곳을 **같은 디자인으로** 운영해야 했다. 호스트마다 같은 `/sub/*` 가 열리면 중복 콘텐츠가 되므로 사이트마다 별도 테마가 필요하다. 손으로 복사하면 수정할 때마다 세 곳이 어긋난다. ## 구조 - **데이터는 한 곳**: 단가표가 도메인 ID 기준으로 저장되어 있어, 상점 코드가 항상 원래 도메인의 단가표를 읽도록 했다(새 도메인에 단가표를 복제하지 않는다). - **화면만 호스트별**: 통합 스토어 테마가 정본이고, 제조사 테마는 생성기가 **파일 복사 + 치환**으로 만든다. - 상점 셸은 제조사 목록 상수 하나(`ST_VENDORS`)로 데이터 주도로 그려, 제조사가 늘어도 코드는 그대로다. - 생성기는 치환 건수를 **assert**(예: 제목 1, 호스트 폴백 1, 리다이렉트 스텁 4)하고 출력 검증을 통과해야 끝난다. 생성물은 **직접 수정 금지**이고 정본을 고친 뒤 다시 생성한다. ## SEO 정리 - 다른 제조사 주소는 해당 전용 사이트로 **301** 한다. - 통합 스토어의 제조사 페이지 canonical 은 전용 사이트를 가리킨다. - 공개 주소와 사이트맵은 확장자 없는 경로로 통일한다. ## 화면 계약 유지 장바구니는 브라우저 저장소의 객체(`{items:{모델:{model,price,qty}}}`)를 계약으로 삼는다. 처음 배열로 가정해 헤더 배지가 항상 0 으로 나온 버그가 있었다. 상태 저장 계약은 문서에 형태까지 적는다. ## 검증 세 테마 모두 같은 스모크 테스트(히어로·티커·드로어 접근성·검색 범위·장바구니·수량 합계·콘솔 오류 0)를 돌린다. 테스트마다 새 브라우저를 열어, 큰 페이지를 한 세션에서 여러 번 열 때 생기는 브라우저 불안정을 피한다. ## 교훈 복제 대상이 셋을 넘으면 **생성기가 정본**이다. 복사본은 항상 틀어지고, 생성기의 assert 는 그 틀어짐을 막는 안전장치다.
KO