Spots Zen
Spots Zen propose des immersions audio bien-être (méditations guidées, respirations, visualisations, musiques composées sur mesure) accessibles sans application : en scannant un QR code dans un lieu partenaire (hébergement, entreprise, campus), ou chez soi avec un abonnement.
Application web progressive (PWA) avec trois espaces : la page d'un spot pour les visiteurs, la bibliothèque des abonnés, et le back-office d'administration.
🔗 Accès
- App en ligne : https://www.spotszen.fr (production, hébergée sur Vercel ;
spotszen.fr redirige vers www)
- Comptes de test : fournis séparément au jury (un compte abonné, un compte admin)
🛠️ Stack
| Rôle | Outil |
|---|
| Génération et front | Lovable · React 19 · TypeScript · TanStack Start · Tailwind CSS 4 · Vite |
| Base de données, Auth, sécurité | Supabase (PostgreSQL, Auth par lien magique, code ou Google, RLS) |
| Déploiement | Vercel, branché sur ce repo GitHub |
| Paiement | Stripe (abonnements, portail client, webhook signé) |
| Emails et CRM | Brevo (emails de connexion via SMTP, 10 emails transactionnels × 5 langues, listes de contacts) |
| Automatisations | Vercel Cron (robot quotidien des emails) · agent boîte mail (tâche planifiée Claude : tri, brouillons, brief Notion) |
| Surveillance | UptimeRobot (www.spotszen.fr, toutes les 5 minutes) |
| Tests | Vitest (tests unitaires) · Playwright (22 parcours × ordinateur + téléphone) |
| Audio | Cloudinary (hébergement des fichiers) · ElevenLabs (production des voix traduites) |
| QR codes | Lien direct www.spotszen.fr/spots/{id}, généré dans l'admin (PNG + SVG) |
| Traductions de l'interface | i18next (FR, EN, DE, NL, ES) |
| IA | API Claude d'Anthropic (modèle Haiku 5.5) : traduction assistée du catalogue |
✨ Fonctionnalités principales
- Page spot (
/spots/:id) : accès immédiat depuis un QR code, sans compte. Accès libre, par email professionnel ou par code PIN selon le lieu. L'immersion mise en avant change selon l'heure (matin, journée, soir, nuit).
- Lecteur audio : choix de la voix (féminine ou masculine), écoute écran verrouillé, messages clairs en cas de réseau faible ou coupé, reprise automatique au retour du réseau.
- Abonnement (
/offres) : 5 €/mois ou 49 €/an, premier mois offert à la première souscription, paiement et résiliation via Stripe.
- Bibliothèque abonné (
/bibliotheque) : catalogue filtrable, gestion de l'abonnement.
- Emails automatiques en 5 langues (Brevo) : bienvenue, confirmation de résiliation, accès offert, accusé de réception B2B, lien « continuer chez soi » pour les visiteurs d'un spot ; et, envoyés chaque matin par le robot quotidien (Vercel Cron) : accueil J+3, relance après 14 jours sans visite, fin d'accès offert (J-7 et lendemain), rappel annuel de reconduction (art. L.215-1 du Code de la consommation). Un même email ne part jamais deux fois ; journal et simulation dans l'admin (onglet Emails). Détail :
docs/tunnel-emails.md.
- Suivi commercial B2B (
/admin/demandes) : formulaire /professionnels → alerte email + demande dans l'admin, étapes (contactée, démo, devis, pilote, client, perdue), note et date de prochaine action, résumé du matin.
- Feature IA, traduction assistée : dans la fiche d'un audio, Claude (Haiku 5.5) propose le titre et la description en EN, DE, NL, ES ; l'admin relit et enregistre. Chaque passage est journalisé (
agent_logs). Détail : docs/fiche-6-briques-traduction-ia.md.
- Back-office (
/admin) : clients B2B, spots et QR codes, bibliothèque audio, abonnés, accès offerts.
- Dashboard admin en temps réel (
/admin, réservé au rôle admin) : pilotage, écoutes (par jour, top audios, moment de la journée, langue, voix, dernières écoutes), clients B2C (accès, revenu mensuel estimé, inscriptions, résiliations, conversion depuis un spot) et activité par spot. Mise à jour automatique via Supabase Realtime.
- PWA installable : épinglable sur l'écran d'accueil comme une application.
🚀 Installation en local
Le projet utilise Bun (le fichier bun.lock fait foi).
git clone https://github.com/Ninonspotszen/zen-admin-haven.git
cd zen-admin-haven
bun install
bun run dev
Autres commandes : bun run build (build de production), bun run lint, bun run test (tests unitaires), bun run test:e2e (parcours Playwright ; voir docs/qa-tests.md).
This is the beginning of the README. Read the rest at the original. Read the full README ↗
