# powersync-docs

Documentation transverse de l'écosystème **ETM-PowerSync** (HEMS sur nymea).

Ce dépôt est la **source de vérité** pour l'architecture, les frontières de licence, les contrats d'interface et les conventions partagées entre tous les composants. Les `README` de chaque dépôt (plugins, services) sont des vues *locales* et renvoient ici pour la vue d'ensemble.

## Contenu

- [`ARCHITECTURE.md`](ARCHITECTURE.md) — le document de référence : composants, couches, frontière de licence, flux, conventions, contrats d'interface, configuration à l'installation, niveaux d'optimisation.

## Règle de cohérence

Toute décision transverse (nouvelle convention, changement de contrat d'interface, déplacement d'une responsabilité entre composants) se prend **ici d'abord**, puis se décline dans les dépôts concernés. Si un `README` de dépôt contredit ce document, c'est ce document qui fait foi.

## Évolution

À terme, ce dépôt pourra être agrégé en site mkdocs. Pour l'instant, README + Markdown versionné suffit.