CIA/e-voting-system/.claude/QUICK_START.md

Quick Start & Notes

🚀 Démarrage rapide

# Docker (recommandé)
cd /home/paul/CIA/e-voting-system
docker-compose up -d

# Frontend: http://localhost:3000
# Backend API: http://localhost:8000
# Database: localhost:3306

🔧 Fixes récentes (5 nov 2025)

LoginPage.js

• ✅ Utilise API_ENDPOINTS.LOGIN au lieu de URL hardcodée
• ✅ Prop correct: onLogin (était onLoginSuccess)
• ✅ Mapping données correct: email, first_name, last_name
• ✅ Teste les identifiants: paul.roost@epita.fr / tennis16

DashboardPage.js

• ✅ Utilise API_ENDPOINTS.ELECTIONS_ACTIVE

Docker

• ✅ Dockerfile.backend: suppression du double CMD
• ✅ Frontend build inclus dans docker-compose

Nettoyage

• ✅ Suppression du dossier src/ (doublon)
• ✅ Installation de lucide-react
• ✅ Suppression des console.log de debug

---

📋 Fichiers à connaître

Fichier	Rôle
backend/main.py	Point d'entrée FastAPI
backend/routes/auth.py	Routes login/register
frontend/src/pages/LoginPage.js	Page de login
frontend/src/config/api.js	Configuration API endpoints
docker-compose.yml	Orchestration services
.env.example	Variables d'environnement

---

🧪 Test login

# Via curl
curl -X POST http://localhost:8000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "paul.roost@epita.fr", "password": "tennis16"}'

# Réponse attendue
{
  "access_token": "eyJ...",
  "token_type": "bearer",
  "expires_in": 1800,
  "id": 1,
  "email": "paul.roost@epita.fr",
  "first_name": "Paul",
  "last_name": "Roost"
}

---

🔑 Points clés

API Base URL

• Local dev: http://localhost:8000
• Docker: Configuration dans frontend/public/config.js

JWT Token

• Stocké dans localStorage sous clé token
• Utilisé dans header Authorization: Bearer <token>
• Expiration: 30 minutes

Voter Data

• Stocké dans localStorage sous clé voter
• Structure: { id, email, name, first_name, last_name }

---

⚠️ Erreurs courantes

Erreur	Cause	Solution
CORS error	Frontend cherche localhost depuis Docker	Utiliser API_ENDPOINTS
onLoginSuccess is not a function	Prop nommé incorrectement	Utiliser onLogin
t is not a function	Composant pas reçu le bon prop	Vérifier noms props parent/enfant
Build cache	Ancien JS chargé	Force refresh: Ctrl+Shift+R

---

📊 Architecture réseau Docker

User Browser (localhost:3000)
        ↓
Frontend Container (nginx serve)
        ↓
Backend Container (:8000)
        ↓
MariaDB Container (:3306)

Important: Du navigateur, utiliser localhost:8000. Du container, utiliser evoting_backend:8000.

---

🔐 Credentials de test

• Email: paul.roost@epita.fr
• Password: tennis16
• DB User: evoting_user
• DB Pass: evoting_pass123

---

📚 Autres fichiers .claude

• PROJECT_STRUCTURE.md - Architecture complète (ce répertoire)
• DEPLOYMENT.md - Guide déploiement production
• POSTQUANTUM_CRYPTO.md - Détails cryptographie

---

Dernière mise à jour: 5 novembre 2025