# Paramètres URL du Simulateur SolarPac

Ce document décrit tous les paramètres acceptés par le simulateur SolarPac pour le préremplissage via URL.

## 🚀 Comportement Automatique

**Si des paramètres sont présents dans l'URL `/simulateur-coproprietes?...`, le simulateur redirige automatiquement vers le formulaire principal prérempli, sans passer par l'écran d'accueil.**

---

## 📋 Table des Paramètres

### A. Immeuble (Bloc Général)

| Paramètre | Type | Description | Exemple |
|-----------|------|-------------|---------|
| `logements` | number | Nombre de logements | `50` |
| `surface` | number | Surface chauffée (m² SHAB) | `3800` |
| `puissance_chaudiere` | number | Puissance chaudière actuelle (kW) | `350` |
| `temperature_consigne` | number | Température de consigne (°C) | `20` |

### B. Chauffage Existant

| Paramètre | Type | Valeurs | Description |
|-----------|------|---------|-------------|
| `energie` | string | `gaz` \| `fioul` | Type d'énergie actuelle |
| `facture` | number | | Facture annuelle de chauffage (€) |
| `rendement` | number | 50-100 | Rendement chaudière (%) |
| `conso_kwh` | number | | Consommation annuelle (kWh PCI) |
| `fioul_litres` | number | | Consommation fioul (litres/an) |

### C. Géographie / Climat

| Paramètre | Type | Valeurs | Description |
|-----------|------|---------|-------------|
| `departement` | string | `69`, `75`, `2A`... | Numéro de département |
| `dept` | string | | Alias de `departement` |
| `altitude` | number | 0-4000 | Altitude (m) |
| `zone` | string | `H1` \| `H2` \| `H3` | Zone climatique |
| `zone_climatique` | string | | Alias de `zone` |
| `t_base` | number | -35 à +10 | **Température de base (°C)** - Override de la valeur normative DTU |
| `tbase` | string | | Alias de `t_base` |
| `temperature_base` | string | | Alias de `t_base` |

⚠️ **Note sur `t_base`** : Ce paramètre permet de simuler un scénario météo non normatif. Si non renseigné, la valeur normative DTU (corrigée pour l'altitude) est utilisée. Tous les calculs de bacs de température et le dimensionnement seront recalculés avec cette température de base personnalisée.

---

## D. DPE (Diagnostic de Performance Énergétique)

### Coefficient EP Électricité (Important!)

| Paramètre | Type | Valeurs | Description |
|-----------|------|---------|-------------|
| `dpe_avant_2026` | boolean | `true` \| `false` | DPE établi avant le 1er janvier 2026 |

- **true (défaut)** : Le DPE utilise l'ancien coefficient EP électricité (**2,3**)
- **false** : Le DPE utilise le nouveau coefficient EP électricité (**1,9** - RE2020/2026)

⚠️ **Note importante sur l'effet réglementaire :** 
Le changement de coefficient EP (2.3 → 1.9) en 2026 améliore le DPE de TOUS les bâtiments avec consommation électrique (éclairage, auxiliaires, ECS électrique), **MÊME SANS TRAVAUX**.

Le simulateur calcule et affiche séparément :
- **Gain réglementaire** : amélioration "gratuite" due au changement de coefficient (automatique en 2026)
- **Gain travaux PAC** : amélioration réelle due à l'installation de la pompe à chaleur

Cela permet une transparence totale dans l'interprétation des résultats DPE.

⚠️ **Note importante :** Le DPE "après projet" sera toujours calculé avec le coefficient **1,9** (nouvelle réglementation).

### Mode Simplifié (Recommandé) 📌

**Utilisation:** Envoyez les valeurs numériques du DPE, la note A-G est calculée automatiquement.

| Paramètre | Alias | Type | Description |
|-----------|-------|------|-------------|
| `conso_ep_kwh_m2` | `valeur_energie`, `conso_ep` | number | Consommation en kWh EP/m²/an |
| `emission_ges_kg_m2` | `valeur_climat`, `emission_ges` | number | Émissions GES en kg CO₂/m²/an |
| `part_chauffage` | | number (0.01-1.0) | Part du chauffage collectif dans le DPE |
| `mode_dpe` | `dpe_mode` | string | `simplifie` ou `simple` |

**Exemple URL Mode Simplifié:**
```
/simulateur-coproprietes/?logements=50&surface=3800&energie=gaz&facture=51000&conso_ep_kwh_m2=245&emission_ges_kg_m2=52&part_chauffage=0.75&dpe_avant_2026=true
```

### Mode Détaillé (Optionnel)

**Utilisation:** Pour les utilisateurs avancés avec accès aux consommations par poste.

| Paramètre | Type | Description |
|-----------|------|-------------|
| `mode_dpe` | string | `detaille` ou `detailed` |
| `unite_dpe` | string | `kwhEP_an` ou `kwhEF_an` |
| `conso_chauffage` | number | Consommation chauffage (kWh/an total bâtiment) |
| `conso_ecs` | number | Consommation ECS (kWh/an) |
| `conso_aux` | number | Consommation auxiliaires (kWh/an) |
| `conso_eclairage` | number | Consommation éclairage (kWh/an) |

**Exemple URL Mode Détaillé:**
```
/simulateur-coproprietes/?logements=50&surface=3800&energie=gaz&facture=51000&mode_dpe=detaille&unite_dpe=kwhEP_an&conso_chauffage=150000&conso_ecs=30000&conso_aux=2000&conso_eclairage=5000
```

### Fallback par Étiquettes (Dégradé)

Si vous n'avez que les notes A-G sans les valeurs numériques:

| Paramètre | Alias | Type | Description |
|-----------|-------|------|-------------|
| `energie_dpe` | `dpe_energie` | string | Étiquette énergie (A-G) |
| `climat_dpe` | `dpe_climat` | string | Étiquette climat (A-G) |

⚠️ **Priorité:** Les valeurs numériques (`conso_ep_kwh_m2`) sont toujours prioritaires sur les étiquettes.

---

## E. ECS (Eau Chaude Sanitaire)

| Paramètre | Type | Valeurs | Description |
|-----------|------|---------|-------------|
| `ecs` | string | `individuelle` \| `collective` | Type d'ECS |
| `ecs_energy` | string | `gaz` \| `fioul` \| `elec` | Énergie ECS actuelle |
| `ecs_litres_jour` | number | | Litres/jour/logement |
| `ecs_conso` | number | | Consommation ECS (kWh/an) |
| `ecs_pertes` | number | 0-50 | Pertes recirculation (%) |

---

## F. PAC (Pompe à Chaleur)

| Paramètre | Type | Valeurs | Description |
|-----------|------|---------|-------------|
| `emetteurs` | string | `radiateurs` \| `plancher` | Type d'émetteurs |
| `regime` | string | `basse` \| `moyenne` \| `haute` | Régime de température radiateurs |
| `nb_modules` | number | | Nombre de modules PAC |
| `puissance_pac` | number | | Puissance PAC override (kW) |
| `marge` | number | 0-30 | Marge sécurité (%) |

---

## G. Solaire / PV

| Paramètre | Type | Description |
|-----------|------|-------------|
| `toit_plat` | boolean | `true`, `1`, `oui` = toit terrasse |
| `surface_toiture` | number | Surface toiture disponible (m²) |
| `region_pv` | string | Région pour productible PV |
| `productible` | number | Productible override (kWh/kWc/an) |

---

## H. Prix et TVA

| Paramètre | Type | Description |
|-----------|------|-------------|
| `prix_gaz` | number | Prix gaz (€/kWh) |
| `prix_fioul` | number | Prix fioul (€/L) |
| `prix_elec` | number | Prix électricité (€/kWh) |
| `tva` | number | Taux de TVA (5.5 ou 20) |

---

## 🎯 Exemples Complets pour GPT SolarPac

### Exemple 1: Copropriété gaz avec DPE simplifié
```
https://solarpac.fr/simulateur-coproprietes/?logements=50&surface=3800&departement=69&energie=gaz&facture=51000&ecs=individuelle&conso_ep_kwh_m2=245&emission_ges_kg_m2=52&part_chauffage=0.75
```

### Exemple 2: Copropriété fioul avec DPE détaillé
```
https://solarpac.fr/simulateur-coproprietes/?logements=30&surface=2200&departement=75&energie=fioul&facture=28000&mode_dpe=detaille&unite_dpe=kwhEP_an&conso_chauffage=120000&conso_ecs=25000&conso_aux=1500
```

### Exemple 3: Avec option solaire
```
https://solarpac.fr/simulateur-coproprietes/?logements=80&surface=6000&departement=13&energie=gaz&facture=72000&toit_plat=true&surface_toiture=400&conso_ep_kwh_m2=198&emission_ges_kg_m2=45
```

---

## 📝 Notes pour l'Extraction DPE

### Où trouver les valeurs sur un DPE ?

| Champ DPE | Paramètre URL |
|-----------|---------------|
| "Consommation énergétique" (kWh/m²/an) | `conso_ep_kwh_m2` |
| "Émissions de GES" (kg CO₂/m²/an) | `emission_ges_kg_m2` |
| Surface habitable (m²) | `surface` |
| "Chauffage collectif" mentionné | `ecs=individuelle` ou `collective` |

### Calcul de `part_chauffage`

La part chauffage (0.01-1.0) représente la proportion de la consommation DPE liée au chauffage collectif:

- **75% (0.75)** = valeur par défaut raisonnable
- **50-60%** = ECS collective importante
- **80-90%** = bâtiment bien isolé avec faible ECS

---

## 🔧 Format des Valeurs

- **Nombres:** Utiliser le point `.` comme séparateur décimal (ex: `0.75`)
- **Booléens:** `true`, `1`, `oui` sont équivalents
- **Texte:** Insensible à la casse pour les énumérations

---

*Document généré pour le GPT SolarPac - Version 2025-12*