kbrdn1/dotfiles/devis-flippad

devis-flippad — devis commercial PDF (charte FLIPPAD/JEWELY)

Ce que produit la skill

Un devis PDF prêt à envoyer au client, reproduisant fidèlement la charte du modèle de référence : logo, blocs « Émetteur ou Émettrice » / « Client ou Cliente » en doré, métadonnées (numéro, dates, type de vente), titre de projet, tableau des lots avec sous-lignes détaillées, « Détails TVA », « Récapitulatif » avec Total TTC encadré en doré, et page 2 (CGV, mention « Bon pour accord » + zone signature, coordonnées de paiement). Pied de page : mentions légales + pagination sur chaque page.

Où elle s'insère

• devis-xlsx (autre skill) = estimation interne : charge en jours, fourchette

bas/haut, evidence-based, TJM en cellule. Outil de calcul/négociation.

• devis-flippad (cette skill) = livrable client : une fois les jours et le TJM

arrêtés, on met en forme le devis commercial.

Enchaînement typique : estimer avec devis-xlsx → figer une valeur ferme de jours par lot + le TJM → regrouper par lot fonctionnel → remplir le JSON → générer le PDF.

Comment générer

1. Choisir la variante de marque et copier l'exemple correspondant comme point

de départ (devis de référence déjà fonctionnel) :

• Jewely (doré + logo JEWELY) → references/exemple_jewely.json
• Flippad (orange #fc6c25 + logo Flippad) → references/exemple_flippad.json

La variante se pilote par le champ racine "brand": "jewely" | "flippad", qui fixe l'accent, le logo et le fond de l'encadré TTC. Toute valeur explicite (accent, emetteur.logo_img, emetteur.logo_bg) prime sur le preset. Voir aussi references/data_schema.md.

1. Garder l'émetteur stable (coordonnées, mentions légales, paiement, logo) ;

ne changer que meta, client, projet, lots, et au besoin cgv.

1. Chaque lot = intitule + sous_titre + jours + prix_unitaire + lignes

(réf. / description / acteurs / j·h). Le total HT du lot, le HT global, la TVA et le TTC sont calculés par le script — ne jamais les saisir.

1. Générer :

``bash python scripts/build_devis_pdf.py mon_devis.json /mnt/user-data/outputs/Devis_XXX.pdf ``

1. Vérifier visuellement : rasteriser et regarder le rendu avant de présenter —

``bash pdftoppm -png -r 150 -f 1 -l 1 /mnt/user-data/outputs/Devis_XXX.pdf /tmp/v ``

contrôler en-tête, totaux (HT = Σ lots, TVA, TTC), et le pied (mentions + pagination). Puis présenter via present_files.

Règles (cohérentes avec devis-xlsx)

• Jours × prix unitaire ; le prix_unitaire (TJM) est une donnée saisie, jamais

inventée. Aucun montant codé en dur : tout se déduit des jours et du TJM.

• Totaux calculés par le script (HT par lot, HT, TVA, TTC), jamais recopiés.
• Honnêteté pro : pas de marketing dans les libellés, pas de chiffre fantaisiste.
• Les jh par ligne sont informatifs et peuvent ne pas sommer au total du lot

(mutualisation) — conforme au modèle ; ne pas les « corriger » de force.

Moteur de rendu (déjà géré par le script)

Le rendu HTML→PDF utilise Chromium en headless via Playwright (page.pdf, format A4, marges T 12mm / B 20mm / L 12mm / R 12mm pilotées par l'API — prefer_css_page_size=False pour qu'elles priment sur le @page { margin: 0 } du template, print_background=True pour rendre les fonds dorés). Le bas de 20mm réserve la zone du pied.

Le pied (mentions légales + pagination i/n) est ensuite incrusté via un overlay reportlab/pypdf sur chaque page : ce mécanisme est indépendant du moteur et garantit un pied identique partout. Ne pas tenter de remettre le pied dans le HTML : utiliser l'overlay du script.

Dépendances : playwright (+ navigateur : python -m playwright install chromium), jinja2, reportlab, pypdf. Vérif visuelle : pdftoppm (poppler).

Note : l'implémentation d'origine utilisait wkhtmltopdf (build « unpatched qt »

qui ignore --footer-* et position:fixed, d'où l'overlay). Le moteur a été

remplacé par Chromium/Playwright — fiable, maintenu, sans binaire système non

signé ni Rosetta. L'architecture (corps + overlay du pied) est inchangée.

Variantes de marque & personnalisation

• `brand` (racine) : jewely (doré #BC8B2C + logos/jewely.jpeg) ou flippad

(orange #fc6c25 + logos/flippad.jpg). Presets définis dans scripts/build_devis_pdf.py (BRANDS). Le fond de l'encadré TTC reste sombre dans les deux cas (label = accent sur fond sombre, montant blanc).

• `accent` : couleur des titres, du thead du tableau et du container Paiement.
• `logo_img` : chemin d'image. Relatif → résolu depuis assets/ (ex.

"logos/flippad.jpg") ; absolu / http(s) / data: / file:// acceptés ; sinon logo CSS « carré + nom ». Logos fournis : assets/logos/{jewely.jpeg,flippad.jpg}.

• `ttc_bg` : héritage, plus utilisé (l'encadré TTC est noir, coins arrondis).

Le template est assets/devis_template.html.j2 (modifiable pour la mise en page).