lapie_app/docs/spec.md

> [!takeaway] 비즈니스/방향성 관점에서의 핵심
> **Lapie (라피)** 는 박재오 [[정체성-Why-탐색|D-3 Why]] "내가 부딪힌 불편함을 누군가 다시 부딪히지 않도록 푸는 것"의 **외면 분기 첫 증거**다. 메인 흐름 '결'이 내면(사주·MBTI 영역)을 다룬다면 Lapie는 외면(체형·옷·스타일 자각의 어려움)을 다룬다. 발견 4 "함께" 키워드(지인 공유)를 시각화로 점유하는 **독립 SNS 친화 브랜드**. v0 = MVP 검증형 4~6주 / iOS 단독 / React Native + Vision Camera. 7월 착수 예정 (현재 5~6월은 [[프로젝트-이모추]] · [[프로젝트-무진장-AI-광고제]] · [[프로젝트-우리카드-AI숏폼-공모전]] · [[정체성-Why-탐색|'결' PMF 1단계]]가 가용시간 점유). 차별점은 "실물 옷을 들고 화면에 댄다" — 의류 디지털화 불필요, 결과물 = 실물 그대로.

# 사업 — Lapie (라피) 피팅 앱

## 한 줄 정의

정면 전신 사진의 신체 영역에 **실시간 카메라로 옷을 대보는** iOS 앱. 사용자가 옷을 카메라 앞에 들면, 사진 속 본인이 그 옷을 입은 듯한 합성 영상이 보이고, 캡쳐해서 지인에게 공유할 수 있다.

## 브랜드 — Lapie (라피)

### 네이밍 근거
- Lap("얹어 대다") + 부드러운 어미 → **"옷을 (내 몸에) 얹어본다"** 의미 점유
- 신조어 점유형 ([[정체성-Why-탐색|D-3 Why 페이지]] 명시: Linear·Notion·Toss 패턴)
- 글로벌 발음 친화, 카테고리에 묶이지 않음
- 박재오 변연계 선택 (Wittu / Mirree / Lapie / Geola 4개 후보 중)

### 톤
- 가벼운 SNS 친화 (쟁승메이드·'결' 메인 흐름과 톤 분리)
- 행위 직설형: "들고 → 댄다 → 본다 → 보낸다"
- 독립 브랜드 (쟁승메이드 산하 아님)

## Why 정합도 — D-3 Why 검증대 통과

| Why 요소 | Lapie 매핑 | 정합도 |
|---|---|---|
| 내가 부딪힌 불편함 | 박재오 본인이 "이 옷이 나한테 어울릴까?" 고민을 직접 경험 | ✅ **강** (사용자 본인 확인 2026-05-23) |
| 적용 영역 '결' | 외면(체형·스타일) 자기자각의 어려움 — 내면 결과 메타 패턴 동일 | ✅ **확장형** ('결'의 외면 분기) |
| 발견 4 "함께" | 지인 공유 부가기능이 정확히 일치 | ✅ **강** |
| 발견 3 "증명" | "이 옷이 어울린다"를 친구·SNS에 증명받고 싶은 욕구 | ✅ **정합** |

→ D-3 Why 정식 증거 라인 #3 추가 ([[프로젝트-쟁승메이드-Co]] #1 사주 / [[사업-AI음악작곡-워크플로우]] #2 음악 / **Lapie #3 외면 피팅**).

## 메인 기능 (v0)

### 핵심 동작 흐름
```
앱 열기
  ↓
정면 전신 사진 1장 등록 (자세 가이드 오버레이 + 자동 검증)
  ↓
자동 마스킹 (MediaPipe Selfie Segmentation + Pose 17점)
  ├ 상의 모드 (어깨~허리)
  ├ 하의 모드 (허리~발목)
  └ 전신 모드 (전체 실루엣)
  ↓
카메라 실행 → 옷을 카메라 앞에 댐
  ↓
자동 스케일 초기 추정 + 사용자 핀치 미세조정 (하이브리드)
  ↓
캡쳐 → SNS·카톡 공유 / 갤러리 저장
```

### 자동 스케일 알고리즘 (v0 차별화 포인트)
```
초기 추정:
  ref_shoulder_px  = 정면사진의 좌우 어깨 keypoint 픽셀거리
  ref_shoulder_cm  = 사용자 입력 키 × 0.25 (인체 평균)
  cam_cloth_width  = 카메라에서 옷 윤곽 검출 (Selfie + 색차 마스크)
  스케일 추정       = ref_shoulder_px / cam_cloth_width

사용자 핀치 줌:
  자동 추정값을 초기 transform으로 적용
  핀치/드래그로 ±30% 미세조정
```

> 자동 스케일은 v0 핵심 차별화이자 발목 잡는 곳. 정확도 부족 시 "재미는 있는데 실용성 없음"으로 굳어질 위험. W3에 별도 검증 사이클 필요.

## 기술 스택

| 영역 | 선택 | 근거 |
|---|---|---|
| 프레임워크 | React Native (Expo bare / EAS Build) | 박재오 React 경험 활용 + v1 Android 동시 확장 가능 |
| 카메라 | react-native-vision-camera v3 | Frame Processor로 ML 모델 호출 + 셰이더 합성 |
| 세그멘테이션 | iOS: Vision (VNGeneratePersonSegmentationRequest) / Android: MediaPipe Selfie | 무료 · on-device · 실시간 |
| Pose 키포인트 | iOS: Vision (VNDetectHumanBodyPoseRequest) / Android: ML Kit Pose | 17점 자동 |
| 합성 | react-native-skia | 마스크 + 카메라 피드 셰이더 합성 |
| 상태관리 | Zustand | 최소 전역 상태 |
| 빌드 | EAS Build (iOS) | TestFlight → 앱스토어 |
| 백엔드 (v0) | 없음 | v1부터 회원·클라우드 추가 |

### 컴포넌트 구조 (RN)
```
src/
├ screens/
│  ├ Onboarding.tsx          // 첫 사용 가이드 3장
│  ├ PhotoCapture.tsx        // 정면사진 촬영/선택 + 가이드
│  ├ MaskPreview.tsx         // 자동 마스킹 결과 + 모드 선택
│  ├ LiveFitting.tsx ⭐      // 카메라 합성 메인 화면
│  └ Capture.tsx             // 캡쳐 결과 + 공유
├ features/
│  ├ segmentation/           // Selfie Segmentation 브릿지
│  ├ pose/                   // MLKit/Vision Pose 브릿지
│  ├ composite/              // Skia 셰이더 합성
│  └ autoScale/              // 어깨너비 ↔ 옷 너비 비율 추정
├ store/                     // Zustand
└ native_modules/
   ├ ios/                    // Vision API 브릿지
   └ android/                // ML Kit 브릿지 (v1)
```

## 시장 분석

### Primary 타겟
20~30대 여성, 온라인 쇼핑(무신사·지그재그·에이블리) 빈도 높음, 반품률 높음, 사이즈/스타일 자주 고민. 구매 직전 "친구에게 사진 보내고 의견 묻는" 행동 패턴 → Lapie의 캡쳐·공유 기능이 그 행동을 흡수.

### Secondary 타겟
- 부모님·배우자 옷 선물 시 본인 사진 위에 대보고 싶은 사람
- 중고거래(번개장터·당근) 옷 사이즈감 확인
- 빨래방·드라이클리닝 전 코디 미리보기

### 경쟁 지형
| 카테고리 | 예시 | Lapie와의 차이 |
|---|---|---|
| AR 가상 피팅 (3D 의류 모델 필요) | Wanna, Snap AR Try-On, Trillenium | **의류 디지털화 전제** → 일반 사용자 불가. Lapie는 실물 옷만 있으면 OK |
| 매장 키오스크 AR Mirror | 무신사 매장, 신세계 일부 | B2B, 일반 접근 불가 |
| AI 의류 생성 | Doji, AI Outfit | AI가 옷을 *생성* → 실물과 다름. Lapie는 실물 그대로 |
| **Lapie 자리** | (직접 경쟁자 거의 없음) | 실물 옷 들고 화면에 대본다 = 의류 디지털화 X, 시각적 임팩트 강함 |

### 비즈니스 모델 후보
1. **Freemium**: 무료 + 캡쳐 워터마크 / 프리미엄(워터마크 제거 + 워드로브 저장 + 다중 사진)
2. **어필리에이트**: 옷 인식 → 무신사·쿠팡·지그재그 유사 상품 추천 (수수료) — v2
3. **B2B 라이선스**: 동대문 셀러·쇼핑몰 사장 모델 1장 위에 신상 합성 — v2
4. **광고**: 트래픽 누적 후 후순위

### 마케팅 채널
**앱 사용 영상 자체가 마케팅**. 시각적 임팩트가 강해 인스타 릴스 / 틱톡 / 쇼츠 친화. [[사업-hedgy75-인스타]] 카드뉴스 채널과 시너지 가능(1인 빌더 일지의 다음 빌드 콘텐츠).

## 일정 (v0 → v2)

### v0 — MVP 검증형 (4~6주, 7월 착수 예정)

| 주차 | 작업 | 산출물 |
|---|---|---|
| W1 | RN 세팅 + Vision Camera PoC + Selfie Segmentation 마스크 | 마스크 오버레이 동작 |
| W2 | 정면사진 등록 + Pose keypoint + 3모드 마스크 자동 분할 | 사진 1장에서 3 마스크 |
| W3 | Skia 합성 + 자동 스케일 추정 | 카메라 합성 동작 |
| W4 | 캡쳐·저장·공유, 온보딩 3장, 폴리싱 | 박재오 사용 가능 빌드 |
| W5~6 (버퍼) | 자동 스케일 보강, 인스타 콘텐츠 5편 | 친구 5명 베타 |

**검증 게이트**: 인스타 릴스 5~10편 + 100명 사용. 매직 넘버 = 주간 콘텐츠 발행 수 + 영상 조회수 ([[정체성-Why-탐색]] PMF 매직넘버 #7 원칙 적용).

### v1 — 출시 (누적 10~14주)
- Android 추가
- 회원·클라우드 저장 (NAS 활용 가능, [[자산-인프라-NAS-GPU]])
- 인앱결제 (워터마크 제거)
- TestFlight → 앱스토어 정식 출시
- 1차 마케팅 (쇼츠 5편)

### v2 — 수익화 (누적 15~22주)
- 옷 인식 → 어필리에이트(무신사·쿠팡)
- 워드로브 갤러리
- 친구 합성 (2인 사진)
- 동대문 셀러용 B2B 모듈

## Day 0 차단성 액션 (착수 전 필수)

### 검증 결과 (2026-05-23, dispatching-parallel-agents 4건 병렬 실행)

| # | 액션 | 결과 | Evidence 강도 |
|---|---|---|---|
| 1 | **도메인 검색** | 🟡 lapie.app ❌(점유, 불어 파킹) / lapie.com ❌($18,999 프리미엄) / lapie.co ❌ / **lapie.kr ✅** / **lapie.io ✅** / getlapie.com ✅ / trylapie.com ✅ | 강 (DNS NXDOMAIN + 등록 사이트 직접 확인) |
| 2 | **앱스토어 동명 앱** | 🟢 **충돌 없음**. App Store(US/KR) "Lapie"·"라피" 0건 / Google Play(Global/KR) 0건. 패션·피팅 카테고리 유사명 없음 | 강 (4채널 직접 검색) |
| 3 | **인스타 핸들** | 🟢 **@lapie_app ✅ 선점 완료 (2026-05-23 박재오 직접)** / @lapie ❌(개인 비활성) / @lapieofficial ❌(La Pie 💎 주얼리 브랜드) / @uselapie ❌(누군가 선점) / @lapie.app·@lapie_kr·@lapie_korea ✅ 추정 (보조 핸들 후보) | **확정** (가입 화면에서 직접 확인 후 등록) |
| 4 | **KIPRIS·USPTO 상표** | 🟡 **중위험**. Lapie 직접 일치 미확인 / 한글 유사 다수: 라피타(LaPitta, Class 9·10) · 라피도(Rapido, Class 25 소멸 추정) · LAP(Class 25 운영 중) / **인스타 신호 추가: La Pie 주얼리 → Class 14 추가 위험** | 약 (KIPRIS·USPTO·WIPO 자동조회 차단 → 우회 웹검색만, 변리사 정식 조사 필요) |
| 5 | Apple Developer Program 가입 ($99) | ⏸ 7월 착수 직전 | — |
| 6 | Figma 와이어프레임 5화면 | ⏸ W1 첫 주 | — |

### 종합 판정 (2026-05-23): 🟢 **Lapie 브랜드 확정** (4건 검증 + 대안 3건 비교 후 박재오 결정)

> 🎉 **@lapie_app 인스타 핸들 선점 완료** (2026-05-23). 가장 회수 어려운 자산 1순위 확보. 도메인(lapie.kr / lapie.io) 등록은 7월 착수 직전 박재오 직접.

**유지 근거 (강):**
- 앱스토어 글로벌·한국 충돌 0건 = 출시 자체에는 무리 없음
- lapie.kr + lapie.io 확보 가능 = 한국 시장 + 글로벌 테크 톤 둘 다 커버
- @lapie_app 등 핸들 선점 가능 (추정 강함)
- Class 9(앱)·Class 42(SaaS) = 출원 가능성 영역

**조건·위험 (중):**
- lapie.app + lapie.com 사실상 막힘 → 글로벌 메인 도메인 톤 약화 (lapie.io로 보완)
- Class 14(주얼리, La Pie 인스타) + Class 25(의류, 라피타·라피도·LAP) **브랜드 컨퓨전 위험** → 의류 카테고리 확장 제한 또는 변리사 검토 후 출원
- KIPRIS·USPTO 자동조회 차단으로 상표 결과는 **공개 검색 한도** — 정식 출원 전 변리사 유사상표 조사 필수
- @uselapie 누군가 선점 = 작명 시도 흔적 → **빠른 선점 권장**

### 즉시 권장 액션 → 진행 상태

1. ⏸ **lapie.kr 등록** (가비아·후이즈, 약 2만/년) — 7월 착수 직전 박재오 직접
2. ⏸ **lapie.io 등록** (Namecheap 등, 약 5만/년) — 7월 착수 직전 박재오 직접
3. ✅ **@lapie_app 인스타 선점 완료** (2026-05-23 박재오 직접) — 가장 회수 어려운 자산 확보
4. ⏸ Class 9·42 출원은 7월 착수 후 변리사 검토 → 진행
5. 🚫 Class 14·25 의류·주얼리 카테고리 출원·확장 회피 (또는 변리사 정식 검토)

### 대안 후보 4건 비교 (2026-05-23 추가 검증 완료)

박재오 요청으로 Wittu·Mirree·Geola 3개 대안에도 동일 4건 검증(도메인·앱스토어·인스타·상표) 실행. dispatching-parallel-agents 스킬로 브랜드별 1 agent 병렬 dispatch.

| 영역 | **Lapie 🟡** | Wittu 🟡 | Mirree 🔴 | Geola 🔴 |
|---|---|---|---|---|
| 메인 .com | ❌ $18,999 | ❌ 2026-06 만료 갱신가능성 | ❌ 선점 | ❌ **28년 보유** |
| .kr / .io | ✅ 확정 / ✅ 확정 | ⚠ 미확인 | ⚠ 미확인 | ✅ 추정 / ✅ 추정 |
| 앱스토어 | 🟢 4채널 0건 | 🟢 0건 + 컨셉충돌 | 🟢 0건 + ASO noise | 🟡 Geolah + GOELIA 인접 |
| 인스타 _app 가능 | ✅ 추정 | ✅ 추정 | ✅ 추정 (단 @mirree 선점) | ⚠ 핸들 불명 |
| 상표 핵심 위험 | Class 14·25 (La Pie 주얼리 + 라피타·라피도·LAP) | **Class 25 (위트·WITT·WIT·위벳유 다중)** | Class 9·42 (**미리캔버스**) + 25 (Art by Mirree) | Class 25 (**(주)지올 G-ALL** + **GOELIA**) + 9 (Geolah) |
| 한국어 SEO | 중립 | "위트" 검색 노이즈 | **🔴 "미리"=부사+미리캔버스** | 발음 모호 |
| 글로벌 SEO | 중립 | 중립 | **🔴 Art by Mirree 호주** | **🔴 GOELIA 중국 패션 앱** |

**판정 결과**:
- 🟡 **Lapie (1순위 유지)** — .kr+.io 가용 확정 우위, 상표 위험 비슷한 수준이나 "위트"보다 "라피"가 한국어 일반 어휘 점유 약함
- 🟡 **Wittu (후보 #2)** — Lapie 변리사 조사 🔴 판정 시 대체 후보
- 🔴 **Mirree (폐기)** — mirree.com 선점 + @mirree 선점 + Art by Mirree 호주 아티스트 + 미리캔버스 한국 SEO 점유 + "미리" 부사 = 4중 회피 사유
- 🔴 **Geola (폐기)** — geola.com 28년 보유 + GOELIA 글로벌 패션 앱 + (주)지올 G-ALL + 영문 발음 모호성 = 4중 회피 사유

**최종 결정 (2026-05-23)**: **Lapie 유지** + 즉시 권장 액션 3건 + Class 9·42 출원만 + 변리사 정식 조사. Lapie 🔴 판정 시 Wittu 진입, 그 외(Mirree·Geola)는 후보군에서 제외.

## 위험 요소

1. **자동 스케일 UX 실패** — 정확도 부족 시 "재미는 있는데 실용성 없음". W3에 별도 검증 사이클 필수.
2. **iOS 단독 출시의 한국시장 함정** — Android 비중 70%대. v1에서 Android 필수.
3. **사진 촬영 진입장벽** — 정면 전신·배경 단순·조명 일정 = 사용자 직접 촬영 어려움. **가이드 오버레이 + 자세 자동 검증** 필수.
4. **개인정보·사진 데이터 정책** — 앱스토어 심사에서 명시 필요. on-device 처리로 유리.
5. **선점 우위 약함** — 컨셉 모방 쉬움. 6개월 내 시장 점유 + 캐릭터 IP / 커뮤니티로 해자.

## 운영·트랙 통합

| 통합 지점 | 관계 |
|---|---|
| [[정체성-Why-탐색]] | D-3 Why 증거 라인 #3 (외면 분기). PMF 매직넘버 원칙 동일 적용 |
| [[정체성-미션과-방향성]] | 1인 비즈니스 파이프라인 트랙 추가 |
| [[사업-부업-파이프라인]] | 트랙 신설 (블로그 폐기 자리 승계 또는 6번째 트랙) |
| [[사업-hedgy75-인스타]] | 1인 빌더 일지 빌드 대상으로 카드뉴스 5편 노출 (마케팅 시너지) |
| [[자산-인프라-NAS-GPU]] | v1 클라우드 저장 시 Synology 활용 |
| [[기술-스택-역량]] | RN + iOS Swift 신규 스택 학습 영역 |

## 다음 액션

- ✅ Day 0 차단성 액션 1~4번 검증 완료 (2026-05-23) — Lapie 1순위 유지 확정
- ✅ @lapie_app 인스타 선점 완료 (2026-05-23 박재오 직접)
- ✅ writing-plans 스킬로 W1~W4 구체 구현 plan 작성 완료 (2026-05-23) — [[사업-Lapie-피팅앱-v0-plan]] 참고
- ⏸ lapie.kr + lapie.io 도메인 등록 — 7월 착수 직전
- ⏸ Pre-Task 0.2 macOS 접근 방안 결정 (Mac mini 구매 / EAS 클라우드 / Flutter 재검토)
- ⏸ 변리사 정식 상표 조사 (Class 9·42 출원 전) — 7월 착수 후
- ⏸ 7월 착수 직전 design + plan 재검토 (5~6월 공모전 트랙 마무리 후)
- ⏸ Figma 와이어프레임 5화면 (W1 첫 주)

## 관련 링크 / 교차참조

- [[사업-Lapie-피팅앱-v0-plan]] — v0 4~6주 구체 구현 plan (13 task / TDD 가능 부분 단위 테스트 / UI·카메라·합성 manual test). 양방향
- [[정체성-Why-탐색]] — D-3 Why 검증대 통과. 외면의 결 분기. 양방향.
- [[정체성-미션과-방향성]] — 1인 비즈니스 트랙 신설
- [[사업-부업-파이프라인]] — 트랙 추가
- [[사업-쟁승메이드]] — 메인 브랜드와 분리 (독립 브랜드 결정)
- [[사업-hedgy75-인스타]] — 마케팅 채널 시너지 + 빌더 일지 콘텐츠
- [[프로젝트-쟁승메이드-Co]] — Why 증거 #1 (사주 카탈로그). Lapie는 #3
- [[사업-AI음악작곡-워크플로우]] — Why 증거 #2 (음악). Lapie는 #3
- [[자산-인프라-NAS-GPU]] — v1 클라우드 저장 인프라
- [[기술-스택-역량]] — RN + iOS Swift 신규 학습
- [[프로젝트-이모추]], [[프로젝트-무진장-AI-광고제]], [[프로젝트-우리카드-AI숏폼-공모전]] — 5~6월 가용시간 점유 트랙 (Lapie 7월 착수 근거)
- [[../CLAUDE|CLAUDE.md]] — 컨텍스트 3단 템플릿

## 출처 / Raw

- `raw/2026-05-23-Lapie-피팅앱-브리핑-원본.md` — 2026-05-23 Claude Code 대화 원본 (브레인스토밍 흐름 + 결정 6건 + design)

## 변경 이력

- 2026-05-23: 페이지 신설. superpowers:brainstorming 스킬로 6단 결정(포지셔닝·Why 정합·브랜드·범위·스택·네이밍) 완료 후 design 승인. RN + Vision Camera 스택, 독립 브랜드 Lapie, v0 4~6주 7월 착수. D-3 Why 증거 라인 #3 편입.
- 2026-05-23: superpowers:writing-plans 스킬로 [[사업-Lapie-피팅앱-v0-plan]] 작성 완료. 13 task(Pre 2 + W1~W4 9 + W5~6 2) / Windows에서 RN iOS 빌드 불가 이슈 Pre-Task 0.2에 명시(mac 확보 / EAS 클라우드 / Flutter 재검토 3 옵션). 사용자 명시: 7월 착수 직전 재수정 가능.
- 2026-05-23: **Day 0 차단성 액션 1~4번 검증 완료** (superpowers:dispatching-parallel-agents 스킬로 4건 병렬 실행). 종합 판정 🟡 Lapie 유지 가능 but 조건부. 즉시 권장: lapie.kr + lapie.io + @lapie_app 선점, Class 9·42 출원만 가능 영역, Class 14·25 회피. 위험 신호 2건: (1) @lapieofficial = La Pie 주얼리 브랜드 → Class 14 추가 위험, (2) @uselapie 누군가 선점 = 작명 시도 흔적. 상표 결과는 KIPRIS/USPTO 자동조회 차단으로 공개 검색 한도 — 변리사 정식 조사 필수.
- 2026-05-23: **대안 3건(Wittu·Mirree·Geola) 동일 4건 검증 완료** (dispatching-parallel-agents 브랜드별 1 agent × 3 병렬). 결과: Wittu 🟡 / Mirree 🔴 / Geola 🔴. **Lapie 1순위 유지 확정** — 도메인 .kr+.io 가용 확정 우위 + 상표 위험에서 "위트(WIT/WITT)"보다 "라피"가 한국어 일반 어휘 점유 약함. 후보 #2 = Wittu (Lapie 변리사 🔴 시 대체). Mirree·Geola는 폐기(.com 선점 + 글로벌 패션 앱 인접 충돌 + 한국어 SEO/발음 모호성). spec 페이지의 "대안 후보" 섹션을 4×4 비교 매트릭스로 전면 갱신.
- 2026-05-23: 🟢 **Lapie 브랜드 확정 + @lapie_app 인스타 선점 완료** (박재오 직접). 종합 판정 🟡 조건부 → 🟢 확정. 가장 회수 어려운 자산 1순위 확보. 도메인(lapie.kr/lapie.io) 등록은 7월 착수 직전으로 미룸. Day 0 표 인스타 항목 ✅ 갱신, 즉시 권장 액션 #3 ✅, 다음 액션 섹션 진행 상태 반영.