feat: implement Iteration 1 — AI recipe recommendations

Backend: - Add Groq LLM client (llama-3.3-70b) for recipe generation with JSON retry strategy (retries only on parse errors, not API errors) - Add Pexels client for parallel photo search per recipe - Add saved_recipes table (migration 004) with JSONB fields - Add GET /recommendations endpoint (profile-aware prompt building) - Add POST/GET/GET{id}/DELETE /saved-recipes CRUD endpoints - Wire gemini, pexels, recommendation, savedrecipe packages in main.go Flutter: - Add Recipe, SavedRecipe models with json_serializable - Add RecipeService (getRecommendations, getSavedRecipes, save, delete) - Add RecommendationsNotifier and SavedRecipesNotifier (Riverpod) - Add RecommendationsScreen with skeleton loading and refresh FAB - Add RecipeDetailScreen (SliverAppBar, nutrition tooltip, steps with timer) - Add SavedRecipesScreen with Dismissible swipe-to-delete and empty state - Update RecipesScreen to TabBar (Recommendations / Saved) - Add /recipe-detail route outside ShellRoute (no bottom nav) - Extend ApiClient with getList() and deleteVoid() Project: - Add CLAUDE.md with English-only rule for comments and commit messages Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-21 22:43:29 +02:00
parent 24219b611e
commit e57ff8e06c
41 changed files with 5994 additions and 353 deletions
--- a/backend/internal/recipe/model.go
+++ b/backend/internal/recipe/model.go
@@ -0,0 +1,62 @@
+package recipe
+
+import (
+	"encoding/json"
+	"time"
+)
+
+// Recipe is a recipe record in the database.
+type Recipe struct {
+	ID            string          `json:"id"`
+	Source        string          `json:"source"` // spoonacular | ai | user
+	SpoonacularID *int            `json:"spoonacular_id"`
+
+	Title         string  `json:"title"`
+	TitleRu       *string `json:"title_ru"`
+	Description   *string `json:"description"`
+	DescriptionRu *string `json:"description_ru"`
+
+	Cuisine      *string `json:"cuisine"`
+	Difficulty   *string `json:"difficulty"` // easy | medium | hard
+	PrepTimeMin  *int    `json:"prep_time_min"`
+	CookTimeMin  *int    `json:"cook_time_min"`
+	Servings     *int    `json:"servings"`
+	ImageURL     *string `json:"image_url"`
+
+	CaloriesPerServing *float64 `json:"calories_per_serving"`
+	ProteinPerServing  *float64 `json:"protein_per_serving"`
+	FatPerServing      *float64 `json:"fat_per_serving"`
+	CarbsPerServing    *float64 `json:"carbs_per_serving"`
+	FiberPerServing    *float64 `json:"fiber_per_serving"`
+
+	Ingredients json.RawMessage `json:"ingredients"` // []RecipeIngredient
+	Steps       json.RawMessage `json:"steps"`       // []RecipeStep
+	Tags        json.RawMessage `json:"tags"`        // []string
+
+	AvgRating   float64   `json:"avg_rating"`
+	ReviewCount int       `json:"review_count"`
+	CreatedBy   *string   `json:"created_by"`
+	CreatedAt   time.Time `json:"created_at"`
+	UpdatedAt   time.Time `json:"updated_at"`
+}
+
+// RecipeIngredient is a single ingredient in a recipe's JSONB array.
+type RecipeIngredient struct {
+	SpoonacularID *int    `json:"spoonacular_id"`
+	MappingID     *string `json:"mapping_id"`
+	Name          string  `json:"name"`
+	NameRu        *string `json:"name_ru"`
+	Amount        float64 `json:"amount"`
+	Unit          string  `json:"unit"`
+	UnitRu        *string `json:"unit_ru"`
+	Optional      bool    `json:"optional"`
+}
+
+// RecipeStep is a single step in a recipe's JSONB array.
+type RecipeStep struct {
+	Number        int     `json:"number"`
+	Description   string  `json:"description"`
+	DescriptionRu *string `json:"description_ru"`
+	TimerSeconds  *int    `json:"timer_seconds"`
+	ImageURL      *string `json:"image_url"`
+}
--- a/backend/internal/recipe/repository.go
+++ b/backend/internal/recipe/repository.go
@@ -0,0 +1,181 @@
+package recipe
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+	"fmt"
+
+	"github.com/jackc/pgx/v5"
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+// Repository handles persistence for recipes.
+type Repository struct {
+	pool *pgxpool.Pool
+}
+
+// NewRepository creates a new Repository.
+func NewRepository(pool *pgxpool.Pool) *Repository {
+	return &Repository{pool: pool}
+}
+
+// Upsert inserts or updates a recipe.
+// Conflict is resolved on spoonacular_id.
+func (r *Repository) Upsert(ctx context.Context, recipe *Recipe) (*Recipe, error) {
+	query := `
+		INSERT INTO recipes (
+			source, spoonacular_id,
+			title, description, title_ru, description_ru,
+			cuisine, difficulty, prep_time_min, cook_time_min, servings, image_url,
+			calories_per_serving, protein_per_serving, fat_per_serving, carbs_per_serving, fiber_per_serving,
+			ingredients, steps, tags
+		) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17, $18, $19, $20)
+		ON CONFLICT (spoonacular_id) DO UPDATE SET
+			title                = EXCLUDED.title,
+			description          = EXCLUDED.description,
+			cuisine              = EXCLUDED.cuisine,
+			difficulty           = EXCLUDED.difficulty,
+			prep_time_min        = EXCLUDED.prep_time_min,
+			cook_time_min        = EXCLUDED.cook_time_min,
+			servings             = EXCLUDED.servings,
+			image_url            = EXCLUDED.image_url,
+			calories_per_serving = EXCLUDED.calories_per_serving,
+			protein_per_serving  = EXCLUDED.protein_per_serving,
+			fat_per_serving      = EXCLUDED.fat_per_serving,
+			carbs_per_serving    = EXCLUDED.carbs_per_serving,
+			fiber_per_serving    = EXCLUDED.fiber_per_serving,
+			ingredients          = EXCLUDED.ingredients,
+			steps                = EXCLUDED.steps,
+			tags                 = EXCLUDED.tags,
+			updated_at           = now()
+		RETURNING id, source, spoonacular_id,
+			title, description, title_ru, description_ru,
+			cuisine, difficulty, prep_time_min, cook_time_min, servings, image_url,
+			calories_per_serving, protein_per_serving, fat_per_serving, carbs_per_serving, fiber_per_serving,
+			ingredients, steps, tags,
+			avg_rating, review_count, created_by, created_at, updated_at`
+
+	row := r.pool.QueryRow(ctx, query,
+		recipe.Source, recipe.SpoonacularID,
+		recipe.Title, recipe.Description, recipe.TitleRu, recipe.DescriptionRu,
+		recipe.Cuisine, recipe.Difficulty, recipe.PrepTimeMin, recipe.CookTimeMin, recipe.Servings, recipe.ImageURL,
+		recipe.CaloriesPerServing, recipe.ProteinPerServing, recipe.FatPerServing, recipe.CarbsPerServing, recipe.FiberPerServing,
+		recipe.Ingredients, recipe.Steps, recipe.Tags,
+	)
+	return scanRecipe(row)
+}
+
+// Count returns the total number of recipes.
+func (r *Repository) Count(ctx context.Context) (int, error) {
+	var n int
+	if err := r.pool.QueryRow(ctx, `SELECT count(*) FROM recipes`).Scan(&n); err != nil {
+		return 0, fmt.Errorf("count recipes: %w", err)
+	}
+	return n, nil
+}
+
+// ListUntranslated returns recipes without a Russian title, ordered by review_count DESC.
+func (r *Repository) ListUntranslated(ctx context.Context, limit, offset int) ([]*Recipe, error) {
+	query := `
+		SELECT id, source, spoonacular_id,
+			title, description, title_ru, description_ru,
+			cuisine, difficulty, prep_time_min, cook_time_min, servings, image_url,
+			calories_per_serving, protein_per_serving, fat_per_serving, carbs_per_serving, fiber_per_serving,
+			ingredients, steps, tags,
+			avg_rating, review_count, created_by, created_at, updated_at
+		FROM recipes
+		WHERE title_ru IS NULL AND source = 'spoonacular'
+		ORDER BY review_count DESC
+		LIMIT $1 OFFSET $2`
+
+	rows, err := r.pool.Query(ctx, query, limit, offset)
+	if err != nil {
+		return nil, fmt.Errorf("list untranslated recipes: %w", err)
+	}
+	defer rows.Close()
+	return collectRecipes(rows)
+}
+
+// UpdateTranslation saves the Russian title, description, and step translations.
+func (r *Repository) UpdateTranslation(ctx context.Context, id string, titleRu, descriptionRu *string, steps json.RawMessage) error {
+	query := `
+		UPDATE recipes SET
+			title_ru       = $2,
+			description_ru = $3,
+			steps          = $4,
+			updated_at     = now()
+		WHERE id = $1`
+
+	if _, err := r.pool.Exec(ctx, query, id, titleRu, descriptionRu, steps); err != nil {
+		return fmt.Errorf("update recipe translation %s: %w", id, err)
+	}
+	return nil
+}
+
+// --- helpers ---
+
+func scanRecipe(row pgx.Row) (*Recipe, error) {
+	var rec Recipe
+	var ingredients, steps, tags []byte
+
+	err := row.Scan(
+		&rec.ID, &rec.Source, &rec.SpoonacularID,
+		&rec.Title, &rec.Description, &rec.TitleRu, &rec.DescriptionRu,
+		&rec.Cuisine, &rec.Difficulty, &rec.PrepTimeMin, &rec.CookTimeMin, &rec.Servings, &rec.ImageURL,
+		&rec.CaloriesPerServing, &rec.ProteinPerServing, &rec.FatPerServing, &rec.CarbsPerServing, &rec.FiberPerServing,
+		&ingredients, &steps, &tags,
+		&rec.AvgRating, &rec.ReviewCount, &rec.CreatedBy, &rec.CreatedAt, &rec.UpdatedAt,
+	)
+	if err != nil {
+		return nil, err
+	}
+	rec.Ingredients = json.RawMessage(ingredients)
+	rec.Steps = json.RawMessage(steps)
+	rec.Tags = json.RawMessage(tags)
+	return &rec, nil
+}
+
+func collectRecipes(rows pgx.Rows) ([]*Recipe, error) {
+	var result []*Recipe
+	for rows.Next() {
+		var rec Recipe
+		var ingredients, steps, tags []byte
+		if err := rows.Scan(
+			&rec.ID, &rec.Source, &rec.SpoonacularID,
+			&rec.Title, &rec.Description, &rec.TitleRu, &rec.DescriptionRu,
+			&rec.Cuisine, &rec.Difficulty, &rec.PrepTimeMin, &rec.CookTimeMin, &rec.Servings, &rec.ImageURL,
+			&rec.CaloriesPerServing, &rec.ProteinPerServing, &rec.FatPerServing, &rec.CarbsPerServing, &rec.FiberPerServing,
+			&ingredients, &steps, &tags,
+			&rec.AvgRating, &rec.ReviewCount, &rec.CreatedBy, &rec.CreatedAt, &rec.UpdatedAt,
+		); err != nil {
+			return nil, fmt.Errorf("scan recipe: %w", err)
+		}
+		rec.Ingredients = json.RawMessage(ingredients)
+		rec.Steps = json.RawMessage(steps)
+		rec.Tags = json.RawMessage(tags)
+		result = append(result, &rec)
+	}
+	return result, rows.Err()
+}
+
+// GetByID returns a recipe by UUID.
+// Returns nil, nil if not found.
+func (r *Repository) GetByID(ctx context.Context, id string) (*Recipe, error) {
+	query := `
+		SELECT id, source, spoonacular_id,
+			title, description, title_ru, description_ru,
+			cuisine, difficulty, prep_time_min, cook_time_min, servings, image_url,
+			calories_per_serving, protein_per_serving, fat_per_serving, carbs_per_serving, fiber_per_serving,
+			ingredients, steps, tags,
+			avg_rating, review_count, created_by, created_at, updated_at
+		FROM recipes
+		WHERE id = $1`
+
+	row := r.pool.QueryRow(ctx, query, id)
+	rec, err := scanRecipe(row)
+	if errors.Is(err, pgx.ErrNoRows) {
+		return nil, nil
+	}
+	return rec, err
+}
--- a/backend/internal/recipe/repository_integration_test.go
+++ b/backend/internal/recipe/repository_integration_test.go
@@ -0,0 +1,311 @@
+//go:build integration
+
+package recipe
+
+import (
+	"context"
+	"encoding/json"
+	"testing"
+
+	"github.com/food-ai/backend/internal/testutil"
+)
+
+func TestRecipeRepository_Upsert_Insert(t *testing.T) {
+	pool := testutil.SetupTestDB(t)
+	repo := NewRepository(pool)
+	ctx := context.Background()
+
+	id := 10001
+	cuisine := "italian"
+	diff := "easy"
+	cookTime := 30
+	servings := 4
+
+	rec := &Recipe{
+		Source:        "spoonacular",
+		SpoonacularID: &id,
+		Title:         "Pasta Carbonara",
+		Cuisine:       &cuisine,
+		Difficulty:    &diff,
+		CookTimeMin:   &cookTime,
+		Servings:      &servings,
+		Ingredients:   json.RawMessage(`[{"name":"pasta","amount":200,"unit":"g"}]`),
+		Steps:         json.RawMessage(`[{"number":1,"description":"Boil pasta"}]`),
+		Tags:          json.RawMessage(`["italian"]`),
+	}
+
+	got, err := repo.Upsert(ctx, rec)
+	if err != nil {
+		t.Fatalf("upsert: %v", err)
+	}
+	if got.ID == "" {
+		t.Error("expected non-empty ID")
+	}
+	if got.Title != "Pasta Carbonara" {
+		t.Errorf("title: want Pasta Carbonara, got %s", got.Title)
+	}
+	if got.SpoonacularID == nil || *got.SpoonacularID != id {
+		t.Errorf("spoonacular_id: want %d, got %v", id, got.SpoonacularID)
+	}
+}
+
+func TestRecipeRepository_Upsert_ConflictUpdates(t *testing.T) {
+	pool := testutil.SetupTestDB(t)
+	repo := NewRepository(pool)
+	ctx := context.Background()
+
+	id := 20001
+	cuisine := "mexican"
+	diff := "medium"
+
+	first := &Recipe{
+		Source:        "spoonacular",
+		SpoonacularID: &id,
+		Title:         "Tacos",
+		Cuisine:       &cuisine,
+		Difficulty:    &diff,
+		Ingredients:   json.RawMessage(`[]`),
+		Steps:         json.RawMessage(`[]`),
+		Tags:          json.RawMessage(`[]`),
+	}
+	got1, err := repo.Upsert(ctx, first)
+	if err != nil {
+		t.Fatalf("first upsert: %v", err)
+	}
+
+	second := &Recipe{
+		Source:        "spoonacular",
+		SpoonacularID: &id,
+		Title:         "Beef Tacos",
+		Cuisine:       &cuisine,
+		Difficulty:    &diff,
+		Ingredients:   json.RawMessage(`[{"name":"beef","amount":300,"unit":"g"}]`),
+		Steps:         json.RawMessage(`[]`),
+		Tags:          json.RawMessage(`[]`),
+	}
+	got2, err := repo.Upsert(ctx, second)
+	if err != nil {
+		t.Fatalf("second upsert: %v", err)
+	}
+
+	if got1.ID != got2.ID {
+		t.Errorf("ID changed on conflict update: %s != %s", got1.ID, got2.ID)
+	}
+	if got2.Title != "Beef Tacos" {
+		t.Errorf("title not updated: got %s", got2.Title)
+	}
+}
+
+func TestRecipeRepository_GetByID_Found(t *testing.T) {
+	pool := testutil.SetupTestDB(t)
+	repo := NewRepository(pool)
+	ctx := context.Background()
+
+	id := 30001
+	diff := "easy"
+	rec := &Recipe{
+		Source:        "spoonacular",
+		SpoonacularID: &id,
+		Title:         "Greek Salad",
+		Difficulty:    &diff,
+		Ingredients:   json.RawMessage(`[]`),
+		Steps:         json.RawMessage(`[]`),
+		Tags:          json.RawMessage(`["vegetarian"]`),
+	}
+	saved, err := repo.Upsert(ctx, rec)
+	if err != nil {
+		t.Fatalf("upsert: %v", err)
+	}
+
+	got, err := repo.GetByID(ctx, saved.ID)
+	if err != nil {
+		t.Fatalf("get by id: %v", err)
+	}
+	if got == nil {
+		t.Fatal("expected non-nil result")
+	}
+	if got.Title != "Greek Salad" {
+		t.Errorf("want Greek Salad, got %s", got.Title)
+	}
+}
+
+func TestRecipeRepository_GetByID_NotFound(t *testing.T) {
+	pool := testutil.SetupTestDB(t)
+	repo := NewRepository(pool)
+	ctx := context.Background()
+
+	got, err := repo.GetByID(ctx, "00000000-0000-0000-0000-000000000000")
+	if err != nil {
+		t.Fatalf("unexpected error: %v", err)
+	}
+	if got != nil {
+		t.Error("expected nil for non-existent ID")
+	}
+}
+
+func TestRecipeRepository_ListUntranslated_Pagination(t *testing.T) {
+	pool := testutil.SetupTestDB(t)
+	repo := NewRepository(pool)
+	ctx := context.Background()
+
+	diff := "easy"
+	for i := 0; i < 5; i++ {
+		spID := 40000 + i
+		_, err := repo.Upsert(ctx, &Recipe{
+			Source:        "spoonacular",
+			SpoonacularID: &spID,
+			Title:         "Recipe " + string(rune('A'+i)),
+			Difficulty:    &diff,
+			Ingredients:   json.RawMessage(`[]`),
+			Steps:         json.RawMessage(`[]`),
+			Tags:          json.RawMessage(`[]`),
+		})
+		if err != nil {
+			t.Fatalf("upsert recipe %d: %v", i, err)
+		}
+	}
+
+	untranslated, err := repo.ListUntranslated(ctx, 3, 0)
+	if err != nil {
+		t.Fatalf("list untranslated: %v", err)
+	}
+	if len(untranslated) != 3 {
+		t.Errorf("expected 3 results with limit=3, got %d", len(untranslated))
+	}
+}
+
+func TestRecipeRepository_UpdateTranslation(t *testing.T) {
+	pool := testutil.SetupTestDB(t)
+	repo := NewRepository(pool)
+	ctx := context.Background()
+
+	id := 50001
+	diff := "medium"
+	saved, err := repo.Upsert(ctx, &Recipe{
+		Source:        "spoonacular",
+		SpoonacularID: &id,
+		Title:         "Chicken Tikka Masala",
+		Difficulty:    &diff,
+		Ingredients:   json.RawMessage(`[]`),
+		Steps:         json.RawMessage(`[{"number":1,"description":"Heat oil"}]`),
+		Tags:          json.RawMessage(`[]`),
+	})
+	if err != nil {
+		t.Fatalf("upsert: %v", err)
+	}
+
+	titleRu := "Курица Тикка Масала"
+	descRu := "Классическое индийское блюдо"
+	stepsRu := json.RawMessage(`[{"number":1,"description":"Heat oil","description_ru":"Разогрейте масло"}]`)
+
+	if err := repo.UpdateTranslation(ctx, saved.ID, &titleRu, &descRu, stepsRu); err != nil {
+		t.Fatalf("update translation: %v", err)
+	}
+
+	got, err := repo.GetByID(ctx, saved.ID)
+	if err != nil {
+		t.Fatalf("get by id: %v", err)
+	}
+	if got.TitleRu == nil || *got.TitleRu != titleRu {
+		t.Errorf("expected title_ru=%q, got %v", titleRu, got.TitleRu)
+	}
+	if got.DescriptionRu == nil || *got.DescriptionRu != descRu {
+		t.Errorf("expected description_ru=%q, got %v", descRu, got.DescriptionRu)
+	}
+
+	var steps []RecipeStep
+	if err := json.Unmarshal(got.Steps, &steps); err != nil {
+		t.Fatalf("unmarshal steps: %v", err)
+	}
+	if len(steps) == 0 || steps[0].DescriptionRu == nil || *steps[0].DescriptionRu != "Разогрейте масло" {
+		t.Errorf("expected description_ru in steps, got %v", steps)
+	}
+}
+
+func TestRecipeRepository_ListUntranslated_ExcludesTranslated(t *testing.T) {
+	pool := testutil.SetupTestDB(t)
+	repo := NewRepository(pool)
+	ctx := context.Background()
+
+	diff := "easy"
+
+	// Insert untranslated
+	for i := 0; i < 3; i++ {
+		spID := 60000 + i
+		_, err := repo.Upsert(ctx, &Recipe{
+			Source:        "spoonacular",
+			SpoonacularID: &spID,
+			Title:         "Untranslated " + string(rune('A'+i)),
+			Difficulty:    &diff,
+			Ingredients:   json.RawMessage(`[]`),
+			Steps:         json.RawMessage(`[]`),
+			Tags:          json.RawMessage(`[]`),
+		})
+		if err != nil {
+			t.Fatalf("upsert: %v", err)
+		}
+	}
+
+	// Insert translated
+	spID := 60100
+	translated, err := repo.Upsert(ctx, &Recipe{
+		Source:        "spoonacular",
+		SpoonacularID: &spID,
+		Title:         "Translated Recipe",
+		Difficulty:    &diff,
+		Ingredients:   json.RawMessage(`[]`),
+		Steps:         json.RawMessage(`[]`),
+		Tags:          json.RawMessage(`[]`),
+	})
+	if err != nil {
+		t.Fatalf("upsert translated: %v", err)
+	}
+	titleRu := "Переведённый рецепт"
+	if err := repo.UpdateTranslation(ctx, translated.ID, &titleRu, nil, translated.Steps); err != nil {
+		t.Fatalf("update translation: %v", err)
+	}
+
+	untranslated, err := repo.ListUntranslated(ctx, 10, 0)
+	if err != nil {
+		t.Fatalf("list untranslated: %v", err)
+	}
+	for _, r := range untranslated {
+		if r.Title == "Translated Recipe" {
+			t.Error("translated recipe should not appear in ListUntranslated")
+		}
+	}
+	if len(untranslated) < 3 {
+		t.Errorf("expected at least 3 untranslated, got %d", len(untranslated))
+	}
+}
+
+func TestRecipeRepository_GIN_Tags(t *testing.T) {
+	pool := testutil.SetupTestDB(t)
+	repo := NewRepository(pool)
+	ctx := context.Background()
+
+	id := 70001
+	diff := "easy"
+	_, err := repo.Upsert(ctx, &Recipe{
+		Source:        "spoonacular",
+		SpoonacularID: &id,
+		Title:         "Veggie Bowl",
+		Difficulty:    &diff,
+		Ingredients:   json.RawMessage(`[]`),
+		Steps:         json.RawMessage(`[]`),
+		Tags:          json.RawMessage(`["vegetarian","gluten-free"]`),
+	})
+	if err != nil {
+		t.Fatalf("upsert: %v", err)
+	}
+
+	// GIN index query: tags @> '["vegetarian"]'
+	var count int
+	row := pool.QueryRow(ctx, `SELECT count(*) FROM recipes WHERE tags @> '["vegetarian"]'::jsonb AND spoonacular_id = $1`, id)
+	if err := row.Scan(&count); err != nil {
+		t.Fatalf("query: %v", err)
+	}
+	if count != 1 {
+		t.Errorf("expected 1 vegetarian recipe, got %d", count)
+	}
+}