Le Fichier National des Établissements Sanitaires et Sociaux (FiNESS) est le répertoire de référence pour les établissements à caractère Sanitaire, Social ou Médico-Social, ainsi que pour la formation aux professions sanitaires et sociales.
Une partie des données FiNESS est accessible via l’API FHIR Annuaire Santé, conforme à la spécification HL7 FHIR :
- Documentation API : Annuaire Santé FHIR
Ce projet vise à publier le code source et la documentation associée à FiNESS, afin de :
- 🔄 Partager les flux outillés pour faciliter leur prise en charge par d'autres équipes
- 🧩 Rendre accessible le modèle de données utilisé dans FiNESS
- 🧑💻 Permettre à d'autres développeurs de proposer des améliorations ou remonter des anomalies
README.md
LICENSE
CONTRIBUTING.md
checklist-publication.md
guide-prise-en-main-github.md
webapp/ → (à venir) Code source de l’IHM
flux/
├── out/
│ ├── standard/
│ └── data.gouv/
└── in/
├── BIO2
├── PHARMA-SI
└── SI-Autorisations
database/
└── ddl/
docs/
└── ...
use-cases/
├── README.md → Index des cas d'usage
└── json-to-table/
├── README.md → Présentation du cas d'usage
├── transform.py → Script Python
├── examples/ → Exemples JSON / CSV
└── mapping.md → Mapping et règles métier
Tous les flux entrants et sortants sont documentés et organisés pour un accès rapide.
Pour une vue d’ensemble et un sommaire des flux, consultez le README global :
Ce README décrit tous les flux sortants et entrants et oriente vers les README spécifiques de chaque sous-dossier.
- 📄 Documentation complète :
docs/flux/out/ - 📁 Schémas JSON & exemples de flux :
flux/out/- 📌 Nouveau : échantillons publiés
-
Flux
structure- Chemin :
flux/out/data.gouv/structure/ - Contenu : échantillons pour tests rapides et jeu complet
exemple-finess-structures-journalier-20260309.json→ échantillon pour testscomplet-finess-structures-20060309.7z→ jeu complet pour traitement exhaustif
- Chemin :
-
Flux
activité- Chemin :
flux/out/data.gouv/activite/ - Contenu : échantillons pour tests rapides et jeu complet
exemple-finess-activite-journalier-20260309.json→ échantillon pour tests
- Chemin :
-
- 📌 Nouveau : échantillons publiés
Ces échantillons permettent aux développeurs et aux équipes de tester la structure des flux avant d’utiliser les fichiers complets.
- 🛠️ Outils de validation JSON :
docs/flux/outils-validation.md
- 📄 Documentation complète :
docs/flux/in/ - 📁 Schémas JSON & Exemples de flux :
flux/in/
- 💾 Scripts SQL DDL :
database/ddl/finess-dll.sql - 📄 Dictionnaire de données FiNESS :
/docs/database/README.md
En complément de la documentation des flux, ce dépôt propose des cas d'usage illustrant leur exploitation dans des contextes réels.
Ces exemples montrent notamment :
- la consommation des flux JSON FiNESS
- leur transformation vers un modèle relationnel
- l'implémentation de règles de gestion métier
- l'alimentation de bases de données
- des scripts Python réutilisables
📂 Index des cas d'usage :
| Cas d'usage | Description |
|---|---|
| JSON vers modèle tabulaire | Transformation du flux d'activités JSON FiNESS+ vers une table relationnelle avec application des règles métier |
📚 Guide de prise en main GitHub : docs/guides/prise-en-main-github.md
Consultez la page dédiée :
👉 FAQ.md
Avant de proposer une modification, merci de lire le guide de contribution pour connaître les règles de collaboration, de formatage, les bonnes pratiques, ainsi que la procédure pour signaler un bug ou proposer une amélioration via les Issues :
Avant de publier une version ou de partager le projet, suivez les étapes listées dans :
Ce projet est distribué sous la licence MIT.