Patrick Schurig bba9c87608 docs: prévision PV et tarif saisi de la version Community, FAQ alignée
Nouvelle page fonctionnalites/prevision-pv (FR/DE/EN, dans la nav) : courbe
horaire jusqu'à la fin du lendemain par plan, correction de température et
plafond onduleur (modèles déterministes publics, aucun apprentissage),
« plafond optimiste », « une heure sans donnée est un trou, jamais un zéro »,
fourchette météo (qualifie la météo seulement), météo horaire, mise en
service, règle centrale de la Community (affiché et enregistré localement,
jamais utilisé pour décider), consommation de base « à venir », données qui
sortent, optimiseur seulement comme interface prévue.

Tarifs (3 langues) : section BETA « tarif saisi », exposé et non utilisé pour
décider ; les tarifs dynamiques restent en roadmap.

FAQ (3 langues) : réponse « données » réécrite avec la liste de ce qui sort ;
« Predict AI », `optimizer-plugin` et « socket Unix » retirés ; la prévision
physique passe dans Community, Pro garde les prévisions apprises.
Accueil : « sans dépendance au cloud ». Tableau des fonctionnalités : trois
lignes. Fiche OpenMeteo : lien vers la page, plafond appliqué par le moteur.

Sources : INTERFACE.md et DESIGN_PREVISION_PV.md (feature/forecast-protocol-1.1),
CONTRACT_A v4, CONSIGNE-app-etm66-prevision.md. Aucune donnée du banc.
Vérifié comme en CI : génération, --check et mkdocs build --strict passent.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 22:29:53 +02:00

107 lines
5.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Prévision de production PV
<span class="badge testing">BETA</span> <span class="badge community">COMMUNITY</span>
La box prévoit la production de vos panneaux, heure par heure, jusqu'à la fin du
lendemain, et l'affiche dans l'application à côté de la production mesurée. C'est une
fonction de la version **Community** (GPL-3.0) : elle repose sur le moteur d'énergie et
sur le plugin [OpenMeteo](../appareils/tarifs/openmeteo.md), sans aucun service ETM.
!!! info "Beta"
Livrée et en fonctionnement sur notre installation de test, elle n'est pas encore
publiée dans un canal du dépôt APT.
## Ce que vous voyez dans l'application
- **La courbe de production prévue**, heure par heure jusqu'à la fin du lendemain,
superposée à la production mesurée.
- **Une fourchette météo** autour de cette courbe (voir plus bas).
- **La météo heure par heure** sur la carte « Journée » : une icône (soleil, nuages,
pluie…), le jour ou la nuit, et la température.
## Comment la prévision est calculée
Pour chaque plan PV déclaré — inclinaison, orientation, puissance crête (kWc) et
rendement du système —, la box convertit l'irradiance prévue par Open-Meteo en
puissance. Elle additionne ensuite tous les plans du site.
Deux corrections s'appliquent, toutes deux **déterministes** : des modèles physiques
publics, paramétrés par les fiches techniques, sans aucun apprentissage.
- **Correction de température** : un module chaud produit moins. La box l'estime à partir
de la température prévue, de la NOCT et du coefficient de température des modules.
- **Plafond onduleur** : la somme des plans ne dépasse jamais la puissance AC maximale de
l'onduleur, si elle a été renseignée.
La prévision est recalculée à chaque nouvelle publication des modèles météo, soit au plus
une fois par heure.
### Une prévision, et un plafond optimiste
Ce que la box affiche est une **prévision**, pas une mesure. C'est aussi un **plafond
optimiste** : l'ombrage (arbres, cheminée, bâtiments voisins) et l'encrassement des
panneaux ne sont pas modélisés. Une production réelle sous la courbe est donc normale et
ne signale pas une panne.
### Une heure sans donnée est un trou, jamais un zéro
Si une heure manque (internet coupé, service météo indisponible), la courbe s'interrompt.
La box n'écrit jamais « 0 » à la place : un zéro se lirait comme « pas de soleil prévu ».
## La fourchette météo
Autour de la courbe, l'application trace une bande :
**prévu × (1 ± dispersion des modèles du jour)**. La dispersion mesure à quel point
plusieurs modèles météo divergent pour la journée.
Cette bande qualifie **la météo**, et seulement la météo. Elle ne dit rien de la
précision de la prévision de production : l'ombrage et l'encrassement n'y figurent pas.
Par grand beau temps stable, elle est étroite alors que l'écart dû à ces facteurs est le
plus fort. Ce n'est donc ni une « erreur attendue » ni un « intervalle de confiance ».
## Mise en service
1. Installez le plugin OpenMeteo et créez le **site** et ses **plans PV** — voir la
[fiche OpenMeteo](../appareils/tarifs/openmeteo.md).
2. **Désignez le site de prévision** dans l'application. Tant qu'aucun site n'est
désigné, la carte de prévision affiche « Aucun site de prévision désigné » et
propose les sites disponibles. Tous les plans du site désigné sont additionnés.
3. Facultatif : renseignez le **plafond onduleur** (puissance AC maximale, en W).
Sans lui, aucun plafond n'est appliqué.
## Ce que la prévision ne fait pas
C'est la règle centrale de la version Community : **sans optimiseur, le pilotage se fait
par règles** (surplus solaire, délestage, priorités). La prévision PV, le
[tarif saisi](../tarifs.md) et la consommation de base sont **affichés** et
**enregistrés localement**, mais ils ne servent jamais à décider. Un test automatique
le vérifie : le moteur prend les mêmes décisions avec ou sans prévision, tarif et profil
de consommation.
L'enregistrement local sert à mesurer la précision des prévisions dans le temps. La
validation sur une installation réelle est en cours ; aucun chiffre de précision n'est
publié avant qu'elle soit terminée.
## Consommation de base prévue <span class="badge nightly">À VENIR</span>
La box calculera un profil de consommation du foyer, hors charges pilotées, à partir de
ses propres mesures : une médiane par heure de la journée, séparée entre jours ouvrés
et week-end. Il faut au moins **7 jours** de mesures avant qu'un profil existe.
D'ici là, rien n'est affiché : une absence, jamais un zéro.
## Vos données
Seul le plugin OpenMeteo se connecte à internet. Il n'envoie que les **coordonnées du
site** (arrondies à environ 1 km), son **altitude** si elle est renseignée, et
l'**orientation des panneaux** (inclinaison, azimut). Les mesures, les prévisions
enregistrées, le tarif et la consommation restent sur la box. L'accès à distance est
désactivé par défaut : il ne s'ouvre que si vous l'activez vous-même dans
l'application.
## Et un optimiseur ?
L'architecture prévoit une **interface ouverte et documentée** vers un optimiseur externe,
qui pourrait utiliser ces prévisions pour planifier. L'optimisation tournerait chez vous,
sur la box ou sur une machine de votre réseau local. Cette connexion est en cours de
développement ; la version Community fonctionne entièrement sans elle.