오히후 — 프로그램 설계 개요

브랜드 쇼핑몰 형태의 상품·옵션(SKU)·장바구니·주문·결제, 쿠폰·포인트, 공지·이벤트·배너, 관리자 백오피스를 제공하는 웹·모바일 서비스입니다. 저장소는 모바일 WebView 셸로 구성됩니다.


1. 시스템 구성 요소

구분디렉터리역할
ohihoo-webNext.js(App Router), Prisma·MySQL, NextAuth
모바일ohihoo-appExpo WebView 셸, 푸시·OTA 등

2. 아키텍처

  • 서버: Next.js가 스토어·관리·콘텐츠 API를 단일 앱에서 제공합니다.
  • 외부 연동: 결제·배송 추적·이메일 인증 등은 각 API·웹훅으로 연결됩니다(엔드포인트·키는 문서에 기재하지 않음).

3. 데이터 흐름

  1. 회원: User·Account·Session(NextAuth), 주소·프로필·포인트·푸시 토큰.
  2. 상품: Category·Product·옵션 그룹·옵션 값·ProductOptionCombination(SKU·재고).
  3. 거래: Cart·CartItem·Order·OrderItem, 결제 완료·취소·게스트 주문·무통장 등 흐름.
  4. 운영: 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