Aller au contenu

Besoins d’architecture — Fiscal, PDF, Media (fiscal, yobale, dawalale)

Objectif : Clarifier qui fournit quoi et qui consomme quoi (factures, PDF, media) pour fiscal, yobale et dawalale.

1. Rôles des services centraux

Service Rôle Consommateur typique
FISCAL Facturation multi‑juridiction : factures, numérotation, taxes, compliance, export (PDF, Factur‑X). RAGNAR (module Facturation), autres apps qui facturent
dynors-pdf Génération PDF (factures, devis, bordereaux, rapports). Mode SDK (lib) ou HOSTED (API). FISCAL, YOBALÉ, RAGNAR, DAWALALE
dynors-media Stockage centralisé de tous les fichiers (images, PDF, documents). FISCAL, YOBALÉ, DAWALALE, dynors-pdf, RAGNAR

2. Besoins par application

2.1 FISCAL (facturation)

Besoin Fournisseur Usage
Factures FISCAL lui‑même Crée et gère les factures (invoicing-core, tax, numbering, compliance).
PDF dynors-pdf (SDK ou API) Export des factures en PDF (templates par pays).
Media dynors-media Logos clients pour les PDF ; stockage des factures PDF générées.

État actuel (code) : - PDF : PdfExportService présent mais non implémenté (TODO, UnsupportedOperationException). FISCAL utilise iText7 en direct dans les deps, pas le module dynors-pdf. - Media : Aucune dépendance ni client vers dynors-media ; pas de récupération de logos ni de dépôt des PDF générés.

2.2 YOBALÉ (livraison)

Besoin Fournisseur Usage
Factures FISCAL (optionnel) Si YOBALÉ facture des clients (ex. abonnements, livraisons).
PDF dynors-pdf (mode SDK prévu) Bordereaux / reçus custom (ex. yobale-delivery-receipt).
Media dynors-media Central : photos livraison (pickup, delivery, signature), upload bulk. Cas d’usage pilote du plan dynors-media.

État actuel (code) : - Aucune dépendance vers dynors-pdf ni dynors-media dans yobale-api/build.gradle.kts. - Besoins décrits dans la doc (plan media, spec PDF hybride) mais non branchés dans l’app.

2.3 DAWALALE (auto‑école)

Besoin Fournisseur Usage
Factures FISCAL (optionnel) Si facturation formations / permis.
PDF dynors-pdf (optionnel) Attestations, rapports, documents officiels.
Media dynors-media Central : documents permis, dossiers candidats (DOC 4 – Dossier, analyse permis & frais).

État actuel (code) : - Aucune dépendance vers dynors-pdf ni dynors-media dans dawalale-api/build.gradle.kts. - Besoins documentés (ARCHITECTURE, INTEGRATION_DYNORS_CORE, plan media) mais non branchés dans l’app.

3. Synthèse : qui a besoin de quoi

App Fiscal (factures) PDF Media
FISCAL Fournit Besoin (export factures) Besoin (logos + stockage PDF)
YOBALÉ Optionnel Optionnel (bordereaux) Besoin (photos livraison)
DAWALALE Optionnel Optionnel (attestations) Besoin (documents permis)

4. Ce qui manque pour que l’archi soit “complète”

  1. FISCAL
  2. Implémenter ou déléguer l’export PDF (soit via dynors-pdf SDK/API, soit finaliser PdfExportService avec templates).

  3. Ajouter un client dynors-media (ou équivalent) pour logos et dépôt des PDF.

  4. YOBALÉ

  5. Déclarer et utiliser un client dynors-media (upload/download photos livraison).

  6. Si bordereaux PDF : ajouter dynors-pdf (mode SDK) et templates dédiés.

  7. DAWALALE

  8. Déclarer et utiliser un client dynors-media (documents permis / dossiers).

  9. Si attestations PDF : ajouter dynors-pdf (SDK ou API).

  10. Services centraux

  11. dynors-media : déployé et exposé (plan Phase 1 en cours) ; ensuite intégration côté fiscal, yobale, dawalale.
  12. dynors-pdf : SDK disponible dans dynors-extensions ; service HOSTED (dynors-pdf-service) optionnel ; FISCAL peut soit l’utiliser soit garder une implémentation interne cohérente avec les specs.

5. Références

  • FISCAL : dynors-internal/applications/fiscal/backend/ARCHITECTURE.md, README.md
  • dynors-pdf : core/GUIDE_INTEGRATION_DYNORS_PDF.md, core/SPEC_DYNORS_PDF_ARCHITECTURE_HYBRIDE.md
  • dynors-media : PLAN_DEVELOPPEMENT_DYNORS_MEDIA.md, dynors-internal/applications/media/README.md
  • Facturation vs FISCAL : docs/INVOICING_EXTENSIONS_VS_FISCAL.md
  • DAWALALE : dynors-projects/dawalale/docs/ARCHITECTURE.md, INTEGRATION_DYNORS_CORE.md
  • YOBALÉ : dynors-projects/yobale/, plan media (YOBALÉ comme premier client)