Guide des projets générés¶
Guide complet pour développer, tester et déployer les projets créés avec create-go-starter
Vue d'ensemble¶
Ce guide complet vous accompagne dans toutes les phases de développement d'un projet créé avec create-go-starter. Que vous débutiez ou que vous cherchiez des références approfondies, vous trouverez ici toute la documentation nécessaire.
Les projets générés suivent l'architecture hexagonale (Ports & Adapters) et intègrent les meilleures pratiques de développement Go.
Navigation du guide¶
Pour commencer¶
rocket_launch Configuration - Variables d'environnement et setup initial
folder Structure du projet - Organisation des fichiers et responsabilités
Architecture et design¶
architecture Architecture hexagonale - Principes, diagrammes et flux de requêtes
code Développement - Workflow quotidien et outils
lightbulb Exemples pratiques - Créer une entité complète de A à Z
Développement¶
api API Reference - Documentation complète des endpoints
check_circle Tests - Organisation, types de tests et best practices
storage Base de données - Migrations, GORM et requêtes avancées
Production¶
shield Sécurité - JWT, validation, hashage et checklist
cloud_upload Déploiement - Docker, Kubernetes et CI/CD
monitor_heart Monitoring - Logging, health checks et observabilité
verified Bonnes pratiques - Patterns, conventions et recommandations
Parcours d'apprentissage recommandé¶
Débutant¶
Si vous découvrez create-go-starter, suivez ce parcours:
- circle Configuration - Setup initial
- circle Structure du projet - Comprendre l'organisation
- circle Architecture - Principes hexagonaux
- circle Exemples pratiques - Créer votre première entité
- circle API Reference - Tester l'API
Intermédiaire¶
Pour approfondir vos connaissances:
- circle Développement - Workflow avancé
- circle Tests - Stratégies de tests
- circle Base de données - Maîtriser GORM
- circle Sécurité - Bonnes pratiques
Avancé¶
Pour la mise en production:
- circle Déploiement - Docker, K8s, CI/CD
- circle Monitoring - Observabilité
- circle Bonnes pratiques - Patterns avancés
Navigation rapide¶
| Section | Contenu principal |
|---|---|
| Architecture | Hexagonal architecture, diagrammes, flux de requêtes |
| Structure | Organisation des fichiers, stack technique, exemples de code |
| Configuration | Variables d'environnement, JWT, PostgreSQL |
| Développement | Workflow quotidien, Makefile, add-model |
| Exemples | Créer l'entité Product complète (9 étapes) |
| API Reference | Endpoints auth et users, workflow API |
| Tests | Organisation, types de tests, coverage |
| Base de données | Migrations, GORM, queries avancées |
| Sécurité | JWT, validation, hashage, checklist |
| Déploiement | Docker, Kubernetes, GitHub Actions |
| Monitoring | Logging, health checks, observabilité |
| Bonnes pratiques | Architecture, code style, patterns |
Prochaines étapes¶
arrow_forward Commencer par l'architecture - Comprendre les fondations hexagonales
menu_book Voir le tutorial complet - Guide pas-à-pas pour créer une API Blog
home Retour à l'accueil - Documentation principale