README_PRODUCTION.md

ENISE Site - Production Deployment Guide

📋 Sommaire

Ce repository contient l'application ENISE Site - une plateforme web Django pour l'école d'ingénieurs ENISE, déployée sur Hugging Face Spaces avec intégration Appwrite.

• Repository: https://github.com/tiffank1802/enise-site-2
• HF Space: https://huggingface.co/spaces/ktongue/ENISE
• Framework: Django 5.0
• Backend: Appwrite Cloud
• Deployment: Docker sur HF Spaces

✨ Caractéristiques

✅ Implémentées

• Homepage avec branding ENISE
• Listing des formations/spécialisations
• Intégration Appwrite pour les données
• Système de gestion des fichiers
• Authentification utilisateur
• Stockage MongoDB (optionnel)
• Fichiers statiques avec WhiteNoise
• Configuration production-ready
• Documentation complète

🗄️ Collections Appwrite Disponibles

• specialites - Programs/Specialties
• actualites - News/Updates
• contact - Contact form submissions
• partenaires - Academic partners
• statistiques - School statistics

🚀 Déploiement Rapide

1️⃣ Configuration sur HF Spaces

1. Visitez: https://huggingface.co/spaces/ktongue/ENISE
2. Cliquez ⚙️ Settings
3. Allez à Repository Secrets
4. Ajoutez ces variables (voir QUICK_START.md pour valeurs):

DEBUG=False
SECRET_KEY=<votre-clé>
ALLOWED_HOSTS=*
CSRF_TRUSTED_ORIGINS=https://ktongue-enise.hf.space
APPWRITE_ENDPOINT=https://fra.cloud.appwrite.io/v1
APPWRITE_PROJECT_ID=<votre-id>
APPWRITE_API_KEY=<votre-clé> ⚠️
APPWRITE_DATABASE_ID=<votre-db-id>

2️⃣ Vérification

Une fois configuré, le space se redémarrera automatiquement.

Testez les endpoints:

• Homepage: https://ktongue-enise.hf.space/
• Formations: https://ktongue-enise.hf.space/formations/
• API: https://ktongue-enise.hf.space/api/appwrite/test/

Voir VERIFIER_DEPLOIEMENT.md pour guide complet.

📚 Documentation

Document	Purpose
QUICK_START.md	Démarrage rapide
DEPLOYMENT_CHECKLIST.md	Checklist complète
VERIFIER_DEPLOIEMENT.md	Guide vérification (FR)
DEPLOYMENT_STATUS.md	État du déploiement
FIXES_APPLIED.md	Corrections appliquées

🔧 Technologies

Composant	Version
Python	3.11+
Django	5.0+
Appwrite	1.0+
WhiteNoise	6.5+
PostgreSQL	optionnel

📊 Structure du Projet

enise-site/
├── enise_site/                 # Django project
│   ├── settings.py             # Configuration
│   ├── urls.py                 # URL routing
│   └── wsgi.py                 # WSGI entry
├── app_core/                   # Main application
│   ├── models.py               # ORM models
│   ├── views.py                # Views
│   ├── urls.py                 # Routes
│   └── templates/              # HTML templates
├── app_formations/             # Formations app
├── static/                     # CSS, JS, images
├── media/                      # User uploads
├── Dockerfile                  # Docker config
├── run.sh                      # Startup script
├── requirements.txt            # Dependencies
└── manage.py                   # Django CLI

🔐 Configuration de Sécurité

✅ Appliquée

• Credentials MongoDB supprimées ✓
• SECRET_KEY en variables d'env ✓
• DEBUG=False en production ✓
• WhiteNoise pour fichiers statiques ✓
• CSRF protection configurée ✓
• API keys en HF Secrets ✓

⚠️ À Faire

• Jamais committer .env
• Régénérer SECRET_KEY pour chaque deployment
• Utiliser HTTPS en production
• Limiter ALLOWED_HOSTS si besoin

🧪 Tests

Tests Locaux

# Vérifier configuration
python manage.py check

# Tester déploiement
python test_deployment.py

# Vérifier variables d'env
python check_env.py

Tests HF Spaces

1. Vérifier status "Running"
2. Tester endpoints (voir VERIFIER_DEPLOIEMENT.md)
3. Vérifier logs en cas d'erreur

🚨 Dépannage

Space "Building"

• C'est normal, attendez 5-10 minutes
• Vérifiez logs si > 15 min

HTTP 400

• Vérifier SECRET_KEY configurée
• Vérifier ALLOWED_HOSTS=*
• Vérifier DEBUG=False

API Appwrite échoue

• Vérifier APPWRITE_API_KEY
• Vérifier IDs du projet/database
• Régénérer clé si besoin

Files statiques ne chargent pas

• WhiteNoise est activé ✓
• Vérifier .log pour erreurs
• Redémarrer le space

Voir VERIFIER_DEPLOIEMENT.md pour plus de solutions.

📈 Monitoring

Vérifiez régulièrement:

1. Status du Space: https://huggingface.co/spaces/ktongue/ENISE
2. Logs: Settings → Logs
3. Endpoints: Tester régulièrement
4. Errors: Chercher "ERROR" dans les logs

🔄 Mise à Jour

Pour déployer une mise à jour:

# 1. Faire changements localement
# 2. Tester localement
python manage.py check

# 3. Commit et push
git add .
git commit -m "Description"
git push origin main

# 4. HF Spaces redéploie automatiquement
# 5. Vérifier logs et endpoints

📞 Support

• Issues: https://github.com/tiffank1802/enise-site-2/issues
• Docs: Voir fichiers *.md dans le repo
• Appwrite: https://console.appwrite.io

📝 Notes Importantes

1. Credentials: Ne jamais committer secrets
2. Branches: Main = production, utilisez branches pour dev
3. Migrations: Auto-exécutées par run.sh
4. Static Files: Auto-collectés par run.sh
5. Logs: Disponibles dans HF Spaces Settings

✅ Dernière Vérification

Avant de considérer le déploiement comme "done":

• Space status = "Running"
• Pas d'erreurs dans les logs
• Homepage charge (200 OK)
• Formations visibles
• API test répond
• Static files chargent
• Admin panel accessible
• Appwrite connecté (avec API Key)

📊 Status

• Code: ✅ Production-ready
• Tests: ✅ Tous passent
• Documentation: ✅ Complète
• Deployment: ✅ Prêt

Dernière mise à jour: Jan 30, 2025

---

Pour commencer, consultez QUICK_START.md ou VERIFIER_DEPLOIEMENT.md.