diff --git a/src/app/rejoindre/page.tsx b/src/app/rejoindre/page.tsx
index 9c5237c..218ea38 100644
--- a/src/app/rejoindre/page.tsx
+++ b/src/app/rejoindre/page.tsx
@@ -1,27 +1,47 @@
import {
ArrowLeft,
+ ArrowRight,
CalendarDays,
Coins,
+ Hand,
HeartHandshake,
Mail,
+ MapPin,
MessagesSquare,
- Sparkles,
Users,
} from "lucide-react";
import type { Metadata } from "next";
+import Image from "next/image";
import Link from "next/link";
import { JoinForm } from "@/components/join-form";
import { SiteFooter } from "@/components/site-footer";
import { SiteHeader } from "@/components/site-header";
+import { WhatsappInviteCard } from "@/components/whatsapp-invite-card";
+import { getUpcomingPublishedEvents } from "@/lib/data";
+import { formatDateTime, formatLongDateTime } from "@/lib/dates";
import { getAssociationSettings } from "@/lib/services/association-settings";
export const dynamic = "force-dynamic";
+/**
+ * Page publique « Rejoindre l'association ».
+ *
+ * Elle s'adresse à un parent qui ne connaît personne : elle répond d'abord à ce
+ * qui le retient, montre ensuite que l'association existe pour de vrai — les
+ * rendez-vous réellement publiés, les places qui restent — puis lui laisse deux
+ * portes, l'une basse (prendre un créneau sans compte), l'autre écrite.
+ *
+ * Règle de confidentialité : getUpcomingPublishedEvents() rapporte aussi les
+ * inscriptions des bénévoles (nom, e-mail, jeton d'annulation). Tout reste dans
+ * ce composant serveur ; ne transmettre à un composant client que des primitives
+ * déjà calculées, jamais un événement ou un créneau entier.
+ */
+
export async function generateMetadata(): Promise {
const settings = await getAssociationSettings();
const title = `Rejoindre ${settings.associationName}`;
- const description = `Ce que fait ${settings.associationName} à ${settings.schoolName}, et comment en être.`;
+ const description = `Ce que fait ${settings.associationName} à ${settings.schoolName}, et comment y prendre part — sans engagement.`;
return {
title,
description,
@@ -29,165 +49,680 @@ export async function generateMetadata(): Promise {
};
}
-const ACTIONS = [
+const OBJECTIONS = [
+ {
+ phrase: "Je n’ai pas le temps.",
+ reponse:
+ "Personne n’en a. C’est pour ça que tout est découpé en créneaux courts, annoncés à l’avance. Deux heures un samedi matin, une fois dans l’année, c’est déjà un vrai coup de main — et personne ici ne tient le compte des heures des autres.",
+ },
+ {
+ phrase: "Je ne connais personne.",
+ reponse:
+ "C’est exactement ce que préparer quelque chose ensemble règle en une matinée. On installe à deux, on sert à trois, on range à plusieurs, et on repart en connaissant des visages. Les familles qui viennent d’arriver entrent souvent par là.",
+ },
+ {
+ phrase: "Je ne saurais pas quoi faire.",
+ reponse:
+ "Il n’y a rien à savoir d’avance. Chaque créneau porte un intitulé, un horaire et le nombre de personnes attendues : vous choisissez celui qui vous va, et on vous montre en arrivant.",
+ },
+ {
+ phrase: "Et si je dis oui, puis que je ne peux plus ?",
+ reponse:
+ "Ça arrive, et c’est prévu. L’e-mail de confirmation contient un lien qui retire votre inscription en un clic, sans avoir à vous justifier ni à prévenir qui que ce soit.",
+ },
+];
+
+const MISSIONS = [
{
icon: CalendarDays,
- title: "Organiser les temps forts",
- text: "Kermesse, vide-grenier, boom, venue du Père Noël : l’association monte les rendez-vous qui font l’année des enfants.",
+ numero: "01",
+ titre: "Les temps forts de l’année",
+ texte:
+ "L’association monte les rendez-vous qui font l’année des enfants : ceux qu’on prépare des semaines à l’avance et dont ils parlent encore en juin.",
},
{
icon: Coins,
- title: "Financer les projets de l’école",
- text: "Les bénéfices des ventes et des événements reviennent aux classes : sorties, spectacles, matériel, voyages.",
+ numero: "02",
+ titre: "Les projets des classes",
+ texte:
+ "Ce que rapportent les ventes et les événements repart vers les classes : sorties, spectacles, matériel.",
},
{
icon: MessagesSquare,
- title: "Porter la voix des parents",
- text: "L’association représente les familles auprès de la direction et relaie ce qui compte pour elles.",
+ numero: "03",
+ titre: "La voix des parents",
+ texte:
+ "L’association représente les familles auprès de la direction et fait remonter ce qui compte pour elles. Une voix collective porte plus loin qu’un mot dans un carnet.",
},
{
icon: Users,
- title: "Créer du lien entre familles",
- text: "On se croise, on prépare, on partage un café : c’est souvent là que les nouvelles familles trouvent leur place.",
+ numero: "04",
+ titre: "Le lien entre les familles",
+ texte:
+ "On prépare ensemble, on discute en rangeant, et l’école devient un endroit où l’on connaît des visages.",
},
];
-const ENGAGEMENTS = [
- "Deux heures sur un stand, une fois dans l’année : c’est déjà un vrai coup de main.",
- "Un savoir-faire ponctuel — affiches, pâtisserie, bricolage, photos — sans réunion à la clé.",
- "Une place au bureau, pour celles et ceux qui veulent s’impliquer davantage.",
+const ETAPES = [
+ {
+ titre: "Vous écrivez",
+ texte: "Deux ou trois lignes suffisent : qui vous êtes, ce qui vous intrigue.",
+ },
+ {
+ titre: "On vous répond",
+ texte: "Un parent de l’équipe vous répond par e-mail.",
+ },
+ {
+ titre: "Vous décidez",
+ texte:
+ "Rien n’est engagé tant que vous n’avez pas dit oui. Ce message n’est ni une adhésion ni une inscription, et il n’y a rien à payer sur cette page.",
+ },
+];
+
+const AMORCES = [
+ "Je peux venir donner un coup de main sur un événement, prévenez-moi.",
+ "Je ne sais pas encore, j’aimerais surtout savoir ce qui se prépare.",
+ "J’aimerais m’impliquer davantage, comment ça marche ?",
+];
+
+/** Teintes des tuiles de mission, pour éviter quatre boîtes blanches identiques. */
+const TEINTES_MISSIONS = [
+ {
+ fond: "bg-brand-950 text-white",
+ pastille: "bg-white text-brand-950",
+ numero: "text-brand-300",
+ texte: "text-brand-100",
+ },
+ {
+ fond: "bg-brand-100 text-brand-950",
+ pastille: "bg-brand-950 text-white",
+ numero: "text-brand-800",
+ texte: "text-brand-900",
+ },
+ {
+ fond: "bg-sea-200 text-brand-950",
+ pastille: "bg-brand-950 text-white",
+ numero: "text-brand-700",
+ texte: "text-brand-950",
+ },
+ {
+ fond: "bg-brand-950 text-white",
+ pastille: "bg-white text-brand-950",
+ numero: "text-brand-300",
+ texte: "text-brand-100",
+ },
];
export default async function RejoindrePage() {
- const settings = await getAssociationSettings();
+ const [settings, events] = await Promise.all([
+ getAssociationSettings(),
+ getUpcomingPublishedEvents(),
+ ]);
+
+ // Agrégats calculés ici, côté serveur : rien de ce qui vient de la base ne
+ // descend jusqu'au navigateur en dehors de ces nombres et de ces chaînes.
+ const placesOuvertes = events.reduce(
+ (total, event) =>
+ total +
+ event.volunteerSlots.reduce(
+ (somme, slot) => somme + Math.max(0, slot.capacity - slot.signups.length),
+ 0,
+ ),
+ 0,
+ );
+ const prochains = events.slice(0, 3).map((event, index) => ({
+ id: event.id,
+ titre: event.title,
+ date: formatDateTime(event.startAt),
+ lieu: event.location,
+ jeton: event.shareToken,
+ restantes: event.volunteerSlots.reduce(
+ (somme, slot) => somme + Math.max(0, slot.capacity - slot.signups.length),
+ 0,
+ ),
+ filet: index % 2 === 0 ? "bg-brand-700" : "bg-sea-500",
+ }));
+ const prochain = events[0]
+ ? {
+ titre: events[0].title,
+ date: formatLongDateTime(events[0].startAt),
+ jeton: events[0].shareToken,
+ }
+ : null;
+ const contactEmail = settings.contactEmail?.trim() || null;
+ const rna = settings.rna?.trim() || null;
return (
+ {/* ————— Héros : la promesse, deux portes d'action, et la preuve chiffrée ————— */}
-
- {settings.associationName} réunit les parents d’élèves de{" "}
- {settings.schoolName}. On y donne le temps qu’on a, pas celui
- qu’on n’a pas — et chaque coup de main sert directement aux
- enfants.
-
+ On donne le temps qu’on a,{" "}
+ pas celui qu’on n’a pas.
+
+
+ {settings.associationName} réunit les parents d’élèves de{" "}
+ {settings.schoolName}. On y prépare les rendez-vous de l’année
+ et on cherche des mains pour les tenir. Deux heures une fois, ou
+ davantage si l’envie vient : rien n’est obligatoire, et rien
+ n’est décidé d’avance.
+
+ L’agenda se remplit d’une période à l’autre. Écrivez-nous :
+ on vous préviendra du prochain rendez-vous plutôt que de
+ vous laisser guetter la page.
+
+
+ )}
+
+ {events.length > 0 && (
+
+
+
+ {events.length}
+
+
+ rendez-vous à venir
+
+
+ {placesOuvertes > 0 ? (
+
+
+ {placesOuvertes}
+
+
+ coup{placesOuvertes > 1 ? "s" : ""} de main recherché
+ {placesOuvertes > 1 ? "s" : ""}
+
+
+ ) : (
+
+ Toutes les places sont prises pour l’instant.
+
+ )}
+
+ )}
+
+
-
-
-
- Ce que fait l’association
+ {/* ————— Respiration : une phrase, un aplat, aucune demande ————— */}
+
+
+
+
+ Une école qui bouge, ce sont des parents qui s’y mettent.
-
- Quatre missions, toute l’année
-
-
- {ACTIONS.map(({ icon: Icon, title, text }) => (
-
+
+
+ {/* ————— Le mur des « oui, mais… » : le seul bloc qui tient debout sans données ————— */}
+
+
-
-
+ {/* ————— La porte basse : les rendez-vous réels, où l'on prend un créneau sans compte ————— */}
+
+
+
+
+
+ Sans écrire à personne
+
+
+ Vous pouvez aussi juste venir voir.
+
+
+
+ Ce ne sont pas des exemples : ce sont les rendez-vous déjà
+ publiés par l’association, avec les places qui restent à prendre.
+
+
+
+ {prochains.length === 0 ? (
+
+
+
-
-
- S’engager, à la mesure de chacun
-
-
- {ENGAGEMENTS.map((item) => (
-
+ Rien de publié en ce moment
+
+
+ L’agenda se remplit d’une période à l’autre. Écrivez-nous : on
+ vous préviendra du prochain rendez-vous plutôt que de vous
+ laisser guetter la page.
+
- Pas besoin de savoir déjà ce que vous voulez faire : dites-nous
- qui vous êtes, on vous rappellera ce qui se prépare.
- {settings.contactEmail && (
- <>
- {" "}
- Vous préférez votre messagerie ?{" "}
-
-
- {settings.contactEmail}
-
-
- )}
-
-
-
+
+
+
+ )}
+
+ {/* ————— Le coupon-réponse : ce qui se passe après l'envoi, puis le formulaire ————— */}
+
+
+
+
+
+
+ {contactEmail ? (
+ <>
+
+ Écrire à {settings.associationName}
+
+
+ Quelques mots suffisent. Vous pouvez aussi simplement dire
+ bonjour.
+
+
+
+
+ Si vous ne savez pas quoi écrire, recopiez une de ces
+ phrases
+
+
+ {AMORCES.map((amorce) => (
+
+
+ « {amorce} »
+
+ ))}
+
+
+
+
+
+
+
+ ) : (
+ <>
+
+ Le formulaire n’est pas disponible pour l’instant
+
+
+ L’association n’a pas encore publié d’adresse de contact :
+ votre message ne partirait nulle part. Repassez d’ici
+ quelques jours, ou parlez-en à un parent de l’équipe à la
+ sortie de l’école.
+
+
+ )}
+
+
+
+
+
+ Retour à l’accueil
+
diff --git a/src/components/association-settings-form.tsx b/src/components/association-settings-form.tsx
index 4a33b8c..b383bad 100644
--- a/src/components/association-settings-form.tsx
+++ b/src/components/association-settings-form.tsx
@@ -6,6 +6,7 @@ import {
Building2,
CircleAlert,
KeyRound,
+ MessageCircle,
Save,
ShieldCheck,
} from "lucide-react";
@@ -16,6 +17,7 @@ import { LogoUploadField } from "@/components/logo-upload-field";
import { useToast } from "@/components/toast";
import { Button, Card, Field, Input, Select } from "@/components/ui";
import { api } from "@/lib/client";
+import { checkWhatsappUrl, estInvitationGroupe } from "@/lib/whatsapp";
export interface AssociationSettingsView {
associationName: string;
@@ -36,6 +38,7 @@ export interface AssociationSettingsView {
recaptchaSecretConfigured: boolean;
recaptchaMinScore: number;
recaptchaReady: boolean;
+ whatsappGroupUrl: string | null;
legacyEnvironment: boolean;
}
@@ -47,6 +50,17 @@ export function AssociationSettingsForm({
const router = useRouter();
const toast = useToast();
const [saving, setSaving] = useState(false);
+ const [whatsappGroupUrl, setWhatsappGroupUrl] = useState(
+ settings.whatsappGroupUrl ?? "",
+ );
+ const [erreurWhatsapp, setErreurWhatsapp] = useState(null);
+ const verdictWhatsapp = checkWhatsappUrl(whatsappGroupUrl);
+ // Prévient sans bloquer : un lien raccourci ou une redirection maison reste
+ // acceptable, mais l'administrateur doit voir qu'il n'a pas collé l'invitation.
+ const whatsappInhabituel =
+ verdictWhatsapp.ok &&
+ verdictWhatsapp.url !== null &&
+ !estInvitationGroupe(verdictWhatsapp.url);
async function save(event: React.FormEvent) {
event.preventDefault();
@@ -57,6 +71,16 @@ export function AssociationSettingsForm({
).trim();
const recaptchaSecret = String(form.get("recaptchaSecret") ?? "").trim();
+ // Contrôlé ici en plus du serveur : handleApiError réduit toute erreur zod
+ // à « Données invalides », le message utile ne serait jamais lu.
+ const whatsapp = checkWhatsappUrl(whatsappGroupUrl);
+ if (!whatsapp.ok) {
+ setErreurWhatsapp(whatsapp.message);
+ setSaving(false);
+ document.getElementById("whatsapp-group-url")?.focus();
+ return;
+ }
+
try {
await api("/api/settings/association", {
method: "PATCH",
@@ -80,6 +104,7 @@ export function AssociationSettingsForm({
recaptchaEnabled: form.get("recaptchaEnabled") === "on",
recaptchaSiteKey: form.get("recaptchaSiteKey") || null,
recaptchaMinScore: Number(form.get("recaptchaMinScore")),
+ whatsappGroupUrl: whatsapp.url,
clearRecaptchaSecret:
!recaptchaSecret && form.get("clearRecaptchaSecret") === "on",
...(recaptchaSecret ? { recaptchaSecret } : {}),
@@ -337,6 +362,60 @@ export function AssociationSettingsForm({
+
+
+
+
+
+
+
Groupe WhatsApp
+
+ Annoncé aux familles sur la page « Rejoindre l’association »
+ et dans le pied de page du site public.
+
+ {erreurWhatsapp ??
+ (whatsappInhabituel
+ ? "Ce lien ne ressemble pas à une invitation de groupe WhatsApp — il sera tout de même enregistré et affiché."
+ : "Facultatif. Sans lien, rien n’est annoncé sur le site public.")}
+
+
+
+
diff --git a/src/components/event-form.tsx b/src/components/event-form.tsx
index 9c75329..6e3f319 100644
--- a/src/components/event-form.tsx
+++ b/src/components/event-form.tsx
@@ -1,6 +1,6 @@
"use client";
-import { Globe, Lock } from "lucide-react";
+import { Globe, Lock, Ticket } from "lucide-react";
import { useRouter } from "next/navigation";
import { useState, type ReactNode } from "react";
@@ -9,6 +9,7 @@ import { Button, Input, Label, Select } from "@/components/ui";
import { ApiError, api } from "@/lib/client";
import { toDatetimeLocal } from "@/lib/dates";
import type { Event } from "@/lib/db/schema";
+import { checkTicketingUrl, ticketingHostLabel } from "@/lib/ticketing";
import { useMutationError } from "@/lib/use-mutation-error";
export function EventForm({
@@ -28,6 +29,15 @@ export function EventForm({
const [publicDescription, setPublicDescription] = useState(
event?.publicDescription ?? "",
);
+ // `?? ""` obligatoire : la colonne vaut null en base, et un input contrôlé
+ // qui reçoit null repasse en non contrôlé.
+ const [ticketingUrl, setTicketingUrl] = useState(event?.ticketingUrl ?? "");
+ const [erreurBilletterie, setErreurBilletterie] = useState(null);
+ const verdictBilletterie = checkTicketingUrl(ticketingUrl);
+ // Sert à prévenir sans bloquer quand la billetterie n'est pas HelloAsso.
+ const hoteBilletterie = verdictBilletterie.ok
+ ? ticketingHostLabel(verdictBilletterie.url)
+ : null;
async function onSubmit(e: React.FormEvent) {
e.preventDefault();
@@ -35,10 +45,21 @@ export function EventForm({
setLoading(true);
const form = new FormData(e.currentTarget);
const endRaw = form.get("endAt");
+
+ // Contrôlée ici en plus du serveur : handleApiError réduit toute erreur zod
+ // à « Données invalides », le message utile ne serait jamais lu.
+ const billetterie = checkTicketingUrl(ticketingUrl);
+ if (!billetterie.ok) {
+ setErreurBilletterie(billetterie.message);
+ setLoading(false);
+ document.getElementById("ticketingUrl")?.focus();
+ return;
+ }
const body = {
title: form.get("title"),
description,
publicDescription,
+ ticketingUrl: billetterie.url,
location: form.get("location"),
startAt: form.get("startAt"),
endAt: endRaw ? endRaw : null,
@@ -180,6 +201,61 @@ export function EventForm({
+
+
+
+
+
+
+ Ce lien sert aux familles qui veulent venir : il ne
+ remplace pas les créneaux de bénévoles, qui restent gérés ici.
+ Ouvrez votre billetterie dans le navigateur et copiez l’adresse
+ affichée dans la barre du haut.
+
+ refuse
+ // « www.helloasso.com/… » sans schéma avec une bulle du navigateur,
+ // dans la langue du système, avant que nos messages ne s'affichent.
+ type="text"
+ inputMode="url"
+ spellCheck={false}
+ value={ticketingUrl}
+ onChange={(e) => {
+ setTicketingUrl(e.target.value);
+ setErreurBilletterie(null);
+ }}
+ onBlur={() => {
+ const verdict = checkTicketingUrl(ticketingUrl);
+ setErreurBilletterie(verdict.ok ? null : verdict.message);
+ }}
+ aria-invalid={erreurBilletterie ? true : undefined}
+ aria-describedby="ticketingUrl-aide"
+ placeholder="https://www.helloasso.com/associations/…/evenements/…"
+ />
+
+ {erreurBilletterie ??
+ (hoteBilletterie && hoteBilletterie !== "HelloAsso"
+ ? `Ce n’est pas un lien HelloAsso : les familles verront « sur ${hoteBilletterie} ». C’est accepté, vérifiez simplement que la page est bien celle de la réservation.`
+ : "Facultatif. Sans lien, la page publique ne parle que des créneaux de bénévoles.")}
+
+
+
+
+
@@ -201,7 +277,7 @@ export function EventForm({
{!editing && templates.length > 0 && (
diff --git a/src/components/join-form.tsx b/src/components/join-form.tsx
index e2679a1..704946c 100644
--- a/src/components/join-form.tsx
+++ b/src/components/join-form.tsx
@@ -10,9 +10,12 @@ import { useRecaptcha } from "@/lib/use-recaptcha";
export function JoinForm({
contactEmail,
recaptchaSiteKey = null,
+ whatsappGroupUrl = null,
}: {
contactEmail: string | null;
recaptchaSiteKey?: string | null;
+ /** Proposé pendant l'attente de la réponse : on suit sans avoir écrit. */
+ whatsappGroupUrl?: string | null;
}) {
const executerRecaptcha = useRecaptcha(recaptchaSiteKey);
const [loading, setLoading] = useState(false);
@@ -67,6 +70,22 @@ export function JoinForm({
) : null}
.
+ {whatsappGroupUrl && (
+
);
@@ -173,8 +216,10 @@ export function VolunteerSignupForm({
+ {/* « Je m'inscris » est le mot qu'un parent emploie pour inscrire son
+ enfant à la kermesse : il ne peut pas désigner ici le bénévolat. */}
);
diff --git a/src/components/whatsapp-invite-card.tsx b/src/components/whatsapp-invite-card.tsx
new file mode 100644
index 0000000..b1db628
--- /dev/null
+++ b/src/components/whatsapp-invite-card.tsx
@@ -0,0 +1,150 @@
+import {
+ ArrowUpRight,
+ CalendarDays,
+ HandHeart,
+ Megaphone,
+ MessageCircle,
+} from "lucide-react";
+
+/**
+ * Carton d'invitation au groupe WhatsApp de l'association.
+ *
+ * L'aperçu de conversation est une illustration, et il est cadré comme telle :
+ * la légende « Exemple de ce qui circule dans le groupe » est visible et placée
+ * avant les bulles, de sorte que personne — voyant ou non — ne puisse prendre
+ * ces trois phrases pour des messages réellement envoyés. Pas d'horodatage, pas
+ * de double coche, pas de prénom, pas d'émoticône : une seule voix, celle de
+ * l'association, et rien qui ressemble à une capture d'écran.
+ *
+ * Le vert de la marque n'apparaît qu'aux deux endroits où il signifie WhatsApp
+ * — le sceau et le bouton — et porte une encre bleu nuit : du blanc sur ce vert
+ * tomberait à 1,98:1, la « correction » que tout relecteur propose au premier
+ * coup d'œil. Le reste est la palette du site.
+ */
+
+const APERCU = [
+ {
+ icon: CalendarDays,
+ texte: "Les dates des rendez-vous, avec un rappel avant le jour J.",
+ largeur: "max-w-[26rem]",
+ },
+ {
+ icon: Megaphone,
+ texte: "Les changements de dernière minute, annoncés là où on les lit vite.",
+ largeur: "max-w-[30rem]",
+ },
+ {
+ icon: HandHeart,
+ texte: "Les coups de main cherchés, quand il manque quelqu’un sur un créneau.",
+ largeur: "max-w-[24rem]",
+ },
+];
+
+export function WhatsappInviteCard({
+ url,
+ associationName,
+}: {
+ url: string;
+ associationName: string;
+}) {
+ return (
+
+
+
+
+
+ {/* Double filet : la signature du carton gravé. */}
+
+
+
+
+
+
+
+
+
+
+ Vous êtes invités
+
+
+ Toutes les infos, dans un seul groupe WhatsApp
+
+
+ {associationName} tient un groupe WhatsApp ouvert aux familles.
+ Les dates, les rappels, les changements de dernière minute et les
+ coups de main cherchés y sont annoncés : vous suivez ce qui se
+ prépare sans avoir à le chercher.
+
+
+
+
+
+
+ Exemple de ce qui circule dans le groupe.
+
+
+ Votre numéro sera visible des autres membres du groupe, et vous
+ pouvez en sortir quand vous voulez. Pas de WhatsApp ?{" "}
+
+ Écrivez-nous
+ {" "}
+ plutôt.
+
+
+
+
+
+ );
+}
diff --git a/src/lib/db/schema.ts b/src/lib/db/schema.ts
index 94257cc..da3a483 100644
--- a/src/lib/db/schema.ts
+++ b/src/lib/db/schema.ts
@@ -145,6 +145,13 @@ export const events = pgTable("events", {
description: text("description"),
/** Texte affiché sur l'accueil public et sur la page d'inscription. */
publicDescription: text("public_description"),
+ /**
+ * Billetterie ou réservation en ligne de l'événement (HelloAsso le plus
+ * souvent). Présentée aux familles comme une action distincte du bénévolat :
+ * « je réserve ma place » n'est pas « je donne un coup de main ».
+ * `null` quand l'événement n'a pas de billetterie — rien n'est alors affiché.
+ */
+ ticketingUrl: text("ticketing_url"),
location: text("location"),
startAt: timestamp("start_at", { withTimezone: true }).notNull(),
endAt: timestamp("end_at", { withTimezone: true }),
@@ -603,6 +610,12 @@ export const associationSettings = pgTable(
recaptchaSiteKey: text("recaptcha_site_key"),
encryptedRecaptchaSecret: text("encrypted_recaptcha_secret"),
recaptchaMinScore: integer("recaptcha_min_score").notNull().default(50),
+ /**
+ * Lien d'invitation au groupe WhatsApp, affiché sur les pages publiques.
+ * Vide : aucun encart n'est rendu. Ce n'est pas un secret — il est fait pour
+ * être publié — mais il n'a rien à faire dans un journal d'audit.
+ */
+ whatsappGroupUrl: text("whatsapp_group_url"),
/**
* Paire de clés VAPID des notifications sur appareil, engendrée au premier
* abonnement : rien à créer ni à recopier pour l'exploitant. La clé
diff --git a/src/lib/mcp/register-core-tools.ts b/src/lib/mcp/register-core-tools.ts
index 0f4f77f..e36c3fb 100644
--- a/src/lib/mcp/register-core-tools.ts
+++ b/src/lib/mcp/register-core-tools.ts
@@ -178,6 +178,8 @@ export function registerCoreTools(
description: optionalNullableString,
/** Affiché sur l'accueil public et sur la page d'inscription. */
publicDescription: optionalNullableString,
+ /** Billetterie en ligne (HelloAsso…) : « je réserve ma place ». */
+ ticketingUrl: optionalNullableString,
location: optionalNullableString,
startAt: localDateTime,
endAt: localDateTime.nullable().optional(),
@@ -194,6 +196,7 @@ export function registerCoreTools(
title: data.title,
description: emptyToNull(data.description),
publicDescription: emptyToNull(data.publicDescription),
+ ticketingUrl: data.ticketingUrl ?? null,
location: emptyToNull(data.location),
startAt: data.startAt,
endAt: data.endAt ?? null,
@@ -227,6 +230,8 @@ export function registerCoreTools(
description: optionalNullableString,
/** Affiché sur l'accueil public et sur la page d'inscription. */
publicDescription: optionalNullableString,
+ /** Billetterie en ligne (HelloAsso…) : « je réserve ma place ». */
+ ticketingUrl: optionalNullableString,
location: optionalNullableString,
startAt: localDateTime.optional(),
endAt: localDateTime.nullable().optional(),
@@ -244,6 +249,8 @@ export function registerCoreTools(
updates.description = emptyToNull(data.description);
if (data.publicDescription !== undefined)
updates.publicDescription = emptyToNull(data.publicDescription);
+ if (data.ticketingUrl !== undefined)
+ updates.ticketingUrl = data.ticketingUrl;
if (data.location !== undefined)
updates.location = emptyToNull(data.location);
if (data.startAt !== undefined) updates.startAt = data.startAt;
diff --git a/src/lib/notifications/emails.ts b/src/lib/notifications/emails.ts
index 2ced5df..aed3d93 100644
--- a/src/lib/notifications/emails.ts
+++ b/src/lib/notifications/emails.ts
@@ -60,11 +60,13 @@ export function volunteerConfirmationEmail(ctx: VolunteerCtx): EmailContent {
? `
Lieu : ${esc(ctx.location)}
`
: "";
return {
- subject: `Inscription confirmée — ${ctx.eventTitle}`,
+ // « Inscription confirmée », lu seul dans une boîte mail trois jours plus
+ // tard, se prend pour une confirmation de billet.
+ subject: `Votre créneau du ${ctx.eventDate} — ${ctx.eventTitle}`,
html: layout(
- "Merci pour votre inscription ! 🎉",
+ "Merci pour votre coup de main ! 🎉",
`
Bonjour ${esc(ctx.name)},
-
Votre inscription comme bénévole est bien enregistrée :
+
Votre créneau de bénévole est bien enregistré :
Événement : ${esc(ctx.eventTitle)}
Date : ${ctx.eventDate}
@@ -75,7 +77,7 @@ export function volunteerConfirmationEmail(ctx: VolunteerCtx): EmailContent {
${button(ctx.cancelUrl, "Me désinscrire")}
`,
ctx.identity,
),
- text: `Bonjour ${ctx.name},\n\nInscription confirmée :\n- Événement : ${ctx.eventTitle}\n- Date : ${ctx.eventDate}\n- Créneau : ${ctx.slotTitle}\n${ctx.location ? `- Lieu : ${ctx.location}\n` : ""}\nMe désinscrire : ${ctx.cancelUrl}`,
+ text: `Bonjour ${ctx.name},\n\nCréneau de bénévole confirmé :\n- Événement : ${ctx.eventTitle}\n- Date : ${ctx.eventDate}\n- Créneau : ${ctx.slotTitle}\n${ctx.location ? `- Lieu : ${ctx.location}\n` : ""}\nMe désinscrire : ${ctx.cancelUrl}`,
};
}
diff --git a/src/lib/services/association-settings.ts b/src/lib/services/association-settings.ts
index a998b1f..e2525db 100644
--- a/src/lib/services/association-settings.ts
+++ b/src/lib/services/association-settings.ts
@@ -94,6 +94,7 @@ export async function getAssociationSettings() {
settings.recaptchaEnabled &&
Boolean(settings.recaptchaSiteKey) &&
Boolean(settings.encryptedRecaptchaSecret),
+ whatsappGroupUrl: settings.whatsappGroupUrl,
legacyEnvironment: false,
updatedAt: settings.updatedAt,
};
@@ -122,6 +123,9 @@ export async function getAssociationSettings() {
recaptchaSecretConfigured: false,
recaptchaMinScore: 50,
recaptchaReady: false,
+ // La branche de repli doit avoir la même forme que l'autre, sinon le champ
+ // devient `string | null | undefined` chez tous les appelants.
+ whatsappGroupUrl: null,
legacyEnvironment: Boolean(
process.env.NEXT_PUBLIC_ASSO_NAME ||
process.env.NEXT_PUBLIC_SCHOOL_NAME ||
@@ -258,6 +262,8 @@ export async function saveAssociationSettings(
recaptchaSiteKey,
encryptedRecaptchaSecret,
recaptchaMinScore: data.recaptchaMinScore,
+ // Déjà normalisé par le schéma : "" est devenu null.
+ whatsappGroupUrl: data.whatsappGroupUrl ?? null,
updatedBy: actor.userId,
updatedAt: new Date(),
};
@@ -281,6 +287,10 @@ export async function saveAssociationSettings(
telegramTokenCleared: data.clearTelegramBotToken,
taskReminderWindowDays: data.taskReminderWindowDays,
volunteerReminderWindowDays: data.volunteerReminderWindowDays,
+ // Un booléen, jamais l'adresse : le journal d'audit n'a pas à porter de
+ // lien d'invitation.
+ whatsappGroupChanged:
+ (data.whatsappGroupUrl ?? null) !== (current?.whatsappGroupUrl ?? null),
},
);
diff --git a/src/lib/services/events.ts b/src/lib/services/events.ts
index 5b34e83..e92ae69 100644
--- a/src/lib/services/events.ts
+++ b/src/lib/services/events.ts
@@ -212,6 +212,10 @@ export async function duplicateEvent(
title: emptyToNull(title ?? null) ?? source.title,
description: source.description,
publicDescription: source.publicDescription,
+ // La billetterie n'est PAS recopiée : elle est propre à une édition, et
+ // une copie qui pointe vers la vente de l'an dernier encaisserait pour
+ // le mauvais événement.
+ ticketingUrl: null,
location: source.location,
startAt,
endAt: shift(source.endAt),
diff --git a/src/lib/ticketing.ts b/src/lib/ticketing.ts
new file mode 100644
index 0000000..f44f7ca
--- /dev/null
+++ b/src/lib/ticketing.ts
@@ -0,0 +1,124 @@
+/**
+ * Lien de billetterie d'un événement (HelloAsso le plus souvent).
+ *
+ * Module volontairement pur — aucun import serveur — pour que la même règle
+ * serve au formulaire d'un organisateur et à la validation de l'API. Sans ce
+ * partage, le message affiché finirait par ne plus décrire la règle appliquée.
+ *
+ * Le champ n'est pas réservé à HelloAsso : une APEL peut vendre ses places sur
+ * Billetweb, sur le site de la mairie ou via un formulaire de l'OGEC. On n'est
+ * sévère que là où l'on sait de quoi on parle — c'est-à-dire sur helloasso.com,
+ * où l'on sait distinguer une billetterie d'un espace d'administration.
+ */
+
+export const TICKETING_URL_MAX = 2000;
+
+export type TicketingUrlError =
+ | "illisible"
+ | "protocole"
+ | "administration"
+ | "accueil"
+ | "longueur";
+
+export const TICKETING_URL_MESSAGES: Record = {
+ illisible:
+ "Cette adresse n’est pas reconnue. Ouvrez votre billetterie dans le navigateur et copiez l’adresse complète depuis la barre du haut : elle commence par https:// et ressemble à https://www.helloasso.com/associations/…/evenements/…",
+ protocole:
+ "Le lien doit commencer par https:// et non http:// — les familles vont y saisir un moyen de paiement. Recopiez l’adresse depuis votre billetterie plutôt que de la retaper.",
+ administration:
+ "Ce lien mène à votre espace d’administration HelloAsso : les familles n’y verraient qu’une page de connexion. Ouvrez votre billetterie dans une fenêtre de navigation privée — l’adresse affichée est celle à coller ici.",
+ accueil:
+ "Ce lien pointe vers l’accueil de HelloAsso, pas vers votre billetterie. Depuis votre page HelloAsso, ouvrez la campagne concernée et copiez l’adresse qui s’affiche alors.",
+ longueur:
+ "Cette adresse est anormalement longue. Vérifiez que vous avez collé un lien et non un bloc de code d’intégration (une balise iframe, par exemple) ; dans ce cas, seule l’adresse entre guillemets est nécessaire.",
+};
+
+export type TicketingUrlCheck =
+ | { ok: true; url: string | null }
+ | { ok: false; raison: TicketingUrlError; message: string };
+
+/** Sous-domaines HelloAsso qu'une famille ne peut pas utiliser. */
+const SOUS_DOMAINES_INTERNES = ["admin", "auth", "api"];
+
+/**
+ * Un nom d'hôte plausible : au moins un point, et rien d'autre que des
+ * étiquettes valides. Sans ce contrôle, `new URL()` accepte « pas une adresse »
+ * en percent-encodant les espaces, et l'organisateur croit son lien enregistré.
+ */
+function hoteVraisemblable(hostname: string): boolean {
+ return /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+$/.test(
+ hostname,
+ );
+}
+
+function estHelloAsso(hostname: string): boolean {
+ // Comparaison stricte, jamais un `includes` : « helloasso.com.piege.fr »
+ // contient la chaîne sans être HelloAsso.
+ return hostname === "helloasso.com" || hostname.endsWith(".helloasso.com");
+}
+
+/**
+ * Vérifie une saisie et rend l'adresse normalisée à stocker.
+ *
+ * Une chaîne vide n'est pas une erreur : le champ est facultatif, et la plupart
+ * des événements d'une APEL n'ont pas de billetterie.
+ */
+export function checkTicketingUrl(saisie: string | null | undefined): TicketingUrlCheck {
+ const brut = (saisie ?? "").trim();
+ if (!brut) return { ok: true, url: null };
+ if (brut.length > TICKETING_URL_MAX) {
+ return { ok: false, raison: "longueur", message: TICKETING_URL_MESSAGES.longueur };
+ }
+
+ // La barre d'adresse de Chrome copie « www.helloasso.com/… » sans schéma :
+ // le refuser pour cette seule raison serait absurde.
+ const candidat = /^[a-z][a-z0-9+.-]*:/i.test(brut) ? brut : `https://${brut}`;
+
+ let url: URL;
+ try {
+ url = new URL(candidat);
+ } catch {
+ return { ok: false, raison: "illisible", message: TICKETING_URL_MESSAGES.illisible };
+ }
+
+ if (!hoteVraisemblable(url.hostname)) {
+ return { ok: false, raison: "illisible", message: TICKETING_URL_MESSAGES.illisible };
+ }
+
+ if (url.protocol !== "https:") {
+ // http: comme javascript: tombent ici. On refuse au lieu de réécrire : une
+ // adresse en http est le plus souvent une adresse retapée à la main.
+ return { ok: false, raison: "protocole", message: TICKETING_URL_MESSAGES.protocole };
+ }
+
+ if (estHelloAsso(url.hostname)) {
+ const sousDomaine = url.hostname.split(".")[0];
+ if (SOUS_DOMAINES_INTERNES.includes(sousDomaine)) {
+ return {
+ ok: false,
+ raison: "administration",
+ message: TICKETING_URL_MESSAGES.administration,
+ };
+ }
+ const segments = url.pathname.split("/").filter(Boolean);
+ if (segments.length < 2) {
+ return { ok: false, raison: "accueil", message: TICKETING_URL_MESSAGES.accueil };
+ }
+ }
+
+ return { ok: true, url: url.toString() };
+}
+
+/**
+ * Nom du service à annoncer aux familles : « sur HelloAsso » rassure, « sur
+ * un autre site » inquiéterait. Rend null si l'adresse est illisible.
+ */
+export function ticketingHostLabel(url: string | null | undefined): string | null {
+ if (!url) return null;
+ try {
+ const hostname = new URL(url).hostname.replace(/^www\./, "");
+ return estHelloAsso(hostname) ? "HelloAsso" : hostname;
+ } catch {
+ return null;
+ }
+}
diff --git a/src/lib/validation.ts b/src/lib/validation.ts
index d6c0029..4093f00 100644
--- a/src/lib/validation.ts
+++ b/src/lib/validation.ts
@@ -2,6 +2,8 @@ import { z } from "zod";
import { parseLocalDateTime } from "@/lib/dates";
import { ASSOCIATION_DOCUMENT_TYPES } from "@/lib/labels";
+import { checkTicketingUrl, TICKETING_URL_MAX } from "@/lib/ticketing";
+import { checkWhatsappUrl, WHATSAPP_URL_MAX } from "@/lib/whatsapp";
import {
LEAD_TIME_MAX,
type LeadTimeUnit,
@@ -47,6 +49,20 @@ export const eventSchema = z.object({
/** Réservé à l'équipe. Ce qui doit être lu par les visiteurs va dans `publicDescription`. */
description: z.string().max(5000).optional(),
publicDescription: z.string().max(5000).optional(),
+ /** Billetterie en ligne : validée par la règle partagée avec le formulaire. */
+ ticketingUrl: z
+ .string()
+ .max(TICKETING_URL_MAX)
+ .optional()
+ .nullable()
+ .transform((valeur, ctx) => {
+ const verdict = checkTicketingUrl(valeur);
+ if (!verdict.ok) {
+ ctx.addIssue({ code: z.ZodIssueCode.custom, message: verdict.message });
+ return z.NEVER;
+ }
+ return verdict.url;
+ }),
location: z.string().max(300).optional(),
startAt: localDateTime,
endAt: localDateTime.nullable().optional(),
@@ -390,6 +406,20 @@ export const associationSettingsSchema = z.object({
clearRecaptchaSecret: z.boolean().default(false),
/** Note minimale acceptée, en pourcentage : Google note de 0 à 1. */
recaptchaMinScore: z.coerce.number().int().min(0).max(100).default(50),
+ /** Lien d'invitation du groupe WhatsApp, publié tel quel sur le site. */
+ whatsappGroupUrl: z
+ .string()
+ .max(WHATSAPP_URL_MAX)
+ .optional()
+ .nullable()
+ .transform((valeur, ctx) => {
+ const verdict = checkWhatsappUrl(valeur);
+ if (!verdict.ok) {
+ ctx.addIssue({ code: z.ZodIssueCode.custom, message: verdict.message });
+ return z.NEVER;
+ }
+ return verdict.url;
+ }),
});
/**
diff --git a/src/lib/whatsapp.ts b/src/lib/whatsapp.ts
new file mode 100644
index 0000000..2776214
--- /dev/null
+++ b/src/lib/whatsapp.ts
@@ -0,0 +1,102 @@
+/**
+ * Lien d'invitation au groupe WhatsApp de l'association.
+ *
+ * Module pur — aucun import serveur — partagé par le formulaire de
+ * configuration et par la validation de l'API, pour que le message affiché à
+ * l'administrateur décrive bien la règle appliquée.
+ *
+ * Le lien est destiné à être publié : ce n'est pas un secret, il n'est ni
+ * chiffré ni masqué. En revanche, il ouvre l'entrée du groupe à quiconque
+ * trouve la page — l'aide du champ le dit explicitement.
+ */
+
+export const WHATSAPP_URL_MAX = 500;
+
+export type WhatsappUrlError = "illisible" | "protocole" | "conversation" | "longueur";
+
+export const WHATSAPP_URL_MESSAGES: Record = {
+ illisible:
+ "Cette adresse n’est pas reconnue. Dans WhatsApp : Infos du groupe › Inviter via un lien › Copier le lien, puis collez-le ici — il ressemble à https://chat.whatsapp.com/…",
+ protocole:
+ "Le lien doit commencer par https:// — recopiez-le depuis WhatsApp plutôt que de le retaper.",
+ conversation:
+ "Ce lien ouvre une conversation avec une personne, pas un groupe. Utilisez le lien d’invitation du groupe : Infos du groupe › Inviter via un lien.",
+ longueur:
+ "Cette adresse est anormalement longue. Vérifiez que vous avez collé un lien et non un bloc de code.",
+};
+
+export type WhatsappUrlCheck =
+ | { ok: true; url: string | null }
+ | { ok: false; raison: WhatsappUrlError; message: string };
+
+/** Adresses WhatsApp qui ouvrent une discussion individuelle, pas un groupe. */
+const HOTES_CONVERSATION = ["wa.me", "api.whatsapp.com"];
+
+/**
+ * Un nom d'hôte plausible : au moins un point, et rien d'autre que des
+ * étiquettes valides. Sans ce contrôle, `new URL()` accepte « pas une adresse »
+ * en percent-encodant les espaces, et l'organisateur croit son lien enregistré.
+ */
+function hoteVraisemblable(hostname: string): boolean {
+ return /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+$/.test(
+ hostname,
+ );
+}
+
+function estHote(hostname: string, hote: string): boolean {
+ return hostname === hote || hostname.endsWith(`.${hote}`);
+}
+
+/**
+ * Vérifie une saisie et rend l'adresse normalisée à stocker.
+ *
+ * On n'est sévère que là où l'on sait de quoi on parle : une adresse WhatsApp
+ * qui n'est manifestement pas celle d'un groupe est refusée, mais un lien
+ * raccourci ou une redirection maison passe — l'association reste maîtresse de
+ * ce qu'elle publie.
+ */
+export function checkWhatsappUrl(saisie: string | null | undefined): WhatsappUrlCheck {
+ const brut = (saisie ?? "").trim();
+ if (!brut) return { ok: true, url: null };
+ if (brut.length > WHATSAPP_URL_MAX) {
+ return { ok: false, raison: "longueur", message: WHATSAPP_URL_MESSAGES.longueur };
+ }
+
+ const candidat = /^[a-z][a-z0-9+.-]*:/i.test(brut) ? brut : `https://${brut}`;
+ let url: URL;
+ try {
+ url = new URL(candidat);
+ } catch {
+ return { ok: false, raison: "illisible", message: WHATSAPP_URL_MESSAGES.illisible };
+ }
+
+ if (!hoteVraisemblable(url.hostname)) {
+ return { ok: false, raison: "illisible", message: WHATSAPP_URL_MESSAGES.illisible };
+ }
+
+ if (url.protocol !== "https:") {
+ return { ok: false, raison: "protocole", message: WHATSAPP_URL_MESSAGES.protocole };
+ }
+ if (url.username || url.password) {
+ return { ok: false, raison: "illisible", message: WHATSAPP_URL_MESSAGES.illisible };
+ }
+ if (HOTES_CONVERSATION.some((hote) => estHote(url.hostname, hote))) {
+ return {
+ ok: false,
+ raison: "conversation",
+ message: WHATSAPP_URL_MESSAGES.conversation,
+ };
+ }
+
+ return { ok: true, url: url.toString() };
+}
+
+/** Vrai lien d'invitation de groupe : sert à prévenir sans bloquer. */
+export function estInvitationGroupe(url: string | null | undefined): boolean {
+ if (!url) return false;
+ try {
+ return new URL(url).hostname === "chat.whatsapp.com";
+ } catch {
+ return false;
+ }
+}