Snail - Scaffolding de développement rapide de microservices d'entreprise

Démarrage rapide • Documentation • Contribution •

🐌 Snail - Scaffold léger pour développement rapide avec Spring Boot

Snail est un framework moderne de développement rapide de microservices basé sur Spring Boot 3,

offrant des fonctionnalités clés prêtes à l'emploi telles que l'authentification, l'autorisation, la passerelle et les services de ressources, pour aider les entreprises à créer rapidement des applications cloud natives sécurisées et évolutives.

🚀 Prêt à l'emploi | Sûr et fiable | Facile à étendre | Intégration front-end/back-end

🌟 Fonctionnalités

• ✅ Basé sur une stack technologique moderne : Spring Boot 3.5.5 + Spring Cloud 2025.0.0 +

• 🔐 Authentification et autorisation OAuth2 : intégration de Spring Security + JWT, supporte l'authentification unifiée et le contrôle d'accès fin
• 🌐 Architecture microservices : découpage modulaire incluant authentification, autorisation, passerelle, services de ressources, prise en charge du déploiement indépendant et de la montée en charge horizontale
• ⚡ Passerelle haute performance : basée sur Spring Cloud Gateway pour le routage, la limitation de débit, le circuit breaker et l'autorisation
• 🧩 Support cloud natif : compatible avec Nacos, Sentinel, Seata, gestion de découverte de services, centre de configuration et transactions distribuées
• 🎨 Console d'administration moderne : interface d'administration réactive et épurée construite avec shadcn-vue/ui
• 📚 Documentation complète : couvrant la conception de l'architecture, le guide de déploiement, l'API et les instructions pour le développement secondaire

🛠 Stack technique

| Catégorie | Technologie |

|-----------|-------------------------------------------------------------------| | Framework Backend | Spring Boot 3.5.5, Spring Cloud 2025.0.0, Spring Security, OAuth2 | | Gouvernance des microservices | Nacos (centre d'enregistrement & centre de configuration), | | Passerelle | Spring Cloud Gateway | | Base de données | MySQL 8 | | Framework Frontend | Vue 3 + Vite + TypeScript + shadcn/ui | | Outils de build | Maven, Docker, Docker Compose | | Supervision | Spring Boot Actuator, Prometheus (optionnel), Grafana (optionnel) |

🏗 Structure du projet

snail/
├── authentication/           # Service d'authentification (serveur d'autorisation OAuth2)
├── authorization/          # Service d'autorisation (gestion des permissions, rôles, menus)
├── gateway/               # Passerelle API (routage, authentification, limitation de débit)
├── resource/              # Service de ressources (exemple d'API métier)
├── snail-vue-app/          # Interface d'administration (Vue3 + shadcn/ui)
└── pom.xml                      # Projet parent Maven