PharmApp est une application web moderne et complète de gestion de pharmacie développée avec Laravel et Filament. Elle offre une solution intégrée pour la gestion des stocks, des ventes, des fournisseurs et la facturation, avec une interface utilisateur intuitive et des fonctionnalités avancées comme le scan de codes-barres.

• Catalogue complet : DCI, dosage, forme pharmaceutique
• Codes-barres : Identification rapide des médicaments
• Gestion des prix : Prix d'achat et de vente
• Suivi des stocks : Alertes de stock minimum automatiques
• Traçabilité : Dates d'expiration et numéros de lot
• Images : Support des photos de produits

• Scanner de codes-barres intégré en temps réel
• Interface de caisse moderne et responsive
• Calcul automatique : TVA (20%), remises, totaux
• Gestion des paiements : Montants reçus et calcul de monnaie
• Validation : Vérification automatique des stocks

• Historique complet des transactions
• Détails des ventes : Articles, quantités, prix
• Génération de factures PDF avec QR codes
• Suivi des performances de vente

• Mouvements automatiques : Entrées/sorties de stock
• Historique détaillé : Achats, ventes, pertes, ajustements
• Alertes intelligentes : Notifications de stock faible
• Mise à jour en temps réel lors des ventes

• Informations légales : SIRET, numéro de licence
• Coordonnées complètes : Adresse, téléphone, email
• Personnalisation : Logo et pied de page des factures

• Authentification sécurisée
• Système de rôles et permissions (Spatie)
• Contrôle d'accès granulaire

• Base de données fournisseurs
• Liaison avec les produits
• Historique des commandes

• Backend : Laravel 12.x (PHP 8.2+)
• Interface Admin : Filament 3.x
• Composants Interactifs : Livewire 3.x
• Base de données : SQLite (configurable)
• PDF Generation : DomPDF
• QR Codes : SimpleSoftwareIO QrCode
• Permissions : Spatie Laravel Permission
• Frontend : Vite + TailwindCSS

• PHP 8.2 ou supérieur
• Composer
• Node.js et npm
• Extension PHP SQLite (ou MySQL/PostgreSQL)
• Extension PHP GD (pour les QR codes)

git clone https://github.com/Ultra2000/pharmapp
cd pharmapp

composer install

npm install

cp .env.example .env
php artisan key:generate

Modifier le fichier .env selon vos besoins :

DB_CONNECTION=sqlite
DB_DATABASE=database/database.sqlite

php artisan migrate --seed

php artisan make:filament-user

npm run build

# Démarrer tous les services en parallèle
composer run dev

# Ou individuellement :
php artisan serve
npm run dev
php artisan queue:work

php artisan config:cache
php artisan route:cache
php artisan view:cache
npm run build

• Interface Admin : http://localhost:8000/admin
• Point de Vente : http://localhost:8000/admin/cash-register-page

1. Connectez-vous avec votre compte administrateur
2. Configurez les informations de votre pharmacie
3. Ajoutez vos fournisseurs
4. Importez ou créez votre catalogue de produits
5. Commencez à vendre !

Pour utiliser le scanner de codes-barres, assurez-vous que :

• Votre navigateur supporte l'API Camera
• L'application est servie en HTTPS (requis pour l'accès à la caméra)

Les factures sont générées automatiquement en PDF avec :

• Informations de la pharmacie
• Détails de la vente
• QR code pour vérification
• Mentions légales

L'application utilise Filament pour offrir :

• Interface moderne et responsive
• Tableaux de données interactifs
• Formulaires intelligents avec validation
• Notifications en temps réel
• Dashboard avec statistiques

• Authentification Laravel Sanctum
• Validation des données côté serveur
• Protection CSRF
• Contrôle d'accès basé sur les rôles
• Logs d'activité des utilisateurs

# Visualiser les logs en temps réel
php artisan pail

# Ou consulter les fichiers de logs
tail -f storage/logs/laravel.log

php artisan test

app/
├── Filament/           # Ressources Filament (admin)
├── Http/Controllers/   # Contrôleurs HTTP
├── Livewire/          # Composants Livewire (POS)
├── Models/            # Modèles Eloquent
├── Services/          # Services métier
└── Policies/          # Politiques d'autorisation

database/
├── migrations/        # Migrations de base de données
└── seeders/          # Données de test

resources/
├── views/            # Templates Blade
└── css/js/           # Assets frontend

Les contributions sont les bienvenues ! Pour contribuer :

1. Forkez le projet
2. Créez une branche feature (git checkout -b feature/nouvelle-fonctionnalite)
3. Committez vos changements (git commit -am 'Ajout nouvelle fonctionnalité')
4. Pushez vers la branche (git push origin feature/nouvelle-fonctionnalite)
5. Ouvrez une Pull Request

• Gestion complète des produits et stocks
• Point de vente avec scanner de codes-barres
• Génération de factures PDF
• Interface d'administration Filament
• Système de permissions utilisateur

Si vous rencontrez des problèmes :

1. Vérifiez les issues existantes
2. Créez une nouvelle issue avec :
   • Description détaillée du problème
   • Étapes pour reproduire
   • Version de PHP/Laravel
   • Logs d'erreur

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

Développé avec ❤️ par Fréjus BOURAIMA pour moderniser la gestion pharmaceutique.

⭐ N'oubliez pas de donner une étoile si ce projet vous aide !