PharmaPro — Quick Start

Guide de démarrage rapide · دليل البدء السريع · Quick start guide

Du déballage à la première vente en moins de 15 minutes.

1. Installation

1. Lancer PharmaPro_Setup.exe
2. Suivre l'assistant Inno Setup (cible par défaut : C:\Program Files\PharmaPro)
3. Cliquer sur Terminer — un raccourci est créé sur le bureau

💡 Aucune dépendance Python n'est requise — l'exécutable est packagé.

2. Activation de la licence

Au premier démarrage :

1. Notez le HWID affiché (format XXXX-XXXX-XXXX-XXXX)
2. Communiquez-le à votre revendeur
3. Collez la clé de licence reçue dans le champ prévu
4. Cliquez sur Activer

⚠ La licence est liée au matériel. Un changement de carte mère ou de système exige une nouvelle clé.

3. Première connexion

Action immédiate : aller dans Utilisateurs, modifier le mot de passe de l'admin, puis créer les comptes vendeurs (rôle worker).

4. Configurer la pharmacie

Paramètres → Informations de la Pharmacie :

• Nom (apparaît sur les tickets et PDF)
• Adresse
• Téléphone

Ajustez aussi : - Seuil stock faible (10 par défaut) - Alerte péremption en jours (30 par défaut) - Taille de police (14 par défaut)

5. Importer le catalogue (~2100 produits)

Si la base est vide ou si vous voulez écraser :

python scripts/import_listing.py --dry-run    # vérifier
python scripts/import_listing.py              # exécuter

Une sauvegarde automatique de data/pharma.db est créée avant l'import dans backups/.

6. Première vente

1. Caisse → ▶ Ouvrir un Shift → fond de caisse (ex. 5000 DA)
2. Point de Vente → F2 → tapez le nom du produit
3. Entrée → ajout au panier
4. Choisir le type de vente (Espèces, Chifa, etc.)
5. F12 → Encaisser → ticket imprimé

Raccourcis essentiels POS :

7. Fin de journée

1. Caisse → 🔄 Actualiser X (vérifier le récap)
2. Compter physiquement les espèces du tiroir
3. ⏹ Clôturer (Z) → saisir le montant compté
4. Le système affiche l'écart (vert = OK, rouge = différence)

8. Sauvegarde

À chaque démarrage, une copie de data/pharma.db est écrite dans backups/ avec un horodatage. Pour une sauvegarde manuelle, copiez ce fichier sur une clé USB.

9. Activer la langue arabe

Paramètres → Langue de l'interface → العربية → Enregistrer → Redémarrer l'application.

L'interface bascule en RTL (droite vers gauche) automatiquement.

10. Aide

• Manuel détaillé : docs/manuel_pharmapro.md (32 chapitres)
• Catalogue trilingue : docs/catalogue_trilingue.md
• Logs d'activité : page Journal d'Activité (admin)
• Sauvegardes : dossier backups/

عربي — البدء السريع

1. التثبيت

شغّل PharmaPro_Setup.exe واتبع المعالج. لا توجد تبعيات إضافية.

2. تفعيل الترخيص

اكتب الـ HWID الظاهر، أرسله للموزّع، الصق الـ clé المُستلَمة، اضغط Activer.

3. أوّل تسجيل دخول

• المستخدم: admin
• كلمة السرّ: admin2026

غيّر الكلمة فوراً من صفحة Utilisateurs.

4. إعدادات الصيدلية

Paramètres → اسم الصيدلية، العنوان، الهاتف، عتبة المخزون المنخفض، تنبيه الانتهاء.

5. استيراد الكاتالوغ

python scripts/import_listing.py

يستورد ~2100 دواء مع نسخة احتياطية تلقائية.

6. أوّل بيع

1. Caisse → فتح وردية برصيد ابتدائي
2. Point de Vente → اضغط F2 → ابحث عن دواء
3. Entrée → الإضافة للسلة
4. اختر نوع البيع (نقد / شفاء / إلخ)
5. F12 → تحصيل → الطباعة

7. نهاية اليوم

Caisse → 🔄 X (المعاينة) → عدّ النقد → ⏹ Z → اكتب المبلغ → النظام يحسب الفرق.

8. تفعيل العربية

Paramètres → Langue → العربية → احفظ → أعد التشغيل.

English — Quick start

1. Install

Run PharmaPro_Setup.exe and follow the wizard. No extra dependencies.

2. License

Note the displayed HWID, send it to your reseller, paste the received key, click Activer.

3. First login

• Username: admin
• Password: admin2026

Change it immediately from the Utilisateurs page.

4. Pharmacy settings

Paramètres → name, address, phone, low-stock threshold, expiry alert days.

5. Import catalog

python scripts/import_listing.py

Imports ~2100 drugs with an automatic backup.

6. First sale

1. Caisse → Open a shift with opening cash
2. Point de Vente → press F2 → search a drug
3. Enter → add to cart
4. Pick the sale type (Cash / Chifa / etc.)
5. F12 → cash out → print

7. End of day

Caisse → 🔄 X (preview) → physically count cash → ⏹ Z → enter counted amount → system shows variance.

8. Enable Arabic UI

Paramètres → Langue → العربية → save → restart.

Quick Start v1.0 — pour l'utilisateur pressé.