FAQ

Questions fréquemment posées sur Wagoo.

Installation et Configuration

Q: Quels sont les prérequis pour installer Wagoo?

A: Vous avez besoin de :

• Node.js 18+
• pnpm 8+
• PostgreSQL 14+
• Un compte GitHub/Google pour OAuth (optionnel)
• Un compte Stripe pour les paiements (optionnel)

Voir Installation

Q: Comment configurer les variables d’environnement?

A: Copiez .env.example en .env.local et remplissez les valeurs :

cp .env.example .env.local

Puis configurez :

• DATABASE_URL
• BETTER_AUTH_SECRET
• Clés Stripe/OAuth

Voir Environment

Q: Quelle version de PostgreSQL utiliser?

A: PostgreSQL 14+ est recommandé. Les versions 12+ fonctionnent aussi.

Vérifiez votre version :

psql --version

Fonctionnalités

Q: Puis-je utiliser Wagoo sans Stripe?

A: Oui! Stripe est optionnel. Vous pouvez utiliser Wagoo sans paiements.

Les articles, festivals, et tickets fonctionnent sans Stripe.

Q: Comment inviter une équipe?

A: Allez à Team → Invite Member et entrez l’email du collaborateur.

Voir Inviter une équipe

Q: Puis-je exporter mes articles?

A: Oui, via l’API :

curl https://monsite.com/api/projects/{id}/articles \
  -H "Authorization: Bearer $TOKEN"

Voir API Blog

Q: Combien d’articles puis-je créer?

A: Illimité! Aucune limite de contenu.

Q: Puis-je changer le domaine plus tard?

A: Oui! Allez à Settings → Custom Domain et changez le domaine.

Voir Domaine personnalisé

Paiements

Q: Comment configurer Stripe?

A: 1. Créez un compte Stripe 2. Récupérez vos clés API 3. Configurez les webhooks 4. Ajoutez les clés à .env.local

Voir Configuration Stripe

Q: Stripe prend combien de frais?

A: 2.9% + 0.30€ par transaction (France).

Voir tarification Stripe 

Q: Puis-je accepter des paiements récurrents?

A: Oui! Stripe supporte les abonnements mensuels et annuels.

Voir Paiements

Q: Comment tester les paiements en local?

A: Utilisez les cartes de test Stripe :

Ou lire HTTPS Local

Q: Puis-je rembouser un client?

A: Oui, via Stripe Dashboard → Refunds.

Les remboursements sont traités en 2-5 jours.

Authentification

Q: Quels systèmes d’auth supportez-vous?

A: Wagoo supporte :

• Email/Password
• Magic Link
• OAuth GitHub
• OAuth Google
• Passkeys
• 2FA/TOTP

Voir Système d’auth

Q: Dois-je configurer OAuth?

A: Non, c’est optionnel. Email/Password fonctionne sans OAuth.

Q: Comment réinitialiser un mot de passe?

A: Les utilisateurs cliquent “Forgot Password” sur la page de connexion.

Un email de réinitialisation est envoyé.

Q: Puis-je activer la 2FA obligatoire?

A: Oui, pour les utilisateurs de votre projet (admin side).

Voir Système d’auth

Déploiement

Q: Comment déployer Wagoo?

A: Nous recommandons Vercel (le plus facile).

1. Connectez votre repository GitHub
2. Configurez les variables d’environnement
3. Déployez

Voir Vercel

Q: Vercel est gratuit?

A: Oui! Gratuit jusqu’à :

• 100 deployments/mois
• 3 serverless functions
• 100 GB de bande passante

Après : $20/mois pour Vercel Pro.

Q: Comment utiliser un domaine personnalisé?

A: Configurez les records DNS de votre domaine.

Wagoo configure automatiquement SSL/HTTPS.

Voir Domaine personnalisé

Q: Quelle est la disponibilité garantie?

A: Vercel garantit 99.95% uptime (SLA).

Wagoo ajoute du monitoring et des alertes pour détecter les problèmes.

Développement

Q: Comment contribuer à Wagoo?

A: Forke le repository, créez une branche, et ouvrez une PR.

Voir Contributing

Q: Quels langages de programmation utilisez-vous?

A: - Frontend : TypeScript, React, Tailwind CSS

• Backend : Node.js, TypeScript
• Database : PostgreSQL, Prisma ORM
• Testing : Vitest, Playwright

Q: Puis-je déployer Wagoo elsewhere qu’on Vercel?

A: Oui! Wagoo fonctionne sur :

• AWS EC2
• DigitalOcean
• Heroku
• Railway.app
• Fly.io

Voir Production

Q: Comment ajouter mes propres features?

A: Modifiez le code source et déployez.

Wagoo est open-source (sauf certaines parties).

Support

Q: Comment contacter le support?

A: Ouvrez un ticket depuis votre dashboard.

Dashboard → Create Ticket

Temps de réponse selon la priorité :

• LOW : 3-5 jours
• MEDIUM : 1-3 jours
• HIGH : 24h
• URGENT : 1-2h

Voir Créer un ticket

Q: Où trouver la documentation?

A: Vous êtes dessus! 📚

Voir aussi :

• Architecture
• API Reference
• Guides pratiques

Q: Avez-vous une roadmap?

A: Oui, consultable sur notre GitHub .

Sécurité

Q: Est-ce que Wagoo est sécurisé?

A: Oui! Wagoo inclut :

• HTTPS/SSL obligatoire
• Hachage des mots de passe
• Protection CSRF
• Protection XSS
• Rate limiting
• Vérification des signatures Stripe

Voir Sécurité

Q: Où storez-vous les données?

A: Les données sont stockées sur :

• Serveurs Vercel (backend)
• PostgreSQL (database)
• Votre région géographique (à configurer)

Q: Puis-je transférer mes données?

A: Oui! Utilisez l’API pour exporter vos données.

curl https://monsite.com/api/projects \
  -H "Authorization: Bearer $TOKEN" | jq .

Q: Supprimez-vous les données après suppression de compte?

A: Oui, immédiatement après la suppression du compte.

Les données ne sont jamais vendues ou partagées.

Performance

Q: Wagoo est-il lent?

A: Non! Wagoo est optimisé pour la performance :

• Next.js avec SSR
• Image optimization
• CDN global Vercel
• Database indexing
• Caching

Temps de réponse cible : < 500ms

Voir Monitoring

Q: Combien de visites puis-je gérer?

A: Illimité! Vercel scale automatiquement.

De 10 visites à 10M visites, Wagoo scale transparemment.

Divers

Q: Quelle licence utilisez-vous?

A: Wagoo est sous MIT License (open source).

Q: Puis-je utiliser Wagoo commercialement?

A: Oui! MIT License permet l’usage commercial.

Vous pouvez héberger, modifier, et vendre des sites Wagoo.

Q: Wagoo est-il disponible en plusieurs langues?

A: Actuellement en français et anglais.

D’autres langues peuvent être ajoutées.

Q: Puis-je avoir une version self-hosted?

A: Oui! Clone le repository et déploie sur ton infrastructure.

Voir Production

Prochaines étapes

Besoin de plus d’aide?

→ Créer un ticket de support → Guides pratiques → API Reference