feat(signature): add signed document storage and management

This commit is contained in:
Fanilo-Nantenaina 2026-01-06 18:38:50 +03:00
parent ba4a9d4773
commit 9bc2a3f7c9
5 changed files with 762 additions and 1010 deletions

11
api.py
View file

@ -80,7 +80,7 @@ from utils.normalization import normaliser_type_tiers
from routes.sage_gateway import router as sage_gateway_router
from routes.universign import router as universign_router
from services.universign_sync import UniversignSyncService, UniversignSyncScheduler
from services.universign_sync import UniversignSyncService
from core.sage_context import (
get_sage_client_for_user,
@ -134,19 +134,10 @@ async def lifespan(app: FastAPI):
sage_client=sage_client, email_queue=email_queue, settings=settings
)
scheduler = UniversignSyncScheduler(
sync_service=sync_service,
interval_minutes=5,
)
sync_task = asyncio.create_task(scheduler.start(async_session_factory))
logger.info("Synchronisation Universign démarrée (5min)")
yield
scheduler.stop()
sync_task.cancel()
email_queue.stop()
logger.info("Services arrêtés")

View file

@ -145,6 +145,12 @@ class UniversignTransaction(Base):
)
webhook_received = Column(Boolean, default=False, comment="Webhook Universign reçu")
signed_document_path = Column(
Text, nullable=True, comment="Chemin local du document signé téléchargé"
)
signed_document_downloaded_at = Column(
DateTime, nullable=True, comment="Date de téléchargement du document signé"
)
# === RELATION ===
signers = relationship(
"UniversignSigner", back_populates="transaction", cascade="all, delete-orphan"

View file

@ -1,36 +1,48 @@
from fastapi import APIRouter, Depends, HTTPException, Query, Request
"""
Routes API Universign améliorées
Intègre la logique métier complète de gestion des signatures
"""
from fastapi import APIRouter, Depends, HTTPException, Path, Request
from fastapi.responses import FileResponse
from sqlalchemy.ext.asyncio import AsyncSession
from sqlalchemy import select, func
from sqlalchemy import select
from sqlalchemy.orm import selectinload
from typing import List, Optional
from typing import Optional
from datetime import datetime
from pydantic import BaseModel, EmailStr
import logging
from data.data import templates_signature_email
from email_queue import email_queue
from database import UniversignSignerStatus, UniversignTransactionStatus, get_session
import uuid
from database import (
UniversignTransaction,
UniversignSigner,
UniversignSyncLog,
LocalDocumentStatus,
SageDocumentType,
UniversignTransactionStatus,
UniversignSignerStatus,
get_session,
EmailLog,
StatutEmail,
)
from services.universign_sync import UniversignSyncService
from services.signed_documents import signed_documents
from config.config import settings
from email_queue import email_queue
from sage_client import sage_client
from data.data import templates_signature_email
from utils.generic_functions import normaliser_type_doc
from utils.universign_status_mapping import get_status_message
from database.models.email import EmailLog
from database.enum.status import StatutEmail
logger = logging.getLogger(__name__)
router = APIRouter(prefix="/universign", tags=["Universign"])
router = APIRouter(prefix="/universign", tags=["Universign Enhanced"])
sync_service = UniversignSyncService(
# Service de synchronisation amélioré
universign_sync = UniversignSyncService(
api_url=settings.universign_api_url, api_key=settings.universign_api_key
)
universign_sync.configure(
sage_client=sage_client, email_queue=email_queue, settings=settings
)
class CreateSignatureRequest(BaseModel):
@ -43,43 +55,29 @@ class CreateSignatureRequest(BaseModel):
document_name: Optional[str] = None
class TransactionResponse(BaseModel):
"""Réponse détaillée d'une transaction"""
id: str
transaction_id: str
sage_document_id: str
sage_document_type: str
universign_status: str
local_status: str
local_status_label: str
signer_url: Optional[str]
document_url: Optional[str]
created_at: datetime
sent_at: Optional[datetime]
signed_at: Optional[datetime]
last_synced_at: Optional[datetime]
needs_sync: bool
signers: List[dict]
class SyncStatsResponse(BaseModel):
"""Statistiques de synchronisation"""
total_transactions: int
pending_sync: int
signed: int
in_progress: int
refused: int
expired: int
last_sync_at: Optional[datetime]
@router.post("/signatures/create", response_model=TransactionResponse)
async def create_signature(
@router.post("/signatures/create-enhanced")
async def create_signature_enhanced(
request: CreateSignatureRequest, session: AsyncSession = Depends(get_session)
):
"""
Création de signature avec logique métier stricte:
- Vérifie le statut Sage actuel
- Ne met à jour à 1 QUE si statut = 0
- Crée la transaction Universign
- Envoie l'email de demande
"""
try:
# === VÉRIFICATION STATUT SAGE ACTUEL ===
doc = sage_client.lire_document(
request.sage_document_id, request.sage_document_type.value
)
if not doc:
raise HTTPException(404, f"Document {request.sage_document_id} introuvable")
statut_actuel = doc.get("statut", 0)
logger.info(f"📊 Statut Sage actuel: {statut_actuel}")
# === VÉRIFICATION DOUBLON ===
existing_query = select(UniversignTransaction).where(
UniversignTransaction.sage_document_id == request.sage_document_id,
@ -99,10 +97,10 @@ async def create_signature(
if existing_tx:
raise HTTPException(
400,
f"Une demande de signature est déjà en cours pour {request.sage_document_id} "
f"(transaction: {existing_tx.transaction_id}, statut: {existing_tx.local_status.value})",
f"Une demande de signature est déjà en cours pour {request.sage_document_id}",
)
# === GÉNÉRATION PDF ===
pdf_bytes = email_queue._generate_pdf(
request.sage_document_id, normaliser_type_doc(request.sage_document_type)
)
@ -112,10 +110,10 @@ async def create_signature(
# === CRÉATION TRANSACTION UNIVERSIGN ===
import requests
import uuid
auth = (settings.universign_api_key, "")
# 1. Créer transaction
resp = requests.post(
f"{settings.universign_api_url}/transactions",
auth=auth,
@ -132,6 +130,7 @@ async def create_signature(
universign_tx_id = resp.json().get("id")
# 2. Upload PDF
files = {
"file": (f"{request.sage_document_id}.pdf", pdf_bytes, "application/pdf")
}
@ -144,6 +143,7 @@ async def create_signature(
file_id = resp.json().get("id")
# 3. Attacher document
resp = requests.post(
f"{settings.universign_api_url}/transactions/{universign_tx_id}/documents",
auth=auth,
@ -156,6 +156,7 @@ async def create_signature(
document_id = resp.json().get("id")
# 4. Créer champ signature
resp = requests.post(
f"{settings.universign_api_url}/transactions/{universign_tx_id}/documents/{document_id}/fields",
auth=auth,
@ -168,6 +169,7 @@ async def create_signature(
field_id = resp.json().get("id")
# 5. Lier signataire
resp = requests.post(
f"{settings.universign_api_url}/transactions/{universign_tx_id}/signatures",
auth=auth,
@ -178,6 +180,7 @@ async def create_signature(
if resp.status_code not in [200, 201]:
raise HTTPException(500, "Erreur liaison signataire")
# 6. Démarrer transaction
resp = requests.post(
f"{settings.universign_api_url}/transactions/{universign_tx_id}/start",
auth=auth,
@ -189,6 +192,7 @@ async def create_signature(
final_data = resp.json()
# 7. Extraire URL de signature
signer_url = ""
if final_data.get("actions"):
for action in final_data["actions"]:
@ -233,7 +237,7 @@ async def create_signature(
session.add(signer)
await session.commit()
# === ENVOI EMAIL AVEC TEMPLATE ===
# === ENVOI EMAIL ===
template = templates_signature_email["demande_signature"]
type_labels = {
@ -244,7 +248,7 @@ async def create_signature(
50: "Avoir",
}
doc_info = email_queue.sage_client.lire_document(
doc_info = sage_client.lire_document(
request.sage_document_id, request.sage_document_type.value
)
montant_ttc = f"{doc_info.get('total_ttc', 0):.2f}" if doc_info else "0.00"
@ -288,45 +292,37 @@ async def create_signature(
email_queue.enqueue(email_log.id)
# === MISE À JOUR STATUT SAGE (Confirmé = 1) ===
try:
from sage_client import sage_client
# === MISE À JOUR STATUT SAGE (LOGIQUE STRICTE) ===
statut_sage_updated = False
if statut_actuel == 0:
try:
sage_client.changer_statut_document(
document_type_code=request.sage_document_type.value,
numero=request.sage_document_id,
nouveau_statut=1,
)
logger.info(
f"Statut Sage mis à jour: {request.sage_document_id} → Confirmé (1)"
nouveau_statut=1, # Confirmé
)
logger.info(f"✅ Statut Sage mis à jour: 0 → 1")
statut_sage_updated = True
except Exception as e:
logger.warning(f"Impossible de mettre à jour le statut Sage: {e}")
logger.warning(f"⚠️ Impossible de mettre à jour le statut Sage: {e}")
else:
logger.info(f" Statut Sage non modifié (était {statut_actuel}, ≠ 0)")
# === RÉPONSE ===
return TransactionResponse(
id=transaction.id,
transaction_id=transaction.transaction_id,
sage_document_id=transaction.sage_document_id,
sage_document_type=transaction.sage_document_type.name,
universign_status=transaction.universign_status.value,
local_status=transaction.local_status.value,
local_status_label=get_status_message(transaction.local_status.value),
signer_url=transaction.signer_url,
document_url=None,
created_at=transaction.created_at,
sent_at=transaction.sent_at,
signed_at=None,
last_synced_at=None,
needs_sync=True,
signers=[
{
"email": signer.email,
"name": signer.name,
"status": signer.status.value,
return {
"success": True,
"transaction_id": transaction.transaction_id,
"sage_document_id": transaction.sage_document_id,
"signer_url": transaction.signer_url,
"statut_sage_initial": statut_actuel,
"statut_sage_updated": statut_sage_updated,
"nouveau_statut_sage": 1 if statut_sage_updated else statut_actuel,
"message": (
f"Signature créée. Statut Sage: {statut_actuel}"
f"{1 if statut_sage_updated else statut_actuel}"
),
}
],
)
except HTTPException:
raise
@ -335,167 +331,108 @@ async def create_signature(
raise HTTPException(500, str(e))
@router.get("/transactions", response_model=List[TransactionResponse])
async def list_transactions(
status: Optional[LocalDocumentStatus] = None,
sage_document_id: Optional[str] = None,
limit: int = Query(100, le=1000),
session: AsyncSession = Depends(get_session),
@router.post("/webhook-enhanced")
@router.post("/webhook-enhanced/")
async def webhook_universign_enhanced(
request: Request, session: AsyncSession = Depends(get_session)
):
"""Liste toutes les transactions"""
query = select(UniversignTransaction).options(
selectinload(UniversignTransaction.signers)
)
"""
Webhook Universign amélioré:
- Détecte l'événement 'closed' (signature complétée)
- Télécharge automatiquement le document signé
- Met à jour le statut Sage à 2
- Envoie la notification avec lien de téléchargement
"""
try:
payload = await request.json()
if status:
query = query.where(UniversignTransaction.local_status == status)
event_type = payload.get("event")
transaction_id = payload.get("transaction_id") or payload.get("id")
if sage_document_id:
query = query.where(UniversignTransaction.sage_document_id == sage_document_id)
logger.info(f"📨 Webhook reçu: event={event_type}, tx={transaction_id}")
query = query.order_by(UniversignTransaction.created_at.desc()).limit(limit)
if not transaction_id:
return {"status": "error", "message": "Pas de transaction_id"}, 400
result = await session.execute(query)
transactions = result.scalars().all()
return [
TransactionResponse(
id=tx.id,
transaction_id=tx.transaction_id,
sage_document_id=tx.sage_document_id,
sage_document_type=tx.sage_document_type.name,
universign_status=tx.universign_status.value,
local_status=tx.local_status.value,
local_status_label=get_status_message(tx.local_status.value),
signer_url=tx.signer_url,
document_url=tx.document_url,
created_at=tx.created_at,
sent_at=tx.sent_at,
signed_at=tx.signed_at,
last_synced_at=tx.last_synced_at,
needs_sync=tx.needs_sync,
signers=[
{
"email": s.email,
"name": s.name,
"status": s.status.value,
"signed_at": s.signed_at.isoformat() if s.signed_at else None,
}
for s in tx.signers
],
)
for tx in transactions
]
@router.get("/transactions/{transaction_id}", response_model=TransactionResponse)
async def get_transaction(
transaction_id: str, session: AsyncSession = Depends(get_session)
):
"""Récupère une transaction par son ID"""
# Récupérer la transaction locale
query = (
select(UniversignTransaction)
.where(UniversignTransaction.transaction_id == transaction_id)
.options(selectinload(UniversignTransaction.signers))
)
result = await session.execute(query)
tx = result.scalar_one_or_none()
if not tx:
raise HTTPException(404, "Transaction introuvable")
return TransactionResponse(
id=tx.id,
transaction_id=tx.transaction_id,
sage_document_id=tx.sage_document_id,
sage_document_type=tx.sage_document_type.name,
universign_status=tx.universign_status.value,
local_status=tx.local_status.value,
local_status_label=get_status_message(tx.local_status.value),
signer_url=tx.signer_url,
document_url=tx.document_url,
created_at=tx.created_at,
sent_at=tx.sent_at,
signed_at=tx.signed_at,
last_synced_at=tx.last_synced_at,
needs_sync=tx.needs_sync,
signers=[
{
"email": s.email,
"name": s.name,
"status": s.status.value,
"signed_at": s.signed_at.isoformat() if s.signed_at else None,
}
for s in tx.signers
],
)
@router.post("/transactions/{transaction_id}/sync")
async def sync_single_transaction(
transaction_id: str,
force: bool = Query(False),
session: AsyncSession = Depends(get_session),
):
"""Force la synchronisation d'une transaction"""
query = select(UniversignTransaction).where(
UniversignTransaction.transaction_id == transaction_id
.where(UniversignTransaction.transaction_id == transaction_id)
)
result = await session.execute(query)
transaction = result.scalar_one_or_none()
if not transaction:
raise HTTPException(404, "Transaction introuvable")
logger.warning(f"Transaction {transaction_id} inconnue")
return {"status": "error", "message": "Transaction inconnue"}, 404
success, error = await sync_service.sync_transaction(
session, transaction, force=force
transaction.webhook_received = True
# Récupérer l'état complet depuis Universign
import requests
resp = requests.get(
f"{settings.universign_api_url}/transactions/{transaction_id}",
auth=(settings.universign_api_key, ""),
timeout=30,
)
if resp.status_code != 200:
logger.error(f"Erreur récupération transaction: {resp.status_code}")
return {"status": "error", "message": "Erreur API Universign"}, 500
universign_data = resp.json()
universign_status_raw = universign_data.get("state", "")
previous_status = transaction.local_status.value
# Déterminer le nouveau statut
from utils.universign_status_mapping import map_universign_to_local
new_status = map_universign_to_local(universign_status_raw)
# Mettre à jour la transaction
transaction.universign_status = (
UniversignTransactionStatus(universign_status_raw)
if universign_status_raw in [s.value for s in UniversignTransactionStatus]
else transaction.universign_status
)
transaction.local_status = LocalDocumentStatus(new_status)
transaction.universign_status_updated_at = datetime.now()
transaction.last_synced_at = datetime.now()
if new_status == "SIGNE" and not transaction.signed_at:
transaction.signed_at = datetime.now()
await session.commit()
# Si statut = SIGNE (completed/closed), gérer la complétion
if new_status == "SIGNE" and previous_status != "SIGNE":
logger.info(f"🎯 Signature complétée détectée via webhook")
success, error = await universign_sync.handle_signature_completed(
session=session,
transaction=transaction,
universign_data=universign_data,
)
if not success:
raise HTTPException(500, error or "Échec synchronisation")
logger.error(f"Erreur handle_signature_completed: {error}")
return {
"status": "partial_success",
"message": "Webhook traité mais erreur téléchargement",
"error": error,
}, 200
logger.info(f"✅ Webhook traité: {previous_status}{new_status}")
return {
"success": True,
"status": "success",
"event": event_type,
"transaction_id": transaction_id,
"new_status": transaction.local_status.value,
"synced_at": transaction.last_synced_at.isoformat(),
}
@router.post("/sync/all")
async def sync_all_transactions(
max_transactions: int = Query(50, le=500),
session: AsyncSession = Depends(get_session),
):
"""Synchronise toutes les transactions en attente"""
stats = await sync_service.sync_all_pending(session, max_transactions)
return {"success": True, "stats": stats, "timestamp": datetime.now().isoformat()}
@router.post("/webhook")
@router.post("/webhook/")
async def webhook_universign(
request: Request, session: AsyncSession = Depends(get_session)
):
try:
payload = await request.json()
logger.info(
f"Webhook reçu: {payload.get('event')} - {payload.get('transaction_id')}"
)
success, error = await sync_service.process_webhook(session, payload)
if not success:
logger.error(f"Erreur traitement webhook: {error}")
return {"status": "error", "message": error}, 500
return {
"status": "processed",
"event": payload.get("event"),
"transaction_id": payload.get("transaction_id"),
"previous_status": previous_status,
"new_status": new_status,
}
except Exception as e:
@ -503,293 +440,122 @@ async def webhook_universign(
return {"status": "error", "message": str(e)}, 500
@router.get("/stats", response_model=SyncStatsResponse)
async def get_sync_stats(session: AsyncSession = Depends(get_session)):
"""Statistiques globales de synchronisation"""
# Total
total_query = select(func.count(UniversignTransaction.id))
total = (await session.execute(total_query)).scalar()
# En attente de sync
pending_query = select(func.count(UniversignTransaction.id)).where(
UniversignTransaction.needs_sync
)
pending = (await session.execute(pending_query)).scalar()
# Par statut
signed_query = select(func.count(UniversignTransaction.id)).where(
UniversignTransaction.local_status == LocalDocumentStatus.SIGNED
)
signed = (await session.execute(signed_query)).scalar()
in_progress_query = select(func.count(UniversignTransaction.id)).where(
UniversignTransaction.local_status == LocalDocumentStatus.IN_PROGRESS
)
in_progress = (await session.execute(in_progress_query)).scalar()
refused_query = select(func.count(UniversignTransaction.id)).where(
UniversignTransaction.local_status == LocalDocumentStatus.REJECTED
)
refused = (await session.execute(refused_query)).scalar()
expired_query = select(func.count(UniversignTransaction.id)).where(
UniversignTransaction.local_status == LocalDocumentStatus.EXPIRED
)
expired = (await session.execute(expired_query)).scalar()
# Dernière sync
last_sync_query = select(func.max(UniversignTransaction.last_synced_at))
last_sync = (await session.execute(last_sync_query)).scalar()
return SyncStatsResponse(
total_transactions=total,
pending_sync=pending,
signed=signed,
in_progress=in_progress,
refused=refused,
expired=expired,
last_sync_at=last_sync,
)
@router.get("/transactions/{transaction_id}/logs")
async def get_transaction_logs(
transaction_id: str,
limit: int = Query(50, le=500),
@router.get("/documents/{transaction_local_id}/download")
async def download_signed_document(
transaction_local_id: str = Path(..., description="ID local de la transaction"),
session: AsyncSession = Depends(get_session),
):
# Trouver la transaction
tx_query = select(UniversignTransaction).where(
UniversignTransaction.transaction_id == transaction_id
)
tx_result = await session.execute(tx_query)
tx = tx_result.scalar_one_or_none()
"""
Téléchargement sécurisé du document signé
if not tx:
**Sécurité**:
- Vérifier que le document existe
- Vérifier l'intégrité du fichier
- Retourner 404 si non trouvé
"""
try:
# Récupérer la transaction
query = select(UniversignTransaction).where(
UniversignTransaction.id == transaction_local_id
)
result = await session.execute(query)
transaction = result.scalar_one_or_none()
if not transaction:
raise HTTPException(404, "Transaction introuvable")
# Logs
logs_query = (
select(UniversignSyncLog)
.where(UniversignSyncLog.transaction_id == tx.id)
.order_by(UniversignSyncLog.sync_timestamp.desc())
.limit(limit)
if transaction.local_status != LocalDocumentStatus.SIGNED:
raise HTTPException(
400, f"Document non signé (statut: {transaction.local_status.value})"
)
logs_result = await session.execute(logs_query)
logs = logs_result.scalars().all()
# Récupérer le chemin du document
file_path = signed_documents.get_document_path(transaction)
return {
"transaction_id": transaction_id,
"total_syncs": len(logs),
"logs": [
{
"sync_type": log.sync_type,
"timestamp": log.sync_timestamp.isoformat(),
"success": log.success,
"previous_status": log.previous_status,
"new_status": log.new_status,
"error_message": log.error_message,
"response_time_ms": log.response_time_ms,
}
for log in logs
],
}
if not file_path:
raise HTTPException(404, "Document signé non disponible")
# Vérifier l'intégrité
if not signed_documents.verify_document_integrity(file_path):
logger.error(f"Document corrompu: {file_path}")
raise HTTPException(500, "Document signé corrompu")
@router.get("/documents/{sage_document_id}/signatures")
async def get_signatures_for_document(
sage_document_id: str,
session: AsyncSession = Depends(get_session),
):
"""Liste toutes les transactions de signature pour un document Sage"""
query = (
select(UniversignTransaction)
.options(selectinload(UniversignTransaction.signers))
.where(UniversignTransaction.sage_document_id == sage_document_id)
.order_by(UniversignTransaction.created_at.desc())
)
result = await session.execute(query)
transactions = result.scalars().all()
return [
{
"id": tx.id,
"transaction_id": tx.transaction_id,
"local_status": tx.local_status.value,
"universign_status": tx.universign_status.value
if tx.universign_status
else None,
"created_at": tx.created_at.isoformat(),
"signed_at": tx.signed_at.isoformat() if tx.signed_at else None,
"signer_url": tx.signer_url,
"signers_count": len(tx.signers),
}
for tx in transactions
]
@router.delete("/documents/{sage_document_id}/duplicates")
async def cleanup_duplicate_signatures(
sage_document_id: str,
keep_latest: bool = Query(
True, description="Garder la plus récente (True) ou la plus ancienne (False)"
),
session: AsyncSession = Depends(get_session),
):
"""
Supprime les doublons de signatures pour un document.
Garde une seule transaction (la plus récente ou ancienne selon le paramètre).
"""
query = (
select(UniversignTransaction)
.where(UniversignTransaction.sage_document_id == sage_document_id)
.order_by(
UniversignTransaction.created_at.desc()
if keep_latest
else UniversignTransaction.created_at.asc()
)
)
result = await session.execute(query)
transactions = result.scalars().all()
if len(transactions) <= 1:
return {
"success": True,
"message": "Aucun doublon trouvé",
"kept": transactions[0].transaction_id if transactions else None,
"deleted_count": 0,
}
# Garder la première (selon l'ordre), supprimer les autres
to_keep = transactions[0]
to_delete = transactions[1:]
deleted_ids = []
for tx in to_delete:
deleted_ids.append(tx.transaction_id)
await session.delete(tx)
await session.commit()
# Nom du fichier à télécharger
filename = f"{transaction.sage_document_id}_signe.pdf"
logger.info(
f"Nettoyage doublons {sage_document_id}: gardé {to_keep.transaction_id}, supprimé {deleted_ids}"
f"📥 Téléchargement: {filename} par transaction {transaction_local_id}"
)
return {
"success": True,
"document_id": sage_document_id,
"kept": {
"id": to_keep.id,
"transaction_id": to_keep.transaction_id,
"status": to_keep.local_status.value,
"created_at": to_keep.created_at.isoformat(),
return FileResponse(
path=file_path,
media_type="application/pdf",
filename=filename,
headers={
"Content-Disposition": f'attachment; filename="{filename}"',
"X-Transaction-ID": transaction.transaction_id,
"X-Signed-At": transaction.signed_at.isoformat()
if transaction.signed_at
else "",
},
"deleted_count": len(deleted_ids),
"deleted_transaction_ids": deleted_ids,
}
)
except HTTPException:
raise
except Exception as e:
logger.error(f"Erreur téléchargement document: {e}", exc_info=True)
raise HTTPException(500, str(e))
@router.delete("/transactions/{transaction_id}")
async def delete_transaction(
transaction_id: str,
session: AsyncSession = Depends(get_session),
@router.get("/documents/{transaction_local_id}/info")
async def get_signed_document_info(
transaction_local_id: str, session: AsyncSession = Depends(get_session)
):
"""Supprime une transaction spécifique par son ID Universign"""
"""
Informations sur le document signé (sans le télécharger)
"""
try:
query = select(UniversignTransaction).where(
UniversignTransaction.transaction_id == transaction_id
UniversignTransaction.id == transaction_local_id
)
result = await session.execute(query)
tx = result.scalar_one_or_none()
transaction = result.scalar_one_or_none()
if not tx:
raise HTTPException(404, f"Transaction {transaction_id} introuvable")
if not transaction:
raise HTTPException(404, "Transaction introuvable")
await session.delete(tx)
await session.commit()
file_path = signed_documents.get_document_path(transaction)
logger.info(f"Transaction {transaction_id} supprimée")
file_info = None
if file_path:
file_stat = file_path.stat()
file_info = {
"exists": True,
"size_bytes": file_stat.st_size,
"size_mb": round(file_stat.st_size / 1024 / 1024, 2),
"created_at": datetime.fromtimestamp(file_stat.st_ctime).isoformat(),
"integrity_ok": signed_documents.verify_document_integrity(file_path),
}
return {
"success": True,
"deleted_transaction_id": transaction_id,
"document_id": tx.sage_document_id,
"transaction_id": transaction.transaction_id,
"sage_document_id": transaction.sage_document_id,
"sage_document_type": transaction.sage_document_type.name,
"local_status": transaction.local_status.value,
"signed_at": transaction.signed_at.isoformat()
if transaction.signed_at
else None,
"downloaded_at": (
transaction.signed_document_downloaded_at.isoformat()
if transaction.signed_document_downloaded_at
else None
),
"file_info": file_info,
"download_url": f"/universign/documents/{transaction_local_id}/download",
}
@router.post("/cleanup/all-duplicates")
async def cleanup_all_duplicates(
session: AsyncSession = Depends(get_session),
):
"""
Nettoie tous les doublons dans la base.
Pour chaque document avec plusieurs transactions, garde la plus récente non-erreur ou la plus récente.
"""
from sqlalchemy import func
# Trouver les documents avec plusieurs transactions
subquery = (
select(
UniversignTransaction.sage_document_id,
func.count(UniversignTransaction.id).label("count"),
)
.group_by(UniversignTransaction.sage_document_id)
.having(func.count(UniversignTransaction.id) > 1)
).subquery()
duplicates_query = select(subquery.c.sage_document_id)
duplicates_result = await session.execute(duplicates_query)
duplicate_docs = [row[0] for row in duplicates_result.fetchall()]
total_deleted = 0
cleanup_details = []
for doc_id in duplicate_docs:
# Récupérer toutes les transactions pour ce document
tx_query = (
select(UniversignTransaction)
.where(UniversignTransaction.sage_document_id == doc_id)
.order_by(UniversignTransaction.created_at.desc())
)
tx_result = await session.execute(tx_query)
transactions = tx_result.scalars().all()
# Priorité: SIGNE > EN_COURS > EN_ATTENTE > autres
priority = {"SIGNE": 0, "EN_COURS": 1, "EN_ATTENTE": 2}
def sort_key(tx):
status_priority = priority.get(tx.local_status.value, 99)
return (status_priority, -tx.created_at.timestamp())
sorted_txs = sorted(transactions, key=sort_key)
to_keep = sorted_txs[0]
to_delete = sorted_txs[1:]
for tx in to_delete:
await session.delete(tx)
total_deleted += 1
cleanup_details.append(
{
"document_id": doc_id,
"kept": to_keep.transaction_id,
"kept_status": to_keep.local_status.value,
"deleted_count": len(to_delete),
}
)
await session.commit()
logger.info(
f"Nettoyage global: {total_deleted} doublons supprimés sur {len(duplicate_docs)} documents"
)
return {
"success": True,
"documents_processed": len(duplicate_docs),
"total_deleted": total_deleted,
"details": cleanup_details,
}
except HTTPException:
raise
except Exception as e:
logger.error(f"Erreur récupération info document: {e}")
raise HTTPException(500, str(e))

View file

@ -0,0 +1,188 @@
import os
import requests
import hashlib
import logging
from pathlib import Path
from typing import Optional, Tuple
from datetime import datetime
from sqlalchemy.ext.asyncio import AsyncSession
from database import UniversignTransaction
logger = logging.getLogger(__name__)
class SignedDocuments:
"""Service de gestion des documents signés"""
def __init__(self, storage_path: str = "./data/signed_documents"):
self.storage_path = Path(storage_path)
self.storage_path.mkdir(parents=True, exist_ok=True)
# Créer des sous-répertoires par type de document
for doc_type in ["devis", "commandes", "factures", "livraisons", "avoirs"]:
(self.storage_path / doc_type).mkdir(exist_ok=True)
def _get_storage_subdir(self, sage_doc_type: int) -> str:
"""Retourne le sous-répertoire selon le type de document Sage"""
mapping = {
0: "devis",
10: "commandes",
30: "livraisons",
50: "avoirs",
60: "factures",
}
return mapping.get(sage_doc_type, "autres")
def _generate_filename(
self, transaction_id: str, sage_doc_id: str, sage_doc_type: int
) -> str:
"""Génère un nom de fichier unique et sécurisé"""
# Hash du transaction_id pour éviter les collisions
hash_suffix = hashlib.md5(transaction_id.encode()).hexdigest()[:8]
timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
return f"{sage_doc_id}_{timestamp}_{hash_suffix}_signed.pdf"
async def download_and_store(
self,
session: AsyncSession,
transaction: UniversignTransaction,
document_url: str,
api_key: str,
) -> Tuple[bool, Optional[str], Optional[str]]:
"""
Télécharge et stocke le document signé
Returns:
(success, file_path, error_message)
"""
try:
# Télécharger le document depuis Universign
logger.info(f"Téléchargement document signé: {transaction.transaction_id}")
response = requests.get(
document_url, auth=(api_key, ""), timeout=60, stream=True
)
if response.status_code != 200:
error = f"Erreur HTTP {response.status_code} lors du téléchargement"
logger.error(error)
return False, None, error
# Vérifier que c'est bien un PDF
content_type = response.headers.get("Content-Type", "")
if "pdf" not in content_type.lower():
error = f"Type de contenu invalide: {content_type}"
logger.warning(error)
# Générer le nom de fichier et le chemin
subdir = self._get_storage_subdir(transaction.sage_document_type.value)
filename = self._generate_filename(
transaction.transaction_id,
transaction.sage_document_id,
transaction.sage_document_type.value,
)
file_path = self.storage_path / subdir / filename
# Écrire le fichier
with open(file_path, "wb") as f:
for chunk in response.iter_content(chunk_size=8192):
if chunk:
f.write(chunk)
file_size = file_path.stat().st_size
logger.info(f"Document stocké: {file_path} ({file_size} octets)")
# Mettre à jour la transaction
transaction.signed_document_path = str(file_path)
transaction.signed_document_downloaded_at = datetime.now()
await session.commit()
return True, str(file_path), None
except requests.exceptions.RequestException as e:
error = f"Erreur réseau lors du téléchargement: {str(e)}"
logger.error(error, exc_info=True)
return False, None, error
except IOError as e:
error = f"Erreur d'écriture du fichier: {str(e)}"
logger.error(error, exc_info=True)
return False, None, error
except Exception as e:
error = f"Erreur inattendue: {str(e)}"
logger.error(error, exc_info=True)
return False, None, error
def get_document_path(self, transaction: UniversignTransaction) -> Optional[Path]:
"""Retourne le chemin du document signé s'il existe"""
if not transaction.signed_document_path:
return None
path = Path(transaction.signed_document_path)
if not path.exists():
logger.warning(f"Document signé introuvable: {path}")
return None
return path
def verify_document_integrity(self, file_path: Path) -> bool:
"""Vérifie l'intégrité basique du document (taille, extension)"""
try:
if not file_path.exists():
return False
# Vérifier que le fichier n'est pas vide
if file_path.stat().st_size == 0:
logger.error(f"Document vide: {file_path}")
return False
# Vérifier l'extension
if file_path.suffix.lower() != ".pdf":
logger.error(f"Extension invalide: {file_path}")
return False
# Vérifier les premiers octets (signature PDF)
with open(file_path, "rb") as f:
header = f.read(5)
if header != b"%PDF-":
logger.error(f"Signature PDF invalide: {file_path}")
return False
return True
except Exception as e:
logger.error(f"Erreur vérification intégrité: {e}")
return False
async def cleanup_old_documents(self, days_to_keep: int = 365):
"""Nettoie les documents signés de plus de X jours (archivage)"""
cutoff_date = datetime.now().timestamp() - (days_to_keep * 86400)
deleted_count = 0
try:
for subdir in self.storage_path.iterdir():
if not subdir.is_dir():
continue
for file_path in subdir.glob("*.pdf"):
if file_path.stat().st_mtime < cutoff_date:
logger.info(f"Suppression ancien document: {file_path}")
file_path.unlink()
deleted_count += 1
logger.info(f"Nettoyage terminé: {deleted_count} document(s) supprimé(s)")
return deleted_count
except Exception as e:
logger.error(f"Erreur nettoyage documents: {e}")
return 0
# Instance globale
signed_documents = SignedDocuments(
storage_path=os.getenv("SIGNED_DOCS_PATH", "./data/signed_documents")
)

View file

@ -1,443 +1,186 @@
import requests
import json
import logging
import uuid
import logging
from typing import Dict, Optional, Tuple
from datetime import datetime, timedelta
from datetime import datetime
from sqlalchemy.ext.asyncio import AsyncSession
from sqlalchemy import select, and_, or_
from sqlalchemy.orm import selectinload
from database import (
UniversignTransaction,
UniversignSigner,
UniversignSyncLog,
UniversignTransactionStatus,
LocalDocumentStatus,
UniversignSignerStatus,
EmailLog,
StatutEmail,
)
from data.data import templates_signature_email
from utils.universign_status_mapping import (
map_universign_to_local,
is_transition_allowed,
get_status_actions,
is_final_status,
resolve_status_conflict,
)
from services.signed_documents import signed_documents
logger = logging.getLogger(__name__)
class UniversignSyncService:
def __init__(self, api_url: str, api_key: str, timeout: int = 30):
"""Service de synchronisation avec logique métier complète"""
def __init__(self, api_url: str, api_key: str):
self.api_url = api_url.rstrip("/")
self.api_key = api_key
self.timeout = timeout
self.auth = (api_key, "")
self.sage_client = None
self.email_queue = None
self.settings = None
def configure(self, sage_client, email_queue, settings):
"""Configure les dépendances injectées"""
self.sage_client = sage_client
self.email_queue = email_queue
self.settings = settings
def fetch_transaction_status(self, transaction_id: str) -> Optional[Dict]:
start_time = datetime.now()
try:
response = requests.get(
f"{self.api_url}/transactions/{transaction_id}",
auth=self.auth,
timeout=self.timeout,
headers={"Accept": "application/json"},
)
response_time_ms = int((datetime.now() - start_time).total_seconds() * 1000)
if response.status_code == 200:
data = response.json()
logger.info(
f"Fetch OK: {transaction_id} status={data.get('state')} ({response_time_ms}ms)"
)
return {
"transaction": data,
"http_status": 200,
"response_time_ms": response_time_ms,
"fetched_at": datetime.now(),
}
elif response.status_code == 404:
logger.warning(
f"Transaction {transaction_id} introuvable sur Universign"
)
return None
else:
logger.error(
f"Erreur HTTP {response.status_code} pour {transaction_id}: {response.text}"
)
return None
except requests.exceptions.Timeout:
logger.error(f"Timeout récupération {transaction_id} (>{self.timeout}s)")
return None
except Exception as e:
logger.error(f"Erreur fetch {transaction_id}: {e}", exc_info=True)
return None
async def sync_transaction(
self,
session: AsyncSession,
transaction: UniversignTransaction,
force: bool = False,
) -> Tuple[bool, Optional[str]]:
if is_final_status(transaction.local_status.value) and not force:
logger.debug(
f"Skip {transaction.transaction_id}: statut final {transaction.local_status.value}"
)
transaction.needs_sync = False
await session.commit()
return True, None
result = self.fetch_transaction_status(transaction.transaction_id)
if not result:
error = "Échec récupération données Universign"
await self._log_sync_attempt(session, transaction, "polling", False, error)
return False, error
universign_data = result["transaction"]
universign_status_raw = universign_data.get("state", "draft")
new_local_status = map_universign_to_local(universign_status_raw)
previous_local_status = transaction.local_status.value
if not is_transition_allowed(previous_local_status, new_local_status):
logger.warning(
f"Transition refusée: {previous_local_status}{new_local_status}"
)
new_local_status = resolve_status_conflict(
previous_local_status, new_local_status
)
status_changed = previous_local_status != new_local_status
if not status_changed and not force:
logger.debug(f"Pas de changement pour {transaction.transaction_id}")
transaction.last_synced_at = datetime.now()
transaction.needs_sync = False
await session.commit()
return True, None
try:
transaction.universign_status = UniversignTransactionStatus(
universign_status_raw
)
except ValueError:
transaction.universign_status = (
UniversignTransactionStatus.COMPLETED
if new_local_status == "SIGNE"
else UniversignTransactionStatus.FAILED
)
transaction.local_status = LocalDocumentStatus(new_local_status)
transaction.universign_status_updated_at = datetime.now()
if new_local_status == "EN_COURS" and not transaction.sent_at:
transaction.sent_at = datetime.now()
if new_local_status == "SIGNE" and not transaction.signed_at:
transaction.signed_at = datetime.now()
if new_local_status == "REFUSE" and not transaction.refused_at:
transaction.refused_at = datetime.now()
if new_local_status == "EXPIRE" and not transaction.expired_at:
transaction.expired_at = datetime.now()
if universign_data.get("documents") and len(universign_data["documents"]) > 0:
first_doc = universign_data["documents"][0]
if first_doc.get("url"):
transaction.document_url = first_doc["url"]
await self._sync_signers(session, transaction, universign_data)
transaction.last_synced_at = datetime.now()
transaction.sync_attempts += 1
transaction.needs_sync = not is_final_status(new_local_status)
transaction.sync_error = None
await self._log_sync_attempt(
session=session,
transaction=transaction,
sync_type="polling",
success=True,
error_message=None,
previous_status=previous_local_status,
new_status=new_local_status,
changes=json.dumps(
{
"status_changed": status_changed,
"universign_raw": universign_status_raw,
"response_time_ms": result.get("response_time_ms"),
}
),
)
await session.commit()
if status_changed:
await self._execute_status_actions(session, transaction, new_local_status)
logger.info(
f"Sync OK: {transaction.transaction_id} {previous_local_status}{new_local_status}"
)
return True, None
async def sync_all_pending(
self, session: AsyncSession, max_transactions: int = 50
) -> Dict[str, int]:
query = (
select(UniversignTransaction)
.options(selectinload(UniversignTransaction.signers))
.where(
and_(
UniversignTransaction.needs_sync,
or_(
~UniversignTransaction.local_status.in_(
[
LocalDocumentStatus.SIGNED,
LocalDocumentStatus.REJECTED,
LocalDocumentStatus.EXPIRED,
]
),
UniversignTransaction.last_synced_at
< (datetime.now() - timedelta(hours=1)),
UniversignTransaction.last_synced_at.is_(None),
),
)
)
.order_by(UniversignTransaction.created_at.asc())
.limit(max_transactions)
)
result = await session.execute(query)
transactions = result.scalars().all()
stats = {
"total_found": len(transactions),
"success": 0,
"failed": 0,
"skipped": 0,
"status_changes": 0,
}
for transaction in transactions:
try:
previous_status = transaction.local_status.value
success, error = await self.sync_transaction(
session, transaction, force=False
)
if success:
stats["success"] += 1
if transaction.local_status.value != previous_status:
stats["status_changes"] += 1
else:
stats["failed"] += 1
except Exception as e:
logger.error(
f"Erreur sync {transaction.transaction_id}: {e}", exc_info=True
)
stats["failed"] += 1
logger.info(
f"Polling terminé: {stats['success']}/{stats['total_found']} OK, {stats['status_changes']} changements détectés"
)
return stats
async def process_webhook(
self, session: AsyncSession, payload: Dict
) -> Tuple[bool, Optional[str]]:
try:
event_type = payload.get("event")
transaction_id = payload.get("transaction_id") or payload.get("id")
if not transaction_id:
return False, "Pas de transaction_id dans le webhook"
query = (
select(UniversignTransaction)
.options(selectinload(UniversignTransaction.signers))
.where(UniversignTransaction.transaction_id == transaction_id)
)
result = await session.execute(query)
transaction = result.scalar_one_or_none()
if not transaction:
logger.warning(
f"Webhook reçu pour transaction inconnue: {transaction_id}"
)
return False, "Transaction inconnue"
transaction.webhook_received = True
success, error = await self.sync_transaction(
session, transaction, force=True
)
await self._log_sync_attempt(
session=session,
transaction=transaction,
sync_type=f"webhook:{event_type}",
success=success,
error_message=error,
changes=json.dumps(payload),
)
await session.commit()
logger.info(
f"Webhook traité: {transaction_id} event={event_type} success={success}"
)
return success, error
except Exception as e:
logger.error(f"Erreur traitement webhook: {e}", exc_info=True)
return False, str(e)
async def _sync_signers(
async def handle_signature_completed(
self,
session: AsyncSession,
transaction: UniversignTransaction,
universign_data: Dict,
):
signers_data = universign_data.get("signers", [])
# Ne pas toucher aux signers existants si Universign n'en retourne pas
if not signers_data:
return
# Mettre à jour les signers existants ou en créer de nouveaux
existing_signers = {s.email: s for s in transaction.signers}
for idx, signer_data in enumerate(signers_data):
email = signer_data.get("email", "")
if email in existing_signers:
# Mise à jour du signer existant
signer = existing_signers[email]
signer.status = UniversignSignerStatus(
signer_data.get("status", "waiting")
) -> Tuple[bool, Optional[str]]:
"""
Gère la complétion d'une signature:
1. Télécharge et stocke le document signé
2. Met à jour le statut Sage à 2 (accepté)
3. Envoie la notification avec lien de téléchargement
"""
try:
logger.info(
f"🎯 Traitement signature complétée: {transaction.transaction_id}"
)
signer.viewed_at = (
self._parse_date(signer_data.get("viewed_at")) or signer.viewed_at
# Étape 1: Télécharger le document signé
document_url = self._extract_document_url(universign_data)
if not document_url:
error = "URL du document signé non trouvée dans la réponse Universign"
logger.error(error)
return False, error
(
success,
file_path,
error,
) = await signed_documents.download_and_store(
session=session,
transaction=transaction,
document_url=document_url,
api_key=self.api_key,
)
signer.signed_at = (
self._parse_date(signer_data.get("signed_at")) or signer.signed_at
)
signer.refused_at = (
self._parse_date(signer_data.get("refused_at")) or signer.refused_at
if not success:
return False, f"Échec téléchargement document: {error}"
logger.info(f"✅ Document signé stocké: {file_path}")
# Étape 2: Mettre à jour le statut Sage UNIQUEMENT si ≠ 2
current_sage_status = await self._get_current_sage_status(transaction)
if current_sage_status != 2:
success_sage = await self._update_sage_to_accepted(transaction)
if success_sage:
logger.info(f"✅ Statut Sage mis à jour: {current_sage_status} → 2")
else:
logger.warning(
f"⚠️ Échec mise à jour statut Sage pour {transaction.sage_document_id}"
)
else:
# Nouveau signer
signer = UniversignSigner(
id=f"{transaction.id}_signer_{idx}_{int(datetime.now().timestamp())}",
transaction_id=transaction.id,
email=email,
name=signer_data.get("name"),
status=UniversignSignerStatus(signer_data.get("status", "waiting")),
order_index=idx,
viewed_at=self._parse_date(signer_data.get("viewed_at")),
signed_at=self._parse_date(signer_data.get("signed_at")),
refused_at=self._parse_date(signer_data.get("refused_at")),
)
session.add(signer)
logger.info(f" Statut Sage déjà à 2, pas de mise à jour")
async def _log_sync_attempt(
# Étape 3: Envoyer notification avec lien de téléchargement
notification_sent = await self._send_signature_confirmation(
session=session,
transaction=transaction,
download_link=self._generate_download_link(transaction),
)
if not notification_sent:
logger.warning("⚠️ Notification non envoyée (mais document stocké)")
return True, None
except Exception as e:
error = f"Erreur handle_signature_completed: {str(e)}"
logger.error(error, exc_info=True)
return False, error
def _extract_document_url(self, universign_data: Dict) -> Optional[str]:
"""Extrait l'URL du document signé depuis la réponse Universign"""
try:
# Structure: data['documents'][0]['url']
documents = universign_data.get("documents", [])
if documents and len(documents) > 0:
return documents[0].get("url")
# Fallback: vérifier dans les actions
actions = universign_data.get("actions", [])
for action in actions:
if action.get("type") == "download" and action.get("url"):
return action["url"]
return None
except Exception as e:
logger.error(f"Erreur extraction URL document: {e}")
return None
async def _get_current_sage_status(self, transaction: UniversignTransaction) -> int:
"""Récupère le statut actuel du document dans Sage"""
try:
if not self.sage_client:
logger.warning("sage_client non configuré")
return 0
doc = self.sage_client.lire_document(
transaction.sage_document_id, transaction.sage_document_type.value
)
return doc.get("statut", 0) if doc else 0
except Exception as e:
logger.error(f"Erreur lecture statut Sage: {e}")
return 0
async def _update_sage_to_accepted(
self, transaction: UniversignTransaction
) -> bool:
"""Met à jour le statut Sage à 2 (accepté)"""
try:
if not self.sage_client:
logger.warning("sage_client non configuré")
return False
self.sage_client.changer_statut_document(
document_type_code=transaction.sage_document_type.value,
numero=transaction.sage_document_id,
nouveau_statut=2, # Accepté
)
return True
except Exception as e:
logger.error(f"Erreur mise à jour Sage: {e}")
return False
def _generate_download_link(self, transaction: UniversignTransaction) -> str:
"""Génère le lien de téléchargement sécurisé"""
base_url = (
self.settings.api_base_url if self.settings else "http://localhost:8000"
)
return f"{base_url}/universign/documents/{transaction.id}/download"
async def _send_signature_confirmation(
self,
session: AsyncSession,
transaction: UniversignTransaction,
sync_type: str,
success: bool,
error_message: Optional[str] = None,
previous_status: Optional[str] = None,
new_status: Optional[str] = None,
changes: Optional[str] = None,
):
log = UniversignSyncLog(
transaction_id=transaction.id,
sync_type=sync_type,
sync_timestamp=datetime.now(),
previous_status=previous_status,
new_status=new_status,
changes_detected=changes,
success=success,
error_message=error_message,
)
session.add(log)
async def _execute_status_actions(
self, session: AsyncSession, transaction: UniversignTransaction, new_status: str
):
actions = get_status_actions(new_status)
if not actions:
return
if actions.get("update_sage_status"):
await self._update_sage_status(transaction, new_status)
if actions.get("send_notification"):
await self._send_notification(session, transaction, new_status)
async def _update_sage_status(
self, transaction: UniversignTransaction, status: str
):
if not self.sage_client:
logger.warning("sage_client non configuré pour mise à jour Sage")
return
download_link: str,
) -> bool:
"""Envoie l'email de confirmation avec lien de téléchargement"""
try:
type_doc = transaction.sage_document_type.value
doc_id = transaction.sage_document_id
if status == "SIGNE":
self.sage_client.changer_statut_document(
document_type_code=type_doc, numero=doc_id, nouveau_statut=2
)
logger.info(f"Statut Sage mis à jour: {doc_id} → Accepté (2)")
elif status == "EN_COURS":
self.sage_client.changer_statut_document(
document_type_code=type_doc, numero=doc_id, nouveau_statut=1
)
logger.info(f"Statut Sage mis à jour: {doc_id} → Confirmé (1)")
except Exception as e:
logger.error(
f"Erreur mise à jour Sage pour {transaction.sage_document_id}: {e}"
)
async def _send_notification(
self, session: AsyncSession, transaction: UniversignTransaction, status: str
):
if not self.email_queue or not self.settings:
logger.warning("email_queue ou settings non configuré")
return
return False
try:
if status == "SIGNE":
template = templates_signature_email["signature_confirmee"]
type_labels = {
@ -459,10 +202,40 @@ class UniversignSyncService:
else datetime.now().strftime("%d/%m/%Y à %H:%M"),
"TRANSACTION_ID": transaction.transaction_id,
"CONTACT_EMAIL": self.settings.smtp_from,
"DOWNLOAD_LINK": download_link, # Nouvelle variable
}
sujet = template["sujet"]
corps = template["corps_html"]
# Corps modifié pour inclure le lien de téléchargement
corps = template["corps_html"].replace(
"</td>\n </tr>\n \n <!-- Footer -->",
f"""</td>
</tr>
<!-- Download Section -->
<tr>
<td style="padding: 20px 30px; background-color: #f0f9ff; border: 1px solid #90cdf4; border-radius: 4px; margin: 20px 0;">
<p style="color: #2c5282; font-size: 14px; line-height: 1.6; margin: 0 0 15px;">
📄 <strong>Télécharger le document signé :</strong>
</p>
<table width="100%" cellpadding="0" cellspacing="0">
<tr>
<td align="center">
<a href="{download_link}" style="display: inline-block; background: #48bb78; color: #ffffff; text-decoration: none; padding: 12px 30px; border-radius: 6px; font-size: 14px; font-weight: 600;">
Télécharger le PDF signé
</a>
</td>
</tr>
</table>
<p style="color: #718096; font-size: 12px; margin: 15px 0 0; text-align: center;">
Ce lien est valable pendant 1 an
</p>
</td>
</tr>
<!-- Footer -->""",
)
for var, valeur in variables.items():
sujet = sujet.replace(f"{{{{{var}}}}}", str(valeur))
@ -485,55 +258,83 @@ class UniversignSyncService:
self.email_queue.enqueue(email_log.id)
logger.info(f"📧 Email confirmation envoyé à {transaction.requester_email}")
return True
except Exception as e:
logger.error(f"Erreur envoi notification: {e}", exc_info=True)
return False
async def handle_status_transition(
self,
session: AsyncSession,
transaction: UniversignTransaction,
previous_status: str,
new_status: str,
universign_data: Dict,
) -> Tuple[bool, Optional[str]]:
"""
Gère les transitions de statut avec logique métier
"""
logger.info(
f"Email confirmation signature envoyé à {transaction.requester_email}"
f"🔄 Transition: {transaction.transaction_id} "
f"{previous_status}{new_status}"
)
# Si passage à SIGNE (completed)
if new_status == "SIGNE" and previous_status != "SIGNE":
return await self.handle_signature_completed(
session=session,
transaction=transaction,
universign_data=universign_data,
)
# Si passage à REFUSE
elif new_status == "REFUSE" and previous_status != "REFUSE":
await self._update_sage_to_refused(transaction)
# Si passage à EXPIRE
elif new_status == "EXPIRE" and previous_status != "EXPIRE":
await self._update_sage_to_expired(transaction)
return True, None
async def _update_sage_to_refused(self, transaction: UniversignTransaction):
"""Met à jour Sage quand signature refusée"""
try:
if not self.sage_client:
return
# Statut 3 = Perdu/Refusé (selon config Sage)
self.sage_client.changer_statut_document(
document_type_code=transaction.sage_document_type.value,
numero=transaction.sage_document_id,
nouveau_statut=3,
)
logger.info(
f"📛 Statut Sage → 3 (Refusé) pour {transaction.sage_document_id}"
)
except Exception as e:
logger.error(
f"Erreur envoi notification pour {transaction.transaction_id}: {e}"
logger.error(f"Erreur mise à jour Sage (refusé): {e}")
async def _update_sage_to_expired(self, transaction: UniversignTransaction):
"""Met à jour Sage quand signature expirée"""
try:
if not self.sage_client:
return
# Statut 4 = Expiré/Archivé (selon config Sage)
self.sage_client.changer_statut_document(
document_type_code=transaction.sage_document_type.value,
numero=transaction.sage_document_id,
nouveau_statut=4,
)
@staticmethod
def _parse_date(date_str: Optional[str]) -> Optional[datetime]:
if not date_str:
return None
try:
return datetime.fromisoformat(date_str.replace("Z", "+00:00"))
except Exception:
return None
class UniversignSyncScheduler:
def __init__(self, sync_service: UniversignSyncService, interval_minutes: int = 5):
self.sync_service = sync_service
self.interval_minutes = interval_minutes
self.is_running = False
async def start(self, session_factory):
import asyncio
self.is_running = True
logger.info(
f"Démarrage polling Universign (intervalle: {self.interval_minutes}min)"
)
while self.is_running:
try:
async with session_factory() as session:
stats = await self.sync_service.sync_all_pending(session)
logger.info(
f"Polling: {stats['success']} transactions synchronisées, "
f"{stats['status_changes']} changements"
f"⏰ Statut Sage → 4 (Expiré) pour {transaction.sage_document_id}"
)
except Exception as e:
logger.error(f"Erreur polling: {e}", exc_info=True)
await asyncio.sleep(self.interval_minutes * 60)
def stop(self):
self.is_running = False
logger.info("Arrêt polling Universign")
logger.error(f"Erreur mise à jour Sage (expiré): {e}")