# Guide Utilisateur - StayManager

**Version:** 1.0  
**Date:** Novembre 2025  
**Application:** StayManager - Système de Gestion Hôtelière

---

## Table des Matières

1. [Introduction](#introduction)
2. [Connexion au Système](#connexion-au-système)
3. [Navigation dans l'Application](#navigation-dans-lapplication)
4. [Modules et Fonctionnalités](#modules-et-fonctionnalités)
5. [Procédures Courantes](#procédures-courantes)
6. [FAQ](#faq)

---

## Introduction

### À propos de StayManager

StayManager est une application web complète de gestion hôtelière qui permet de gérer :
- Les réservations de chambres
- Les événements et salles
- Les clients
- La restauration
- La caisse et les paiements
- L'inventaire et les stocks
- Les utilisateurs et permissions

### Prérequis

- Navigateur web moderne (Chrome, Firefox, Edge, Safari)
- Connexion Internet (pour l'accès à l'application)
- Compte utilisateur avec les permissions appropriées

---

## Connexion au Système

### Étape 1 : Accéder à la page de connexion

1. Ouvrez votre navigateur web
2. Accédez à l'URL de l'application : `http://localhost:81/StayManager/login.php`
3. La page de connexion s'affiche

> **Note:** Remplacez l'URL par celle de votre serveur si nécessaire.

### Étape 2 : Saisir les identifiants

1. Entrez votre **nom d'utilisateur** dans le champ prévu
2. Entrez votre **mot de passe** dans le champ prévu
3. Cliquez sur le bouton **"Se connecter"** ou appuyez sur **Entrée**

### Étape 3 : Accès au Dashboard

Après une connexion réussie, vous êtes redirigé vers le **Dashboard** qui affiche :
- Les statistiques en temps réel
- Les actions rapides
- Les notifications et alertes

> **Capture d'écran à ajouter :** Page de connexion  
> **Capture d'écran à ajouter :** Dashboard principal

---

## Navigation dans l'Application

### Menu Principal

Le menu principal est situé en haut de la page et contient les modules suivants :

1. **Dashboard** - Vue d'ensemble
2. **Séjours** - Gestion des réservations
3. **Événements** - Gestion des événements
4. **Clients** - Gestion des clients
5. **Chambres** - Gestion des chambres
6. **Planning Chambres** - Vue calendaire
7. **Réservations Groupées** - Gestion des groupes
8. **Rapports** - Rapports et statistiques
9. **Notifications** - Centre de notifications
10. **Modules** - Modules avancés (Restaurant, Cuisine, Caisse, Stock)
11. **Utilisateurs** - Gestion des utilisateurs et rôles

> **Capture d'écran à ajouter :** Menu principal avec tous les modules

### Sous-menus

Certains modules ont des sous-menus accessibles via un menu déroulant :
- **Dashboard** : Dashboard Standard, Dashboard Simple
- **Rapports** : Chiffre d'Affaires, Transactions Annulées, Rapport d'Occupation, Rapport Restauration, Rapport Événements
- **Modules > Cuisine** : Commandes Cuisine, Sorties de Stock
- **Modules > Caisse** : Gestion Caisse, Récapitulatifs Sessions, Détails Transactions
- **Utilisateurs** : Utilisateurs, Nouvel Utilisateur, Rôles, Nouveau Rôle

> **Capture d'écran à ajouter :** Menu déroulant avec sous-menus

---

## Modules et Fonctionnalités

### 1. Dashboard

#### Accès
Menu : **Dashboard** > **Dashboard Standard**

#### Fonctionnalités
- Vue d'ensemble des statistiques
- Accès rapide aux modules
- Graphiques et indicateurs
- Actions rapides

#### Actions Disponibles
- Cliquer sur une statistique pour accéder au module correspondant
- Utiliser les actions rapides pour créer rapidement des éléments

> **Capture d'écran à ajouter :** Dashboard avec statistiques

---

### 2. Gestion des Réservations

#### Accès
Menu : **Séjours**

#### Créer une Nouvelle Réservation

1. Cliquez sur **"Nouvelle Réservation"** dans les actions rapides ou dans le menu
2. Remplissez le formulaire :
   - **Client** : Sélectionnez un client existant ou créez-en un nouveau
   - **Chambre** : Sélectionnez une chambre disponible
   - **Dates** : Date d'arrivée et date de départ
   - **Nombre de personnes** : Nombre d'adultes et d'enfants
   - **Prix par nuit** : Saisissez le prix (peut être pré-rempli)
   - **Remise** : Optionnelle
   - **Notes** : Informations complémentaires
3. Cliquez sur **"Enregistrer"**

> **Capture d'écran à ajouter :** Formulaire de création de réservation

#### Modifier une Réservation

1. Accédez à la liste des réservations
2. Cliquez sur le bouton **"Modifier"** (icône crayon) de la réservation souhaitée
3. Modifiez les informations nécessaires
4. Cliquez sur **"Enregistrer"**

#### Check-in / Check-out

1. Accédez à la liste des réservations
2. Pour le **Check-in** : Cliquez sur **"Check-in"** (icône clé)
3. Pour le **Check-out** : Cliquez sur **"Check-out"** (icône porte)
4. Confirmez l'action

> **Capture d'écran à ajouter :** Liste des réservations avec actions

---

### 3. Gestion des Clients

#### Accès
Menu : **Clients**

#### Créer un Nouveau Client

1. Cliquez sur **"Nouveau Client"** dans les actions rapides ou le bouton **"Ajouter"**
2. Remplissez le formulaire :
   - **Prénom** : Obligatoire
   - **Nom** : Obligatoire
   - **Email** : Optionnel
   - **Téléphone** : Optionnel
   - **Date de naissance** : Optionnel (l'âge sera calculé automatiquement)
   - **Adresse** : Optionnel
   - **Type** : Particulier, Société, Groupe
3. Cliquez sur **"Enregistrer"**

> **Capture d'écran à ajouter :** Formulaire de création de client

#### Rechercher un Client

1. Utilisez la barre de recherche en haut de la liste
2. Tapez le nom, prénom, email ou téléphone
3. Les résultats s'affichent automatiquement

---

### 4. Gestion des Chambres

#### Accès
Menu : **Chambres**

#### Créer une Nouvelle Chambre

1. Cliquez sur **"Gérer Chambres"** dans les actions rapides ou le bouton **"Ajouter"**
2. Remplissez le formulaire :
   - **Numéro de chambre** : Obligatoire (ex: 101, 201)
   - **Type** : Standard, Supérieur, Premium, Mini Suite
   - **Étage** : Numéro d'étage
   - **Capacité** : Nombre de personnes
   - **Prix par nuit** : Montant en FCFA
   - **Statut** : Disponible, Occupée, Réservée, Maintenance
3. Cliquez sur **"Enregistrer"**

> **Capture d'écran à ajouter :** Formulaire de création de chambre

---

### 5. Gestion des Événements

#### Accès
Menu : **Événements**

#### Créer un Nouvel Événement

1. Cliquez sur **"Nouvel Événement"** dans les actions rapides ou le bouton **"Ajouter"**
2. Remplissez le formulaire :
   - **Client** : Sélectionnez un client
   - **Type d'événement** : Mariage, Séminaire, Anniversaire, etc.
   - **Salle** : Sélectionnez une salle disponible
   - **Date de l'événement** : Date et heure
   - **Nombre de participants** : Nombre de personnes attendues
   - **Montant total** : Prix de la réservation
   - **Notes** : Informations complémentaires
3. Cliquez sur **"Enregistrer"**

> **Note:** Le champ "Nombre de participants" n'impacte pas le montant total dans le formulaire de modification.

> **Capture d'écran à ajouter :** Formulaire de création d'événement

---

### 6. Module Restaurant

#### 6.1. Créer une Commande Restaurant

**Accès:** Menu > **Modules** > **Commandes Restaurant**

1. Cliquez sur **"Nouvelle Commande"** ou **"Facture Restaurant"** dans les actions rapides
2. Remplissez le formulaire :
   - **Client** : Optionnel (peut être un client de passage)
   - **Date de commande** : Date de la commande
3. Ajoutez des articles :
   - **Menu** : Sélectionnez un menu dans la liste déroulante
   - **Article individuel** : Sélectionnez un article de l'inventaire (ex: boissons)
   - **Quantité** : Saisissez la quantité
   - Cliquez sur **"Ajouter"**
4. Le prix unitaire et le total sont calculés automatiquement
5. Une fois tous les articles ajoutés, cliquez sur **"Enregistrer"**

> **Capture d'écran à ajouter :** Formulaire de création de commande restaurant

#### 6.2. Valider une Commande

1. Accédez à la liste des commandes
2. Cliquez sur **"Voir"** (icône œil) pour une commande en attente
3. Vérifiez les détails de la commande
4. Cliquez sur **"Valider"**
5. La commande est validée et le stock est automatiquement mis à jour

> **Important:** La validation d'une commande impacte le stock des ingrédients utilisés.

> **Capture d'écran à ajouter :** Page de détails d'une commande avec bouton Valider

#### 6.3. Créer une Facture à partir d'une Commande

1. Après validation d'une commande, cliquez sur **"Générer Facture"**
2. La facture est créée automatiquement
3. Vous pouvez imprimer la facture ou la régler à la caisse

> **Capture d'écran à ajouter :** Facture générée à partir d'une commande

#### 6.4. Gérer les Menus Restaurant

**Accès:** Menu > **Modules** > **Menus Restaurant**

##### Créer un Menu

1. Cliquez sur **"Nouveau Menu"** dans les actions rapides ou le bouton **"Ajouter"**
2. Remplissez le formulaire :
   - **Nom du menu** : Ex: "Poulet braisé", "Poisson au four"
   - **Prix** : Prix global du menu
   - **Catégorie** : Optionnelle
3. Ajoutez les ingrédients :
   - **Article** : Sélectionnez un article de l'inventaire
   - **Quantité** : Saisissez la quantité nécessaire
   - **Unité** : Sera remplie automatiquement (pièce, kg, litre, etc.)
   - Cliquez sur **"Ajouter"**
4. Cliquez sur **"Enregistrer"**

> **Note:** Pour les menus avec poulet ou poisson, l'ingrédient principal (1 poulet entier ou 1/2 poulet, 1 poisson entier) doit être défini.

> **Capture d'écran à ajouter :** Formulaire de création de menu avec ingrédients

---

### 7. Module Caisse

#### 7.1. Ouvrir une Session de Caisse

**Accès:** Menu > **Modules** > **Caisse** > **Gestion Caisse**

1. Cliquez sur **"Ouvrir Caisse"** dans les actions rapides ou le bouton **"Nouvelle Session"**
2. Sélectionnez la **Caisse** (Réception, Restaurant, etc.)
3. Saisissez le **Montant d'ouverture** (espèces en caisse)
4. Ajoutez des **Notes** si nécessaire
5. Cliquez sur **"Ouvrir la Session"**

> **Capture d'écran à ajouter :** Formulaire d'ouverture de session

#### 7.2. Enregistrer une Transaction

1. Accédez à une session ouverte
2. Cliquez sur **"Nouvelle Transaction"** ou **"Encaissement"**
3. Remplissez le formulaire :
   - **Client** : Optionnel (peut être vide pour les clients de passage)
   - **Type** : Encaissement ou Décaissement
   - **Mode de paiement** : Espèces, Carte, Mobile Money, Virement
   - **Montant** : Sera calculé automatiquement si des factures sont sélectionnées
4. Si un client est sélectionné :
   - Les factures impayées s'affichent automatiquement
   - Pour chaque facture, saisissez le **"Montant à régler"** (pré-rempli avec le solde)
   - Le montant total est calculé automatiquement
5. Cliquez sur **"Enregistrer"**
6. Le reçu s'ouvre dans un nouvel onglet

> **Note:** Le champ "Montant" est en lecture seule et affiche la somme des montants à régler.

> **Capture d'écran à ajouter :** Formulaire de transaction avec factures impayées

#### 7.3. Fermer une Session de Caisse

1. Accédez à la session à fermer
2. Cliquez sur **"Fermer la session"** (bouton rouge avec icône cadenas)
3. Vérifiez le résumé :
   - Montant d'ouverture
   - Total des encaissements
   - Montant théorique en caisse
4. Saisissez le **Montant réel en caisse**
5. L'écart est calculé automatiquement (Montant saisi - Total encaissements)
6. Cliquez sur **"Fermer la Session"** et confirmez

> **Important:** L'écart est calculé comme la différence entre le montant saisi par la caissière et le total des transactions encaissées.

> **Capture d'écran à ajouter :** Formulaire de fermeture de session avec calcul d'écart

#### 7.4. Consulter les Relevés de Compte

**Accès:** Menu > **Modules** > **Relevés de Compte**

1. Utilisez les filtres :
   - **Client** : Optionnel (laissez vide pour tous les clients)
   - **Numéro de facture/réservation** : Recherche par référence
   - **Type de facture** : Réservations, Événements, Factures Restaurant, Commandes
   - **Période** : Date de début et date de fin
2. Cliquez sur **"Rechercher"**
3. Les résultats affichent :
   - **Résumé** : Total des transactions et montant total
   - **Relevé par facture** : Détails de toutes les transactions pour chaque facture
   - **Liste détaillée** : Toutes les transactions avec leurs détails
4. Cliquez sur **"Imprimer"** pour imprimer le relevé

> **Capture d'écran à ajouter :** Page des relevés de compte avec résultats

---

### 8. Module Inventaire (Stock)

#### Accès
Menu : **Modules** > **Stock**

#### Créer un Article

1. Cliquez sur **"Ajouter Stock"** dans les actions rapides ou le bouton **"Ajouter"**
2. Remplissez le formulaire :
   - **Nom de l'article** : Ex: "Poulet", "Poisson", "Riz", "Bière"
   - **Catégorie** : Optionnelle
   - **Quantité en stock** : Quantité actuelle
   - **Unité** : Pièce, kg, litre, etc.
   - **Prix unitaire** : Prix d'achat
   - **Prix de vente** : Prix de vente (à saisir manuellement)
   - **Stock minimum** : Seuil d'alerte
   - **Fournisseur** : Optionnel
   - **Article disponible au menu** : Cocher si l'article peut être vendu directement
   - **Article utilisé comme ingrédient** : Cocher si l'article est utilisé dans les menus
3. Cliquez sur **"Enregistrer"**

> **Note:** Le champ "Prix de vente" doit être saisi manuellement et n'est pas automatiquement rempli à partir du prix unitaire.

> **Capture d'écran à ajouter :** Formulaire de création d'article

#### Modifier un Article

1. Accédez à la liste des articles
2. Cliquez sur **"Modifier"** (icône crayon)
3. Modifiez les informations nécessaires
4. Cliquez sur **"Enregistrer"**

> **Capture d'écran à ajouter :** Formulaire de modification d'article

#### Exporter l'Inventaire en Excel

1. Accédez à la liste des articles
2. Cliquez sur **"EXPORT EXCEL"**
3. Le fichier Excel est généré avec :
   - Bordures colorées
   - En-têtes colorés
   - Total à la fin
   - Formatage correct des caractères spéciaux
4. Le fichier se télécharge automatiquement

> **Capture d'écran à ajouter :** Fichier Excel exporté avec design

---

### 9. Module Cuisine

#### Accès
Menu : **Modules** > **Cuisine** > **Commandes Cuisine**

#### Visualiser les Commandes

1. Les commandes validées apparaissent automatiquement
2. Le statut de chaque commande est affiché :
   - **En attente** : Commande validée, en attente de préparation
   - **Préparation en cours** : En cours de préparation
   - **Prêt** : Prête à être servie
   - **Livrée** : Commande livrée
   - **Annulée** : Commande annulée

#### Mettre à jour le Statut d'une Commande

1. Cliquez sur **"Voir"** pour une commande
2. Utilisez les boutons de statut pour mettre à jour :
   - **"Préparation en cours"**
   - **"Prêt"**
   - **"Livrée"**
3. Le statut est mis à jour immédiatement

> **Capture d'écran à ajouter :** Liste des commandes cuisine avec statuts

---

### 10. Rapports

#### Accès
Menu : **Rapports**

#### Types de Rapports Disponibles

1. **Chiffre d'Affaires** : Revenus par période
2. **Transactions Annulées** : Liste des transactions annulées
3. **Rapport d'Occupation** : Taux d'occupation des chambres
4. **Rapport Restauration** : Statistiques restaurant (basé sur les commandes)
5. **Rapport Événements** : Statistiques des événements

#### Générer un Rapport

1. Sélectionnez le type de rapport dans le menu
2. Utilisez les filtres :
   - **Période** : Quotidien, Hebdomadaire, Mensuel, Annuel
   - **Date de début** et **Date de fin**
   - **Statut** : Pour les rapports restaurant (optionnel)
3. Cliquez sur **"Générer"**
4. Le rapport s'affiche avec :
   - Graphiques (ligne, barre, camembert)
   - Tableaux de données
   - Statistiques agrégées
5. Utilisez les boutons **"Exporter PDF"** ou **"Exporter Excel"** pour exporter

> **Capture d'écran à ajouter :** Rapport restaurant avec graphiques et export

---

## Procédures Courantes

### Procédure : Créer une Réservation Complète

1. **Créer le client** (si nouveau) : Menu > Clients > Nouveau Client
2. **Créer la réservation** : Menu > Séjours > Nouvelle Réservation
3. **Sélectionner le client** et la chambre
4. **Saisir les dates** et informations
5. **Enregistrer** la réservation
6. **Check-in** : Lors de l'arrivée, cliquer sur "Check-in"
7. **Enregistrer les consommations** : Menu > Modules > Commandes Restaurant
8. **Valider la commande** : La commande impacte le stock
9. **Générer la facture** : À partir de la commande validée
10. **Régler à la caisse** : Menu > Modules > Caisse > Nouvelle Transaction
11. **Check-out** : Lors du départ, cliquer sur "Check-out"
12. **Fermer la session de caisse** : En fin de journée

### Procédure : Gérer le Stock

1. **Créer les articles** : Menu > Modules > Stock > Ajouter
2. **Définir les menus** : Menu > Modules > Menus Restaurant > Nouveau Menu
3. **Associer les ingrédients** aux menus
4. **Créer les commandes** : Les commandes consomment les ingrédients
5. **Valider les commandes** : Le stock est automatiquement mis à jour
6. **Surveiller les alertes** : Le dashboard affiche les articles en stock faible
7. **Exporter l'inventaire** : Pour les rapports et audits

---

## FAQ

### Questions Fréquentes

**Q: Comment puis-je voir toutes mes permissions ?**  
R: Les permissions sont gérées par votre administrateur système. Contactez-le pour connaître vos accès.

**Q: Pourquoi je ne vois pas certains menus ?**  
R: Les menus sont filtrés selon vos permissions. Si vous ne voyez pas un menu, vous n'avez probablement pas la permission correspondante.

**Q: Comment imprimer une facture ?**  
R: Sur la page de détails de la facture, cliquez sur le bouton **"Imprimer"** ou **"Générer PDF"**.

**Q: Comment rechercher une facture impayée ?**  
R: Utilisez le module **Relevés de Compte** (Menu > Modules > Relevés de Compte) et utilisez les filtres pour rechercher par client, référence ou période.

**Q: Le stock n'est pas mis à jour après validation d'une commande ?**  
R: Vérifiez que :
- La commande est bien validée (statut "Confirmée")
- Les ingrédients sont correctement définis dans le menu
- L'ingrédient principal est bien identifié (1 pièce pour poulet/poisson)

**Q: Comment fermer une session de caisse ?**  
R: Accédez à la session ouverte, cliquez sur **"Fermer la session"**, saisissez le montant réel en caisse, et confirmez. L'écart est calculé automatiquement.

**Q: Comment exporter les données en Excel ?**  
R: La plupart des listes (réservations, clients, inventaire, etc.) ont un bouton **"EXPORT EXCEL"** qui génère un fichier avec design amélioré.

**Q: Puis-je modifier une facture après génération ?**  
R: Les factures générées à partir de commandes validées ne peuvent pas être modifiées. Elles sont en lecture seule pour garantir la traçabilité.

---

## Support et Assistance

### Contact

Pour toute question ou problème :
- Contactez votre administrateur système
- Consultez la documentation technique
- Vérifiez les logs d'erreur si nécessaire

### Mises à jour

L'application est régulièrement mise à jour avec de nouvelles fonctionnalités et corrections. Consultez les notes de version pour connaître les nouveautés.

---

**Document généré automatiquement**  
**StayManager v1.0**  
**Novembre 2025**

> **Note pour l'utilisateur :** Ce guide nécessite l'ajout de captures d'écran pour chaque section mentionnée. Les emplacements sont indiqués par "Capture d'écran à ajouter :".


