Wash & Go — Guide d’Utilisation

Application web MVC en PHP pour la gestion d’une station de lavage automobile. Ce guide unique explique l’usage pour le Gérant (Admin) et le Caissier.

Démarrage rapide

• Placez le projet dans:
  • XAMPP: C:\xampp\htdocs\wash_and_go
  • WAMP: C:\wamp64\www\wash_and_go
• Base de données:
  • Créez wash_and_go et importez /database/wash_and_go.sql via phpMyAdmin.
• Configuration:
  • Éditez /config/config.php et ajustez BASE_URL à /wash_and_go/public/.
• Accès:
  • http://localhost/wash_and_go/public/
  • Comptes de test (mdp: admin123):
    • Admin: admin@washgo.ci
    • Caissier: caissier@washgo.ci

Pour le Gérant (Admin)

• Tableau de bord: statistiques globales.
• Services:
  • Créer/modifier/supprimer les services et leurs prix.
  • Chemin: Admin → Services
• Véhicules:
  • Ajouter/modifier/supprimer les véhicules (liés aux clients).
  • Champ “Immatriculation” optionnel avec capture caméra.
  • Chemin: Admin → Véhicules
• Utilisateurs (Caissiers):
  • Créer/éditer/supprimer des caissiers.
  • Chemin: Admin → Utilisateurs
• Rapports:
  • Accès aux données de commandes et rendez‑vous.

Pour le Caissier

• Nouvelle commande:
  • Recherche client par téléphone, création rapide si absent.
  • Sélection services, calcul du total, encaissement (Espèces ou Mobile Money simulé).
  • Reçu numérique: envoi WhatsApp depuis la page de succès.
  • Chemin: Caissier → Nouvelle commande
• Rendez‑vous:
  • Voir les RDV du jour, confirmer/annuler; statut mis à jour et badges colorés.
  • Chemin: Caissier → Rendez‑vous
• Historique du jour:
  • Liste des commandes du jour, auto‑rafraîchissement 30s.
  • Chemin: Caissier → Historique du jour

Portail Client (interface web simple)

• Catalogue:
  • Consultation des services et prix: /client/catalog
• Prise de RDV:
  • Créneaux dynamiques; option “Urgent / Je suis déjà sur place”.
  • Saisie libre du véhicule (marque + modèle); création automatique si non existant.
  • Paiement pour confirmation (simulé): /client/appointments/pay/{id}
  • Portail intégré: /client/portal avec onglets (Catalogue, Prendre RDV, Mes Rendez‑vous, Points)
• Points & Historique:
  • Solde des points, prochaine récompense et historique consultables.

Notes techniques

• MVC:
  • Contrôleurs: /controllers (ex: ClientController, CashierController, AdminController, AppointmentController)
  • Modèles: /models (ex: ClientModel, VehicleModel, ServiceModel, AppointmentModel)
  • Vues: /views
• Routage:
  • Router.php gère les segments d’URL. Les sous‑routes client pour rendez‑vous sont gérées via ClientController::appointments.
• Sécurité & sessions:
  • Accès restreints selon rôle: Admin, Caissier, Client (simulé).

Dépannage

• Page noire sur une route client:
  • Utiliser /client/portal ou /client/appointments (routage imbriqué corrigé).
• Rendez‑vous annulé encore visible:
  • Filtre appliqué: les RDV avec statut annule sont exclus des listes du jour.
• Historique non rafraîchi:
  • La page s’auto‑met à jour toutes les 30s; bouton “Actualiser” disponible.

Navigation et URLs

• Base:
  • http://localhost/wash_and_go/public/
  • Connexion: http://localhost/wash_and_go/public/auth
• Admin:
  • Dashboard: http://localhost/wash_and_go/public/admin
  • Utilisateurs (liste): http://localhost/wash_and_go/public/admin/users
  • Créer caissier: http://localhost/wash_and_go/public/admin/users/create
  • Éditer caissier: http://localhost/wash_and_go/public/admin/users/edit/{id}
  • Véhicules (liste): http://localhost/wash_and_go/public/admin/vehicles
  • Ajouter véhicule: http://localhost/wash_and_go/public/admin/vehicles/create
  • Modifier véhicule: http://localhost/wash_and_go/public/admin/vehicles/edit/{id}
  • Services (liste): http://localhost/wash_and_go/public/admin/services
  • Ajouter service: http://localhost/wash_and_go/public/admin/services/create
  • Modifier service: http://localhost/wash_and_go/public/admin/services/edit/{id}
• Caissier:
  • Nouvelle commande: http://localhost/wash_and_go/public/cashier
  • Rendez‑vous (vue liste): http://localhost/wash_and_go/public/cashier/appointments
  • Créer RDV rapide: http://localhost/wash_and_go/public/cashier/create_appointment
  • Historique du jour: http://localhost/wash_and_go/public/cashier/history
• Client:
  • Portail (onglets): http://localhost/wash_and_go/public/client/portal
  • Catalogue: http://localhost/wash_and_go/public/client/catalog
  • Mes rendez‑vous: http://localhost/wash_and_go/public/client/appointments
  • Prendre rendez‑vous: http://localhost/wash_and_go/public/client/appointments/create
  • Modifier RDV: http://localhost/wash_and_go/public/client/appointments/edit/{id}
  • Payer RDV: http://localhost/wash_and_go/public/client/appointments/pay/{id}
  • Points fidélité: http://localhost/wash_and_go/public/client/loyalty
  • Profil: http://localhost/wash_and_go/public/client/profile