简体中文 · English

MoodShaker is an AI-powered, bilingual cocktail recommendation web app.
It turns a short mood questionnaire into a personalized cocktail recipe with ingredients, tools, steps, and a shareable visual card.

• AI recommendation pipeline with two bartender modes (classic_bartender / creative_bartender).
• Localized UX in Chinese and English (/cn, /en) with path-based routing and auto language redirect.
• Full cocktail journey: home → questions → recommendation → gallery → detail page.
• Image generation + optimization via external image API, optional sharp processing, and DB thumbnail backfill support.
• Performance-focused client state using split contexts, async storage batching, request dedup/cache, and dev performance overlay.

Home	Questionnaire

Gallery	Detail

• Framework: Next.js 16 (App Router), React 19
• Language: TypeScript
• Styling/UI: Tailwind CSS, Framer Motion, Radix UI, Lucide
• Data layer: Prisma + PostgreSQL
• AI integration: OpenAI-compatible chat endpoint + image generation endpoint
• Tooling: pnpm, ESLint (next/core-web-vitals + TypeScript rules)

flowchart LR
  A["User (Web)"] --> B["App Router Pages (/cn, /en)"]
  B --> C["Client Contexts (Language / Form / Result)"]
  C --> D["API Routes (/api/cocktail, /api/image)"]
  D --> E["LLM + Image Providers"]
  D --> F["Prisma"]
  F --> G["PostgreSQL"]
  B --> H["Gallery / Detail (DB + fallback catalog)"]

app/
  [lang]/
    page.tsx
    questions/page.tsx
    gallery/page.tsx
    cocktail/[id]/page.tsx
    cocktail/recommendation/page.tsx
  api/
    cocktail/route.ts
    cocktail/[id]/route.ts
    image/route.ts
components/
context/
locales/
lib/
prisma/
proxy.ts

• Node.js 20+
• pnpm 9+
• PostgreSQL 15+ (or Docker)

pnpm install

cp .env.example .env

Fill in required API/database values in .env (see Environment Variables).

Make sure PostgreSQL is running and DATABASE_URL is reachable, then:

pnpm db:init

This runs Prisma client generation, migration deploy, and seed data.

pnpm dev

Open http://localhost:3000.
Root path redirects to language routes (default /cn).

• Supported languages: cn, en
• proxy.ts handles language detection from URL, cookie, and Accept-Language
• Missing language prefix paths are redirected to localized routes
• Translation dictionaries live in locales/cn.ts and locales/en.ts

This repo includes:

• Dockerfile for multi-stage app image build
• docker-compose.yml with moodshaker-web + postgres services
• scripts/docker-entrypoint.sh to init DB schema and seed on container startup

Run:

docker compose up -d

If you see:

The column `cocktails.thumbnail` does not exist in the current database

Run:

pnpm db:init
# or
pnpm prisma:migrate

• Verify .env keys and endpoint URLs
• Ensure OPENAI_BASE_URL is OpenAI-compatible and includes /v1/
• Check server logs from api/openai.ts and app/api/* handlers

There is no automated test runner configured yet. Recommended checks:

pnpm lint
pnpm build

Manual smoke checks:

1. Questionnaire flow and recommendation generation
2. Gallery search + filters
3. Detail page rendering and language switch
4. Share card generation/download

PRs are welcome. Suggested PR content:

• short summary
• related issue (if any)
• verification steps
• screenshots for UI changes
• env/database notes when applicable

• AI outputs can be inaccurate; always review recipes and safety constraints.
• Do not commit .env or any secret values.