Apa yang bisa saya masak dari bahan yang sudah ada?

POST /api/v1/recommendations
Content-Type: application/json

{
  "ingredients": [
    "telur",
    "ayam",
    "wortel"
  ],
  "limit": 5
}

{
  "query": {
    "raw": [
      "telur",
      "ayam",
      "wortel"
    ],
    "ingredients": [
      "egg",
      "chicken",
      "carrot"
    ]
  },
  "unknownIngredients": [],
  "results": [
    {
      "id": "recipe_001",
      "name": "Omelet Ayam Wortel",
      "description": "Omelet berisi ayam dan wortel, cukup satu wajan untuk sarapan yang mengenyangkan.",
      "matchPercentage": 100,
      "availableIngredients": [
        "egg",
        "chicken",
        "carrot"
      ],
      "missingIngredients": [],
      "cookingTimeMinutes": 15,
      "difficulty": "easy",
      "servings": 2,
      "ingredients": [
        "egg",
        "chicken",
        "carrot",
        "shallot",
        "salt",
        "pepper",
        "cooking_oil"
      ],
      "steps": [
        "Potong ayam dan wortel menjadi dadu kecil agar cepat matang.",
        "Kocok telur dalam wadah, bumbui dengan garam dan lada."
      ],
      "tags": [
        "sarapan",
        "praktis",
        "indonesian"
      ]
    }
  ],
  "meta": {
    "count": 1,
    "limit": 5,
    "threshold": 30
  }
}

Arsitektur

1. BrowserInput bahan dari pengguna
   ↓
2. Next.js (Web)Client API, bukan tempat business logic
   ↓
3. Smart Living API (FastAPI)Validasi request dan response
   ↓
4. Ingredient NormalizerTeks bebas menjadi nama kanonik
   ↓
5. Matching EngineHitung persentase kecocokan
   ↓
6. RankingUrutkan deterministik dengan tie-breaker
   ↓
7. Recipe RepositoryBaca recipes.json sekali saat startup

Tech Stack

Frontend

Next.js, TypeScript, Tailwind CSS

Backend

Python 3.12, FastAPI, Pydantic v2

Data

JSON (version-controlled), PostgreSQL-ready

Testing

pytest, Vitest, Playwright

Tooling

uv, pnpm, ruff, Docker, GitHub Actions