waitlist-launch — Processus de mise en ligne d'une page d'attente
Extrait de l'implémentation réelle de fare-waitlist (juillet 2026, early-fare.hengshiou.com, références pratiques :
/Users/xiuxiu/Documents/個人事宜/1_Projects/fare-waitlist).
Idée centrale : KV est la seule source de vérité pour la liste, l'anti-abus ne consomme pas d'écritures KV, tous les paramètres publics passent par des variables d'exécution, pas de trafic avant d'avoir des analytics, le copywriting crée la confiance en inversant la vente.
Trois fichiers de référence (charger à la demande, pas tous en même temps)
| Fichier | Rôle | Quand le lire |
|---|---|---|
references/architecture.md | Architecte de l'information | À lire obligatoirement avant de commencer : checklist d'entretien préalable, processus en six étapes, contrat API/KV (à copier), séparation var vs secret, tableau des permissions des outils, manuel de validation, pièges connus |
references/copywriting.md | Spécialiste marketing | À lire pour écrire les textes de la page, les messages de partage, l'image OG, et planifier les canaux de trafic : formules pour les points de douleur H1, structure de l'accroche, formule de consentement, règles d'anti-vente, playbook des canaux + codes de référence |
references/operations.md | Chef de produit | À lire pour la validation pré-lancement et l'exploitation post-lancement : checklist de validation (obligatoire / recommandé), indicateurs de succès et de vanité, rythme de relance, périmètre des décisions, template de backlog d'itération |
Processus d'exécution (vue orchestrateur)
- Entretien préalable : Poser les 9 questions de la section §1 de
architecture.md; ne pas commencer sans les réponses. Attention particulière : vérifier le handle de la communauté (grep sur le code source du site existant ou confirmer avec la personne), ne pas deviner avec la mémoire du modèle. - Reconnaissance de l'existant : S'il s'agit d'un dépôt existant, exécuter
git logpour vérifier ; confirmer le compte de connexion wrangler et les droits sur la zone. - Implémentation par phases (étapes détaillées et définition de "Fait" dans
architecture.md§2) :- Phase 1 : Construction de base (Worker + assets + KV + domaine personnalisé)
- Phase 2 : Synchronisation de la liste avec Resend (best-effort + ops/sync idempotent pour re-création)
- Phase 3 : Anti-abus en trois couches (honeypot → rate-limiting natif → Turnstile, aucun consommateur d'écriture KV)
- Phase 4 : Pied de page de marque personnelle (discret, poids visuel inférieur au CTA)
- Phase 5 : Couche d'exposition (og:image → parrainage → analytics, dans cet ordre, tous modifient index.html)
- Phase 6 : Validation de déploiement (checklist smoke + cache-buster)
- Copywriting : Chaque emplacement (H1/accroche/puces/consentement/ carte de preuve /message de partage) utilise la formule de
copywriting.md; la phrase de dissuasion honnête doit être vraie. - Passerelle de mise en ligne : Cocher chaque élément de la §1 de
operations.md; si un élément "obligatoire" n'est pas rempli, ne pas mettre en ligne. Pas de trafic avant d'avoir des analytics. - Post-lancement : Les canaux utilisent un code de référence pour l'attribution (
copywriting.md§4) ; relancer quand la liste dépasse 100 ; afficher la preuve sociale uniquement lorsque le seuil de nombre est atteint (operations.md§3).
Discipline d'affectation (quand plusieurs sous-agents)
- Plusieurs tâches modifiant le même fichier (typique : les trois sous-tâches de la couche d'exposition modifient toutes index.html) → affecter séquentiellement, pas en parallèle.
- Chaque mission d'un sous-agent doit inclure : quels fichiers sont autorisés à être modifiés, définition de "Fait", demande de preuve concrète (capture d'écran / sortie curl), interdiction de commit/déployer.
- L'orchestrateur valide chaque tâche (diff + inspection visuelle des artefacts clés ; les images doivent être lues), commit par tâche, puis un seul déploiement + smoke test en ligne à la fin.
- Le rapport de livraison contient quatre choses : branche, hash du commit, état du déploiement, et nettoyage du worktree.
Actions manuelles nécessaires (non automatisables, à signaler tôt)
- Créer un Turnstile site dans le tableau de bord CF (obtenir site key + secret)
- Créer un Web Analytics site dans le tableau de bord CF (obtenir le beacon token ; l'OAuth de wrangler n'a pas les droits RUM, l'API ne peut pas le créer)
- Resend : Créer une audience, générer une clé API dédiée (ne pas réutiliser celle d'autres sites), valider le DNS du domaine d'envoi
- Le premier rattachement d'un domaine personnalisé peut nécessiter une vérification DNS/certificats dans le tableau de bord
Le code est d'abord écrit en mode variables d'exécution (/api/health les fournit dynamiquement au front-end). Une fois les credentials réunis, remplir les var/secret et redéployer pour les activer, sans modifier le code — cela permet de ne pas bloquer le développement en attendant les credentials.
Pièges les plus fréquents (liste complète dans architecture.md §5.3)
- Capture d'écran OG avec headless Chrome :
--force-device-scale-factor=1(le retina donne du 2x) +--virtual-time-budget=4000(pour attendre les webfonts) ; vérifier visuellement la capture (police de secours, lignes orphelines dans le titre). - Cache périphérique renvoyant une ancienne version HTML après déploiement → tester avec
?cb=<timestamp>. - Turnstile en ligne bloque curl pour tester
/api/join→ les tests de contrat (trois cas : normal/ doublon / honeypot) ne peuvent être faits qu'en local avecwrangler dev(sans secret, les étapes sont sautées automatiquement). - Honeypot / rate-limiting renvoient un succès soft mais sans refCode (aucune information donnée au bot) ; les inscriptions déjà présentes renvoient already + le même refCode (idempotence).
- Clé API en texte clair dans la conversation/fichier → passer immédiatement en secret.