Aide-mémoire de la progression IoT¶

Récapitulatif des paliers de la progression Bonjour Forge IoT et des API du module opt-in forge-mvc-iot introduites à chaque étape.

Module opt-in

Toute cette progression suppose forge-mvc-iot installé (forge opt-in:install iot). Le cœur de Forge reste autonome.

Niveau débutant — découvrir (lecture, sans broker)¶

#	Palier	Ce qu'on apprend	API-clé
1	Bonjour Forge IoT	Vérifier le module, inspecter la config (secret masqué)	`load_iot_config`
2	Lire les événements IoT	Lire les derniers événements, rester pédagogique si la table manque	`IotEventRepository.list_recent`
3	Les événements d'un capteur	Cibler un capteur et compter ses événements	`find_by_device`, `count_by_device`

#	Palier	Ce qu'on apprend	API-clé
1	Simuler une mesure IoT	Composer, valider et insérer une mesure sans broker	`build_payload`, `parse_message`, `IotEventRepository.insert`
2	Exposer l'API IoT	Brancher l'API HTTP JSON officielle (lecture seule, Bearer optionnel)	`register_iot_routes`
3	Tableau de bord IoT	Afficher les événements dans une page HTML	`list_recent` + `render`

#	Palier	Ce qu'on apprend	API-clé
1	Valider un message IoT	Le contrat des messages réels	`parse_message`, `ContractError`
2	Le subscriber MQTT	Recevoir d'un vrai broker en temps réel	`forge iot:listen`, `MqttSubscriber`
3	Diagnostiquer le module IoT	Vérifier la santé du module	`forge iot:doctor`, contrôles non invasifs

Élément	Usage
`load_iot_config()`	Lire la configuration MQTT (hôte, port, topic, identifiants, token API)

Un secret (mot de passe, token) est toujours masqué quand la config est sérialisée.

Élément	Usage
`IotEventRepository()`	Accès aux événements stockés (utilise `core.database.db` par défaut)
`repo.list_recent(limit=…)`	Derniers événements, ordre du plus récent
`repo.find_by_device(site, device_id, limit=…)`	Événements d'un capteur précis
`repo.count_by_device(site, device_id)`	Nombre d'événements d'un capteur
`repo.insert(measurement)`	Écrire une mesure validée dans `iot_events`

Élément	Usage
`build_topic(site, device_id)` / `build_payload(...)`	Composer un topic et un payload conformes
`parse_message(topic, payload)`	Valider → `Measurement` (lève `ContractError` sinon)

Élément	Usage
`register_iot_routes(router)`	Brancher l'API JSON officielle (3 routes lecture seule)
`FORGE_IOT_API_TOKEN`	Si défini, exige `Authorization: Bearer <token>`

Élément	Usage
`forge iot:listen` (`MqttSubscriber`)	Recevoir d'un vrai broker : valider puis stocker
`forge iot:doctor`	Diagnostic complet (paquet, config, API, `--db`, `--mqtt`)
`check_package_importable` / `check_config_loadable` / `check_http_api_registrable`	Contrôles de diagnostic non invasifs, réutilisables en app