story-research-zapwall/docs/DOCUMENTATION.md

Documentation complète - zapwall.fr

📚 Index de la documentation

🚀 Déploiement et infrastructure

Documentation principale

1. Documentation complète du déploiement

   • Vue d'ensemble de l'architecture
   • Configuration initiale
   • Mise à jour du site (Git, transfert manuel)
   • Configuration HTTPS (auto-signé et Let's Encrypt)
   • Scripts disponibles
   • Dépannage complet
   • Maintenance et commandes utiles

2. Référence des scripts

   • Liste complète de tous les scripts
   • Description détaillée de chaque script
   • Paramètres et options
   • Ordre d'exécution recommandé

3. Guide de référence rapide

   • Commandes essentielles en un coup d'œil
   • Informations importantes
   • Liens rapides vers la documentation

Guides pratiques

4. README-DEPLOYMENT.md

   • Guide de déploiement et mise à jour
   • Méthodes de mise à jour
   • Commandes utiles
   • Configuration HTTPS

5. RESUME-DEPLOIEMENT.md

   • Résumé du déploiement
   • État actuel
   • Problèmes identifiés et solutions
   • Prochaines étapes

📝 Scripts de déploiement

Scripts principaux

• deploy.sh : Déploiement initial complet avec vérifications
• update-remote-git.sh : Mise à jour via Git (stash + pull + rebuild) ⭐ Recommandé
• update-from-git.sh : Mise à jour depuis dépôt local
• finish-deploy.sh : Finalisation du déploiement

Scripts de vérification

• check-deploy.sh : Vérification préalable avant déploiement
• check-deployment-status.sh : État complet du déploiement
• check-nginx-config.sh : Vérification de la configuration nginx
• check-git-repo.sh : Vérification du dépôt Git
• final-status.sh : Résumé de l'état final

Scripts de configuration

• setup-https-autosigned.sh : Configuration HTTPS avec certificats auto-signés
• deploy-letsencrypt.sh : Déploiement des certificats Let's Encrypt
• open-firewall-ports.sh : Ouverture des ports 80/443
• fix-nginx-config.sh : Correction de la configuration

🔧 Informations techniques

Serveur

• Adresse : 92.243.27.35
• Utilisateur : debian
• Domaine : zapwall.fr
• Répertoire : /var/www/zapwall.fr
• Port application : 3001
• Service : zapwall.service (systemd)
• Nginx : Conteneur Docker lecoffre_nginx_test

Architecture

Internet → Firewall (80/443) → Nginx Docker → Port 3001 → Next.js App

📖 Documentation utilisateur

• Guide utilisateur : Guide d'utilisation de la plateforme
• FAQ : Questions fréquentes
• Guide de publication : Comment publier un article
• Guide de paiement : Comment effectuer un paiement

🔬 Documentation technique

• Documentation technique : Architecture technique
• Configuration stricte : Règles de qualité du code
• Configuration Rizful API : Configuration de l'API Rizful

📋 Spécifications

• Fonctionnalités : Liste des fonctionnalités
• Notifications : Implémentation des notifications
• Séries et médias : Spécification des séries
• Refactoring : Notes de refactoring

🎯 Démarrage rapide

Pour déployer ou mettre à jour

# Déploiement depuis la branche main (par défaut)
./deploy.sh

# Déploiement depuis une autre branche
./deploy.sh develop

Le script deploy.sh effectue automatiquement :

• Mise à jour depuis Git
• Installation des dépendances
• Construction de l'application
• Redémarrage du service

📞 Support

En cas de problème :

1. Consulter docs/deployment.md - Section Dépannage
2. Vérifier les logs : ssh debian@92.243.27.35 'sudo journalctl -u zapwall -n 100'
3. Utiliser les scripts de vérification

---

Dernière mise à jour : 2025-12-28