Système de contrôle des stocks — Traiteur
Guide d'installation sur votre serveur
==========================================================

CONTENU
- index.html   → page d'accueil (2 boutons : Gérant / Secrétaire)
- app.html     → l'application elle-même
- api.php      → le serveur (enregistre les données)
- dossier data → créé automatiquement, contient les données


INSTALLATION — 3 étapes
----------------------------------------------------------

1. Téléversez index.html, app.html et api.php sur votre
   serveur, dans un dossier (ex. public_html/stock/).

2. Les codes sont déjà réglés dans api.php :
       $ACCESS_CODE = '1234';       ← code secrétaire
       $ADMIN_CODE  = 'noam2211';   ← votre code (gérant)
   Vous pouvez les changer en haut du fichier api.php.

3. UN SEUL LIEN À PARTAGER
   ----------------------------------------------------
       https://votre-site.com/stock/

   Tout le monde ouvre cette adresse et voit deux boutons :
   « Gérant » et « Secrétaire ». Chacun clique sur le sien
   et n'a qu'à entrer son nom — le code est automatique.

   Vous pouvez donner la même adresse à la secrétaire ;
   elle cliquera simplement sur « Secrétaire ».


LES DEUX RÔLES
----------------------------------------------------------
SECRÉTAIRE (code personnel) — voit seulement :
  • Factures    : saisit ce qui entre + les prix
  • Événements  : saisit ce qui sort (plats ou convives)

GÉRANT (code admin) — voit tout :
  • Tableau de bord : état du stock, écarts, valeur des manques
  • Comptage        : vous comptez, le système compare
  • Prix            : suivi et comparaison des fournisseurs
  • Réglages        : produits et recettes


COMMENT ÇA MARCHE — la logique
----------------------------------------------------------
  Entrées (factures)  −  Sorties (événements)  =  Stock attendu
  Stock attendu  vs  Comptage réel  =  Écart

  La secrétaire remplit les entrées et les sorties.
  Vous comptez de temps en temps.
  Le système calcule tout seul et signale les écarts.

  Personne ne contrôle les deux côtés → protection maximale.


MISE EN ROUTE (une seule fois)
----------------------------------------------------------
1. Onglet Réglages → ajoutez vos produits (nom, unité, prix).
2. Onglet Réglages → définissez les recettes des plats
   importants (ex. Bar grillé = 0,18 kg de bar / portion).
   → À faire avec le chef : lui seul sait les vraies quantités.
3. Concentrez la précision sur les produits CHERS
   (poisson, viande, alcool). Le reste : estimation par convives.


CONTRÔLE DE L'ALCOOL
----------------------------------------------------------
Onglet « Contrôle » : pour l'alcool et les produits chers
non cuisinés. Chaque sortie et chaque retour est signé,
donc on sait toujours qui a pris quoi. Dans Réglages,
cochez « Produit sous contrôle » pour ces produits.

GUIDE INTÉGRÉ
----------------------------------------------------------
Un bouton « ? Aide » en haut de l'écran explique tout,
en français. Il s'ouvre automatiquement à la première
utilisation. Rien à installer, rien à imprimer.

EXPORT EXCEL / SAUVEGARDE
----------------------------------------------------------
Tableau de bord → bouton « Exporter vers Excel » : télécharge
un rapport complet en 7 feuilles (stock, comptages,
événements, factures, prix, contrôle alcool). Faites-le
chaque fin de semaine — c'est votre historique et sauvegarde.

Les données vivent aussi dans le dossier data (.json) ;
sauvegardez-le via votre hébergeur de temps en temps.


SÉCURITÉ
----------------------------------------------------------
- Utilisez https (cadenas vert), pas http.
- Changez les codes quand un employé part.
- Le dossier data est protégé (.htaccess) sur serveur Apache.
  Si votre serveur n'est pas Apache, demandez à votre
  hébergeur de bloquer l'accès direct au dossier data.
