{"openapi":"3.0.3","info":{"title":"Cabinet Médical Cité Golf (CMCG) - API Partenaires & Interconnexion","version":"2.1.0","description":"API REST pour l'interconnexion hospitalière du Cabinet Médical Cité Golf (Dakar, Sénégal). Permet la synchronisation avec les laboratoires externes (ex: Institut Pasteur de Dakar), les mutuelles / IPM pour le tiers-payant, et les passerelles de paiement Wave et Orange Money.","contact":{"name":"Dr Soumaïla Amina Bangna - CMCG","url":"https://cmcg-dakar.sn","email":"contact@cmcg.sn"}},"servers":[{"url":"http://localhost:3008/api","description":"Serveur Local Clinique (Production Port 3008)"},{"url":"https://erp.cmcg-dakar.sn/api","description":"Serveur Cloud Sécurisé CMCG"}],"paths":{"/patients":{"get":{"summary":"Recherche et liste des dossiers patients","description":"Retourne les dossiers médicaux avec filtres par nom, téléphone, ou phénotype d'hémoglobine (SS, SC, etc.).","parameters":[{"name":"q","in":"query","description":"Terme de recherche (nom, prénom, numéro dossier, téléphone)","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Liste des patients correspondants","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"numeroDossier":{"type":"string","example":"CMCG-2026-0001"},"nom":{"type":"string","example":"Diagne"},"prenom":{"type":"string","example":"Mamadou Lamine"},"electrophoreseHb":{"type":"string","example":"SS"},"telephone":{"type":"string","example":"77 123 45 67"}}}}}}}}},"post":{"summary":"Création d'un nouveau dossier patient (DME)","description":"Enregistre un patient avec ses données d'état civil, constantes et antécédents médicaux.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["nom","prenom","dateNaissance","sexe","telephone"],"properties":{"nom":{"type":"string","example":"Sow"},"prenom":{"type":"string","example":"Aissatou"},"dateNaissance":{"type":"string","format":"date","example":"2018-05-12"},"sexe":{"type":"string","enum":["M","F"],"example":"F"},"telephone":{"type":"string","example":"77 654 32 10"},"electrophoreseHb":{"type":"string","example":"SC"}}}}}},"responses":{"201":{"description":"Patient créé avec succès"},"400":{"description":"Données invalides ou incomplètes"}}}},"/appointments":{"get":{"summary":"Consulter l'agenda et la file d'attente","description":"Retourne les rendez-vous par date, médecin et créneau (Heures normales vs Permanences).","responses":{"200":{"description":"Liste des rendez-vous"}}},"post":{"summary":"Programmer une consultation ou urgence","description":"Planifie un rendez-vous ou insère le patient en file d'attente active.","responses":{"201":{"description":"Rendez-vous confirmé"}}}},"/billing":{"get":{"summary":"Journal des factures et encaissements","description":"Historique des factures avec décomposition part patient / part assurance (IPM) et méthode (Wave, OM, Espèces).","responses":{"200":{"description":"Liste des factures émises"}}}},"/lab":{"get":{"summary":"Résultats et prescriptions de laboratoire","description":"Interconnexion pour réception des bilans NFS, Électrophorèse Hb, CRP, Test d'Emmel.","responses":{"200":{"description":"Analyses de laboratoire"}}}},"/backup":{"get":{"summary":"Export complet ou partiel de la base de données","parameters":[{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv"]}},{"name":"type","in":"query","schema":{"type":"string","enum":["all","patients","billing","pharmacy"]}}],"responses":{"200":{"description":"Fichier de sauvegarde exporté"}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-CMCG-API-KEY"}}}}