Integrations

codex# Services et intégrations

Services applicatifs¶

StockService : opérations et cohérence du stock.
DeferredSalePaymentService : règlement des ventes différées.
DataTableService, SearchService : listes et recherches.
PdfService, ProductExportService, SaleExportService : documents et exports.
ConfigService, FeatureService, PosService : configuration et communication Business.
MailerService : notifications email.
SmsService : envoi SMS.
UploaderService : stockage des fichiers.
RefreshTokenService : cycle de vie des refresh tokens.

Email¶

MailerService construit des TemplatedEmail et utilise le transport défini par MAILER_DSN. Les erreurs de transport sont capturées localement et traduites en résultat booléen. Il n’existe actuellement ni cache persistant des échecs, ni file Messenger, ni retry automatique.

Le fonctionnement détaillé, les limites et les recommandations d’exploitation sont décrits dans Gestion des erreurs d’email.

Upload et compression des images¶

Lors de la création ou de la modification d’un produit, l’image passe par UploaderService::uploadImageCompressed(). Elle est redimensionnée avec GD, convertie en JPEG progressif et enregistrée sous un nom unique.

Voir Compression des images produit pour l’algorithme exact et ses cas de repli.

SMS MySMS¶

SmsService appelle :

POST {SMS_API_BASE_URL}/messages
Authorization: Bearer {SMS_API_KEY}

Corps :

{
  "sender": "Bconnect",
  "body": "Message",
  "contacts": [],
  "groups": [],
  "manualRecipients": ["+224620000000"]
}

La planification n’est pas utilisée. Les appels métier doivent fournir des numéros internationaux normalisés.

Subscribers¶

Les subscribers gèrent notamment les alertes de stock, les mouvements de fonds après vente, les changements de statut de paiement, les annulations et les informations ajoutées au JWT.

Un effet secondaire critique doit être idempotent : une nouvelle exécution ne doit pas doubler un mouvement de fonds, un paiement ou une notification.