ADR-0005: 서비스 폴더 구조 v3 — Partners 분리 복귀 (5-way)
- 일자: 2026-05-10
- 상태: ⚠️ Superseded by ADR-0006 — 서비스 폴더 구조 v4 (2026-05-10)
- 결정자: cony@yumyum.im
- 관련: ADR-0002 — 사장님 앱 영문 표기, 용어 정의
이 ADR 은 ADR-0006 으로 대체되었습니다. Marketing 와 Partners 가 코드 자산을 강하게 공유한다는 점에서 별도 서비스로 분리할 필요가 없다고 재판단. ADR-0006 은 4-way 구조로 회귀하면서 Marketing 우선순위를 2번으로 올림.
배경 (Context)
ADR-0004 가 Partners 를 단독 서비스로 분리하지 않고 Marketing(공개 마케팅) + Store-Portal(운영) 두 곳으로 나눠 흡수했다. 이후 쿠팡이츠의 웹 구조를 검토한 결과 — Partners 가 별도 도메인 + 별도 마케팅 사이트 로 운영되는 것이 업계 표준임을 확인했다.
쿠팡이츠 웹 구조 (벤치마크)
| 도메인 | 역할 |
|---|---|
www.coupangeats.com | B2C 메인 마케팅 / 앱 다운로드 |
partners.coupangeats.com | B2B 사장님 입점 마케팅 / 신청 |
store.coupangeats.com | 로그인 후 사장님 운영 포털 |
세 사이트는 다른 사용자 / 다른 도메인 / 다른 카피 / 다른 SEO 전략을 가진 분리된 자산이다. 한 우산에 묶으면 디자인·코드·CMS·트래킹이 모두 뒤섞임.
결정 (Decision)
5 최상위 + Store 3채널 구조로 변경. Partners 를 별도 서비스로 복귀.
최상위 5개
| 코드명 | 한국어 | 사용자 | 플랫폼 | 쿠팡이츠 매핑 |
|---|---|---|---|---|
User | 냠냠픽업 App | 고객 (User) | iOS / Android | (앱) |
Store | 사장님 운영 도구 (3채널 우산) | 사장님 (Merchant) | Web + iOS/Android + Windows | (운영 도구 모음) |
Marketing | 메인 마케팅 사이트 | 일반 방문자 / 잠재 고객 | Web (www.yumyum.im) | coupangeats.com |
Partners | 사장님 입점 마케팅 사이트 | 잠재 사장님 (로그인 전) | Web (partners.yumyum.im) | partners.coupangeats.com |
Admin | 운영 어드민 | 운영팀 | Web (내부) | (내부) |
Store 3채널 (변동 없음)
| 코드명 | 한국어 | 플랫폼 | 쿠팡이츠 매핑 |
|---|---|---|---|
Store-Portal | 사장님 운영 포털 | Web (store.yumyum.im) | store.coupangeats.com |
Store-App | 냠냠픽업 스토어앱 | iOS / Android | (모바일) |
Store-POS | 냠냠픽업 POS | Windows | (POS) |
변동 사항 (vs ADR-0004)
Partners복귀 (이전 ADR-0004 에서 흡수됐던 것을 별도 서비스로 다시 분리)- Admin 폴더 번호 변경:
yumyum-40-admin/→yumyum-50-admin/(Partners 가 40 자리로 들어옴) - Marketing 의 "사장님 입점 안내" 표는 요약 + 링크로 축소 (실 콘텐츠는 Partners 로 이동)
근거 (Rationale)
1. 쿠팡이츠가 동일 결정을 한 사례 — 객관적 검증
- 픽업·배달 카테고리 1위 경쟁사가 3개 도메인 분리 채택
- 경쟁사 분석상 같은 결정을 따르는 것이 학습 비용 ↓ (사용자 인지 패턴 공유)
2. Marketing(B2C) ↔ Partners(B2B) 는 본질적으로 다른 사이트
| 축 | Marketing | Partners |
|---|---|---|
| 사용자 | 일반 소비자 | 잠재 사장님 |
| 가치 제안 | 맛있는 음식, 빠른 픽업 | 낮은 수수료, 입점 혜택 |
| KPI | 앱 다운로드 / DAU | 입점 신청 / 리드 |
| SEO 키워드 | "픽업 앱", "포장 주문" | "음식 배달 입점", "픽업 매장 등록" |
| 카피 톤 | 친근 / 일상 | 신뢰 / 비즈니스 |
같은 우산에 두면 디자인·정보 구조·CMS·트래킹이 모두 뒤섞임.
3. ADR-0003 의 원래 원칙 (사용자 군별 분리) 회복
- ADR-0003 은 "사용자 군별 분리가 가장 안정적인 경계" 라고 결정
- ADR-0004 는 "Partners 포털은 본질적으로 웹페이지" 인사이트로 일부 흡수했지만, 두 인사이트는 양립 가능 — Partners 도 웹페이지이고 동시에 별도 사용자 군
- ADR-0005 는 두 인사이트를 통합: 분리 유지 + 숫자 prefix 적용 + Store 3채널
4. 고려한 대안
대안 A: ADR-0004 유지 (Partners 흡수) (기각)
- 기각: 쿠팡이츠 사례 + B2C/B2B 본질 차이로 인한 향후 디자인·트래킹 충돌 예상
대안 B: Marketing 안에 Partners 를 sub-라우트로 (www.yumyum.im/partners) (기각)
- 기각: 도메인 분리(
partners.yumyum.im)가 SEO/브랜딩에 유리. 별도 코드 / 디자인 / CMS 가 자연스러움.
대안 C: Partners 와 Store-Portal 을 다시 같은 우산에 (B2B 통합) (기각)
- 기각: ADR-0004 가 이미 시도한 방향. 로그인 경계가 흐려진다는 단점 그대로.
결과 (Consequences)
긍정
- 3개 웹 도메인이 코드/문서/Figma 에서 1:1 매핑 — 인지 비용 ↓, 충돌 ↓
- B2C / B2B 분리 로 SEO·마케팅·트래킹 KPI 가 깔끔하게 측정 가능
- 쿠팡이츠 패턴 채택으로 사장님이 학습 없이 구조 인지 가능
주의 / 후속 필요
- Marketing 의 "사장님 입점 안내" 페이지 는 요약 + Partners 로의 강한 CTA 만 두기 (긴 콘텐츠는 Partners 본문에)
- 글로서리 갱신 — Partners 항목에 "도메인(
partners.yumyum.im) = 본 사이트의 정식 명칭" 명시 - CLAUDE.md / README.md 폴더 표 갱신
- Phase 0/1/2 정식 결정 ADR 은 별도 — 5 서비스 중 어떤 걸 언제 만들지
후속 작업
- [x] yumyum-40-partners/ 신규 생성 + 골격 작성
- [x] yumyum-40-admin → yumyum-50-admin 번호 변경
- [x] yumyum-30-marketing/ 본문 갱신 (Partners sub-페이지 표 → 별도 사이트 안내)
- [x] /20-product/index.md 5-way 카탈로그 + 쿠팡이츠 매핑 표
- [x] ADR-0004 ⚠️ Superseded 표시
- [x] 사이드바 config 갱신
- [ ] 글로서리에 코드명 추가 (
User등 5개 + Store 3개) - [ ] Phase 0/1/2 정식 결정 ADR
- [ ] Figma·코드 레포 명명 정합 (작업 측에서)