caisse-du-jour

Caisse du jour (POS FoodEatUp)

Cycle ouverture → encaissements → rapport → clôture Z. Argent réel : chaque encaissement et la clôture sont confirmés. Rien d'inventé (montants, modes, rendu viennent du serveur).

Étape 0 — Références et établissement (obligatoire)

1. Charger ${CLAUDE_PLUGIN_ROOT}/reference/directives-outils.md et l'appliquer.
2. S'assurer d'avoir l'establishment_id (le demander si absent).
3. Un encaissement/une clôture exige un opérateur (operator_id = employé avec la permission caisse) — le résoudre via list_employees si besoin, jamais deviné.

1. Ouvrir la caisse

open_pos_session : opening_float (fond de caisse), operator_id. Vérifier qu'aucune session n'est déjà ouverte (get_pos_session) avant d'ouvrir.

2. Encaisser une note

record_pos_payment : order_id, amount, method ∈ especes/carte/titre_restaurant/cheque, operator_id ; tendered (espèces, pour le rendu). Argent réel → confirmation avant l'appel.

• titre_restaurant : jamais de rendu (ne pas renseigner un rendu).
• La note est soldée quand le reste dû = 0 — vérifier avec list_pos_payments (paiements, montants, rendu, reste dû) plutôt que de supposer.

3. Rapport de caisse (X / Z)

get_pos_report : sans session_id = rapport X (session en cours) ; avec session_id = rapport Z (session clôturée). CA, ticket moyen, par mode, par opérateur, TVA, remises — restitués tels quels.

4. Clôturer (Z)

get_pos_session pour l'état, puis clôture Z : close_pos_session (operator_id, confirm ; counted_cash optionnel pour le comptage des espèces, écart calculé par le serveur). Le serveur exige confirm:true → le skill résume le rapport X à l'opérateur (CA, écart annoncé) puis confirme, jamais confirm:true d'office. Après clôture, présenter le Z (get_pos_report avec le session_id).

Ardoises clients ouvertes (soldes dus) : list_pos_tabs — le règlement se fait en caisse (record_pos_payment).

Passerelles

• Facture / devis d'une commande → gestion-commandes. Analyse marge/prix → margin-analyzer / price-check. Synthèse financière → finance_summary (skill analyse-rentabilite-carte).

Règles

• Argent réel : record_pos_payment et close_pos_session confirmés (hook garde-destructif les gate en ask) ; confirm:true jamais posé d'office.
• Modes de paiement = enum strict ; titre_restaurant sans rendu.
• Opérateur réel (permission caisse) requis ; note soldée = reste dû 0.
• Rien d'inventé : montants, écarts et rendus viennent du serveur.