Snail Beta Test Web — 사장님 베타 테스트 웹
네일 예약 플랫폼 Snail의 사장님(샵 오너) 관리 웹을 베타 테스트용 모바일 웹으로 변형한 fork입니다.
- 원본:
snail_owner_web
- 현재 repo:
snail_beta_test_web
- 실제 clone URL:
https://github.com/YeaeunnKim/snail_beta_test_web.git
핵심 기능
- 계정 관리: 회원가입, 로그인, 비밀번호 재설정
- 베타 온보딩: 가입 후 샵/영업시간/디자이너/디자인 입력
- 사업자 인증 게이트: 인증 제출 및 대기 상태 확인
- 샵 관리: 샵 정보, 영업시간 등
- 스케줄/예약 운영: 예약성 목록과 상태 관리
- 디자인 관리: 디자인 등록, AI 분석 상태, 폴더/공개 상태 관련 UI
- 알림/운영 목록: 예약/문의/알림성 데이터를 운영 화면에서 확인
기술 스택
| 항목 | 선택 |
|---|
| 프레임워크 | Next.js 15.1.6 (App Router) |
| 언어 | TypeScript 5.7 strict |
| 런타임 UI | React 19 |
| 스타일링 | Tailwind CSS 4 |
| 상태/서버 상태 | Zustand, TanStack Query |
| 폼 | React Hook Form + Zod |
| 타입 생성 | openapi-typescript |
| 패키지 매니저 | pnpm 11.5.0 |
개발 환경
| 항목 | 최소 요구 |
|---|
| Node.js | 20.0 이상 |
| pnpm | 9.0 이상 |
| 브라우저 | Chrome/Safari 최신 |
시작하기
# 1. 레포 클론
git clone https://github.com/YeaeunnKim/snail_beta_test_web.git
cd snail_beta_test_web
# 2. 의존성 설치
pnpm install
# 3. 환경 변수 설정
cp .env.example .env.local
# .env.local에서 API URL 등 수정
# 4. OpenAPI 타입 생성 (선택)
pnpm run generate:types
# 5. 개발 서버 실행
pnpm dev
# → http://localhost:3000
검증
pnpm typecheck
pnpm lint
pnpm build
자동 테스트와 CI는 현재 없습니다.
백엔드 API 참조
API 계약은 로컬 backend-context/를 기준으로 아래 순서로 확인합니다.
backend-context/owner_web.ai.txtbackend-context/api_cookbook.ai.txtbackend-context/openapi.json
src/types/api.d.ts는 openapi-typescript 자동 생성물입니다. 직접 수정하지 마세요.
환경 변수
| 키 | 설명 | 기본값 |
|---|
NEXT_PUBLIC_API_BASE_URL | 백엔드 API 주소 | http://localhost:8000/api/v1 |
NEXT_PUBLIC_APP_NAME | 앱 이름 | 스네일 사장님 |
NEXT_PUBLIC_GITHUB_PAGES_URL | API 문서 URL | (옵션) |
실제 페이지 구조
src/app/
├── (auth)/
│ ├── login/page.tsx
│ ├── register/page.tsx
│ └── password-reset/page.tsx
├── (gate)/
│ ├── business-verification/page.tsx
│ └── pending/page.tsx
├── dashboard/
│ ├── designs/page.tsx
│ ├── notifications/page.tsx
│ ├── schedule/page.tsx
│ └── shop/page.tsx
└── onboarding/page.tsx
dashboard/reservations와 dashboard/reviews 라우트는 현재 존재하지 않습니다. 라우트/구조와 에이전트 작업 규칙은 AGENTS.md를 기준으로 합니다.
관련 레포
