PROJECT_STRUCTURE.md 3.3 KB

Structure du Projet Assistant AI

📁 Organisation des dossiers

assistant_ai/
├── 📁 src/                          # Code source principal
│   ├── 📁 api/                      # Routes API
│   ├── 📁 models/                   # Modèles ML
│   │   └── VLM.py                  # Vision Language Model
│   ├── 📁 static/                   # Assets statiques (CSS, JS, images)
│   ├── 📁 templates/                # Templates HTML
│   │   └── index.html              # Interface utilisateur
│   ├── 📁 utils/                    # Utilitaires
│   │   ├── ocr.py                  # OCR des documents
│   │   └── processing.py           # Traitement des données
│   ├── 📁 agent_ai/                # Module d'authentification
│   │   └── auth.py                 # Authentification Wiki
│   └── app.py                      # Application Flask principale
├── 📁 tests/                        # Tests automatisés
│   └── test_deployment.py          # Tests de déploiement
├── 📁 scripts/                      # Scripts de déploiement
│   ├── setup.sh                    # Installation locale
│   └── deploy-vps.sh               # Déploiement VPS
├── 📁 uploads/                      # Fichiers uploadés (généré)
├── 📁 data/                         # Données persistantes (généré)
├── 📄 config.py                     # Configuration centralisée
├── 📄 wsgi.py                       # Point d'entrée WSGI
├── 📄 requirements.txt              # Dépendances complètes
├── 📄 requirements-prod.txt         # Dépendances production
├── 📄 Dockerfile                    # Configuration Docker
├── 📄 docker-compose.yml           # Orchestration Docker
├── 📄 render.yaml                   # Configuration Render.com
├── 📄 env.example                   # Variables d'environnement
├── 📄 .gitignore                    # Fichiers ignorés Git
├── 📄 README.md                     # Documentation principale
├── 📄 DEPLOYMENT.md                 # Guide de déploiement
└── 📄 PROJECT_STRUCTURE.md          # Ce fichier

🔧 Fichiers de configuration

config.py

Configuration centralisée de l'application avec :

  • Variables d'environnement
  • Configuration Flask
  • Paramètres des modèles ML
  • Configuration des API

wsgi.py

Point d'entrée pour le déploiement avec Gunicorn

requirements-prod.txt

Dépendances optimisées pour la production

🚀 Déploiement

Local (Docker Compose)

docker-compose up -d

VPS

./scripts/deploy-vps.sh <vps-ip> <user> <ssh-key>

Render.com

Configuration automatique via render.yaml

🧪 Tests

python tests/test_deployment.py

📊 Monitoring

  • Healthchecks : Intégrés dans Docker Compose
  • Logs : docker-compose logs -f
  • Statut : docker-compose ps

🔒 Sécurité

  • Variables d'environnement pour les secrets
  • Limite de taille de fichiers
  • Validation des extensions
  • Configuration production sécurisée

📈 Évolutions recommandées

  1. Sécurité : Nginx + SSL
  2. Performance : Redis cache
  3. Monitoring : Prometheus + Grafana
  4. CI/CD : GitHub Actions