[Event] add referrer code

migrations/2025/Version20250227133157.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Migrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20250227133157 extends AbstractMigration
+{
+    public function up(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE
+          national_event_inscription
+        ADD
+          referrer_id INT UNSIGNED DEFAULT NULL,
+        ADD
+          referrer_code VARCHAR(7) DEFAULT NULL');
+        $this->addSql('ALTER TABLE
+          national_event_inscription
+        ADD
+          CONSTRAINT FK_C3325557798C22DB FOREIGN KEY (referrer_id) REFERENCES adherents (id) ON DELETE
+        SET
+          NULL');
+        $this->addSql('CREATE INDEX IDX_C3325557798C22DB ON national_event_inscription (referrer_id)');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE national_event_inscription DROP FOREIGN KEY FK_C3325557798C22DB');
+        $this->addSql('DROP INDEX IDX_C3325557798C22DB ON national_event_inscription');
+        $this->addSql('ALTER TABLE national_event_inscription DROP referrer_id, DROP referrer_code');
+    }
+}

src/Adherent/Referral/ReferralParams.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace App\Adherent\Referral;
+
+class ReferralParams
+{
+    public const REFERRER_CODE = 'referrer';
+
+    public static function filterParameter(?string $parameter): ?string
+    {
+        if (!$parameter) {
+            return null;
+        }
+
+        return mb_substr($parameter, 0, 7);
+    }
+}

src/Admin/NationalEvent/NationalEventInscriptionsAdmin.php

@@ -98,6 +98,7 @@ protected function configureListFields(ListMapper $list): void
             ->add('postalCode', null, ['label' => 'Code postal'])
             ->add('status', 'trans', ['label' => 'Statut'])
             ->add('adherent.tags', null, ['label' => 'Labels', 'template' => 'admin/national_event/list_adherent_tags.html.twig'])
+            ->add('referrerCode', null, ['label' => 'Parrain', 'template' => 'admin/national_event/list_referrer_code.html.twig'])
             ->add(ListMapper::NAME_ACTIONS, null, ['actions' => ['edit' => []]])
         ;
     }

src/Controller/Renaissance/NationalEvent/EventInscriptionController.php

@@ -2,6 +2,7 @@
 
 namespace App\Controller\Renaissance\NationalEvent;
 
+use App\Adherent\Referral\ReferralParams;
 use App\Entity\Adherent;
 use App\Entity\NationalEvent\NationalEvent;
 use App\Event\Request\EventInscriptionRequest;
@@ -18,6 +19,7 @@
 use Symfony\Component\Security\Csrf\CsrfTokenManagerInterface;
 
 #[Route('/{slug}', name: 'app_national_event_by_slug', methods: ['GET', 'POST'])]
+#[Route('/{slug}/{referrerCode}', name: 'app_national_event_by_slug_with_referrer', methods: ['GET', 'POST'])]
 class EventInscriptionController extends AbstractController
 {
     private const SESSION_ID = 'nation_event:sess_id';
@@ -31,7 +33,7 @@ public function __construct(
     ) {
     }
 
-    public function __invoke(Request $request, string $app_domain, ?NationalEvent $event = null): Response
+    public function __invoke(Request $request, string $app_domain, ?NationalEvent $event = null, ?string $referrerCode = null): Response
     {
         if (!$event && !$event = $this->nationalEventRepository->findOneForInscriptions()) {
             return $this->redirectToRoute('renaissance_site');
@@ -64,6 +66,10 @@ public function __invoke(Request $request, string $app_domain, ?NationalEvent $e
             $inscriptionRequest->utmCampaign = UtmParams::filterUtmParameter($request->query->get(UtmParams::UTM_CAMPAIGN));
         }
 
+        if ($referrerCode) {
+            $inscriptionRequest->referrerCode = ReferralParams::filterParameter($referrerCode);
+        }
+
         $isOpen = !$event->isComplete($inscriptionRequest->utmSource);
 
         $form = $this

src/Entity/NationalEvent/EventInscription.php

@@ -113,6 +113,13 @@ class EventInscription
     #[ORM\Column(nullable: true)]
     public ?string $ticketQRCodeFile = null;
 
+    #[ORM\Column(length: 7, nullable: true)]
+    public ?string $referrerCode = null;
+
+    #[ORM\JoinColumn(onDelete: 'SET NULL')]
+    #[ORM\ManyToOne(targetEntity: Adherent::class)]
+    public ?Adherent $referrer = null;
+
     public function __construct(NationalEvent $event, ?UuidInterface $uuid = null)
     {
         $this->uuid = $uuid ?? Uuid::uuid4();
@@ -138,6 +145,7 @@ public function updateFromRequest(EventInscriptionRequest $inscriptionRequest):
         $this->birthdate = $inscriptionRequest->birthdate;
         $this->utmSource = $inscriptionRequest->utmSource;
         $this->utmCampaign = $inscriptionRequest->utmCampaign;
+        $this->referrerCode = $inscriptionRequest->referrerCode;
     }
 
     public function getFullName(): string

src/Event/Request/EventInscriptionRequest.php

@@ -62,6 +62,8 @@ class EventInscriptionRequest implements RecaptchaChallengeInterface
     public ?string $utmSource = null;
     public ?string $utmCampaign = null;
 
+    public ?string $referrerCode = null;
+
     public array $qualities = [];
 
     #[Assert\Length(max: 255)]

src/NationalEvent/EventInscriptionHandler.php

@@ -27,6 +27,13 @@ public function handle(NationalEvent $nationalEvent, EventInscriptionRequest $in
             $eventInscription->adherent = $adherent;
         }
 
+        if (
+            $eventInscription->referrerCode
+            && $referrer = $this->adherentRepository->findOneBy(['publicId' => $eventInscription->referrerCode])
+        ) {
+            $eventInscription->referrer = $referrer;
+        }
+
         $this->entityManager->persist($eventInscription);
 
         $this->entityManager->flush();

templates/admin/national_event/list_referrer_code.html.twig

@@ -0,0 +1,9 @@
+{% extends get_admin_template('base_list_field', admin.code) %}
+
+{% block field %}
+    {% if object.referrer %}
+        {{ include(('admin/adherent/_summary.html.twig'), {adherent: object.referrer}) }}
+    {% elseif object.referrerCode %}
+        Code: <b>{{ object.referrerCode }}</b>
+    {% endif %}
+{% endblock %}