CaskShop
E-commerce vêtements neuf & occasion — headless Medusa v2, Stripe, Sendcloud, emails transactionnels.
- TypeScript
- Next.js 14
- Medusa v2
- PostgreSQL
- Redis
- Stripe
- Sendcloud
- Cloudinary
- Resend
Contexte
CaskShop est un e-commerce full-stack dédié à la vente de vêtements (neuf & occasion), objets et jeux pour enfants, développé en autonomie complète. L'objectif : construire une boutique souveraine — sans dépendance à Shopify ou WooCommerce — avec un catalogue maîtrisé, un tunnel de paiement intégré et une gestion des expéditions directement connectée au transporteur. Le projet est structuré en monorepo Turborepo (storefront, admin, backend) et déployé en production sur VPS Hetzner.
Problème
Les solutions e-commerce packagées imposent leurs contraintes : commissions, limites d'extension, architecture fermée. L'enjeu était de construire une plateforme headless complète : découpler le storefront Next.js 14 du backend commerce (Medusa v2), intégrer Stripe pour le paiement sécurisé, Sendcloud pour les flux d'expédition et Resend pour les emails transactionnels (confirmation, expédition, remboursement) — le tout en TypeScript strict.
Résultats
Architecture headless opérationnelle : Medusa v2 gère catalogue, panier et commandes via API REST ; Next.js 14 consomme les endpoints côté storefront. Paiement Stripe intégré avec webhooks (confirmation commande, remboursement). Expédition automatisée via Sendcloud : génération d'étiquettes, numéro de suivi injecté dans l'email client. Emails transactionnels Resend sur trois événements : commande placée, colis expédié, remboursement. Images produits hébergées sur Cloudinary. CI/CD GitHub Actions avec environnement preprod sur Railway.