Aller au contenu

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.

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:

  1. circle Configuration - Setup initial
  2. circle Structure du projet - Comprendre l'organisation
  3. circle Architecture - Principes hexagonaux
  4. circle Exemples pratiques - Créer votre première entité
  5. circle API Reference - Tester l'API

Intermédiaire

Pour approfondir vos connaissances:

  1. circle Développement - Workflow avancé
  2. circle Tests - Stratégies de tests
  3. circle Base de données - Maîtriser GORM
  4. circle Sécurité - Bonnes pratiques

Avancé

Pour la mise en production:

  1. circle Déploiement - Docker, K8s, CI/CD
  2. circle Monitoring - Observabilité
  3. circle Bonnes pratiques - Patterns avancés

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