말랑엠티 (Mallang MT)

MT(엠티/모임) 준비를 한 번에 끝내는 서비스입니다. 숙소 예약 흐름과 쇼핑리스트·배달 요청을 연결해 준비 과정을 단축하고, 파트너/관리자 관점에서는 예약 승인·정산·CS 처리를 빠르게 하도록 설계했습니다.

주요 기능

• MT 일정 입력 → 숙소 예약 → 쇼핑리스트 확정 → 배달 요청까지 한 플로우로 구성
• 인원/기간 기반 추천 쇼핑리스트 및 예산 가이드
• 예약 생성/제출/결제 준비/취소/환불 정책 지원
• 파트너 예약 가격 확정, 노쇼 확인, 호스트 과실/마트 실패 환불
• 정산 원장(파트너/관리자) 조회
• /docs에서 Swagger UI로 API 명세 제공

사용자 역할

• customer: 예약 생성 및 쇼핑리스트/결제 진행
• partner_owner: 파트너 예약 확인/가격 확정, 정산 내역 조회
• admin: 예약/환불/노쇼 처리, 전체 정산 관리

기술 스택

• Next.js 16 (App Router), React 19
• Emotion (styled-components 스타일), React Query
• Supabase (Auth, Postgres)
• Zod (런타임 환경변수/스키마 검증)
• Swagger UI (public/openapi.yaml)

로컬 실행

pnpm install
pnpm dev

기본 개발 서버는 http://localhost:4070에서 실행됩니다.

환경변수

.env.local 파일을 생성하고 아래 값을 설정하세요.

NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
NEXT_PUBLIC_APP_URL= # 선택
SUPABASE_SERVICE_ROLE_KEY=

API 문서

• Swagger UI: http://localhost:4070/docs
• OpenAPI 스펙: public/openapi.yaml

프로젝트 구조

• src/app: Next.js 라우트, 페이지, API Route Handlers
• src/server: 도메인 로직, 인증/권한, DB 리포지토리
• src/ui: 레이아웃/프리미티브 UI 컴포넌트
• supabase: 마이그레이션 및 시드