Spring-Fullstack-Speed (SFS) - v1.0.4

Générateur rapide d'applications fullstack avec Spring Boot et divers frameworks frontend

SFS est un générateur de code CLI basé sur Yeoman qui permet de créer rapidement des applications web fullstack modernes avec Spring Boot comme backend et divers frameworks frontend (React, Vue.js, Angular, Thymeleaf, JTE). Inspiré par JHipster, ce projet vise à simplifier et accélérer le développement d'applications Java enterprise en automatisant la génération de code boilerplate et l'intégration des technologies modernes.

🆕 Nouveautés de la version 1.0.4

• Système de paiement complet : Intégration facile avec Stripe, PayPal et autres passerelles de paiement
• Gestion des abonnements : Support pour les plans d'abonnement et paiements récurrents
• Support international : Plus de 135 devises et méthodes de paiement locales

📋 Table des matières

• Installation
• Démarrage Rapide
• Utilisation
  • Générer une application
  • Générer une entité
  • Générer des DTOs
  • Générer des opérations CRUD
  • Générer un module
  • Système de paiement
  • Recherche et Indexation
  • Notifications
  • Conteneurisation
  • Déploiement
  • CI/CD
• Documentation
• Technologies supportées
• Fonctionnalités
• Architecture
• Développement
• Tests
• Contribuer
• Licence

🚀 Installation

# Installation globale
npm install -g @enokdev/spring-fullstack-speed

# Ou utilisation directe avec npx
npx @enokdev/spring-fullstack-speed

Prérequis

• Node.js : v20.0.0 ou supérieure
• NPM : v10.0.0 ou supérieure
• Java : JDK 17 ou supérieure
• Maven ou Gradle : pour la compilation des projets Spring Boot

⚡ Démarrage Rapide

Pour générer rapidement une application complète avec une interface utilisateur React et une base de données PostgreSQL :

# Installation globale si ce n'est pas déjà fait
npm install -g @enokdev/spring-fullstack-speed

# Création d'un nouveau projet
sfs app --name=my-awesome-app --package=com.example.myapp --db=postgresql --frontend=react

# Génération d'une entité
cd my-awesome-app
sfs entity --name=Product --fields=name:string,description:string,price:double

# Ajout des DTOs et opérations CRUD
sfs dtos --entity=Product
sfs crud --entity=Product --frontend=true

# Lancement de l'application
./mvnw spring-boot:run

Voir notre Guide de démarrage rapide pour plus d'options et d'explications.

🧰 Utilisation

Générer une nouvelle application

# Mode interactif
sfs app

# Mode avec options
sfs app --name=my-app --package=com.example --db=mysql --frontend=react --build=maven

Options disponibles :

• --name : Nom de l'application
• --package : Package Java de base
• --db : Base de données (h2, mysql, postgresql, mongodb)
• --build : Outil de build (maven, gradle)
• --frontend : Framework frontend (none, react, vue, angular, thymeleaf, jte)
• --auth : Type d'authentification (none, jwt, oauth2, basic)
• --cache : Solution de cache (none, redis, ehcache)
• --messaging : Solution de messagerie (none, kafka, rabbitmq)

Générer une nouvelle entité

sfs entity --name=Product --fields=name:string,price:double,description:string

Options pour les champs :

• Types : string, integer, long, float, double, boolean, date, time, datetime, enum, blob, uuid
• Validations : [required], [min=x], [max=y], [pattern=regex], [email], etc.

Générer des DTOs

sfs dtos --entity=Product --mapping=mapstruct

Options :

• --entity : Nom de l'entité
• --types : Types de DTOs (basic, create, update, view, all)
• --mapping : Outil de mapping (manual, mapstruct, modelmapper)

Générer des opérations CRUD

sfs crud --entity=Product --pagination=true --sorting=true --frontend=true

Options :

• --entity : Nom de l'entité
• --pagination : Activer la pagination
• --sorting : Activer le tri
• --frontend : Générer des composants frontend

Générer un module fonctionnel

sfs module --name=Inventory --entities=Product,Category,Supplier

Options :

• --name : Nom du module
• --entities : Liste d'entités à inclure
• --package : Package spécifique pour le module

Système de paiement

sfs payment --provider=stripe --currency=usd --plan=monthly

Options :

• --provider : Fournisseur de paiement (stripe, paypal, braintree)
• --currency : Devise (usd, eur, gbp, etc.)
• --plan : Type de plan (one-time, monthly, yearly)

Recherche et Indexation

sfs search --entity=Article --engine=elasticsearch --fields=title,content,tags

Options :

• --entity : Entité à indexer
• --engine : Moteur de recherche (database, elasticsearch, solr)
• --fields : Champs à indexer

Notifications

sfs notification --type=email --entity=User

Options :

• --type : Type de notification (email, sms, push, websocket, all)
• --entity : Entité liée aux notifications
• --templates : Générer des templates (true, false)

Conteneurisation

sfs container --type=compose --services=db,redis,elasticsearch

Options :

• --type : Type de configuration (simple, multi-stage, compose)
• --services : Services supplémentaires à inclure

Déploiement

sfs deploy --platform=aws --type=advanced

Options :

• --platform : Plateforme de déploiement (heroku, aws, azure, gcp)
• --type : Type de configuration (basic, advanced)

CI/CD

sfs cicd --platform=github --stages=build,test,deploy

Options :

• --platform : Plateforme CI/CD (github, gitlab, jenkins, azure)
• --stages : Étapes à inclure

📚 Documentation

• Guide de démarrage rapide
• Documentation des générateurs
• Guide des cas d'utilisation
• Documentation des entités
• Documentation des DTOs
• Liste des commandes

🛠 Technologies supportées

Backend

• Spring Boot : 3.x
• Bases de données : MySQL, PostgreSQL, MongoDB, H2
• JPA/Hibernate pour la persistance
• Spring Security pour l'authentification et l'autorisation
• Spring Data JPA/MongoDB pour l'accès aux données
• MapStruct/ModelMapper pour la conversion DTO
• Redis/EhCache pour la mise en cache
• Kafka/RabbitMQ pour la messagerie
• Elasticsearch pour la recherche avancée
• Liquibase/Flyway pour les migrations de base de données

Frontend

• React avec hooks et context API
• Vue.js avec composition API
• Angular avec composants et services
• Thymeleaf pour le rendu côté serveur
• JTE pour les templates haute performance
• TailwindCSS/Bootstrap pour le styling
• Jest/Testing Library/Vitest pour les tests frontend

DevOps

• Docker pour la conteneurisation
• Kubernetes pour l'orchestration
• GitHub Actions/GitLab CI pour CI/CD
• AWS/Azure/GCP/Heroku pour le déploiement

✨ Fonctionnalités

• Génération complète d'applications prêtes à l'emploi
• Création d'entités avec validations et relations
• Génération automatique d'API RESTful
• Authentification JWT et OAuth2
• Interfaces utilisateur cohérentes et réactives
• Pagination et tri côté serveur
• Recherche full-text avec Elasticsearch
• Mises en cache pour les performances
• Tests unitaires et d'intégration
• Documentation Swagger/OpenAPI
• Support multi-langues
• Conteneurisation Docker
• Scripts de déploiement
• Configuration CI/CD

🏗 Architecture

SFS génère des applications suivant une architecture en couches classique:

+----------------+
|   Frontend     |
| React/Vue/etc. |
+--------+-------+
         |
  REST/GraphQL API
         |
+--------v-------+
|  Controllers   |
+----------------+
|   Services     |
+----------------+
| Repositories   |
+----------------+
|   Entities     |
+----------------+
|   Database     |
+----------------+

🧪 Tests

Le projet comprend plusieurs niveaux de tests:

# Tests unitaires
npm test

# Tests d'intégration
npm run test:integration

# Tests end-to-end
npm run test:e2e

# Tests des cas limites
npm run test:edge-cases

# Tests de compatibilité multi-plateforme
npm run test:platform-compatibility

# Tous les tests
npm run test:all

💻 Développement

Pour contribuer au développement de Spring-Fullstack-Speed:

# Cloner le dépôt
git clone https://github.com/tky0065/spring-fullstack-speed.git
cd spring-fullstack-speed

# Installer les dépendances
npm install

# Lier le package pour les tests locaux
npm link

# Lancer en mode développement
npm run dev

👥 Contribuer

Les contributions sont les bienvenues! Consultez notre guide de contribution pour plus d'informations.

📄 Licence

Ce projet est sous licence ISC. Voir le fichier LICENSE pour plus de détails.