프로젝트 기획 및 설계

graph TD
    A[User Browser] -- HTTP/HTTPS Request --> B(Vercel CDN / Edge)
    B -- Cache Miss / Dynamic Request --> C(Next.js App on Vercel)
    C -- API Routes / Server Actions --> D(Vercel Serverless Function)
    D -- Database Query --> E(MongoDB Atlas)
    E -- Database Response --> D
    D -- API Response --> C
    C -- HTML / JSON --> B
    B -- Response --> A

your-bookstore/
├── app/                  # App Router의 루트 (Next.js 13+ 앱 라우팅)
│   ├── layout.tsx        # 전역 레이아웃
│   ├── page.tsx          # 홈 페이지
│   ├── loading.tsx       # 전역 로딩 UI
│   ├── error.tsx         # 전역 에러 UI
│   ├── not-found.tsx     # 404 페이지
│   ├── api/              # API Routes (서버리스 함수)
│   │   ├── books/        # 도서 관련 API
│   │   │   ├── route.ts  # GET (목록), POST (생성)
│   │   │   └── [id]/route.ts # GET (상세), PUT (수정), DELETE (삭제)
│   │   └── cart/route.ts # 장바구니 API
│   ├── books/            # 도서 관련 페이지
│   │   ├── page.tsx      # 도서 목록 페이지
│   │   └── [id]/page.tsx # 도서 상세 페이지 (동적 라우팅)
│   ├── cart/page.tsx     # 장바구니 페이지
│   └── order/page.tsx    # 주문 페이지
├── components/           # 재사용 가능한 UI 컴포넌트
│   ├── ui/               # Tailwind CSS 기반의 일반 UI 컴포넌트
│   │   ├── Button.tsx
│   │   └── Input.tsx
│   ├── BookCard.tsx
│   ├── Header.tsx
│   ├── Footer.tsx
│   ├── CartItem.tsx
│   └── ...
├── lib/                  # 유틸리티 함수, 헬퍼, 설정 등
│   ├── db.ts             # 데이터베이스 연결 및 모델 정의
│   ├── utils.ts          # 일반 유틸리티 함수
│   └── constants.ts      # 상수 정의
├── public/               # 정적 파일 (이미지, 폰트, 매니페스트 등)
│   ├── images/
│   ├── icons/
│   ├── favicon.ico
│   └── manifest.json
├── styles/               # 전역 스타일 (Tailwind CSS 설정 등)
│   └── globals.css
├── __tests__/            # 테스트 파일
│   ├── unit/
│   ├── components/
│   └── e2e/
├── prisma/               # Prisma ORM 사용 시 스키마 파일
├── .env.local            # 로컬 환경 변수
├── next.config.js        # Next.js 설정
├── tailwind.config.ts    # Tailwind CSS 설정
├── tsconfig.json         # TypeScript 설정
└── package.json          # 프로젝트 의존성 및 스크립트

// lib/db.ts 또는 models/Book.ts
import mongoose, { Schema, Document } from 'mongoose';

// Book 스키마 정의
export interface IBook extends Document {
  title: string;
  author: string;
  description: string;
  price: number;
  imageUrl: string;
  isbn: string;
  publishedDate: Date;
  genre: string[];
  stock: number;
}

const BookSchema: Schema = new Schema({
  title: { type: String, required: true },
  author: { type: String, required: true },
  description: { type: String, required: true },
  price: { type: Number, required: true },
  imageUrl: { type: String, required: true },
  isbn: { type: String, required: true, unique: true },
  publishedDate: { type: Date, default: Date.now },
  genre: [{ type: String }],
  stock: { type: Number, default: 0 },
});

// 이미 정의된 모델이 없으면 생성
const Book = mongoose.models.Book || mongoose.model<IBook>('Book', BookSchema);

// CartItem 스키마 정의 (사용자 인증 후 User 모델과 연결)
export interface ICartItem extends Document {
  userId: mongoose.Types.ObjectId; // User 모델의 ID
  bookId: mongoose.Types.ObjectId; // Book 모델의 ID
  quantity: number;
  addedAt: Date;
}

const CartItemSchema: Schema = new Schema({
  userId: { type: Schema.Types.ObjectId, ref: 'User', required: true },
  bookId: { type: Schema.Types.ObjectId, ref: 'Book', required: true },
  quantity: { type: Number, required: true, min: 1 },
  addedAt: { type: Date, default: Date.now },
});

const CartItem = mongoose.models.CartItem || mongoose.model<ICartItem>('CartItem', CartItemSchema);

// Order 스키마 정의
export interface IOrder extends Document {
  userId: mongoose.Types.ObjectId; // User 모델의 ID
  items: Array<{
    bookId: mongoose.Types.ObjectId;
    quantity: number;
    priceAtPurchase: number; // 구매 시점의 가격
  }>;
  totalPrice: number;
  orderDate: Date;
  status: 'pending' | 'completed' | 'cancelled';
}

const OrderSchema: Schema = new Schema({
  userId: { type: Schema.Types.ObjectId, ref: 'User', required: true },
  items: [
    {
      bookId: { type: Schema.Types.ObjectId, ref: 'Book', required: true },
      quantity: { type: Number, required: true },
      priceAtPurchase: { type: Number, required: true },
    },
  ],
  totalPrice: { type: Number, required: true },
  orderDate: { type: Date, default: Date.now },
  status: { type: String, enum: ['pending', 'completed', 'cancelled'], default: 'pending' },
});

const Order = mongoose.models.Order || mongoose.model<IOrder>('Order', OrderSchema);

// 데이터베이스 연결 함수
let cachedDb = null;
export async function connectToDatabase() {
  if (cachedDb) {
    return cachedDb;
  }
  const MONGODB_URI = process.env.MONGODB_URI;
  if (!MONGODB_URI) {
    throw new Error('Please define the MONGODB_URI environment variable inside .env.local');
  }
  const conn = await mongoose.connect(MONGODB_URI, {
    bufferCommands: false, // Node.js 드라이버의 기본 버퍼링을 비활성화
  });
  cachedDb = conn;
  return conn;
}

export { Book, CartItem, Order };