Documentation
Présentation du produit, des données et des invariants d'audit. La documentation technique de l'API est servie sur l'endpoint Swagger côté backend.
Cinq invariants
- 0 ≠ NULL
- Une donnée absente reste explicitement absente. Le score d'une commune sans DVF n'est pas dilué par un zéro fabriqué.
- Atomicité Bronze
- Chaque ingestion écrit d'abord dans _tmp/ puis copie vers la clé finale. Aucun fichier partiel ne sera jamais consommé.
- Isolation du moteur de scoring
- Le moteur de score ne dépend que des schémas Zod publics. Auditable et rejouable sans la base.
- État UI explicite
- Toute fiche expose un état : chargement, donnée fiable, aucun arrêté, ou indisponible. Pas de fallback silencieux.
- run_id Bronze → Silver → Gold
- L'identifiant d'exécution traverse les couches sans modification. L'auditeur RCP remonte du score jusqu'au fichier brut original.
Promesse
À partir d'une adresse libre, Sonar produit en moins de 3 secondes une fiche de risque MRH / MRI. Sources couvertes : arrêtés de péril, insalubrité, RHI, marché DVF. Chaque score est traçable jusqu'à la donnée brute (responsabilité civile professionnelle du courtier).
Données
Sources Open Data fusionnées dans le pipeline :
- RNIC (Registre National des Copropriétés) — arrêtés et indicateurs
- Georisques BRGM (risques naturels et technologiques)
- RAA (Recueil des Actes Administratifs) — upload manuel
- DVF Etalab (médiane €/m² 24 mois glissants)
- Base Adresse Nationale + Cadastre IGN (géocodage et parcelle)
Contact
Pour les besoins Enterprise, l'accès à l'API ou une démonstration produit, écrivez à contact@sonar.tld.