Aisge Gold Certificate

### Version

- Current version: **1.1.0**
- License: **GPL-3.0-or-later**

### Compatibility

- **Dolibarr 19.0.0 to 23.0.3** (validated)

### Main Features

- Generate certificate PDFs from invoice data
- Filter and include gold-related invoice lines (keyword-based rules)
- Include item details and totals (quantity, weight, amounts)
- PDF layout support: **A4 / A5**
- Embedded QR code on certificate
- Anti-fraud verification using signed URL (`ref + sig`)
- Multilingual support:
  - zh_CN
  - en_US
  - fr_FR
- Admin-configurable behavior and layout settings

### Configuration

After enabling the module in Dolibarr, configure it from the module setup page.

Typical settings include:
- Gold/type keyword rules
- One-invoice-one-certificate behavior
- PDF format and layout options
- Typography sizing options (title/body/footer/signature)

Verification settings (required for anti-fraud QR):
- `AISGEGOLDCERT_VERIFY_BASEURL`  
- `AISGEGOLDCERT_SIGN_SECRET`  
  HMAC signing secret (must be kept private)

### Usage

1. Enable the module in Dolibarr.
2. Configure module parameters in setup.
3. Open a customer invoice.
4. Generate a certificate from the module workflow.
5. Download/print the generated PDF.
6. Scan the QR code to verify certificate authenticity

### Anti-fraud Verification

- The QR code carries a signed URL with:
  - `ref` (certificate reference)
  - `sig` (signature)
- `verify` returns:
  - **valid**
  - **invalid**
  - **tampered**
- Backward compatibility with legacy `token` parameter is retained.

### Notes

- This release focuses on stable PDF certificate generation from invoice content.
- Ensure your company information in Dolibarr is correctly filled for proper certificate header/footer rendering.
- For stricter internal control, require authenticated Dolibarr users to access 

### Changelog (v1.1.0)

- Improved certificate rendering and layout consistency
- Added/adjusted A4 and A5 display behavior
- Improved company information block formatting
- Enhanced configurable font/visual parameters
- Added signed QR verification URL (`ref + sig`)
- Added/updated  verification flow
- Backward compatibility for legacy `token`
- General stability and compatibility refinements

### Support

- Company: Aisge technology
- Website: https://www.aisge.fr
- Email: contact@aisge.fr

Watch the demo video: https://www.youtube.com/watch?v=o6F6zw7EcsI