Backstage - Portail Développeur

Cette implémentation de Backstage est une plateforme de portail développeur moderne basée sur le framework open-source de Spotify. Elle fournit un hub centralisé pour la gestion des services, la documentation technique, et l'automatisation des processus de développement.

🚀 Démarrage Rapide

Installation

# Installer les dépendances
yarn install

# Démarrer l'application
yarn dev

Avec dotenv-cli (recommandé)

dotenv -e .env -- yarn dev

📚 Documentation Complète

Pour une documentation détaillée, consultez le Guide d'Installation et la Documentation Complète.

Guides Disponibles

• 📖 Documentation Principale - Vue d'ensemble complète
• 🔧 Guide d'Installation - Installation étape par étape
• 💻 Guide de Développement - Personnalisation et extension
• 🗄️ Configuration Base de Données - Setup PostgreSQL
• 🔗 Intégration GitHub - Configuration GitHub

🏗️ Architecture

Technologies Utilisées

• Frontend : React 18, TypeScript, Material-UI
• Backend : Node.js 18/20, Express
• Base de données : PostgreSQL
• Authentification : GitHub OAuth + Guest Provider
• Tests : Playwright (e2e), Jest
• Build : Backstage CLI, Lerna

Fonctionnalités Principales

• 📋 Catalogue de Services - Gestion centralisée des composants et APIs
• 📚 Documentation Technique - Génération automatique avec TechDocs
• 🔨 Templates de Software - Création automatisée de projets
• 🔍 Recherche Globale - Recherche unifiée dans toute la plateforme
• 🔐 Authentification GitHub - OAuth avec résolution d'utilisateurs
• 🔄 Intégration GitHub - Synchronisation automatique des dépôts
• ⚡ GitHub Actions - Visualisation des workflows CI/CD
• 📊 GitHub Insights - Métriques et analytics

🔧 Configuration

Variables d'Environnement Requises

Créer un fichier .env à la racine du projet :

# Base de données PostgreSQL
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_USER=backstage
POSTGRES_PASSWORD=backstage

# GitHub Integration
GITHUB_TOKEN=your_github_personal_access_token
GITHUB_CLIENT=your_github_oauth_app_client_id
GITHUB_CLIENT_SECRET=your_github_oauth_app_client_secret

# Backend Secret (pour la production)
BACKEND_SECRET=your_backend_secret_key

🧪 Tests

# Tests unitaires
yarn test

# Tests avec couverture
yarn test:all

# Tests end-to-end
yarn test:e2e

# Linting
yarn lint

# Formatage
yarn prettier:check

🚀 Déploiement

# Build complet
yarn build:all

# Build du backend
yarn build:backend

# Image Docker
yarn build-image

📞 Support

• Documentation officielle : backstage.io/docs
• GitHub Issues : github.com/backstage/backstage
• Discord : discord.gg/backstage

📝 Licence

Ce projet est basé sur Backstage, un projet open-source de Spotify.

---

Dernière mise à jour : $(date) Version Backstage : $(backstage --version)