# Suivi facturation / échéancier (POC EMGI) Application de suivi facturation et échéancier de paiement — remplacement Excel pour l’équipe commerciale. La facturation (émission des factures, PDF) provient de **Pennylane** ; l’appli sert au suivi (saisie manuelle des factures pour encours, paiements, écheanciers). ## Démo sans base (mode mock) Aucune config, pas de MySQL. Depuis le dossier `app` : ```bash cd app php -S localhost:8080 ``` Ouvre http://localhost:8080 — les données viennent de `mock/*.json`. Pour utiliser la vraie base, crée `.env` (copie de `.env.example`), mets `MOCK_MODE=0` et configure DB_*. ## Prérequis (mode base) - PHP 7.4+ (avec extensions `pdo`, `pdo_mysql`, `json`) - MariaDB ou MySQL ## Installation (mode base) 1. Créer la base et importer le schéma : ```bash mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS bmad CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;" mysql -u root -p bmad < sql/schema.sql ``` 2. Configurer l’accès DB : ```bash cp .env.example .env # Éditer .env : DB_HOST, DB_NAME, DB_USER, DB_PASS ``` 3. Démarrer le serveur PHP (depuis le dossier `app/`) : ```bash php -S localhost:8080 ``` 4. Ouvrir dans le navigateur : [http://localhost:8080](http://localhost:8080) ## Structure - `api/` — API REST PHP (clients, factures GET/POST, paiements, calculs, reporting, top-clients, quantites-clients) - `js/` — Scripts front (liste clients, détail client, formulaire ajout facture, paiements, tableau de bord, top clients, quantités par client) - `sql/schema.sql` — Schéma : `clients`, `factures` (type_produit, cycle, qte_livree), `paiements` - Pages : index (clients), client (détail + ajout facture + paiement), dashboard, top-clients, quantites-clients ## Données de test (optionnel) ```sql INSERT INTO clients (nom) VALUES ('Client A'), ('Client B'); INSERT INTO factures (client_id, n_facture, n_vente, date_facture, montant_ht) VALUES (1, 'FA-001', 'V1', '2026-01-15', 1000), (1, 'FA-002', 'V2', '2026-02-01', 500); INSERT INTO paiements (facture_id, montant, date_paiement) VALUES (1, 500, '2026-02-01'); ``` ## Export - Tableau de bord : lien « Exporter CSV » pour télécharger l’encours par client. - API : `GET /api/reporting.php?format=csv` pour le même export.