Initial commit

TROUBLESHOOTING.md

@@ -0,0 +1,238 @@
+# 🔧 Guide de dépannage rapide
+
+## Problème : 404 sur l'interface web
+
+### Cause
+Le serveur HTTP démarre mais ne trouve pas `index.html`
+
+### Solution
+
+```bash
+# 1. Arrêter tout
+bash stop.sh
+
+# 2. Vérifier la structure des fichiers
+cd /mnt/e/My\ IA  # Ou ton chemin
+ls -la
+ls -la frontend/
+
+# 3. Tu DOIS voir :
+# frontend/
+#   └── index.html
+
+# 4. Si index.html manque, télécharge à nouveau l'archive
+
+# 5. Lancer correctement
+bash start.sh
+
+# 6. Ouvrir
+# http://localhost:9000
+```
+
+## Problème : Permission denied avec source
+
+### Cause
+Utilisation de `sh` au lieu de `bash`
+
+### Solution
+
+```bash
+# ❌ PAS COMME ÇA :
+sh start.sh
+
+# ✅ COMME ÇA :
+bash start.sh
+
+# Ou directement :
+./start.sh
+```
+
+## Problème : Backend ne démarre pas
+
+### Diagnostic
+
+```bash
+# Voir les logs
+cat /tmp/fastapi.log
+
+# Vérifier Python
+python3 --version  # Doit être 3.10+
+
+# Vérifier le port 8000
+lsof -i :8000
+```
+
+### Solution
+
+```bash
+# Si le port est occupé
+kill $(lsof -t -i :8000)
+
+# Relancer
+cd /mnt/e/My\ IA/backend
+. venv/bin/activate
+python main.py
+```
+
+## Problème : Ollama non accessible
+
+### Diagnostic
+
+```bash
+curl http://localhost:11434/api/tags
+```
+
+### Solution
+
+```bash
+# Démarrer Ollama
+ollama serve &
+
+# Attendre 3 secondes
+sleep 3
+
+# Vérifier
+ollama list
+```
+
+## Lancement manuel complet (si scripts ne marchent pas)
+
+```bash
+# 1. Aller dans le dossier
+cd /mnt/e/My\ IA
+
+# 2. Terminal 1 : Ollama
+ollama serve
+
+# 3. Terminal 2 : Backend
+cd backend
+python3 -m venv venv
+. venv/bin/activate
+pip install -r requirements.txt
+python main.py
+
+# 4. Terminal 3 : Frontend
+cd frontend
+python3 -m http.server 9000
+
+# 5. Ouvrir navigateur
+# http://localhost:9000
+```
+
+## Vérification complète
+
+```bash
+# Vérifier tous les services
+echo "=== Ollama ==="
+curl -s http://localhost:11434/api/tags | head -5
+
+echo -e "\n=== Backend ==="
+curl -s http://localhost:9001/health
+
+echo -e "\n=== Frontend ==="
+curl -s http://localhost:9000 | head -5
+
+echo -e "\n=== Processus ==="
+ps aux | grep -E "ollama|python|http.server" | grep -v grep
+```
+
+## Checklist de debug
+
+- [ ] Ollama installé : `which ollama`
+- [ ] Python 3.10+ : `python3 --version`
+- [ ] Structure correcte : `ls -la frontend/index.html`
+- [ ] Scripts exécutables : `ls -la *.sh`
+- [ ] Ports libres : `netstat -tlnp | grep -E "9001|9000"`
+- [ ] Logs accessibles : `cat /tmp/fastapi.log`
+
+## Réinstallation propre
+
+```bash
+# 1. Tout arrêter
+bash stop.sh
+pkill ollama
+pkill python
+
+# 2. Nettoyer
+rm -rf backend/venv
+rm /tmp/*.log
+rm /tmp/ai-assistant-*.pid
+
+# 3. Retélécharger l'archive
+# (télécharger ai-code-assistant.zip)
+
+# 4. Extraire
+unzip -o ai-code-assistant.zip
+cd ai-code-assistant
+
+# 5. Rendre exécutable
+chmod +x start.sh stop.sh
+
+# 6. Démarrer
+bash start.sh
+```
+
+## Astuce : Vérifier que tout fonctionne
+
+```bash
+# Ce script vérifie tout en une commande
+cat > check.sh << 'EOF'
+#!/bin/bash
+echo "🔍 Vérification système..."
+echo ""
+
+echo "1. Ollama:"
+if curl -s http://localhost:11434/api/tags > /dev/null 2>&1; then
+    echo "   ✅ Actif"
+else
+    echo "   ❌ Inactif"
+fi
+
+echo "2. Backend (port 8000):"
+if curl -s http://localhost:9001/health > /dev/null 2>&1; then
+    echo "   ✅ Actif"
+else
+    echo "   ❌ Inactif"
+fi
+
+echo "3. Frontend (port 9000):"
+if curl -s http://localhost:9000 > /dev/null 2>&1; then
+    echo "   ✅ Actif"
+else
+    echo "   ❌ Inactif"
+fi
+
+echo "4. Fichiers:"
+if [ -f "frontend/index.html" ]; then
+    echo "   ✅ index.html présent"
+else
+    echo "   ❌ index.html manquant"
+fi
+
+echo ""
+echo "URL à ouvrir: http://localhost:9000"
+EOF
+
+chmod +x check.sh
+bash check.sh
+```
+
+## Contact / Support
+
+Si rien ne fonctionne :
+
+1. Copie la sortie de :
+```bash
+bash check.sh
+cat /tmp/fastapi.log
+cat /tmp/frontend.log
+```
+
+2. Vérifie ta structure de fichiers :
+```bash
+tree -L 2
+# ou
+find . -type f
+```
+
+3. Partage ces informations pour obtenir de l'aide