🕎 SystĂšme de ContrĂŽle d'EntrĂ©e

Hanouccah 2025 ‱ Documentation Complùte

📋 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 :

Fond principal
#e3d5c7
Texte / Titres
#c6787b
Fond sections
#d4c4b5
Accent foncé
#a85c5f
Accent lumineux
#e8a3a7
SuccÚs / Validé
#8b9d83
Attention
#d4a574
Texte secondaire
#8d7169

📂 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

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

  1. Sélectionner le fichier CSV
  2. Cocher "Supprimer les données existantes" si besoin
  3. 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 :

🎹 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 :

đŸ“· 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

đŸ“±Mobile

🔒SĂ©curitĂ©

⚡Performance

🐛 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

📞 Support

Pour toute question ou problĂšme :

🎉 ÉvĂ©nement

Grande FĂȘte de Hanouccah 2025
📅 20 DĂ©cembre 2025
đŸ›ïž Association NAOMIIE
✹ Illuminons ensemble leurs sourires ✹