Services Métiers

/**
 * Calcule toutes les offres possibles pour une demande donnée
 * 
 * @param Request $request La demande de maintenance
 * @return array Tableau des offres calculées avec détails des coûts
 */
public function calculate(Request $request): array

/**
 * Calcule le coût de la main d'œuvre
 * Utilise les coefficients par catégorie d'équipement
 */
private function calculateWorkforce(MaintenanceOffer $maintenanceOffer): PriceWorkforce

/**
 * Calcule les frais de déplacement
 */
private function calculateShift(MaintenanceOffer $maintenanceOffer): ?PriceShift

/**
 * Calcule le coût des fournitures
 */
private function calculateSupplies(MaintenanceOffer $maintenanceOffer): PriceSupplies

// Dans un contrôleur ou un gestionnaire de commande
$offers = $calculateOfferService->calculate($request);

// Exemple de sortie
[
    'basic' => [
        'id' => 'uuid',
        'type' => 'basic',
        'label' => 'Forfait Basique',
        'price' => 299.99,
        'description' => 'Description du forfait...',
        'includes' => ['Service 1', 'Service 2']
    ],
    // ... autres forfaits
]

/**
 * Génère un nouveau contrat à partir d'une demande
 * 
 * @param Request $request La demande de maintenance
 * @return Contract Le contrat généré
 * @throws \RuntimeException Si la génération échoue
 */
public function generateContract(Request $request): Contract

/**
 * Lance le processus de signature électronique
 */
public function signContract(Contract $contract): void

/**
 * Trouve une ville par son code postal
 */
public function getCityByCode(string $code): ?string

/**
 * Valide un code postal
 */
public function isValid(string $code): bool

/**
 * Crée une demande de signature pour un contrat
 */
public function createSignature(Contract $contract): array

/**
 * Télécharge le document signé
 */
public function downloadDocument(string $signRequestId): string

/**
 * Vérifie l'état d'une signature sur l'API YouSign
 */
public function getSignatureStatus(string $signRequestId): array

/**
 * Anonymise une demande et ses données associées
 */
public function anonymizeRequest(Request $request): void

/**
 * Vérifie si une demande peut être anonymisée
 */
public function canBeAnonymized(Request $request): bool

/** Paiement unique (carte) : montant total du contrat en une seule fois. */
public function createOneShotPayment(Request $request): Session

/** Abonnement mensuel (SEPA) : prélèvement mensuel récurrent. */
public function createSubscriptionPayment(Request $request): Session

Admin EasyAdmin         Backend (webhook YouSign)        Stripe
──────────────          ────────────────────────         ──────
Crée Discount      →    createSubscriptionPayment()  →   Coupon Stripe (12 mois)
  type: numeric          → stripe->coupons->create()      automatiquement retiré
  amount: 50€            → checkout->sessions->create()   après 1 an

public function __construct(
    private readonly EntityManagerInterface $entityManager,
    private readonly GotenbergPdfInterface $gotenbergPdf,
    private readonly Filesystem $filesystem,
    // ...
) {}

if (!$this->isValid($code)) {
    throw new InvalidPostalCodeException($code);
}

use Psr\Log\LoggerInterface;

public function __construct(
    private readonly LoggerInterface $logger
) {}

public function someMethod() {
    $this->logger->info('Opération effectuée', ['id' => $id]);
}

// tests/Service/CalculateOfferFromRequestServiceTest.php
public function testCalculateBasicOffer(): void
{
    $service = new CalculateOfferFromRequestService(
        $this->createMock(MaintenanceOfferRepository::class),
        $this->createMock(PostalCodeService::class),
        $this->createMock(ParameterRepository::class),
        $this->createMock(CoefficientRateRepository::class)
    );
    
    $request = new Request();
    // Configuration de la requête...
    
    $result = $service->calculate($request);
    
    $this->assertArrayHasKey('basic', $result);
    $this->assertGreaterThan(0, $result['basic']['price']);
}

public function signContract(Contract $contract, User $user): void
{
    if (!$this->authorizationChecker->isGranted('SIGN', $contract)) {
        throw new AccessDeniedException('Accès refusé');
    }
    
    // Suite du traitement...
}