From 78efa4311437219778d79a49b8d19425eaf037b5 Mon Sep 17 00:00:00 2001
From: Ronan Lenouvel <ronan.lenouvel@orange.com>
Date: Sun, 11 Oct 2026 19:57:01 +0200
Subject: [PATCH 1/3] =?UTF-8?q?=E2=9C=A8=20feat(AnnouncementMail):=20gabar?=
 =?UTF-8?q?it=20d'annonce=20de=20l'appli=20#B27=20avec=20boutons=20d'activ?=
 =?UTF-8?q?ation=20et=20de=20connexion=20(#444)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 templates/mail/announcement.html.php | 33 +++++++++++++++++++++++++++
 templates/mail/announcement.txt.php  | 25 ++++++++++++++++++++
 tests/Mail/MailRendererTest.php      | 34 ++++++++++++++++++++++++++--
 3 files changed, 90 insertions(+), 2 deletions(-)
 create mode 100644 templates/mail/announcement.html.php
 create mode 100644 templates/mail/announcement.txt.php

diff --git a/templates/mail/announcement.html.php b/templates/mail/announcement.html.php
new file mode 100644
index 00000000..420ec157
--- /dev/null
+++ b/templates/mail/announcement.html.php
@@ -0,0 +1,33 @@
+<?php
+/**
+ * @var string $link       page de connexion
+ * @var string $forgotLink page « Mot de passe oublié » (activation du compte)
+ */
+?>
+<h1 style="margin:0 0 16px 0;font-size:22px;line-height:1.3;color:#1c1a17;">L'appli #B27 est ouverte !</h1>
+<p style="margin:0 0 16px 0;">Bonjour,</p>
+<p style="margin:0 0 24px 0;">L'appli #B27 est maintenant disponible pour tous les groupes du local. Son but : <strong>voir à l'avance si le local est libre</strong>, sans avoir à demander à tout le monde.</p>
+
+<h2 style="margin:0 0 8px 0;font-size:17px;color:#1c1a17;">Se connecter</h2>
+<p style="margin:0 0 16px 0;"><strong>Première fois ?</strong> Votre compte existe déjà : pour l'activer, passez par « Mot de passe oublié » avec votre adresse e-mail et choisissez votre mot de passe.</p>
+<table role="presentation" cellpadding="0" cellspacing="0" border="0" style="margin:0 0 24px 0;">
+    <tr>
+        <td style="background:#b5654a;border-radius:4px;">
+            <a href="<?= e($forgotLink) ?>" style="display:inline-block;padding:14px 24px;font-weight:bold;font-size:16px;color:#ffffff;text-decoration:none;">Activer mon compte</a>
+        </td>
+    </tr>
+</table>
+<p style="margin:0 0 16px 0;"><strong>Compte déjà configuré ?</strong> Rien à refaire, connectez-vous comme d'habitude.</p>
+<table role="presentation" cellpadding="0" cellspacing="0" border="0" style="margin:0 0 24px 0;">
+    <tr>
+        <td style="background:#b5654a;border-radius:4px;">
+            <a href="<?= e($link) ?>" style="display:inline-block;padding:14px 24px;font-weight:bold;font-size:16px;color:#ffffff;text-decoration:none;">Me connecter</a>
+        </td>
+    </tr>
+</table>
+<h2 style="margin:0 0 8px 0;font-size:17px;color:#1c1a17;">À quoi ça sert</h2>
+<p style="margin:0 0 8px 0;"><strong>1. Voir le planning.</strong> Les créneaux du local apparaissent dans l'appli : vous voyez d'un coup d'œil ce qui est pris et ce qui est libre.</p>
+<p style="margin:0 0 8px 0;"><strong>2. Réserver un créneau libre.</strong> Un créneau disponible se réserve directement depuis l'appli, et votre réservation y apparaît aussitôt.</p>
+<p style="margin:0 0 8px 0;"><strong>3. Demander un échange de créneau.</strong> Un créneau vous intéresse mais il est pris ? Contactez le groupe concerné depuis l'appli : la demande d'échange lui apparaît dans l'appli.</p>
+<p style="margin:0;"><strong>4. Écrire aux autres membres.</strong> La messagerie permet d'échanger entre membres directement dans l'appli.</p>
+
diff --git a/templates/mail/announcement.txt.php b/templates/mail/announcement.txt.php
new file mode 100644
index 00000000..6ba42d53
--- /dev/null
+++ b/templates/mail/announcement.txt.php
@@ -0,0 +1,25 @@
+<?php
+/**
+ * @var string $link
+ * @var string $forgotLink
+ */
+?>
+Bonjour,
+
+L'appli #B27 est ouverte !
+
+L'appli #B27 est maintenant disponible pour tous les groupes du local. Son but : voir à l'avance si le local est libre, sans avoir à demander à tout le monde.
+
+SE CONNECTER
+- Première fois ? Votre compte existe déjà : pour l'activer, passez par « Mot de passe oublié » avec votre adresse e-mail et choisissez votre mot de passe. Activer mon compte :
+  <?= $forgotLink ?>
+
+- Compte déjà configuré ? Rien à refaire, connectez-vous comme d'habitude. Me connecter :
+  <?= $link ?>
+
+
+À QUOI ÇA SERT
+1. Voir le planning. Les créneaux du local apparaissent dans l'appli : vous voyez d'un coup d'œil ce qui est pris et ce qui est libre.
+2. Réserver un créneau libre. Un créneau disponible se réserve directement depuis l'appli, et votre réservation y apparaît aussitôt.
+3. Demander un échange de créneau. Un créneau vous intéresse mais il est pris ? Contactez le groupe concerné depuis l'appli : la demande d'échange lui apparaît dans l'appli.
+4. Écrire aux autres membres. La messagerie permet d'échanger entre membres directement dans l'appli.
diff --git a/tests/Mail/MailRendererTest.php b/tests/Mail/MailRendererTest.php
index d94a9eca..8770ee9f 100644
--- a/tests/Mail/MailRendererTest.php
+++ b/tests/Mail/MailRendererTest.php
@@ -34,6 +34,7 @@ public function testEveryMailIsAFullHtmlDocumentWithTheBrandAndNoExternalResourc
             ['mention-reminder', ['mentionerName' => 'Alice', 'link' => self::LINK]],
             ['booking-pending', ['groupName' => 'Alpha', 'when' => 'mercredi 7 octobre 2026', 'range' => '09:00 – 14:00', 'link' => self::LINK]],
             ['booking-decided', ['groupName' => 'Alpha', 'when' => 'mercredi 7 octobre 2026', 'range' => '09:00 – 14:00', 'accepted' => true, 'note' => null, 'link' => self::LINK]],
+            ['announcement', ['link' => self::LINK, 'forgotLink' => self::LINK]],
         ] as [$template, $data]) {
             $html = $this->renderer->render($template, $data)['html'];
 
@@ -54,8 +55,8 @@ public function testEveryMailIsAFullHtmlDocumentWithTheBrandAndNoExternalResourc
     #[Test]
     public function testEveryMailHasABothHtmlAndPlainTextVersion(): void
     {
-        foreach (['password-reset', 'account-alert'] as $template) {
-            $mail = $this->renderer->render($template, ['link' => self::LINK]);
+        foreach (['password-reset', 'account-alert', 'announcement'] as $template) {
+            $mail = $this->renderer->render($template, ['link' => self::LINK, 'forgotLink' => self::LINK]);
 
             self::assertNotSame('', trim($mail['html']), $template);
             self::assertNotSame('', trim($mail['text']), $template);
@@ -90,6 +91,35 @@ public function testPasswordResetEscapesAMaliciousLink(): void
         self::assertStringContainsString('&lt;script&gt;', $html);
     }
 
+    // --- Annonce de mise à disposition (#444) -----------------------------------------------
+
+    #[Test]
+    public function testAnnouncementExplainsTheAimTheTwoWaysToLogInAndTheFourMainFeaturesInBothVersions(): void
+    {
+        $mail = $this->renderer->render('announcement', ['link' => 'https://b27.example/login', 'forgotLink' => 'https://b27.example/forgot-password']);
+
+        foreach ([$mail['html'], $mail['text']] as $body) {
+            self::assertStringContainsString('local est libre', $body, 'le but premier');
+            self::assertStringContainsString('Mot de passe oublié', $body, 'activation du compte');
+            self::assertStringContainsString('déjà', $body, 'compte déjà configuré : rien à refaire');
+            self::assertStringContainsString('créneau libre', $body, 'réservation');
+            self::assertStringContainsString('échange', $body, 'demande par contact du groupe');
+            self::assertStringContainsString('messagerie', $body);
+            self::assertStringContainsString('https://b27.example/forgot-password', $body);
+            self::assertStringContainsString('https://b27.example/login', $body);
+            self::assertStringContainsString('Activer mon compte', $body);
+            self::assertStringContainsString('Me connecter', $body);
+        }
+    }
+
+    #[Test]
+    public function testAnnouncementEscapesTheLinks(): void
+    {
+        $html = $this->renderer->render('announcement', ['link' => 'https://x.test/"><script>alert(1)</script>', 'forgotLink' => 'https://x.test/"><script>alert(2)</script>'])['html'];
+
+        self::assertStringNotContainsString('<script>alert', $html);
+    }
+
     // --- Alerte « Ce n'est pas moi » --------------------------------------------------------
 
     #[Test]

From 35c3ee6dc683950cb657107e45f8682d6e1002ae Mon Sep 17 00:00:00 2001
From: Ronan Lenouvel <ronan.lenouvel@orange.com>
Date: Sun, 11 Oct 2026 19:57:01 +0200
Subject: [PATCH 2/3] =?UTF-8?q?=E2=9C=A8=20feat(AnnouncementService):=20en?=
 =?UTF-8?q?voi=20unique=20aux=20comptes=20actifs,=20essai=20=C3=A0=20une?=
 =?UTF-8?q?=20adresse=20et=20m=C3=A9moire=20des=20comptes=20servis=20(#444?=
 =?UTF-8?q?)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 config/services.php                           |   8 +
 .../Announcement/AnnouncementLedger.php       |  48 ++++++
 .../Announcement/AnnouncementReport.php       |  38 +++++
 .../Announcement/AnnouncementService.php      |  80 ++++++++++
 .../Announcement/AnnouncementServiceTest.php  | 137 ++++++++++++++++++
 5 files changed, 311 insertions(+)
 create mode 100644 src/Account/Service/Announcement/AnnouncementLedger.php
 create mode 100644 src/Account/Service/Announcement/AnnouncementReport.php
 create mode 100644 src/Account/Service/Announcement/AnnouncementService.php
 create mode 100644 tests/Account/Service/Announcement/AnnouncementServiceTest.php

diff --git a/config/services.php b/config/services.php
index a2c56074..79baa876 100644
--- a/config/services.php
+++ b/config/services.php
@@ -106,6 +106,8 @@
 use App\Group\Service\GroupServiceInterface;
 use App\Http\AfterResponseInterface;
 use App\Http\DeferredAfterResponse;
+use App\Account\Service\Announcement\AnnouncementLedger;
+use App\Account\Service\Announcement\AnnouncementService;
 use App\Mail\Mailbox;
 use App\Mail\MailRenderer;
 use App\Account\Service\UserAdminServiceInterface;
@@ -396,6 +398,12 @@
         $c->get(MetricsRecorderInterface::class),
     ));
 
+    $container->set(AnnouncementService::class, fn ($c) => new AnnouncementService(
+        $c->get(UserRepositoryInterface::class),
+        $c->get(Mailbox::class),
+        new AnnouncementLedger(__DIR__ . '/../storage/announcement-sent.txt'),
+    ));
+
     $container->set(MailerInterface::class, fn () => new \Symfony\Component\Mailer\Mailer(
         Transport::fromDsn($config['mailer']['dsn']),
     ));
diff --git a/src/Account/Service/Announcement/AnnouncementLedger.php b/src/Account/Service/Announcement/AnnouncementLedger.php
new file mode 100644
index 00000000..b182cdff
--- /dev/null
+++ b/src/Account/Service/Announcement/AnnouncementLedger.php
@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Account\Service\Announcement;
+
+/**
+ * Mémoire de l'annonce (#444) : un identifiant de compte par ligne, ajouté dès que son e-mail est parti. Un fichier plutôt qu'une
+ * table : l'annonce est un envoi unique, une migration n'aurait pas de second usage. Aucune adresse n'y est écrite.
+ */
+final class AnnouncementLedger
+{
+    /** @var array<int, true>|null */
+    private ?array $sent = null;
+
+    public function __construct(private readonly string $path)
+    {
+    }
+
+    public function has(int $userId): bool
+    {
+        return isset($this->load()[$userId]);
+    }
+
+    public function add(int $userId): void
+    {
+        // Écrit tout de suite : un envoi interrompu à mi-parcours ne renvoie pas aux comptes déjà servis.
+        file_put_contents($this->path, $userId . "\n", FILE_APPEND | LOCK_EX);
+        $this->sent = $this->load() + [$userId => true];
+    }
+
+    /** @return array<int, true> */
+    private function load(): array
+    {
+        if ($this->sent !== null) {
+            return $this->sent;
+        }
+        $this->sent = [];
+        $lines = is_file($this->path) ? file($this->path, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES) : false;
+        foreach ($lines ?: [] as $line) {
+            if (ctype_digit($line)) {
+                $this->sent[(int) $line] = true;
+            }
+        }
+
+        return $this->sent;
+    }
+}
diff --git a/src/Account/Service/Announcement/AnnouncementReport.php b/src/Account/Service/Announcement/AnnouncementReport.php
new file mode 100644
index 00000000..8658d8db
--- /dev/null
+++ b/src/Account/Service/Announcement/AnnouncementReport.php
@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Account\Service\Announcement;
+
+/** Bilan d'un passage de l'annonce (#444). Aucune adresse : seulement des comptes. */
+final class AnnouncementReport
+{
+    public function __construct(
+        private readonly int $sent,
+        private readonly int $failed,
+        private readonly int $alreadySent,
+        private readonly int $pending,
+    ) {
+    }
+
+    public function sent(): int
+    {
+        return $this->sent;
+    }
+
+    public function failed(): int
+    {
+        return $this->failed;
+    }
+
+    public function alreadySent(): int
+    {
+        return $this->alreadySent;
+    }
+
+    /** Comptes à qui l'annonce partirait lors d'un envoi réel. */
+    public function pending(): int
+    {
+        return $this->pending;
+    }
+}
diff --git a/src/Account/Service/Announcement/AnnouncementService.php b/src/Account/Service/Announcement/AnnouncementService.php
new file mode 100644
index 00000000..eafcda68
--- /dev/null
+++ b/src/Account/Service/Announcement/AnnouncementService.php
@@ -0,0 +1,80 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Account\Service\Announcement;
+
+use App\Account\Repository\UserRepositoryInterface;
+use App\Mail\Mailbox;
+use Symfony\Component\Mime\Email;
+
+/**
+ * E-mail d'annonce « l'appli est ouverte » (#444) : une fois, à chaque compte actif. Trois gestes, du plus sûr au plus engageant :
+ * simulation (rien ne part), essai à UNE adresse (sans mémoire), envoi réel (chaque compte servi est noté : relancer ne crée aucun doublon).
+ */
+final class AnnouncementService
+{
+    public function __construct(
+        private readonly UserRepositoryInterface $users,
+        private readonly Mailbox $mailbox,
+        private readonly AnnouncementLedger $ledger,
+    ) {
+    }
+
+    public function dryRun(): AnnouncementReport
+    {
+        [$todo, $done] = $this->split();
+
+        return new AnnouncementReport(0, 0, count($done), count($todo));
+    }
+
+    public function sendToAll(): AnnouncementReport
+    {
+        [$todo, $done] = $this->split();
+        $sent = $failed = 0;
+        foreach ($todo as $user) {
+            if ($this->mailbox->sendSafely(fn (): Email => $this->build($user->email()), "annonce, compte #{$user->id()}")) {
+                $this->ledger->add($user->id());
+                ++$sent;
+            } else {
+                ++$failed;
+            }
+        }
+
+        return new AnnouncementReport($sent, $failed, count($done), count($todo));
+    }
+
+    public function sendTest(string $to): AnnouncementReport
+    {
+        $ok = $this->mailbox->sendSafely(fn (): Email => $this->build($to), 'annonce, essai');
+
+        return new AnnouncementReport($ok ? 1 : 0, $ok ? 0 : 1, 0, 1);
+    }
+
+    /** @return array{0: list<\App\Account\Entity\User>, 1: list<\App\Account\Entity\User>} comptes actifs à servir, comptes déjà servis */
+    private function split(): array
+    {
+        $todo = $done = [];
+        foreach ($this->users->findAll() as $user) {
+            if (!$user->isActive()) {
+                continue;
+            }
+            if ($this->ledger->has($user->id())) {
+                $done[] = $user;
+            } else {
+                $todo[] = $user;
+            }
+        }
+
+        return [$todo, $done];
+    }
+
+    private function build(string $to): Email
+    {
+        return $this->mailbox->compose($to, "l'appli #B27 est ouverte", 'announcement', [
+            'link' => $this->mailbox->url('/login'),
+            'forgotLink' => $this->mailbox->url('/forgot-password'),
+            'preheader' => 'Voir à l’avance si le local est libre : mode d’emploi en 4 points.',
+        ]);
+    }
+}
diff --git a/tests/Account/Service/Announcement/AnnouncementServiceTest.php b/tests/Account/Service/Announcement/AnnouncementServiceTest.php
new file mode 100644
index 00000000..be5c04d8
--- /dev/null
+++ b/tests/Account/Service/Announcement/AnnouncementServiceTest.php
@@ -0,0 +1,137 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Account\Service\Announcement;
+
+use App\Account\Entity\User;
+use App\Account\Entity\UserRole;
+use App\Account\Repository\UserRepositoryInterface;
+use App\Account\Service\Announcement\AnnouncementLedger;
+use App\Account\Service\Announcement\AnnouncementService;
+use App\Mail\Mailbox;
+use App\Tests\Doubles\RecordingMailer;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\Mailer\Envelope;
+use Symfony\Component\Mailer\MailerInterface;
+use Symfony\Component\Mime\RawMessage;
+
+/** #444 : e-mail d'annonce envoyé UNE fois à chaque compte actif — simulation par défaut, reprise sans doublon. */
+final class AnnouncementServiceTest extends TestCase
+{
+    private RecordingMailer $mailer;
+    private string $ledgerPath;
+
+    protected function setUp(): void
+    {
+        $this->mailer = new RecordingMailer();
+        $this->ledgerPath = sys_get_temp_dir() . '/rb-announcement-' . bin2hex(random_bytes(6));
+    }
+
+    protected function tearDown(): void
+    {
+        @unlink($this->ledgerPath);
+    }
+
+    private function user(int $id, string $email, bool $active = true): User
+    {
+        return new User($id, $email, 'hash', 'Nom ' . $id, UserRole::Musicien, $active, 0, null);
+    }
+
+    /** @param list<User> $users */
+    private function service(array $users, ?MailerInterface $mailer = null): AnnouncementService
+    {
+        $repository = $this->createStub(UserRepositoryInterface::class);
+        $repository->method('findAll')->willReturn($users);
+
+        return new AnnouncementService(
+            $repository,
+            new Mailbox($mailer ?? $this->mailer, 'no-reply@rehearsalbox.example', 'https://b27.example'),
+            new AnnouncementLedger($this->ledgerPath),
+        );
+    }
+
+    #[Test]
+    public function testDryRunCountsTheActiveRecipientsAndSendsNothing(): void
+    {
+        $report = $this->service([$this->user(1, 'a@x.test'), $this->user(2, 'b@x.test'), $this->user(3, 'off@x.test', false)])->dryRun();
+
+        self::assertSame(2, $report->pending());
+        self::assertSame(0, $report->sent());
+        self::assertSame([], $this->mailer->sent);
+        self::assertFileDoesNotExist($this->ledgerPath);
+    }
+
+    #[Test]
+    public function testSendMailsEveryActiveAccountWithTheTwoLinksAndSkipsInactiveOnes(): void
+    {
+        $report = $this->service([$this->user(1, 'a@x.test'), $this->user(2, 'b@x.test'), $this->user(3, 'off@x.test', false)])->sendToAll();
+
+        self::assertSame(2, $report->sent());
+        self::assertSame(0, $report->failed());
+        self::assertCount(2, $this->mailer->sent);
+        self::assertSame('a@x.test', $this->mailer->sent[0]->getTo()[0]->getAddress());
+        $html = (string) $this->mailer->sent[0]->getHtmlBody();
+        self::assertStringContainsString('https://b27.example/forgot-password', $html);
+        self::assertStringContainsString('href="https://b27.example/login"', $html);
+    }
+
+    #[Test]
+    public function testASecondRunSendsNothingMoreBecauseEachSentAccountIsRemembered(): void
+    {
+        $users = [$this->user(1, 'a@x.test'), $this->user(2, 'b@x.test')];
+        $this->service($users)->sendToAll();
+        $second = $this->service($users)->sendToAll();
+
+        self::assertSame(0, $second->sent());
+        self::assertSame(2, $second->alreadySent());
+        self::assertCount(2, $this->mailer->sent, 'aucun doublon');
+    }
+
+    #[Test]
+    public function testAFailedSendIsCountedNotRememberedAndRetriedOnTheNextRun(): void
+    {
+        $flaky = new class () implements MailerInterface {
+            public int $calls = 0;
+
+            public function send(RawMessage $message, ?Envelope $envelope = null): void
+            {
+                if (++$this->calls === 1) {
+                    throw new \RuntimeException('SMTP indisponible');
+                }
+            }
+        };
+        $users = [$this->user(1, 'a@x.test'), $this->user(2, 'b@x.test')];
+
+        $first = $this->service($users, $flaky)->sendToAll();
+        self::assertSame(1, $first->failed());
+        self::assertSame(1, $first->sent(), "l'échec d'un compte n'arrête pas les suivants");
+
+        $second = $this->service($users, $flaky)->sendToAll();
+        self::assertSame(1, $second->sent(), 'seul le compte en échec est réessayé');
+        self::assertSame(1, $second->alreadySent());
+    }
+
+    #[Test]
+    public function testTestSendGoesToOneAddressOnlyAndDoesNotTouchTheLedger(): void
+    {
+        $report = $this->service([$this->user(1, 'a@x.test')])->sendTest('moi@x.test');
+
+        self::assertSame(1, $report->sent());
+        self::assertCount(1, $this->mailer->sent);
+        self::assertSame('moi@x.test', $this->mailer->sent[0]->getTo()[0]->getAddress());
+        self::assertFileDoesNotExist($this->ledgerPath);
+    }
+
+    #[Test]
+    public function testTheLedgerIgnoresGarbageLines(): void
+    {
+        file_put_contents($this->ledgerPath, "1\nabc\n\n2\n");
+        $ledger = new AnnouncementLedger($this->ledgerPath);
+
+        self::assertTrue($ledger->has(1));
+        self::assertTrue($ledger->has(2));
+        self::assertFalse($ledger->has(3));
+    }
+}

From a0b6cbef35a3d0320b5c56bec3906f21167df55a Mon Sep 17 00:00:00 2001
From: Ronan Lenouvel <ronan.lenouvel@orange.com>
Date: Sun, 11 Oct 2026 19:57:01 +0200
Subject: [PATCH 3/3] =?UTF-8?q?=F0=9F=9B=A0=EF=B8=8F=20chore(send-announce?=
 =?UTF-8?q?ment):=20script=20d'envoi,=20simulation=20par=20d=C3=A9faut,=20?=
 =?UTF-8?q?--test=20puis=20--send=20(#444)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 bin/send-announcement.php | 46 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 bin/send-announcement.php

diff --git a/bin/send-announcement.php b/bin/send-announcement.php
new file mode 100644
index 00000000..4f5c0474
--- /dev/null
+++ b/bin/send-announcement.php
@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+// Annonce « l'appli est ouverte » (#444) : un e-mail à chaque compte actif. À lancer À LA MAIN, une fois.
+//   php bin/send-announcement.php                       simulation : compte les destinataires, n'envoie RIEN
+//   php bin/send-announcement.php --test=moi@exemple.fr envoi d'essai à UNE adresse (sans mémoire)
+//   php bin/send-announcement.php --send                envoi réel ; chaque compte servi est noté dans storage/announcement-sent.txt,
+//                                                       relancer ne renvoie qu'aux comptes en échec ou ajoutés depuis
+// Code de sortie : 0 = succès, 1 = au moins un échec d'envoi, 2 = option inconnue. Le bilan ne contient aucune adresse.
+
+if (PHP_SAPI !== 'cli') {
+    http_response_code(404);
+    exit(1);
+}
+
+require __DIR__ . '/../vendor/autoload.php';
+
+use App\Account\Service\Announcement\AnnouncementService;
+
+$options = getopt('', ['send', 'test:']);
+foreach (array_slice($argv, 1) as $arg) {
+    if ($arg !== '--send' && !str_starts_with($arg, '--test=')) {
+        fwrite(STDERR, "Option inconnue. Voir l'en-tête de bin/send-announcement.php.\n");
+        exit(2);
+    }
+}
+
+$config = require __DIR__ . '/../config/config.php';
+$service = (require __DIR__ . '/../config/services.php')($config)->get(AnnouncementService::class);
+
+if (isset($options['test'])) {
+    $report = $service->sendTest((string) $options['test']);
+    echo $report->sent() === 1 ? "Essai envoyé.\n" : "Essai en échec (voir le journal).\n";
+    exit($report->failed() > 0 ? 1 : 0);
+}
+
+if (!isset($options['send'])) {
+    $report = $service->dryRun();
+    printf("Simulation : %d destinataire(s) à servir, %d déjà servi(s). Rien n'a été envoyé.\n", $report->pending(), $report->alreadySent());
+    exit(0);
+}
+
+$report = $service->sendToAll();
+printf("%d envoyé(s), %d échec(s), %d déjà servi(s).\n", $report->sent(), $report->failed(), $report->alreadySent());
+exit($report->failed() > 0 ? 1 : 0);