đ Description
SystĂšme complet de gestion des entrĂ©es pour la Grande FĂȘte de Hanouccah du 20 DĂ©cembre 2025.
Interface mobile-first avec design chaleureux aux couleurs de l'événement, développé pour l'Association NAOMIIE.
âš Points forts :
- Design responsive optimisé pour smartphones
- Recherche instantanée en temps réel
- Animations élégantes et feedback visuel
- Import CSV simplifié
- SystĂšme de placement avec plans de tables
đš Palette de Couleurs
Palette personnalisée créée spécialement pour l'événement Hanouccah 2025 :
SuccÚs / Validé
#8b9d83
đ Structure des Fichiers
hanouccah2025/
âââ config.php # Configuration base de donnĂ©es
âââ api.php # API pour toutes les actions
âââ import.php # Import CSV des participants
âââ entree.php # ContrĂŽle d'entrĂ©e (mobile)
âââ recherche_placement.php # Recherche de placement (mobile)
âââ index.php # Page d'accueil avec navigation
âââ test_connexion.php # Test de connexion BDD
âââ install_database.sql # Script installation MySQL
âââ participants_exemple.csv# Exemple format CSV
âââ README.md # Documentation texte
âââ tables/ # Dossier pour images des tables
âââ Table_page-0001.jpg
âââ Table_page-0002.jpg
âââ ...
đïž Base de DonnĂ©es
Configuration
- Base :
gala_db
- Utilisateur :
gala_user
- Mot de passe :
gala2025
- Table :
participants_gala
Structure de la table
CREATE TABLE participants_gala (
id INT AUTO_INCREMENT PRIMARY KEY,
nom VARCHAR(100) NOT NULL,
prenom VARCHAR(100) NOT NULL,
mode_paiement VARCHAR(50),
table_numero VARCHAR(20),
nom_table VARCHAR(100),
deja_rentre TINYINT(1) DEFAULT 0,
heure_entree DATETIME NULL,
INDEX idx_nom (nom),
INDEX idx_prenom (prenom),
INDEX idx_table (table_numero)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
đ„ Format CSV
Format attendu
nom;prenom;mode_paiement;table_numero;nom_table
COHEN;Sarah;CB;1;Table des LumiĂšres
LEVY;David;EspĂšces;2;Table de la Joie
ABITBOL;Rachel;ChĂšque;3;Table de l'Espoir
â ïž RĂšgles importantes :
- Délimiteur : point-virgule
;
- Encodage : UTF-8
- Header optionnel (sera ignoré si présent)
- Pas de guillemets sauf si nécessaire
đ Installation
1. Configuration MySQL
# Se connecter Ă MySQL
mysql -u root -p
# Exécuter le script d'installation
source /chemin/vers/install_database.sql
2. Déploiement des fichiers
# Copier tous les fichiers dans le serveur web
sudo cp -r hanouccah2025/* /var/www/html/hanouccah2025/
# Créer le dossier pour les images de tables
sudo mkdir -p /var/www/html/hanouccah2025/tables
# Ajuster les permissions
sudo chown -R www-data:www-data /var/www/html/hanouccah2025/
sudo chmod -R 755 /var/www/html/hanouccah2025/
3. Tester la connexion
Accéder à : http://votre-serveur/hanouccah2025/test_connexion.php
â
Vous devriez voir : "Connexion réussie à la base de données 'gala_db'"
đ± Utilisation
đ„1. Import des participants
URL : import.php
- Sélectionner le fichier CSV
- Cocher "Supprimer les données existantes" si besoin
- Cliquer sur "Importer les participants"
Note : Le systĂšme affiche le nombre de participants actuels.
đ«2. ContrĂŽle d'entrĂ©e
URL : entree.php
Interface mobile optimisée pour les agents d'accueil :
- Recherche instantanée : Tapez nom ou prénom
- Validation rapide : Bouton tactile large
- Compteur en temps réel : Affiche entrées validées / total
- Feedback visuel : Animation de validation avec sparkles âš
- Annulation possible : Bouton pour corriger les erreurs
- Reset global : Bouton pour réinitialiser toutes les entrées
đš Codes couleurs :
- Bordure normale : Participant non entré
- Fond vert : Participant déjà entré
- Bordure orange : Participant sans placement
đ3. Recherche de placement
URL : recherche_placement.php
Interface conviviale pour les invités :
- Recherche instantanée : Résultats en temps réel
- Affichage du plan : Image de la table avec animation
- Confettis : Animation festive lors de l'affichage đ
- Retour facile : Bouton pour nouvelle recherche
đ· Organisation des images de tables :
- Nommer :
Table_page-0001.jpg, Table_page-0002.jpg, etc.
- Format : JPG recommandé
- Résolution : Optimisée pour mobile (800-1200px)
đ§ API Endpoints
| Endpoint |
Description |
api.php?action=search&q=[terme] |
Recherche de participants pour contrÎle d'entrée |
api.php?action=validate&id=[id] |
Valide l'entrée d'un participant |
api.php?action=unvalidate&id=[id] |
Annule la validation d'une entrée |
api.php?action=stats |
Retourne les statistiques (total / validés) |
api.php?action=reset |
Réinitialise toutes les entrées |
api.php?action=placement&q=[terme] |
Recherche pour le placement (sans infos sensibles) |
đŻ FonctionnalitĂ©s Principales
âšDesign
- Palette Hanouccah (beige rosé et terracotta)
- Interface mobile-first responsive
- Animations fluides et élégantes
- Emojis thĂ©matiques đ âš đ«
đ±Mobile
- Optimisé pour smartphone
- Boutons tactiles larges
- Clavier automatique sur champ de recherche
- Pas de zoom involontaire
đSĂ©curitĂ©
- RequĂȘtes prĂ©parĂ©es (PDO)
- Protection contre injections SQL
- Validation des données
- Gestion des erreurs
âĄPerformance
- Recherche instantanée (AJAX)
- Index sur colonnes clés
- RequĂȘtes optimisĂ©es
- Refresh auto des stats (3s)
đ DĂ©pannage
Erreur de connexion MySQL
# Vérifier que MySQL est démarré
sudo systemctl status mysql
# Vérifier les identifiants dans config.php
Images de tables non affichées
# Vérifier le chemin du dossier tables/
# Vérifier les permissions
sudo chmod 755 /var/www/html/hanouccah2025/tables/
sudo chmod 644 /var/www/html/hanouccah2025/tables/*.jpg
Encodage CSV incorrect
- Vérifier que le CSV est en UTF-8
- Utiliser LibreOffice ou Excel avec export UTF-8
- Vérifier le délimiteur (point-virgule)
đ Support
Pour toute question ou problĂšme :
- Vérifier les logs Apache/PHP
- Tester avec
test_connexion.php
- Vérifier la structure de la table
- Valider le format CSV
đ ĂvĂ©nement
Grande FĂȘte de Hanouccah 2025
đ
20 Décembre 2025
đïž Association NAOMIIE
âš Illuminons ensemble leurs sourires âš