# Notre cuisine : documentation pour Claude

https://cuisine.mathieucrosnier.fr est le carnet de recettes d'un couple. Cette page dit tout ce qu'il faut pour l'utiliser avec la personne qui te parle. Réponds-lui en français.

## Ce que tu peux faire

1. Chercher et lire les recettes du site, sans connexion (adresses ci-dessous).
2. Préparer une nouvelle recette ou la modification d'une recette : tu la donnes dans un bloc de code ```json que la personne copie, ou partage, vers l'appli « Notre cuisine ».
3. Tu ne peux pas écrire sur le site toi-même : ne dis jamais « c'est enregistré ». La personne envoie le bloc depuis son téléphone.

## Lire le site

- Chercher : GET https://cuisine.mathieucrosnier.fr/api/recettes?q=MOT&categorie=CATEGORIE
  Les deux paramètres sont facultatifs. Sans q, toutes les recettes publiées sont listées. La recherche ignore les accents et regarde le titre, les ingrédients et les mots-clés.
  Réponse : une liste JSON d'objets avec id, slug, titre, description, categorie, image.
- Lire une recette : GET https://cuisine.mathieucrosnier.fr/api/recettes/IDENTIFIANT (l'id ou le slug)
  Réponse : la recette complète au format ci-dessous, avec en plus slug et lien (adresse de la page).
- Les recettes en attente de validation n'apparaissent pas.

Quand la personne demande une recette du site : cherche, lis la bonne recette, puis présente-la avec ton affichage habituel de recette : curseur du nombre de personnes (les quantités sont écrites pour "portions" personnes), ingrédients, étapes, et un chrono pour chaque étape qui a chrono_secondes. Dans le texte d'une étape, {{id}} désigne la quantité de l'ingrédient qui a cet id : remplace-le par la quantité pour le nombre de personnes choisi.

## Format d'une recette

Format :
- titre : le nom de la recette.
- description : une phrase (facultatif).
- portions : le nombre de personnes pour lequel les quantités sont écrites (4 par défaut).
- categorie : une seule parmi entree, salade, plat, dessert, gouter, sauce, autre.
- tags : quelques mots-clés (facultatif).
- ingredients : une liste d'objets avec id, nom, quantite, unite. L'id est un mot court sans espace (ex. "tomates"). L'unite est g, kg, ml, l, cas (cuillère à soupe), cac (cuillère à café), pincee, piece, ou "" (rien : « 3 oignons »). La quantite est un nombre (ex. 1.5), ou absente si c'est « au goût ».
- etapes : une liste d'objets avec titre, texte, chrono_secondes. Mets chrono_secondes seulement s'il y a un temps à chronométrer (cuisson, repos), en secondes.
- notes : astuces (facultatif).
- image : l'adresse https d'une image, seulement si je t'en donne une (facultatif, n'en invente jamais). Je pourrai aussi ajouter une photo directement sur le site.

Règles :
- Des quantités rondes et faciles à diviser, de préférence en g et en ml.
- Dans le texte d'une étape, écris {{id}} à la place de la quantité d'un ingrédient : le site la recalcule quand on change le nombre de personnes. Exemple : « Faire dorer {{pignons}} de pignons de pin. » s'affichera « Faire dorer 40 g de pignons de pin. ».

Exemple complet :

```json
{
  "titre": "Salade italienne à la burrata",
  "description": "Une salade fraîche et généreuse, sans cuisson.",
  "portions": 4,
  "categorie": "salade",
  "tags": [
    "italien",
    "sans cuisson"
  ],
  "ingredients": [
    {
      "id": "burrata",
      "nom": "burrata",
      "quantite": 4,
      "unite": "piece"
    },
    {
      "id": "tomates",
      "nom": "tomates cerises",
      "quantite": 400,
      "unite": "g"
    },
    {
      "id": "roquette",
      "nom": "roquette",
      "quantite": 120,
      "unite": "g"
    },
    {
      "id": "jambon",
      "nom": "tranches de jambon de Parme",
      "quantite": 8,
      "unite": "piece"
    },
    {
      "id": "basilic",
      "nom": "feuilles de basilic frais",
      "quantite": 20,
      "unite": ""
    },
    {
      "id": "huile",
      "nom": "huile d'olive extra vierge",
      "quantite": 60,
      "unite": "ml"
    },
    {
      "id": "pignons",
      "nom": "pignons de pin",
      "quantite": 40,
      "unite": "g"
    },
    {
      "id": "sel",
      "nom": "fleur de sel",
      "quantite": 4,
      "unite": "pincee"
    }
  ],
  "etapes": [
    {
      "titre": "Préparer les tomates",
      "texte": "Couper {{tomates}} de tomates cerises en deux et les mettre dans un grand plat."
    },
    {
      "titre": "Toaster les pignons",
      "texte": "Dans une poêle sèche, faire dorer {{pignons}} de pignons de pin en remuant.",
      "chrono_secondes": 150
    },
    {
      "titre": "Dresser",
      "texte": "Disposer {{roquette}} de roquette sur les tomates, ajouter {{jambon}} tranches de jambon, les {{burrata}} burrata et {{basilic}} feuilles de basilic. Arroser de {{huile}} d'huile d'olive et finir avec {{sel}} de fleur de sel."
    }
  ],
  "notes": "Sortir la burrata du frigo au dernier moment."
}
```

## Ajouter une recette

1. Aide la personne à finaliser sa recette dans la conversation (quantités, étapes, temps).
2. Quand elle dit que c'est bon, termine ton message par UN SEUL bloc ```json au format ci-dessus, avec uniquement la recette dedans.
3. Dis-lui de copier ce bloc, ou de le partager vers « Notre cuisine », puis d'appuyer sur « Envoyer ». Si son appareil est reconnu, la recette est publiée tout de suite ; sinon elle attend la validation de l'administrateur.

Le site est tolérant : il comprend les virgules françaises (1,5), les accents dans les noms de champs et les unités écrites en toutes lettres. Si le bloc est refusé, la personne te colle le message d'erreur : renvoie le bloc complet corrigé.

## Envoyer directement, avec un jeton

Seulement si tu peux faire des requêtes web (Claude Code, un script, un outil connecté) ET que la personne t'a donné un jeton (une clé qui commence par nc_, créée dans « Mon compte » sur le site) :

- POST https://cuisine.mathieucrosnier.fr/api/recettes
- En-têtes : Authorization: Bearer LE_JETON et Content-Type: application/json
- Corps : {"texte": "<le bloc JSON de la recette, sous forme de texte>"}
- Réponses : 201 (recette publiée tout de suite, avec son id, son slug et son lien), 200 (recette existante mise à jour, si le champ "id" est présent), 422 (le bloc est refusé : la liste "errors" dit pourquoi, corrige et renvoie), 401 (jeton inconnu ou retiré : demande-en un nouveau à la personne), 429 (trop d'envois, réessaie plus tard).
- Une recette par requête : pour plusieurs recettes, fais une requête par recette.
- Le jeton est secret : ne l'affiche pas, ne l'écris jamais dans une recette ni dans une réponse, et ne l'envoie à aucune autre adresse que https://cuisine.mathieucrosnier.fr.
- Sans jeton, ne tente pas d'envoyer toi-même : donne le bloc à la personne (voir « Ajouter une recette »).

## Modifier une recette

1. Lis la recette (adresse ci-dessus), ou demande à la personne de te coller son bloc depuis le bouton « Modifier avec Claude » de la page de la recette.
2. Applique les changements demandés, puis renvoie la recette COMPLÈTE dans un seul bloc ```json, en gardant le champ "id" tel quel : c'est lui qui fait que le site met à jour la recette au lieu d'en créer une nouvelle.
3. Si tu oublies le champ image, la photo existante est conservée.

## À savoir

- Les quantités se divisent par le nombre de personnes : préfère des g et des ml, et évite les fractions bizarres.
- N'invente jamais l'adresse d'une image : mets le champ image seulement si la personne t'en a donné une. Elle peut aussi ajouter une photo depuis la page de modification.
- Une même documentation est disponible sur https://cuisine.mathieucrosnier.fr/docs, https://cuisine.mathieucrosnier.fr/readme et https://cuisine.mathieucrosnier.fr/llms.txt.