# Tessera — vendre un accès en ligne depuis votre site (PEREL) · v0.2.2

Un bouton « Acheter » sur votre site → une page d'achat → le paiement → une commande et une facture payée dans Dolibarr → l'accès livré par e-mail. Sans boutique en ligne à installer.

## Le parcours de l'acheteur

1. Il clique sur « Acheter » sur votre site et arrive sur la **page d'achat** de l'offre : quantité, nom, e-mail, « Pour qui ? » (si l'offre le demande), CGV, accord pour l'accès immédiat.
2. Tessera retrouve son tiers par l'e-mail (ou le crée comme particulier) et crée une **commande validée**.
3. Il paie avec ce qui est **déjà configuré dans Dolibarr** : la page de paiement en ligne de Dolibarr affiche les modules activés (Stripe, PayPal…). Dolibarr crée la facture, la valide et enregistre le règlement. Tessera n'a aucune clé de paiement à lui.
   En option, **virement sur facture** (désactivé par défaut, éventuellement à partir d'un montant) : la facture part tout de suite avec le RIB, l'accès part quand le règlement est saisi.
4. Il arrive sur sa **page d'achat** (codes, liens, téléchargements, facture) et reçoit l'**e-mail de livraison** : l'accès, la confirmation de commande (vendeur, prix, accord pour l'exécution immédiate), la facture en pièce jointe. Le lien de l'e-mail ramène à sa page à tout moment.

## Ce qu'on peut vendre (livraisons)

- **Lien web** : formation, vidéo, espace membre… `{email}`, `{ref}` et `{token}` sont remplacés dans l'adresse.
- **Fichier à télécharger** : joint à l'e-mail jusqu'à 8 Mo, toujours téléchargeable depuis la page de l'acheteur.
- **Enquête Ludus** (si le module Ludus est activé) : un code de jeu par exemplaire, avec sa convocation PDF.

Un autre module peut ajouter sa livraison : fichier `/<module>/class/TesseraProvider<Module>.class.php`, classe qui étend `TesseraProvider`. Elle n'apparaît que si ce module est activé.

## Installation

1. Configuration → Modules → **Déployer/installer un module externe** → envoyer `module_tessera-0.2.2.zip`.
2. Activer **Tessera** (active aussi Tiers, Commandes, Factures et Services s'ils ne le sont pas).
3. Activer et configurer un module de paiement en ligne de Dolibarr (Stripe, PayPal…) avec son compte bancaire. Pour le virement : un compte bancaire avec IBAN.
4. Tessera → Configuration : lien des CGV, mentions légales, couleur, expéditeur des e-mails.
5. Créer un **produit ou service** Dolibarr (prix TTC, TVA), puis Tessera → Offres → **Nouvelle offre** : le produit + ce que reçoit l'acheteur.
6. Sur la fiche de l'offre, copier l'adresse de la page d'achat (ou le bouton HTML) dans votre site.

## Tester

- Stripe en mode test, carte `4242 4242 4242 4242`, date future, n'importe quel CVC.
- Vérifier : commande « Facturée », facture « Payée », règlement en banque, e-mail reçu avec la facture, codes ou fichier sur la page de l'acheteur.

## Suivi (Tessera → Ventes en ligne)

- Indicateurs : ventes payées, chiffre d'affaires, ventes en attente, e-mails non partis.
- Actions : renvoyer l'e-mail, relancer une livraison, livrer une vente payée autrement, annuler une vente en attente, **retirer l'accès** après un remboursement (codes refusés, parties Ludus en cours arrêtées).
- Un règlement saisi à la main sur la facture d'une vente déclenche aussi la livraison.

## Points techniques

- Pages publiques : `public/buy.php?o=<réf>`, `public/thanks.php?t=<jeton>`. Multisociété : `&entity=N`.
- Déclencheurs : `PAYMENTONLINE_PAYMENT_OK` (commande payée en ligne → livraison, puis renvoi de l'acheteur vers sa page) et `BILL_PAYED` (facture soldée → livraison).
- États : En attente → Payée → Livraison en cours → Livrée, ou Livraison en échec (motif conservé). « Livrée » n'est posé qu'une fois l'accès réellement produit.
- Reprise automatique : tâche planifiée toutes les 15 min (5 essais), et à chaque visite de la page de l'acheteur.
- Chaque étape passe par un changement d'état atomique : retour de l'acheteur, déclencheurs et tâche planifiée peuvent arriver dans n'importe quel ordre sans double livraison.
- E-mails sur le gabarit PEREL, modifiables dans Tessera → Modèles d'e-mails (aperçu, envoi de test, retour au modèle par défaut).

## Nouveautés 0.2.2

- **Vendeur non assujetti à la TVA** (franchise en base) : si la société est réglée « Non assujetti à la TVA » dans Dolibarr (Configuration → Société), la page d'achat et les e-mails n'affichent plus « TTC » et ajoutent « TVA non applicable, art. 293 B du CGI ». La facture Dolibarr porte déjà cette mention d'elle-même.

## Nouveautés 0.2.1

- **Habillage des e-mails** (Réglages → E-mails, ou directement sur la page Modèles d'e-mails) : « Standard » (clair, couleur d'accent) ou **« Nuit & or »** — bleu nuit et or sur papier crème, titre en serif, bouton doré. S'applique aux modèles par défaut ; un modèle personnalisé garde sa mise en forme (« Rétablir le modèle par défaut » pour revenir à l'habillage).

## Nouveautés 0.2.0

- Numéro de module 493250 (mise à jour depuis 0.1 : déployer, désactiver puis réactiver le module).
- Plus de circuit Stripe propre à Tessera : uniquement le paiement en ligne de Dolibarr.
- Virement sur facture en option, avec montant minimum.
- Livraison fiabilisée (états intermédiaires, échec récupérable, reprise automatique) et retrait d'accès.
- Interface au niveau graphique de Legatus ; modèles d'e-mails modifiables.
- Limitation des tentatives sur la page d'achat (15 par heure et par adresse IP) et champ piège anti-robot.