batchCooking/specs/batch-cooking-modele.md

# Modèle de données — Projet Batch-cooking

> Documentation du schéma de données de l'application de planification de batch-cooking.

---

## Vue d'ensemble

Le modèle s'articule autour de trois grands pôles :

- **Utilisateurs & foyer** — `user_profiles`, `house`, `diet`, `allergy`, `category`
- **Planification** — `planning`, `planning_item`
- **Recettes** — `recipe`, `ingredients`, `step`, `tech_step`, `tech_step_mapping`, `sources`

---

## Schéma entité-relation

```mermaid
erDiagram
  USER_PROFILES }o--|| HOUSE : "vit dans"
  USER_PROFILES }o--|| DIET : "suit"
  HOUSE ||--o{ PLANNING : "planifie"
  PLANNING ||--o{ PLANNING_ITEM : "contient"
  PLANNING_ITEM }o--|| RECIPE : "utilise"
  RECIPE }o--|| SOURCES : "vient de"
  CATEGORY ||--o{ ALLERGY : "classe"
  USER_PROFILES }o--o{ ALLERGY : "a"
  RECIPE }o--o{ INGREDIENTS : "compose de"
  RECIPE }o--o{ STEP : "compose de"
  STEP }o--|| TECH_STEP : "utilise"
  TECH_STEP ||--o{ TECH_STEP_MAPPING : "mappe"
  INGREDIENTS }o--|| RECIPE : "recette alternative"

  USER_PROFILES {
    int id PK
    string first_name
    string last_name
    string email
    int house_id FK
    int diet_id FK
  }
  HOUSE {
    int id PK
    string name
  }
  PLANNING {
    int id PK
    date start_date
    date finish_date
    int house_id FK
  }
  PLANNING_ITEM {
    int id PK
    int planning_id FK
    string week_day
    string meal
    int recipe_id FK
  }
  DIET {
    int id PK
    string name
  }
  ALLERGY {
    int id PK
    int cat_id FK
  }
  CATEGORY {
    int id PK
    string name
  }
  INGREDIENTS {
    int id PK
    string name
    string icon
    int alternate_recipe FK
  }
  RECIPE {
    int id PK
    string name
    int source_id FK
    string description
    string picture
  }
  STEP {
    int id PK
    string description
    string picture
    int order
    int tech_step_id FK
  }
  TECH_STEP {
    int id PK
  }
  TECH_STEP_MAPPING {
    int id PK
    int tech_step_id FK
    string expression
    int weight
  }
  SOURCES {
    int id PK
    string name
    string url
  }
```

*(Rendu sur les visualiseurs markdown compatibles mermaid — GitHub, VS Code, Obsidian, etc.)*

---

## Tables

### `user_profiles`
| Champ | Description |
|---|---|
| `id` | Identifiant |
| `first_name` | Prénom |
| `last_name` | Nom |
| `email` | Email |
| `house_id` | FK → `house` |
| `diet_id` | FK → `diet` |

### `house`
| Champ | Description |
|---|---|
| `id` | Identifiant |
| `name` | Nom du foyer |

### `diet`
| Champ | Description |
|---|---|
| `id` | Identifiant |
| `name` | Nom du régime alimentaire |

### `allergy`
| Champ | Description |
|---|---|
| `id` | Identifiant |
| `cat_id` | FK → `category` |

Associée à `user_profiles` en many-to-many (table de jointure simple, sans champ additionnel).

### `category`
| Champ | Description |
|---|---|
| `id` | Identifiant |
| `name` | Nom de la catégorie |

Table d'énumération, destinée à grandir au fil du projet (portera notamment les nuances liées aux allergies).

### `planning`
| Champ | Description |
|---|---|
| `id` | Identifiant |
| `start_date` | Date de début |
| `finish_date` | Date de fin |
| `house_id` | FK → `house` |

### `planning_item`
| Champ | Description |
|---|---|
| `id` | Identifiant |
| `planning_id` | FK → `planning` |
| `week_day` | Jour de la semaine |
| `meal` | Repas concerné |
| `recipe_id` | FK → `recipe` |

### `recipe`
| Champ | Description |
|---|---|
| `id` | Identifiant |
| `name` | Nom de la recette |
| `source_id` | FK → `sources` |
| `description` | Description |
| `picture` | Image |

Associée à `ingredients` en many-to-many.

### `ingredients`
| Champ | Description |
|---|---|
| `id` | Identifiant |
| `name` | Nom |
| `icon` | Icône |
| `alternate_recipe` | FK → `recipe` (recette alternative) |

### `step`
| Champ | Description |
|---|---|
| `id` | Identifiant |
| `description` | Description de l'étape |
| `picture` | Image |
| `order` | Ordre dans la recette |
| `tech_step_id` | FK → `tech_step` |

Associée à `recipe` en many-to-many.

### `tech_step`
| Champ | Description |
|---|---|
| `id` | Identifiant |

### `tech_step_mapping`
| Champ | Description |
|---|---|
| `id` | Identifiant |
| `tech_step_id` | FK → `tech_step` |
| `expression` | Expression |
| `weight` | Poids |

### `sources`
| Champ | Description |
|---|---|
| `id` | Identifiant |
| `name` | Nom de la source |
| `url` | URL |

---

## Relations

### Many-to-one (clés étrangères)

| Table source | Champ FK | Table cible |
|---|---|---|
| `user_profiles` | `house_id` | `house` |
| `user_profiles` | `diet_id` | `diet` |
| `planning` | `house_id` | `house` |
| `planning_item` | `planning_id` | `planning` |
| `planning_item` | `recipe_id` | `recipe` |
| `allergy` | `cat_id` | `category` |
| `ingredients` | `alternate_recipe` | `recipe` |
| `recipe` | `source_id` | `sources` |
| `step` | `tech_step_id` | `tech_step` |
| `tech_step_mapping` | `tech_step_id` | `tech_step` |

### Many-to-many (associations)

| Table A | Table B | Détail |
|---|---|---|
| `user_profiles` | `allergy` | Table de jointure simple |
| `recipe` | `ingredients` | Composition d'une recette |
| `step` | `recipe` | Étapes d'une recette |

---

## Règles de modélisation

- Toute relation qualifiée d'**« association »** entre deux tables est une relation **many-to-many**.
- `category` est une table d'énumération, amenée à grandir au fur et à mesure du projet.