How kiritoem/3d-shop works
Project Type and Purpose
• This is a full-stack, e-commerce / product-customization web application built with Next.js (App Router), React (client & server components), Prisma (ORM), and a PostgreSQL database.
• Key features:
• User authentication (NextAuth)
• Product catalog & category browsing
• 3D model rendering (Three.js)
• Shopping cart & Stripe payments
• Admin/data-import scripts (SQL dump)
File Structure
• src/app/(auth) & src/app/(client): Next.js App Router zones for authenticated vs. public pages (login, signup, shop, payment result, product & category pages).
• src/app/api/*: API routes for auth ([...nextauth]), product, products, category, payment—each handling HTTP requests and server-side logic.
• prisma/: Database schema + migrations (user, transaction, customization_configs).
• data_import/: SQL dump for initial data load.
• components/ & features/: UI building blocks and feature modules (auth forms, cart, shop filters, 3D-model viewers) following a modular/feature-slice pattern.
• lib/: Shared utilities (auth, Prisma client, Stripe client, HTTP exceptions, Zod schemas).
• providers/: React Context providers (NextAuth, TanStack Query, Theme).
• docker-compose.yaml & Dockerfile: Containerize app + Postgres (and possibly Redis if added).