Générer un PDF

pip install reportlab "qrcode[pil]"

import io, secrets, qrcode
from reportlab.lib.pagesizes import A4
from reportlab.lib.units import mm
from reportlab.lib.utils import ImageReader
from reportlab.pdfgen import canvas

def pdf_facture(facture, lignes, url_base: str) -> bytes:
    tampon = io.BytesIO()
    c = canvas.Canvas(tampon, pagesize=A4)
    c.setFont("Helvetica-Bold", 16)
    c.drawString(20 * mm, 275 * mm, f"Facture n° {facture.numero}")
    y = 255 * mm
    c.setFont("Helvetica", 10)
    for l in lignes:
        c.drawString(20 * mm, y, f"{l.reference} — {l.surface} m² × {l.tarif_m2:,.0f}")
        c.drawRightString(190 * mm, y, f"{l.montant:,.0f} GNF")
        y -= 7 * mm
    c.setFont("Helvetica-Bold", 12)
    c.drawRightString(190 * mm, y - 5 * mm, f"Total : {facture.montant:,.0f} GNF")
    qr = qrcode.make(f"{url_base}/verification/{facture.code_verif}")
    image = io.BytesIO(); qr.save(image, format="PNG"); image.seek(0)
    c.drawImage(ImageReader(image), 160 * mm, 15 * mm, 30 * mm, 30 * mm)
    c.save()
    return tampon.getvalue()

@router.get("/api/factures/{fid}/pdf")
def telecharger(fid: int, u = Depends(utilisateur_courant), s = Depends(session)):
    f = charger_facture_autorisee(s, fid, u)        # applique le cloisonnement
    return Response(pdf_facture(f, f.lignes, URL_PUBLIQUE), media_type="application/pdf",
                    headers={"Content-Disposition": f'inline; filename="facture-{f.numero}.pdf"'})

Le code de vérification

À l'émission : code_verif = secrets.token_urlsafe(16). Ce code aléatoire de 128 bits ne se devine pas, contrairement à un numéro de facture qui se suit.

@app.get("/api/verification/{code}")           # route publique
def verifier(code: str, s = Depends(session)):
    f = s.scalar(select(Facture).where(Facture.code_verif == code))
    if f is None:
        raise HTTPException(404, "Document inconnu")
    return {"type": "facture", "numero": f.numero, "emise_le": f.emise_le, "etat": f.statut}

La réponse ne contient ni montant, ni nom, ni adresse : juste de quoi confirmer l'authenticité. Dans le front, la page /verification/:code est en dehors de la zone protégée par la connexion : un scan depuis n'importe quel téléphone doit fonctionner. Limitez aussi le nombre de requêtes sur cette route.

Numérotation sans trou

Deux factures ne doivent jamais porter le même numéro, et la série ne doit pas avoir de trou. Une séquence PostgreSQL saute des numéros en cas d'annulation ; utilisez un compteur verrouillé dans la même transaction que l'émission :

compteur = s.scalar(select(Compteur).where(Compteur.annee == annee).with_for_update())
compteur.dernier += 1
facture.numero = f"{annee}-{compteur.dernier:05d}"