================================================================================
  PACKAGE DE DÉPLOIEMENT - FORMATION MANAGER ITINOVA
  Version: 7a737c05
  Date: 24 novembre 2025
================================================================================

Ce package contient tous les fichiers nécessaires pour déployer l'application
Formation Manager Itinova sur un serveur VPS de production.

================================================================================
  CONTENU DU PACKAGE
================================================================================

1. GUIDE_DEPLOIEMENT.pdf (425 KB)
   Guide complet de déploiement avec instructions pas à pas pour installer
   l'application sur un VPS Ubuntu 22.04. Inclut la configuration de la base
   de données, Nginx, SSL, et la mise en service systemd.

2. GUIDE_DEPLOIEMENT.md (19 KB)
   Version Markdown du guide de déploiement (même contenu que le PDF).

3. CONFIGURATION.pdf (376 KB)
   Documentation complète de toutes les variables d'environnement et
   paramètres de configuration. Explique chaque variable, sa fonction,
   et les valeurs recommandées.

4. CONFIGURATION.md (12 KB)
   Version Markdown de la documentation de configuration.

5. RELEASE_NOTES.md (9.5 KB)
   Notes de version détaillées listant toutes les fonctionnalités,
   corrections de bugs et améliorations de cette version.

6. deploy.sh (8.6 KB)
   Script bash automatisé pour l'installation initiale complète de
   l'application. Installe toutes les dépendances, configure la base
   de données, compile l'application et crée le service systemd.

7. update.sh (2.5 KB)
   Script bash pour les mises à jour rapides de l'application. Récupère
   les dernières modifications, recompile et redémarre le service.

8. README.txt (ce fichier)
   Instructions de démarrage rapide.

================================================================================
  DÉMARRAGE RAPIDE
================================================================================

ÉTAPE 1 : Prérequis
-------------------
- Serveur VPS Ubuntu 22.04 ou supérieur
- Accès SSH avec droits sudo
- Nom de domaine pointant vers le serveur (pour SSL)
- Base de données MySQL ou TiDB accessible

ÉTAPE 2 : Transfert des fichiers
---------------------------------
Transférez le contenu de ce package sur votre serveur :

  scp -r deployment-package/* user@votre-serveur.com:/home/user/

ÉTAPE 3 : Lecture de la documentation
--------------------------------------
Avant de commencer, lisez attentivement :

  1. GUIDE_DEPLOIEMENT.pdf - Pour comprendre le processus complet
  2. CONFIGURATION.pdf - Pour préparer vos variables d'environnement

ÉTAPE 4 : Exécution du script de déploiement
---------------------------------------------
Sur le serveur, exécutez le script d'installation :

  chmod +x deploy.sh
  ./deploy.sh

Le script vous guidera à travers toutes les étapes d'installation.

ÉTAPE 5 : Configuration post-installation
------------------------------------------
Après l'installation :

  1. Configurez SMTP dans l'interface web (Configuration > Configuration SMTP)
  2. Créez vos premiers utilisateurs (Gestion > Utilisateurs)
  3. Personnalisez les templates d'emails (Configuration > Templates d'emails)
  4. Testez l'envoi d'emails

================================================================================
  MISES À JOUR FUTURES
================================================================================

Pour mettre à jour l'application vers une version plus récente :

  1. Transférez le nouveau fichier update.sh sur le serveur
  2. Exécutez : chmod +x update.sh && ./update.sh
  3. Le script sauvegarde automatiquement la base de données avant la mise à jour

================================================================================
  STRUCTURE DE L'APPLICATION
================================================================================

Après installation, l'application sera installée dans :
  /opt/formation-manager/

Fichiers de configuration :
  /opt/formation-manager/.env

Logs de l'application :
  sudo journalctl -u formation-manager -f

Service systemd :
  sudo systemctl status formation-manager
  sudo systemctl restart formation-manager
  sudo systemctl stop formation-manager

Configuration Nginx :
  /etc/nginx/sites-available/formation-manager

================================================================================
  IDENTIFIANTS PAR DÉFAUT
================================================================================

Après l'installation, connectez-vous avec :

  Identifiant : adminServFormation
  Mot de passe : Itinova69!

⚠️  IMPORTANT : Changez ce mot de passe immédiatement après la première connexion
    via le menu Gestion > Utilisateurs > Modifier l'utilisateur adminServFormation

================================================================================
  SUPPORT ET ASSISTANCE
================================================================================

Documentation technique :
  - README.md du projet (dans le dépôt Git)
  - GUIDE_DEPLOIEMENT.pdf (ce package)
  - CONFIGURATION.pdf (ce package)

Support Manus :
  https://help.manus.im

Contact développeur :
  o.pareige@itinova.org

================================================================================
  SÉCURITÉ
================================================================================

Recommandations de sécurité importantes :

  ✓ Changez le mot de passe administrateur par défaut
  ✓ Utilisez HTTPS (SSL/TLS) avec Let's Encrypt
  ✓ Configurez un pare-feu (ufw) pour limiter les ports ouverts
  ✓ Sauvegardez régulièrement la base de données
  ✓ Gardez le système à jour (apt update && apt upgrade)
  ✓ Utilisez des mots de passe forts pour la base de données
  ✓ Ne commitez jamais le fichier .env dans Git
  ✓ Limitez les accès SSH (clés SSH uniquement)

================================================================================
  DÉPANNAGE
================================================================================

L'application ne démarre pas :
  - Vérifiez les logs : sudo journalctl -u formation-manager -n 100
  - Vérifiez le fichier .env : toutes les variables sont-elles définies ?
  - Testez la connexion DB : mysql -h HOST -u USER -p DATABASE

Les emails ne sont pas envoyés :
  - Vérifiez la configuration SMTP dans l'interface
  - Utilisez la fonction "Test d'envoi" dans Configuration > Configuration SMTP
  - Consultez les logs pour les erreurs SMTP

Erreur 502 Bad Gateway :
  - Le service formation-manager est-il démarré ? sudo systemctl status formation-manager
  - Vérifiez les logs Nginx : sudo tail -f /var/log/nginx/error.log

================================================================================
  LICENCE ET COPYRIGHT
================================================================================

Formation Manager Itinova
Version 7a737c05

Développé par Manus AI pour Itinova
© 2025 Itinova - Tous droits réservés

Ce logiciel est fourni "tel quel", sans garantie d'aucune sorte.

================================================================================
  FIN DU README
================================================================================
