augustin.podvin 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
..
api 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
js 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
mock 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
sql 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
.env.example 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
.gitignore 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
INSTALL.md 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
ONBOARDING-STAGIAIRE.md 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
README.md 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
client.html 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
dashboard.html 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
index.html 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
quantites-clients.html 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад
top-clients.html 617d63da8e Initial: PDF planning, maquettes (doc projet), app 9 месяцев назад

README.md

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 :

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 :

    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 :

    cp .env.example .env
    # Éditer .env : DB_HOST, DB_NAME, DB_USER, DB_PASS
    
  3. Démarrer le serveur PHP (depuis le dossier app/) :

    php -S localhost:8080
    
  4. Ouvrir dans le navigateur : 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)

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.