오히후 — 프로그램 설계 개요
브랜드 쇼핑몰 형태의 상품·옵션(SKU)·장바구니·주문·결제, 쿠폰·포인트, 공지·이벤트·배너, 관리자 백오피스를 제공하는 웹·모바일 서비스입니다. 저장소는 웹과 모바일 WebView 셸로 구성됩니다.
1. 시스템 구성 요소
| 구분 | 디렉터리 | 역할 |
|---|---|---|
| 웹 | ohihoo-web | Next.js(App Router), Prisma·MySQL, NextAuth |
| 모바일 | ohihoo-app | Expo WebView 셸, 푸시·OTA 등 |
2. 아키텍처
- 서버: Next.js가 스토어·관리·콘텐츠 API를 단일 앱에서 제공합니다.
- 외부 연동: 결제·배송 추적·이메일 인증 등은 각 API·웹훅으로 연결됩니다(엔드포인트·키는 문서에 기재하지 않음).
3. 데이터 흐름
- 회원:
User·Account·Session(NextAuth), 주소·프로필·포인트·푸시 토큰. - 상품:
Category·Product·옵션 그룹·옵션 값·ProductOptionCombination(SKU·재고). - 거래:
Cart·CartItem·Order·OrderItem, 결제 완료·취소·게스트 주문·무통장 등 흐름. - 운영:
Review·Like, 쿠폰 발급·검증, 공지·이벤트·배너, 방문 통계 등.
스키마 상세는 ohihoo-web/prisma/schema.prisma를 참고합니다.
3.1 요청·저장 흐름(도식)
3.2 핵심 엔티티 관계(요약)
4. 웹 애플리케이션 레이어 (ohihoo-web)
4.1 기능 영역(예)
- 스토어: 카테고리·상품·검색·장바구니·주문·결제·배송 조회·리뷰·좋아요·쿠폰
- 콘텐츠: 공지·이벤트·배너·팝업·다운로드 등
- 사용자: 프로필·주소·포인트·찜·탈퇴·비밀번호·이메일 인증
- 관리자: 주문·상태·메모·엑스포트·배송 연동, 사용자·포인트, 상품·카테고리 순서, 쿠폰, 리뷰, 통계·방문 통계
5. 모바일 앱 레이어 (ohihoo-app)
5.1 WebView 브릿지(요약)
6. 디렉터리 구조(루트)
PROD_ohihoo/
├── ohihoo-web/
├── ohihoo-app/
└── ReadMe.md
7. 기술 스택 요약
| 영역 | 기술 |
|---|---|
| 웹 | Next.js 16, React 19, Prisma, MySQL, NextAuth, Tailwind, Ant Design·Mantine·Tiptap 등 |
| 앱 | Expo, React Native, WebView |