Aisge Gold Certificate

### Version

- Version actuelle : **1.1.0**
- Licence : **GPL-3.0-or-later**

### Compatibilité

- **Dolibarr 19.0.0 à 23.0.3** (compatibilité validée)

### Fonctionnalités principales

- Génération de certificats PDF à partir des données de facture
- Filtrage des lignes liées à l’or (règles par mots-clés)
- Inclusion des détails et des totaux (quantité, poids, montants)
- Prise en charge des formats PDF : **A4 / A5**
- QR code de vérification intégré au certificat
- Vérification anti-fraude via URL signée (`ref + sig`)
- Support multilingue :
  - zh_CN
  - en_US
  - fr_FR
- Paramétrage du comportement et de la mise en page depuis l’administration

### Configuration

Après activation du module dans Dolibarr, configurez-le depuis la page de paramètres du module.

Paramètres typiques :
- Règles de mots-clés (or/type)
- Comportement une facture = un certificat
- Format PDF et options de mise en page
- Paramètres de typographie (titre/corps/pied/signature)

Paramètres de vérification (obligatoires pour QR anti-fraude) :
- `AISGEGOLDCERT_VERIFY_BASEURL`  
- `AISGEGOLDCERT_SIGN_SECRET`  
  Secret de signature HMAC (à conserver confidentiel)

### Utilisation

1. Activer le module dans Dolibarr.
2. Configurer les paramètres dans la page de setup.
3. Ouvrir une facture client.
4. Générer un certificat via le workflow du module.
5. Télécharger / imprimer le PDF généré.
6. Scanner le QR code pour vérifier le certificat

### Vérification anti-fraude

- Le QR code contient une URL signée avec :
  - `ref` (référence certificat)
  - `sig` (signature)
- La page `verify` retourne un statut :
  - **valide**
  - **invalide**
  - **suspect / altéré**
- Compatibilité conservée avec les anciens QR via paramètre `token` (fallback).

### Remarques

- Cette version se concentre sur une génération PDF stable à partir du contenu des factures.
- Vérifiez que les informations société dans Dolibarr sont correctement renseignées pour un rendu correct de l’en-tête et du pied de page.
- Pour un contrôle interne renforcé, il est recommandé d’imposer la connexion Dolibarr pour accéder à `verify`.

### Journal des modifications (v1.1.0)

- Amélioration du rendu des certificats et de la cohérence de mise en page
- Ajustements d’affichage pour les formats A4 et A5
- Amélioration du formatage du bloc d’informations société
- Renforcement des paramètres visuels configurables (polices, tailles)
- Intégration d’un QR code de vérification signé (`ref + sig`)
- Ajout/ajustement du flux de vérification
- Compatibilité avec ancien paramètre `token`
- Améliorations globales de stabilité et de compatibilité

### Support

- Société : Aisge technology
- Site web : https://www.aisge.fr
- Email : contact@aisge.fr

Regardez la vidéo de démonstration: https://www.youtube.com/watch?v=o6F6zw7EcsI