dynors-media - Hub Central de Stockage

Service interne DYNORS - Stockage centralisé de tous les fichiers

🎯 Objectif

dynors-media est le hub central de stockage pour TOUT l'écosystème DYNORS. Il gère tous les types de fichiers (images, documents, PDF, audio, vidéo) pour toutes les applications (FISCAL, RAGNAR, YOBALÉ, DAWALALE, etc.).

Principe Fondamental

┌────────────────────────────────────────────┐
│  UN SEUL SERVICE pour TOUS les fichiers    │
│  Pas d'exception. Pas de stockage custom.  │
└────────────────────────────────────────────┘

📋 Informations Générales

Propriété	Valeur
Nom	dynors-media
Type	Service interne (webservice)
Domaine	Stockage, CRUD médias
Port	8085
Repository	`dynors-internal/applications/media`
Status	⏳ MVP Phase 1

🏗️ Architecture

Stack Technique

Backend : Java 17, Spring Boot 3.2
Base de données : PostgreSQL 15
Cache : Redis 7
Storage : MinIO (dev/staging), S3 (production)
Modules CORE : commons, security, db

Types de Fichiers Supportés

Catégorie	Types	Usage typique
Images	JPG, PNG, GIF, WebP, SVG	Logos clients, photos livraison
Documents	PDF, DOC, DOCX, XLS, XLSX	Factures, contrats, documents permis
Audio	MP3, WAV, OGG, M4A	Podcasts, enregistrements
Vidéo	MP4, AVI, MOV, WebM	Tutorials, formations
Autres	ZIP, RAR, TXT, CSV, JSON	Archives, données

✨ Fonctionnalités Principales

CRUD Complet

1. CREATE (Upload/Déposer)

✅ Upload fichier simple
✅ Upload multiple (batch)
✅ Validation types MIME
✅ Validation taille
✅ Checksum MD5 (intégrité)

2. READ (Récupérer/Chercher)

✅ Récupérer par ID
✅ Récupérer par code (logo-client-X)
✅ Recherche (nom, type, tags)
✅ URLs publiques/privées
✅ Presigned URLs (accès temporaire)

3. UPDATE (Modifier)

✅ Mise à jour métadonnées
⏳ Optimisation images (resize, compression)
⏳ Génération thumbnails

4. DELETE (Supprimer)

✅ Soft delete (archivage)
✅ Restauration possible
⏳ Hard delete (après X jours)

🔄 Intégrations

Consommateurs

Application	Usage	Exemples
FISCAL	Logos clients + PDFs factures	`logo-client-teranga`, `facture-INV-2025-001.pdf`
dynors-pdf	Logos dans templates	Logo dans facture PDF
YOBALÉ	Photos livraison	Pickup, delivery, signature
DAWALALE	Documents permis	Dossiers candidats, pièces d'identité
RAGNAR	Contrats, documents	Contrats clients signés

📊 Modèle de Données

FileMetadata

@Entity
public class FileMetadata {
    private UUID id;
    private String tenantCode;           // Isolation tenant
    private String code;                 // Code unique (ex: "logo-client-teranga")
    private String filename;             // facture-001.pdf
    private String originalFilename;     // Nom original uploadé
    private String mimeType;             // image/jpeg, application/pdf
    private MediaType type;              // IMAGE, DOCUMENT, AUDIO, VIDEO
    private long size;                   // Bytes
    private String storagePath;          // Chemin MinIO/S3
    private String publicUrl;            // URL publique (si public)
    private boolean isPublic;            // Accès public ou privé
    private String checksum;             // MD5 (intégrité)

    // Source Tracking (CRITIQUE pour stats)
    private String sourceApplication;    // "fiscal", "yobale", "ragnar"
    private String sourceVersion;        // "1.0.0"
    private String sourceInstance;       // "fiscal-pod-3"

    // Relations
    private String entityType;           // "invoice", "delivery", "contract"
    private String entityId;             // ID entité métier

    // Métadonnées custom
    private Map<String, String> metadata;
    private List<String> tags;

    // Audit
    private LocalDateTime uploadedAt;
    private UUID uploadedBy;
    private LocalDateTime deletedAt;     // Soft delete
}

🔐 Sécurité & Quotas

Multi-tenancy

Isolation stricte par tenantCode
Storage dédié par tenant
Pas de fuite entre tenants

Quotas

Tier	Storage	Max File Size
FREE	100 MB	5 MB
TIER_3	500 MB	10 MB
TIER_2	1 GB	20 MB
TIER_1	5 GB	50 MB
SOVEREIGN	∞	100 MB

Authentification

JWT obligatoire
Header : X-Tenant-Code requis
Permissions : Lecture/Écriture par tenant

🚀 Flux Métier Exemples

Cas 1 : FISCAL génère facture PDF

1. FISCAL → dynors-media : GET /api/media/by-code/logo-client-teranga
   (Récupère logo client)
   ↓
2. FISCAL → dynors-pdf : génère PDF avec logo
   ↓
3. FISCAL → dynors-media : POST /api/media/upload
   Body: {
     file: facture-INV-2025-001.pdf,
     code: "facture-INV-2025-001",
     sourceApplication: "fiscal"
   }
   ↓
4. dynors-media : stocke PDF + retourne URL

Cas 2 : YOBALÉ upload photos livraison

1. YOBALÉ → dynors-media : POST /api/media/upload/bulk
   Body: {
     files: [pickup.jpg, delivery.jpg, signature.jpg],
     metadata: {
       deliveryId: "DEL-123",
       sourceApplication: "yobale"
     }
   }
   ↓
2. dynors-media : stocke 3 fichiers + retourne URLs

📚 API REST

Endpoints Principaux

Méthode	Endpoint	Description
`POST`	`/api/media/upload`	Upload fichier
`POST`	`/api/media/upload/bulk`	Upload multiple
`GET`	`/api/media/{id}`	Récupérer par ID
`GET`	`/api/media/by-code/{code}`	Récupérer par code
`GET`	`/api/media/search`	Recherche (query params)
`DELETE`	`/api/media/{id}`	Soft delete
`GET`	`/api/media/quotas`	Consulter quotas tenant

Exemple Upload

curl -X POST http://localhost:8085/api/media/upload \
  -H "Authorization: Bearer <JWT>" \
  -H "X-Tenant-Code: teranga-cereales" \
  -F "file=@logo.png" \
  -F "code=logo-client-teranga" \
  -F "description=Logo client Teranga"

📊 Source Tracking (Stats)

Chaque fichier uploadé inclut :

source_application : App qui a uploadé (fiscal, yobale, ragnar)
source_version : Version de l'app
source_instance : Instance (pour load balancing)

Usage : Identifier quelles apps génèrent le plus de fichiers, détecter goulots d'étranglement.

🎯 Roadmap

✅ Phase 1 : MVP (En cours)

✅ Upload/Download basique
✅ Multi-tenant strict
✅ Quotas enforced
✅ Source tracking
✅ Checksum validation
⏳ Storage MinIO

📋 Phase 2 : Features Avancées

Thumbnails automatiques (images)
Optimisation images (resize, compression)
Recherche full-text
Presigned URLs expirables
Webhooks (upload completed)

📋 Phase 3 : Production

Storage S3/Azure Blob
CDN pour fichiers publics
Versioning fichiers
Backup automatique

🚀 Démarrage Rapide

Infrastructure Locale

cd dynors-internal/applications/media/backend
docker-compose up -d  # Lance PostgreSQL + Redis + MinIO

Backend

./gradlew bootRun

URL : http://localhost:8085
Health : http://localhost:8085/actuator/health
MinIO Console : http://localhost:9001

📚 Documentation

README : dynors-internal/applications/media/README.md
QUICKSTART : dynors-internal/applications/media/QUICKSTART.md
Plan développement : PLAN_DEVELOPPEMENT_DYNORS_MEDIA.md
Architecture : core/ARCHITECTURE_DYNORS_MEDIA.md
Guide intégration : core/GUIDE_INTEGRATION_DYNORS_MEDIA.md

👥 Équipe

Product Owner : Direction DYNORS
Tech Lead : À définir
Développeurs : Équipe DYNORS

📞 Contact

Support : support@dynors.com
Issues : GitLab dynors-internal/media

Dernière mise à jour : 30 janvier 2026