Snail - Scaffolding de desarrollo rápido de microservicios empresarial

Inicio rápido • Documentación • Contribuir •

🐌 Snail - Scaffold ligero para desarrollo rápido con Spring Boot

Snail es un framework moderno de desarrollo rápido de microservicios

basado en Spring Boot 3, que ofrece capacidades esenciales listas para usar como autenticación, autorización, gateway y servicios de recursos, ayudando a las empresas a construir aplicaciones cloud-native seguras y escalables rápidamente.

🚀 Listo para usar | Seguro y confiable | Fácil de expandir | Integración frontend-backend

🌟 Características

• ✅ Basado en el stack tecnológico más reciente: Spring Boot 3.5.5 + Spring Cloud 2025.0.0 +

• 🔐 Autenticación y autorización OAuth2: Integración con Spring Security + JWT, soporte para autenticación unificada y control de permisos granular
• 🌐 Arquitectura de microservicios: Modularización, incluye autenticación, autorización, gateway y servicios de recursos, soporta despliegue independiente y escalabilidad horizontal
• ⚡ Gateway de alto rendimiento: Basado en Spring Cloud Gateway, implementa enrutamiento, limitación de tasa, circuit breaker y autenticación
• 🧩 Soporte cloud-native: Compatible con Nacos, Sentinel, Seata, soporta descubrimiento de servicios, centro de configuración y transacciones distribuidas
• 🎨 Panel de administración moderno: Interfaz de administración limpia y responsiva construida con shadcn-vue/ui
• 📚 Documentación completa: Incluye diseño de arquitectura, guía de despliegue, documentación de API y notas para desarrollo secundario

🛠 Stack tecnológico

| Categoría | Tecnología |

|-----------|-------------------------------------------------------------------| | Framework Backend | Spring Boot 3.5.5, Spring Cloud 2025.0.0, Spring Security, OAuth2 | | Gobierno de Microservicios | Nacos (Centro de Registro & Centro de Configuración), | | Gateway | Spring Cloud Gateway | | Base de Datos | MySQL 8 | | Framework Frontend | Vue 3 + Vite + TypeScript + shadcn/ui | | Herramientas de Construcción | Maven, Docker, Docker Compose | | Monitoreo | Spring Boot Actuator, Prometheus (opcional), Grafana (opcional) |

🏗 Estructura del Proyecto

snail/
├── authentication/           # Servicio de autenticación (Servidor de autorización OAuth2)
├── authorization/          # Servicio de autorización (Gestión de permisos, roles, menús)
├── gateway/               # Gateway API (Enrutamiento, autenticación, limitación de tasa)
├── resource/              # Servicio de recursos (Ejemplo de API de negocio)
├── snail-vue-app/          # Interfaz de administración (Vue3 + shadcn/ui)
└── pom.xml                      # Proyecto padre Maven