🚀 Guide de démarrage rapide

📋 Prérequis

Avant de commencer, assurez-vous d'avoir installé :

• Node.js (version 18+)
• pnpm (gestionnaire de paquets)
• Git (contrôle de version)
• VS Code (éditeur recommandé)

🔧 Installation de l'environnement

1. Cloner le repository

git clone https://github.com/lipaix/lipaix-web-v3.git
cd lipaix-web-v3

2. Installer les dépendances

pnpm install

3. Configuration des variables d'environnement

Copiez les fichiers d'exemple et configurez vos variables :

cp apps/web/.env.example apps/web/.env.local
cp apps/discord-bot/.env.example apps/discord-bot/.env.local

🏃‍♂️ Démarrer le développement

Application web (Next.js)

pnpm run web:dev

L'application sera disponible sur http://localhost:3000

Interface d'administration (PayloadCMS)

pnpm run web:dev

L'admin sera disponible sur http://localhost:3000/admin

Bot Discord

pnpm run discord:dev

Documentation

pnpm run docs:dev

La documentation sera disponible sur http://localhost:3001

🏗️ Structure du projet

lipaix-web-v3/
├── 📁 apps/
│   ├── 🌐 web/           # Application Next.js + PayloadCMS
│   └── 🤖 discord-bot/   # Bot Discord
├── 📁 shared/
│   └── 🔧 common/        # Code partagé
├── 📁 docs/
│   └── 📚 vitepress/     # Documentation technique
└── 📄 package.json       # Configuration monorepo

🎯 Première contribution

1. Créer une branche feature

git checkout -b feature/ma-nouvelle-fonctionnalite

2. Développer et tester

• Modifiez le code dans le dossier approprié
• Testez localement avec pnpm run [app]:dev
• Vérifiez que tout fonctionne

3. Commiter et pousser

git add .
git commit -m "feat: ajouter ma nouvelle fonctionnalité"
git push origin feature/ma-nouvelle-fonctionnalite

4. Créer une Pull Request

• Allez sur GitHub
• Créez une PR de votre branche vers main
• Décrivez vos changements
• Attendez la review

🔍 Outils de développement

VS Code Extensions recommandées

• ESLint - Linting JavaScript/TypeScript
• Prettier - Formatage automatique
• Tailwind CSS IntelliSense - Autocomplétion Tailwind
• GitLens - Historique Git avancé

Scripts utiles

# Linting
pnpm run lint

# Build de tous les projets
pnpm run build

# Tests (quand ils seront implémentés)
pnpm run test

🚨 Dépannage courant

Problème de dépendances

# Nettoyer et réinstaller
rm -rf node_modules
pnpm install

Port déjà utilisé

# Vérifier les processus
lsof -i :3000

# Tuer le processus
kill -9 [PID]

Problème de base de données

# Redémarrer les services
pnpm run web:dev

📚 Ressources d'apprentissage

Technologies principales

• React - Composants et hooks
• Next.js - Framework React
• TailwindCSS - CSS utility-first
• PayloadCMS - CMS headless
• Discord.js - API Discord

Concepts d'architecture

• Clean Architecture - Principes d'architecture
• Monorepo - Gestion de projets multiples

🆘 Besoin d'aide ?

• 📖 Documentation - Ce site
• 🐛 Issues GitHub - Signaler des bugs
• 💬 Discussions - Questions et idées
• 📧 Contact - Équipe technique

🚀 Prochaines étapes

• Architecture - Comprendre la structure technique
• Frontend - Découvrir React et Next.js
• Backend - Explorer PayloadCMS
• Déploiement - Comprendre le processus de déploiement

---

Bienvenue dans l'équipe LIPAIX ! 🎭