📚 Documentation

1. Vue d'ensemble

Le projet se compose de 3 couches :

• Logiciel de vente : application desktop Python (Tkinter) + API FastAPI locale.
• API locale : exposée par le logiciel, permet d'interroger le stock.
• Backend web (ce site) : agrège plusieurs serveurs et expose une interface de recherche publique.

2. Le logiciel desktop

📥 Telecharger le logiciel (v14)

Lancement

1. Décompresse LogicielVenteMedicaments_Portable_v14.zip.
2. Crée un fichier .env à partir de .env.example.
3. Définis API_KEY dans le .env.
4. Lance LogicielVente.exe.
5. Lance le tunnel Cloudflare : lancer_tunnel.bat.

Endpoints utiles

GET  /api/v1/health
GET  /api/v1/produits
GET  /api/v1/produits/search?q=aspirine
GET  /api/v1/disponibilite/{reference}?qte=2

Tous les endpoints métier nécessitent le header X-API-Key.

3. Le backend web

Ce backend est hébergé sur ton sous-domaine. Il sert de point d'entrée unique pour ton application mobile.

Fichiers importants

• api/config.php : clé API du backend.
• api/profils.php : gestion des serveurs.
• api/search.php : recherche multi-serveurs.
• data/profiles.json : base de données JSON des profils.

Pages

• index.html : recherche publique.
• settings.html : ajout des serveurs.
• docs.html : cette page.

4. Clés API fournies

Chaque installation du logiciel doit utiliser une seule clé. Copie la clé choisie dans le .env du logiciel, puis dans le profil correspondant du backend.

• CLE_1 = VVMed1-7xKp9-QmL2v-W4zT8-RnB5j
• CLE_2 = VVMed2-Ac3Df-Eg5Hj-Ik7Lm-Np9Qr
• CLE_3 = VVMed3-St1Uv-Wx3Yz-Ab5Cd-Ef7Gh
• CLE_4 = VVMed4-RX8U-EECM-RDOZ-7GZH-DIWI

5. Produits de test

5.1 Médicaments déjà intégrés au logiciel

Ces 5 produits sont présents par défaut dans le logiciel desktop. Utilise leurs références pour tester la disponibilité unique.

5.2 Liste de test A — Mixte

5 produits uniques, categories variées. A importer dans un serveur de test.

5.3 Liste de test B — Mixte

5 produits uniques, categories variées. A importer dans un second serveur de test.

5.4 Liste de test C — Mixte

5 produits uniques, categories variées. A importer dans un troisieme serveur de test.

6. Test rapide avec curl

curl -H "X-API-Key: TA_CLE" \
  "https://url-serveur.trycloudflare.com/api/v1/produits/search?q=doliprane"