feat: PHASE 5 COMPLÈTE - Gestion Documentaire
Service créé: - DocumentService: CRUD documents, enregistrement téléchargements, gestion pièces jointes - Validation qu'une seule relation est renseignée pour pièce jointe - Conversions DTO ↔ Entity complètes PHASE 5 - COMPLÉTÉE (100%): ✅ Entités: Document, PieceJointe ✅ Enum: TypeDocument (module API) ✅ Repositories: DocumentRepository, PieceJointeRepository ✅ DTOs: DocumentDTO, PieceJointeDTO ✅ Service: DocumentService avec validation ✅ Relations flexibles: Membre, Organisation, Cotisation, Adhesion, DemandeAide, TransactionWave Fonctionnalités: - Vérification intégrité avec MD5/SHA256 - Formatage taille fichiers - Compteur téléchargements - Validation relations pièces jointes Respect strict DRY/WOU: - Patterns cohérents avec autres modules - Gestion d'erreurs standardisée
This commit is contained in:
dahoud
@@ -0,0 +1,311 @@
|
||||
package dev.lions.unionflow.server.service;
|
||||
|
||||
import dev.lions.unionflow.server.api.dto.document.DocumentDTO;
|
||||
import dev.lions.unionflow.server.api.dto.document.PieceJointeDTO;
|
||||
import dev.lions.unionflow.server.entity.*;
|
||||
import dev.lions.unionflow.server.repository.*;
|
||||
import dev.lions.unionflow.server.service.KeycloakService;
|
||||
import jakarta.enterprise.context.ApplicationScoped;
|
||||
import jakarta.inject.Inject;
|
||||
import jakarta.transaction.Transactional;
|
||||
import jakarta.ws.rs.NotFoundException;
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.List;
|
||||
import java.util.UUID;
|
||||
import java.util.stream.Collectors;
|
||||
import org.jboss.logging.Logger;
|
||||
|
||||
/**
|
||||
* Service métier pour la gestion documentaire
|
||||
*
|
||||
* @author UnionFlow Team
|
||||
* @version 3.0
|
||||
* @since 2025-01-29
|
||||
*/
|
||||
@ApplicationScoped
|
||||
public class DocumentService {
|
||||
|
||||
private static final Logger LOG = Logger.getLogger(DocumentService.class);
|
||||
|
||||
@Inject DocumentRepository documentRepository;
|
||||
|
||||
@Inject PieceJointeRepository pieceJointeRepository;
|
||||
|
||||
@Inject MembreRepository membreRepository;
|
||||
|
||||
@Inject OrganisationRepository organisationRepository;
|
||||
|
||||
@Inject CotisationRepository cotisationRepository;
|
||||
|
||||
@Inject AdhesionRepository adhesionRepository;
|
||||
|
||||
@Inject DemandeAideRepository demandeAideRepository;
|
||||
|
||||
@Inject TransactionWaveRepository transactionWaveRepository;
|
||||
|
||||
@Inject KeycloakService keycloakService;
|
||||
|
||||
/**
|
||||
* Crée un nouveau document
|
||||
*
|
||||
* @param documentDTO DTO du document à créer
|
||||
* @return DTO du document créé
|
||||
*/
|
||||
@Transactional
|
||||
public DocumentDTO creerDocument(DocumentDTO documentDTO) {
|
||||
LOG.infof("Création d'un nouveau document: %s", documentDTO.getNomFichier());
|
||||
|
||||
Document document = convertToEntity(documentDTO);
|
||||
document.setCreePar(keycloakService.getCurrentUserEmail());
|
||||
|
||||
documentRepository.persist(document);
|
||||
LOG.infof("Document créé avec succès: ID=%s, Fichier=%s", document.getId(), document.getNomFichier());
|
||||
|
||||
return convertToDTO(document);
|
||||
}
|
||||
|
||||
/**
|
||||
* Trouve un document par son ID
|
||||
*
|
||||
* @param id ID du document
|
||||
* @return DTO du document
|
||||
*/
|
||||
public DocumentDTO trouverParId(UUID id) {
|
||||
return documentRepository
|
||||
.findByIdOptional(id)
|
||||
.map(this::convertToDTO)
|
||||
.orElseThrow(() -> new NotFoundException("Document non trouvé avec l'ID: " + id));
|
||||
}
|
||||
|
||||
/**
|
||||
* Enregistre un téléchargement de document
|
||||
*
|
||||
* @param id ID du document
|
||||
*/
|
||||
@Transactional
|
||||
public void enregistrerTelechargement(UUID id) {
|
||||
Document document =
|
||||
documentRepository
|
||||
.findByIdOptional(id)
|
||||
.orElseThrow(() -> new NotFoundException("Document non trouvé avec l'ID: " + id));
|
||||
|
||||
document.setNombreTelechargements(
|
||||
(document.getNombreTelechargements() != null ? document.getNombreTelechargements() : 0) + 1);
|
||||
document.setDateDernierTelechargement(LocalDateTime.now());
|
||||
document.setModifiePar(keycloakService.getCurrentUserEmail());
|
||||
|
||||
documentRepository.persist(document);
|
||||
}
|
||||
|
||||
/**
|
||||
* Crée une pièce jointe
|
||||
*
|
||||
* @param pieceJointeDTO DTO de la pièce jointe à créer
|
||||
* @return DTO de la pièce jointe créée
|
||||
*/
|
||||
@Transactional
|
||||
public PieceJointeDTO creerPieceJointe(PieceJointeDTO pieceJointeDTO) {
|
||||
LOG.infof("Création d'une nouvelle pièce jointe");
|
||||
|
||||
PieceJointe pieceJointe = convertToEntity(pieceJointeDTO);
|
||||
|
||||
// Vérifier qu'une seule relation est renseignée
|
||||
if (!pieceJointe.isValide()) {
|
||||
throw new IllegalArgumentException("Une seule relation doit être renseignée pour une pièce jointe");
|
||||
}
|
||||
|
||||
pieceJointe.setCreePar(keycloakService.getCurrentUserEmail());
|
||||
pieceJointeRepository.persist(pieceJointe);
|
||||
|
||||
LOG.infof("Pièce jointe créée avec succès: ID=%s", pieceJointe.getId());
|
||||
return convertToDTO(pieceJointe);
|
||||
}
|
||||
|
||||
/**
|
||||
* Liste toutes les pièces jointes d'un document
|
||||
*
|
||||
* @param documentId ID du document
|
||||
* @return Liste des pièces jointes
|
||||
*/
|
||||
public List<PieceJointeDTO> listerPiecesJointesParDocument(UUID documentId) {
|
||||
return pieceJointeRepository.findByDocumentId(documentId).stream()
|
||||
.map(this::convertToDTO)
|
||||
.collect(Collectors.toList());
|
||||
}
|
||||
|
||||
// ========================================
|
||||
// MÉTHODES PRIVÉES
|
||||
// ========================================
|
||||
|
||||
/** Convertit une entité Document en DTO */
|
||||
private DocumentDTO convertToDTO(Document document) {
|
||||
if (document == null) {
|
||||
return null;
|
||||
}
|
||||
|
||||
DocumentDTO dto = new DocumentDTO();
|
||||
dto.setId(document.getId());
|
||||
dto.setNomFichier(document.getNomFichier());
|
||||
dto.setNomOriginal(document.getNomOriginal());
|
||||
dto.setCheminStockage(document.getCheminStockage());
|
||||
dto.setTypeMime(document.getTypeMime());
|
||||
dto.setTailleOctets(document.getTailleOctets());
|
||||
dto.setTypeDocument(document.getTypeDocument());
|
||||
dto.setHashMd5(document.getHashMd5());
|
||||
dto.setHashSha256(document.getHashSha256());
|
||||
dto.setDescription(document.getDescription());
|
||||
dto.setNombreTelechargements(document.getNombreTelechargements());
|
||||
dto.setTailleFormatee(document.getTailleFormatee());
|
||||
dto.setDateCreation(document.getDateCreation());
|
||||
dto.setDateModification(document.getDateModification());
|
||||
dto.setActif(document.getActif());
|
||||
|
||||
return dto;
|
||||
}
|
||||
|
||||
/** Convertit un DTO en entité Document */
|
||||
private Document convertToEntity(DocumentDTO dto) {
|
||||
if (dto == null) {
|
||||
return null;
|
||||
}
|
||||
|
||||
Document document = new Document();
|
||||
document.setNomFichier(dto.getNomFichier());
|
||||
document.setNomOriginal(dto.getNomOriginal());
|
||||
document.setCheminStockage(dto.getCheminStockage());
|
||||
document.setTypeMime(dto.getTypeMime());
|
||||
document.setTailleOctets(dto.getTailleOctets());
|
||||
document.setTypeDocument(dto.getTypeDocument() != null ? dto.getTypeDocument() : dev.lions.unionflow.server.api.enums.document.TypeDocument.AUTRE);
|
||||
document.setHashMd5(dto.getHashMd5());
|
||||
document.setHashSha256(dto.getHashSha256());
|
||||
document.setDescription(dto.getDescription());
|
||||
document.setNombreTelechargements(dto.getNombreTelechargements() != null ? dto.getNombreTelechargements() : 0);
|
||||
|
||||
return document;
|
||||
}
|
||||
|
||||
/** Convertit une entité PieceJointe en DTO */
|
||||
private PieceJointeDTO convertToDTO(PieceJointe pieceJointe) {
|
||||
if (pieceJointe == null) {
|
||||
return null;
|
||||
}
|
||||
|
||||
PieceJointeDTO dto = new PieceJointeDTO();
|
||||
dto.setId(pieceJointe.getId());
|
||||
dto.setOrdre(pieceJointe.getOrdre());
|
||||
dto.setLibelle(pieceJointe.getLibelle());
|
||||
dto.setCommentaire(pieceJointe.getCommentaire());
|
||||
|
||||
if (pieceJointe.getDocument() != null) {
|
||||
dto.setDocumentId(pieceJointe.getDocument().getId());
|
||||
}
|
||||
if (pieceJointe.getMembre() != null) {
|
||||
dto.setMembreId(pieceJointe.getMembre().getId());
|
||||
}
|
||||
if (pieceJointe.getOrganisation() != null) {
|
||||
dto.setOrganisationId(pieceJointe.getOrganisation().getId());
|
||||
}
|
||||
if (pieceJointe.getCotisation() != null) {
|
||||
dto.setCotisationId(pieceJointe.getCotisation().getId());
|
||||
}
|
||||
if (pieceJointe.getAdhesion() != null) {
|
||||
dto.setAdhesionId(pieceJointe.getAdhesion().getId());
|
||||
}
|
||||
if (pieceJointe.getDemandeAide() != null) {
|
||||
dto.setDemandeAideId(pieceJointe.getDemandeAide().getId());
|
||||
}
|
||||
if (pieceJointe.getTransactionWave() != null) {
|
||||
dto.setTransactionWaveId(pieceJointe.getTransactionWave().getId());
|
||||
}
|
||||
|
||||
dto.setDateCreation(pieceJointe.getDateCreation());
|
||||
dto.setDateModification(pieceJointe.getDateModification());
|
||||
dto.setActif(pieceJointe.getActif());
|
||||
|
||||
return dto;
|
||||
}
|
||||
|
||||
/** Convertit un DTO en entité PieceJointe */
|
||||
private PieceJointe convertToEntity(PieceJointeDTO dto) {
|
||||
if (dto == null) {
|
||||
return null;
|
||||
}
|
||||
|
||||
PieceJointe pieceJointe = new PieceJointe();
|
||||
pieceJointe.setOrdre(dto.getOrdre() != null ? dto.getOrdre() : 1);
|
||||
pieceJointe.setLibelle(dto.getLibelle());
|
||||
pieceJointe.setCommentaire(dto.getCommentaire());
|
||||
|
||||
// Relation Document
|
||||
if (dto.getDocumentId() != null) {
|
||||
Document document =
|
||||
documentRepository
|
||||
.findByIdOptional(dto.getDocumentId())
|
||||
.orElseThrow(() -> new NotFoundException("Document non trouvé avec l'ID: " + dto.getDocumentId()));
|
||||
pieceJointe.setDocument(document);
|
||||
}
|
||||
|
||||
// Relations flexibles (une seule doit être renseignée)
|
||||
if (dto.getMembreId() != null) {
|
||||
Membre membre =
|
||||
membreRepository
|
||||
.findByIdOptional(dto.getMembreId())
|
||||
.orElseThrow(() -> new NotFoundException("Membre non trouvé avec l'ID: " + dto.getMembreId()));
|
||||
pieceJointe.setMembre(membre);
|
||||
}
|
||||
|
||||
if (dto.getOrganisationId() != null) {
|
||||
Organisation org =
|
||||
organisationRepository
|
||||
.findByIdOptional(dto.getOrganisationId())
|
||||
.orElseThrow(
|
||||
() ->
|
||||
new NotFoundException(
|
||||
"Organisation non trouvée avec l'ID: " + dto.getOrganisationId()));
|
||||
pieceJointe.setOrganisation(org);
|
||||
}
|
||||
|
||||
if (dto.getCotisationId() != null) {
|
||||
Cotisation cotisation =
|
||||
cotisationRepository
|
||||
.findByIdOptional(dto.getCotisationId())
|
||||
.orElseThrow(
|
||||
() -> new NotFoundException("Cotisation non trouvée avec l'ID: " + dto.getCotisationId()));
|
||||
pieceJointe.setCotisation(cotisation);
|
||||
}
|
||||
|
||||
if (dto.getAdhesionId() != null) {
|
||||
Adhesion adhesion =
|
||||
adhesionRepository
|
||||
.findByIdOptional(dto.getAdhesionId())
|
||||
.orElseThrow(
|
||||
() -> new NotFoundException("Adhésion non trouvée avec l'ID: " + dto.getAdhesionId()));
|
||||
pieceJointe.setAdhesion(adhesion);
|
||||
}
|
||||
|
||||
if (dto.getDemandeAideId() != null) {
|
||||
DemandeAide demandeAide =
|
||||
demandeAideRepository
|
||||
.findByIdOptional(dto.getDemandeAideId())
|
||||
.orElseThrow(
|
||||
() ->
|
||||
new NotFoundException(
|
||||
"Demande d'aide non trouvée avec l'ID: " + dto.getDemandeAideId()));
|
||||
pieceJointe.setDemandeAide(demandeAide);
|
||||
}
|
||||
|
||||
if (dto.getTransactionWaveId() != null) {
|
||||
TransactionWave transactionWave =
|
||||
transactionWaveRepository
|
||||
.findByIdOptional(dto.getTransactionWaveId())
|
||||
.orElseThrow(
|
||||
() ->
|
||||
new NotFoundException(
|
||||
"Transaction Wave non trouvée avec l'ID: " + dto.getTransactionWaveId()));
|
||||
pieceJointe.setTransactionWave(transactionWave);
|
||||
}
|
||||
|
||||
return pieceJointe;
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user