# Vendoring — sunspec

Copié depuis : ETM/nymea-plugins-modbus (fork de nymea/nymea-plugins-modbus)
Commit source (HEAD au moment de la copie) : 2b18e84
Dernier commit touchant les sources copiées : bf53a74
  ("Update license text and add SPDX identifier", 2025-11-18)
Base upstream : nymea-plugins-modbus 1.15.2
Date copie : 2026-07-31
Nom paquet cible : powersync-plugin-sunspec

Raison : le chantier Fronius (voir `specs/fronius-sunspec.md`) ajoute un vendor
`fronius` et corrige des anomalies du vendor `sunspec` générique. Ces
changements vivent dans ce dépôt ETM, pas dans le mirror nymea.

## Ce qui a été copié

Sources uniquement. Exclus de la copie : `*.o`, `moc_*`, `*.so`, `Makefile`,
`plugininfo.h`, `extern-plugininfo.h`, `moc_predefs.h`, `*.qm` — tous des
artefacts de build régénérés par `qmake6` / `nymea-plugininfocompiler`.

## Dépendance de build

`libnymea-sunspec-dev` (paquet `repos.nymea.io`, 1.15.2). `sunspec.pri` le
résout par `pkg-config nymea-sunspec`.

## Règle absolue

**`libnymea-sunspec` n'est PAS vendorée et ne doit pas l'être.** Le plugin doit
rester rebasable sur l'upstream nymea : toute modification vit dans `sunspec/`.
Si un changement de la bibliothèque paraît inévitable, s'arrêter et remonter la
question plutôt que de la modifier.

## Hygiène de commits

Deux natures de changements, à ne jamais mélanger dans un même commit :

- **correctifs upstream** (bugs présents dans nymea 1.15.2 — AC-1 à AC-4 de la
  spec) : message en anglais, aucune référence à ETM / Fronius / PowerSync, pour
  rester proposables en amont ;
- **spécifique ETM** (vendor `fronius`, réglages produit) : commits séparés.

## SORTIE

Si nymea intègre en amont les correctifs AC-1..AC-4 et un vendor Fronius
équivalent : rebaser sur la version amont et réduire ce dossier au delta ETM.