chore: initial skeleton — NextPM sensor, JSON format, Miotiq UDP parser

README.md

@@ -0,0 +1,44 @@
+# aircarto-protocols
+
+Documentation de référence pour tous les capteurs AirCarto : protocoles de communication (UART, I2C, UDP, HTTP, MQTT…), formats de données, parsers et conventions.
+
+**Public visé** — chaque projet firmware ou backend AirCarto consomme cette doc pour intégrer la logique commune (dialogue capteur, format d'envoi, parsing côté serveur) sans réinventer ni diverger.
+
+## Structure
+
+```
+aircarto-protocols/
+├── CONVENTIONS.md           Nommage, versioning, style doc
+├── formats/                 Formats d'échange de données
+│   ├── json-payload.md        Format JSON canonique des mesures
+│   └── mqtt.md                Topics et conventions MQTT
+├── sensors/                 Un fichier par capteur
+│   ├── _TEMPLATE.md           Gabarit à copier pour tout nouveau capteur
+│   └── nextpm.md              NextPM (Tera Sensor) — UART
+└── parsers/                 Parsers côté serveur / passerelle
+    └── udp-miotiq.md          Webhook Miotiq (UDP → HTTPS JSON)
+```
+
+## Index des capteurs
+
+| Capteur     | Interface | Doc                               | État       |
+|-------------|-----------|-----------------------------------|------------|
+| NextPM      | UART      | [sensors/nextpm.md](sensors/nextpm.md) | Complet    |
+
+## Index des parsers
+
+| Nom             | Transport        | Doc                                           | État    |
+|-----------------|------------------|-----------------------------------------------|---------|
+| UDP Miotiq      | UDP → HTTPS JSON | [parsers/udp-miotiq.md](parsers/udp-miotiq.md) | Complet |
+
+## Comment ajouter une entrée
+
+- **Nouveau capteur** : copier `sensors/_TEMPLATE.md` vers `sensors/<nom>.md`, remplir les sections, mettre à jour l'index ci-dessus.
+- **Nouveau format / parser** : créer le fichier sous `formats/` ou `parsers/`, mettre à jour l'index.
+- Voir [CONVENTIONS.md](CONVENTIONS.md) pour le style et le nommage.
+
+## Pourquoi ce repo
+
+Avant : chaque firmware AirCarto (NebuleAir, ModuleAir, MobileAir…) redéfinissait ses trames, ses topics et son format JSON dans son coin. Les parsers côté serveur (`data.mobileair.fr/udp_miotiq_*.php`, `gestion.aircarto.fr`) devaient suivre. Résultat : dérives silencieuses entre capteurs, bugs d'intégration.
+
+Ici on centralise la **spécification**. Le code de référence reste dans les repos des projets (firmwares, backends) ; ce repo décrit ce qui est attendu sur le fil.