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