my-ia/TROUBLESHOOTING.md

# 🔧 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