Tout savoir sur
MemoryCompta.

MemoryCompta est un panel web autonome (Node.js + Express) qui gère toute la comptabilité d'une entreprise RP : ventes et prestations, clients, employés et grades, contrats partenaires, primes, quota, banque de l'entreprise, recrutement, rendez-vous, sanctions et documents RH. Il fournit aussi un site public à l'image de ton entreprise et un espace client.

Il tourne à côté de ton serveur FiveM ou Nova-Life et ne dépend d'aucun framework de jeu (ESX, QBCore…) : tout se passe dans le navigateur, et chaque personne se connecte avec son propre compte Discord. Aucun mot de passe n'est géré par la compta.

Les trois espaces

Toutes les pages

Vocabulaire

Le chemin le plus court entre l'achat et ta première prestation enregistrée. Chaque étape renvoie vers le chapitre détaillé.

1. Récupère ta clé de licence

   Elle arrive par e-mail après le paiement, au format MEMC-XXXX-XXXX-XXXX-XXXX. Vérifie tes spams. → Licence

2. Installe et lance le serveur

   npm install puis npm start (ou pm2). Note le code d'installation affiché dans la console. → Installation

3. Crée ton application Discord

   Sur discord.com/developers/applications : récupère le Client ID et le Client Secret, ajoute le lien de redirection https://ton-site/auth/callback. → Application Discord

4. Suis l'assistant /setup

   Code d'installation → licence → application Discord → ton Owner ID → connexion avec ton compte Discord. → Assistant

5. Configure ta société sur /config

   Nom de la société, logo et images, lien du règlement, webhook des primes, puis « Terminer l'installation ». → Page /config

6. Découvre ton panel

   « Terminer l'installation » t'envoie sur /panel, avec le menu Patron et Paramètres compta. Remplis ton profil (clic sur ton nom en bas du menu). → Le panel

7. Règle ton catalogue

   Panel → Paramètres compta → Prestations & tarifs : adapte les 6 prestations d'exemple ou crée les tiennes, et règle la taxe. → Catalogue

8. Personnalise le site public

   Type d'entreprise, ville, nom des employés, thème de couleur, services, textes et images. → Site public

9. Ajoute ton équipe

   Panel Patron → Employés → « Ajouter » avec l'ID Discord, le nom RP et le grade de chaque employé. Ils n'ont plus qu'à se connecter. → Employés

10. Enregistre ta première prestation

    Dashboard → Nouvelle Prestation. Le prix, la taxe, le bénéfice et la prime se calculent tout seuls. → Saisir une prestation

Ce chapitre concerne l'installation sur ton propre serveur (VPS, hébergeur Node.js, machine perso). Si ta compta est hébergée par MemoryCompta, passe directement à l'assistant.

Prérequis

• Node.js 16 ou plus récent (une version LTS récente est conseillée) et npm.
• Une adresse publique (nom de domaine ou sous-domaine), idéalement en HTTPS. En local, http://localhost:40244 suffit pour tester.
• Une application Discord (gratuite) pour la connexion.
• Une clé de licence MemoryCompta valide.
• Un accès sortant à Internet : la compta contacte discord.com (connexion et webhook) et compta.memorylink.fr (licence).

Dépendances installées par npm : express, express-session, multer (envoi de fichiers) et node-fetch. Aucune base de données à installer : tout est enregistré dans des fichiers JSON.

Contenu du dossier

Installer et lancer

# dans le dossier de la compta
npm install
npm start
# → 🚗 Compta démarrée sur le port 40244

Pour la laisser tourner en permanence et la relancer automatiquement, utilise pm2 :

npm install -g pm2
pm2 start server.js --name memorycompta
pm2 save
pm2 logs memorycompta   # pour lire le code d'installation et les messages

Au premier lancement, la console affiche :

🔧  INSTALLATION REQUISE — premier lancement de la compta
  1. Ouvre le site dans ton navigateur → /setup
     (en local : http://localhost:40244/setup)
  2. Code d'installation :  XXXX-XXXX

Ce code de 8 caractères (sans 0, O, 1 ni I pour éviter les confusions) prouve que c'est bien toi qui installes. Il reste le même tant que l'installation n'est pas terminée.

Le fichier .env

Facultatif. Crée un fichier .env à la racine, une ligne CLE=valeur par réglage. Les lignes qui commencent par # sont des commentaires, et les guillemets autour d'une valeur sont retirés. Une variable déjà définie par ton hébergeur ou pm2 est prioritaire sur le .env. Redémarre la compta après chaque modification.

# Port de la compta
PORT=40244
# Accès administrateur du support (on / off)
ADMIN_ACCESS=on

Nom de domaine, HTTPS et proxy

En production, place la compta derrière un reverse proxy (Nginx, Caddy, Apache, Cloudflare Tunnel…) qui gère le HTTPS et transmet les requêtes au port de la compta. La compta fait confiance au premier proxy pour connaître le protocole et l'adresse d'origine.

server {
  server_name compta.ton-domaine.fr;
  # (certificat HTTPS géré par certbot ou ton hébergeur)
  location / {
    proxy_pass http://127.0.0.1:40244;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_read_timeout 1h;   # garde ouvert le flux temps réel
  }
}

Le temps réel du panel passe par /api/live (Server-Sent Events). La compta envoie elle-même l'en-tête X-Accel-Buffering: no et un signal toutes les 15 secondes pour que la connexion reste ouverte derrière Nginx.

Tant que l'installation n'est pas terminée, tout le site redirige vers /setup. L'assistant enchaîne 6 étapes ; les étapes déjà validées restent cliquables pour revenir en arrière.

1. Code d'installation

   Entre le code XXXX-XXXX affiché dans la console (terminal, pm2 logs, panel de l'hébergeur). Il se met en majuscules et le tiret s'ajoute tout seul. Le déverrouillage est lié à ton navigateur.

   Protection : après 8 codes faux depuis la même adresse IP, l'assistant se bloque 10 minutes (« Trop d'essais. Réessaie dans 10 minutes. »).

2. Licence MemoryCompta

   Colle ta clé MEMC-XXXX-XXXX-XXXX-XXXX. Elle est vérifiée en direct auprès du serveur de licence. Rien ne fonctionne sans licence active. Si une licence est déjà active, tu peux la remplacer ou continuer.

3. Application Discord

   Sur discord.com/developers/applications :

   • New Application, donne-lui le nom de ton entreprise.
   • Onglet OAuth2 : copie le Client ID, clique sur Reset Secret et copie le Client Secret.
   • OAuth2 → Redirects → Add Redirect : colle exactement le lien affiché par l'assistant (bouton « Copier »), puis Save Changes.

   Le lien proposé est https://ton-site/auth/callback (ou http:// en local). Règles vérifiées : Client ID de 17 à 20 chiffres ; Client Secret de 16 à 128 caractères ; lien en http(s):// qui se termine par /auth/callback. L'assistant teste ensuite les identifiants auprès de Discord : s'ils sont refusés, tu vois « Discord refuse ce Client ID / Client Secret ». Si Discord est injoignable, ils sont enregistrés quand même, avec un avertissement.

   La compta ne demande à Discord que la permission identify (pseudo, avatar, identifiant) : ni e-mail, ni liste de serveurs, ni messages.

4. Owner ID (le patron)

   L'identifiant Discord du compte qui aura tous les droits. Pour le copier : Discord → Paramètres utilisateur → Avancés → active le Mode développeur, puis clic droit sur ton pseudo → Copier l'identifiant utilisateur. C'est un nombre de 17 à 20 chiffres.

5. Connexion du patron

   Clique sur « Se connecter avec Discord » avec le compte du patron. Pendant l'installation, seul ce compte peut se connecter. Avec un autre compte, l'assistant l'affiche : « Tu t'es connecté avec le compte …, mais l'Owner ID enregistré est … ». Si Discord affiche « redirect_uri invalide », le lien de redirection n'est pas identique dans le portail Discord.

6. Configuration

   Tu arrives sur /config en mode « Dernière étape » : voir ci-dessous. Le bouton Terminer l'installation ouvre le site à tout le monde et t'envoie sur le panel.

La page /config

Après l'installation, /config reste accessible au patron (et à l'administrateur) : depuis le panel → Paramètres compta → Configuration serveur, ou directement à l'adresse /config. Les autres comptes sont renvoyés vers le panel.

Le fichier data/config.json est écrit avec des droits restreints (lecture/écriture pour le propriétaire uniquement). Les changements faits sur /config s'appliquent sans redémarrer.

Une licence MemoryCompta valide est obligatoire pour utiliser la compta et afficher le site. Elle se présente sous la forme MEMC-XXXX-XXXX-XXXX-XXXX et arrive par e-mail après l'achat.

Vérification

• La clé est vérifiée à l'activation, au démarrage, puis toutes les 6 heures.
• La compta envoie au serveur de licence la clé, un identifiant d'installation unique (créé une fois pour toutes dans data/memorycompta.json) et le nom de domaine de ton site.
• À la première activation, la licence est liée à cette installation : elle est ensuite refusée sur toute autre installation.
• Si le serveur de licence est injoignable, la compta continue de fonctionner normalement pendant 72 heures après la dernière vérification réussie.
• Si le serveur répond que la clé est invalide ou expirée, la compta se bloque immédiatement.
• L'activation d'une nouvelle clé nécessite que le serveur de licence soit joignable (pas d'activation hors ligne).

Que se passe-t-il sans licence ?

Changer ou revérifier la clé

Panel → Paramètres compta → Général → bloc Licence MemoryCompta : on y voit la clé enregistrée (masquée), la date de la dernière vérification et de la dernière validation, la raison en cas de problème, et deux boutons : Activer (nouvelle clé) et Vérifier (revérification immédiate). On peut aussi changer de clé sur /config.

Chaque personne se connecte avec Discord. Ce qu'elle peut faire dépend de son statut : patron (Owner ID), employé avec un grade, ou simple client (toute personne connectée qui n'est pas dans l'équipe).

Les grades

Les quatre grades juniors suivent l'ordre Recrue < Stagiaire < Novice < Expérimenté. Chaque type de prestation peut exiger un grade minimum (ex. « Novice et plus ») : un grade trop bas ne voit pas ce type dans le formulaire, et le serveur refuse l'enregistrement (« Grade insuffisant »). Tous les grades au-dessus d'Expérimenté (Responsable, Co-Patron, Gouvernement…) peuvent tout enregistrer.

Qui peut faire quoi

Accès administrateur (support)

Par défaut, un compte Discord du support MemoryCompta (JustSimon) est présent dans l'équipe avec le grade Administrateur. Il a les mêmes droits que le patron, y compris l'accès à /config, pour pouvoir t'aider à configurer ou dépanner ta compta. Ce compte est recréé à chaque démarrage tant que l'accès est actif, et il n'apparaît pas dans l'équipe en service du site public ni dans le compteur d'employés actifs.

Connexion et session

• Bouton Connexion du site, ou n'importe quelle page qui le demande → autorisation Discord → retour sur la page demandée. Sans page demandée : le panel pour l'équipe, l'espace client pour les autres.
• Une session dure 24 heures. Les sessions sont enregistrées dans data/sessions.json : tout le monde reste connecté après un redémarrage de la compta (mise à jour, crash, hébergeur).
• Dans le panel, une session expirée affiche « 🔒 Session expirée » et la page se recharge toute seule au bout de 5 secondes.
• Déconnexion : bouton en bas du menu du panel, ou menu du compte sur le site.

Le panel s'ouvre sur /panel. Sur ordinateur, le menu est à gauche ; sur téléphone (moins de 900 px), il devient une barre d'onglets flottante en bas de l'écran, façon iPhone, et les fenêtres s'ouvrent en feuille depuis le bas.

Le menu

En bas du menu : ta photo, ton nom et ton grade (clic → Mon profil) et le bouton Déconnexion.

Dashboard

• En-tête : « Bonjour, Prénom », ton grade, la date du jour et le bouton Nouvelle Prestation.
• Ma Prime Estimée : ta prime de la semaine, grade et quota compris. Si un quota est actif, une barre indique ta progression : « 🔒 Quota 6/10 · encore 4 prestas pour débloquer ta prime » ou « ✅ Quota atteint ».
• Mon CA Semaine (somme de tes factures) et Mon Bénéfice (avec le détail par type, ex. « 🔧 3 🎨 2 »).
• Aujourd'hui : facturé et bénéfice de toute l'entreprise depuis minuit. Cette semaine : CA total, bénéfice et nombre de prestations par type, avec le rappel « reset ven. 0:00 ».
• Dernières Prestations : les 8 plus récentes (les tiennes sont mises en évidence) et « Voir tout → ».
• Équipe en ligne : qui a le panel ouvert, depuis combien de temps (rafraîchi toutes les 30 s).

Les customs perso ne comptent pas dans ces chiffres.

Enregistrer une prestation

Bouton Nouvelle Prestation (Dashboard) ou + Nouvelle Prestation (page Prestations). Le formulaire est construit automatiquement à partir du catalogue : il ne montre que les champs utiles au type choisi.

1. Choisis le type

   Seuls les types actifs autorisés pour ton grade s'affichent. Le titre de la fenêtre reprend l'icône et le nom du type, et sa description sert de sous-titre. Si aucun type n'est autorisé : « Aucune prestation disponible pour ton grade. »

2. Informations client si le type les demande

   Nom complet du client (écrit automatiquement en MAJUSCULES) avec suggestions dès 2 lettres : les 8 clients les plus fréquents qui correspondent, avec leur dernière plaque. Navigation au clavier : ↑ ↓ Entrée Échap. Si le client a un compte sur le site, un encadré affiche son total dépensé, son téléphone, son âge et sa ville. Plaque d'immatriculation (majuscules, ex. LS-1234).

3. Contrat applicable si le type accepte les contrats

   « — Aucun contrat — » ou un contrat actif, avec sa remise pour ce type (« LSPD — -50% », « EMS — GRATUIT », « std »).

4. Calcul du prix

   Selon le type : rien à saisir (prix fixe), un choix d'option (ex. zone Nord / Sud), le coût usine (le prix client = coût × marge), ou un prix libre avec minimum/maximum. Une quantité peut être demandée.

5. Informations complémentaires

   Les champs personnalisés du type (texte, nombre ou liste), puis les notes (obligatoires ou non selon le type).

6. Vérifie le récapitulatif

   L'encadré se met à jour en direct : prix ou coût usine, majoration, remises automatiques (🎁), remise contrat (📋), FACTURE CLIENT, taxe, bénéfice net de l'entreprise et ta prime (ex. « 10% coût usine », « 1 000 $ / unité · Novice »).

7. Créer la Prestation

   « ✅ Prestation enregistrée — 14 000 $ ». Toute l'équipe la voit apparaître en direct (« ⚡ Custom — MARCUS BELLAMY · 14 000 $ par … »). Le type reste sélectionné pour enchaîner.

À chaque prestation : le bénéfice net est crédité en banque automatiquement, le client est ajouté (ou remis) dans la liste Clients, et le grade de l'employé au moment de la saisie est mémorisé pour le calcul de sa prime.

Page Prestations

• Filtres : Toutes · un bouton par type · 📋 Contrat (paiements de contrats) · Custom perso · menu « 👤 Tous les mécanos » pour n'afficher qu'un employé.
• 50 prestations par page, avec « ‹ Précédent », numéros de page et « Suivant › ».
• Chaque ligne montre : type, client, plaque, option, quantité, contrat et prix de base, coût usine, remises appliquées, champs personnalisés, notes, employé, date et prix.
• ✏ Modifier notes : seules les notes sont modifiables (prix, type et client ne changent pas après coup). Un employé ne peut modifier que ses propres prestations ; le patron peut modifier toutes les notes.
• 🗑 Supprimer (patron, Co-Patron, Gouvernement) : suppression définitive, avec annulation automatique en banque du bénéfice crédité.

Page Employés

• Synthèse : nombre d'employés, en ligne, primes hebdo cumulées, et Sortant (estimation de ce que la semaine coûte : primes des employés + part reversée calculée sur le CA).
• Filtre par grade, tri par Grade / Prestas / Embauche (recliquer inverse l'ordre), vue grille ou liste.
• Clic sur un employé → fiche : photo, grade, statut en ligne, âge, téléphone, ville, véhicule, date d'embauche, bio, total de prestations, CA généré, prime de la semaine, courbe d'activité depuis son embauche et, pour le patron, ses avertissements.

L'ajout, la modification et le retrait d'employés se font dans le Panel Patron.

Page Clients

Un client n'est pas un compte à créer : c'est un nom regroupé automatiquement à partir des prestations (sans tenir compte des majuscules). La liste ne reprend que les types qui demandent un nom de client, classés par total dépensé.

• Recherche instantanée, rang #, dernière visite, nombre de prestations par type, total dépensé. Un 🔗 signale un client qui a aussi un compte sur le site : son profil (âge, téléphone, ville, véhicule, bio) s'ouvre avec ↗.
• ✏ Renommer (patron) : renomme toutes ses prestations d'un coup et met à jour le compte client lié. Renommer vers un nom existant regroupe les deux historiques.
• 🗑 Retirer (patron) : le client disparaît de la liste, mais ses prestations, son CA et les primes sont conservés. Il réapparaît tout seul à sa prochaine prestation.

Enregistrer ma Custom (custom perso)

Pour qu'un employé enregistre une custom faite sur son propre véhicule. Le nom est verrouillé sur le sien ; il saisit la plaque, le prix de la custom et une note. Prix à payer = prix saisi + 10 %. Une custom perso apparaît dans la fiche client et la liste des prestations (filtre « Custom perso »), mais ne compte ni dans le CA, ni dans les primes, ni dans le quota, ni en banque, ni dans le Hall of Fame. Elle demande le même grade minimum que la Custom (Novice et plus par défaut). Dans l'espace client du propriétaire du véhicule, elle compte dans son total dépensé et son classement. Le patron peut désactiver cette fonction (Fonctions du panel).

Statistiques

Par semaine compta, avec ‹ › pour remonter dans le temps (le badge indique « CETTE SEMAINE » ou les dates). Les customs perso sont exclues.

• 5 indicateurs : CA, bénéfice, nombre de prestations, employés actifs (au moins une prestation), coût usine — chacun comparé à la semaine précédente (↑ +12 %, ↓, = Stable, ↑ Nouveau).
• Bénéfice par jour (vendredi → jeudi, comparé à S-1), répartition par type (anneau), prestations par jour (barres).
• Records : meilleure journée, heure de pointe, panier moyen, évolution, employés actifs.
• Carte de chaleur 7 jours × 24 h de l'activité.
• Comparatif détaillé : CA, bénéfice, prestations (au total et par type), employés actifs, panier moyen, avec l'évolution en %.

Hall Of Fame

Les légendes de l'entreprise depuis la première prestation (customs perso et Gouvernement exclus). Les primes sont recalculées avec les réglages actuels. Bouton Actualiser ; mise à jour automatique à chaque nouvelle prestation.

• Indicateurs : CA historique (+ moyenne par semaine), prestations, bénéfice généré, primes cumulées, nombre de légendes, clients servis.
• Ma place : « Tu es #3 sur 12 en CA avec … Encore … pour dépasser … ! »
• Podium de tous les temps par Chiffre d'affaires, Prestations, Primes cumulées, Bénéfice généré, Clients servis ou Titres de la semaine (case « Inclure les anciens »).
• Classement général triable : prestas, CA, bénéfice, primes, panier moyen, clients, semaines, titres, série max, ancienneté. Clic sur un nom → fiche employé.
• La course au CA (CA cumulé du top 5 semaine par semaine), Employés de la semaine (plus grosse prime, puis CA) et Les spécialistes (top 3 par type).

Mon profil

Clic sur ton nom en bas du menu. Tous les champs sont facultatifs et s'affichent dans ta fiche employé : photo (image de 5 Mo max), âge, téléphone, description / bio, ville / quartier, véhicule personnel. Le nom RP et le grade sont gérés par le patron.

Pour le patron, le nom affiché est son nom Discord.

Temps réel

Le panel reste connecté au serveur : ces changements apparaissent sans recharger la page chez tous les membres connectés.

Menu Patron (badge PATRON). Accessible au patron, au Co-Patron et au Gouvernement en écriture, au Responsable en lecture seule. En haut : employés actifs, contrats actifs et impôts estimés de la semaine. Dix onglets ; le dernier ouvert est retenu tant que la page n'est pas rechargée.

Accueil (DashBoard Patron)

Classement Prime

Les primes estimées par employé pour la semaine (‹ › pour les semaines passées) : rang, nom, avancement du quota (« ✅ 12/10 » ou « 🔒 6/10 · 4 200 $ en attente »), détail par type et montant. Les 6 premiers s'affichent ; Voir tout ouvre le classement complet de tous les employés actifs, même ceux à 0 $.

Remise Premier Client

Interrupteur ACTIVÉ / DÉSACTIVÉ. Quand il est activé, les clients qui n'ont encore aucune prestation reçoivent la remise « Remise Premier Client » prévue dans le catalogue (−5 % sur le coût usine d'une Custom, par défaut). L'encart Perte générée totalise ce que cette remise a coûté sur tout l'historique. L'interrupteur agit sur toutes les remises cochées « Suivre l'interrupteur » dans le catalogue.

Quota de prestations

Le nombre minimum de prestations par semaine pour toucher sa prime.

• Quota par semaine : 1 à 10 000 (10 par défaut).
• Quand l'employé touche sa prime : 🎯 Si le quota est atteint (tout ou rien : sous le quota, la prime de la semaine est 0) ou 🚀 La prime commence après le quota (les N premières prestations ne rapportent rien, les suivantes normalement).
• Compter les quantités : une vente de 5 kits compte pour 5 prestations.
• Les customs perso et les paiements de contrat ne comptent jamais.
• Quand le quota est actif : nombre d'employés qui l'ont atteint et montant des primes bloquées ou non versées.

Les changements forment un brouillon : Annuler ou Enregistrer. À l'enregistrement, toutes les primes (classements, fiches, Hall of Fame, webhook) sont recalculées immédiatement.

Impôt Gouv

La déclaration hebdomadaire : impôts estimés = bénéfice de la semaine × 12 %, avec le CA de la semaine. Navigation ‹ › par semaine.

Banque

Le compte de l'entreprise, mis à jour en temps réel. Chaque prestation crédite automatiquement son bénéfice net (prix − coût usine − taxe) ; la suppression d'une prestation le retire (ligne « Annulation »).

• Solde en banque (en rouge s'il est négatif), dernier mouvement, entrées et sorties des 7 derniers jours.
• Ajouter de l'argent : montant + motif facultatif.
• Retirer de l'argent : montant + motif obligatoire parmi Prime, Impôts, Coût usine, Autre, + détail facultatif.
• Définir le solde : fixe le solde exact (la différence est enregistrée dans l'historique).
• Aperçu du « Solde après opération » avant de valider. Les montants sont des dollars entiers. Un retrait peut rendre le solde négatif.
• Mouvements : 💰 Prestation, ↩️ Annulation, ➕ Ajout, 🏆 Primes, 🏛️ Impôts, 🏭 Coût usine, 💸 Autre, ✏️ Solde défini — avec date, auteur, montant et solde après opération. Les 300 dernières opérations sont conservées.
• Vider l'historique : efface la liste des mouvements, le solde est conservé.

La banque se consulte dans le Panel Patron (le Responsable en lecture seule) ; seuls le patron, le Co-Patron et le Gouvernement peuvent la modifier.

Contrats

Un contrat lie l'entreprise à un partenaire (LSPD, EMS, Gouvernement, autre entreprise…). Il fixe une remise par type de prestation, un montant versé par le partenaire et une prime par prestation.

Créer ou modifier un contrat

Carte d'un contrat

Remises par type (« -50% », « GRATUIT », « std »), montant par renouvellement, prime par prestation, bénéfice ou perte du contrat, nombre de prestations et total offert en remises depuis le dernier paiement. En haut, le bilan total de tous les contrats = montants prévus par renouvellement − remises offertes − taxe gouvernementale de 10 % sur ces montants.

Encaisser un contrat (bouton « Payé »)

Enregistre le paiement du partenaire comme une prestation spéciale 📋 Paiement contrat (paiement par virement) : elle compte dans le CA, apparaît avec le filtre « Contrat », est créditée en banque (taxe sur facture déduite) et ne donne ni prime ni avancement de quota. Dans le Hall of Fame, elle compte dans le CA de la personne qui a cliqué sur « Payé ». Le bouton n'apparaît que si un montant est défini.

Supprimer un contrat ne touche pas aux prestations passées, qui gardent son nom et leur prix. Leurs primes, elles, sont recalculées avec la prime normale du type (la prime du contrat n'existe plus). Il n'y a pas de bouton pour désactiver un contrat : supprime-le s'il ne doit plus servir.

Recherche Plaque

Tape une plaque (même partielle) : la recherche se fait à chaque frappe. Résultat : la dernière personne venue avec ce véhicule (nom, date, employé, prix, contrat) et l'historique complet des passages.

Employés (gestion)

Tableau de toute l'équipe : nom, ID Discord, grade, date d'embauche, statut en ligne, actions.

• Ajouter : Discord ID (17 à 19 chiffres : clic droit sur le profil → Copier l'identifiant, mode développeur activé), Nom RP, Rôle. La personne a accès au panel dès qu'elle se connecte avec Discord. La date d'embauche est enregistrée automatiquement.
• Modifier : nom et grade. Une promotion ne change pas les primes déjà gagnées : c'est le grade au moment de la prestation qui compte.
• Supprimer : retire l'employé de l'équipe et lui coupe l'accès. Ses prestations restent dans l'historique (il apparaît comme « Ancien » dans le Hall of Fame).

Membres

Les comptes Discord connectés au site qui ont déclaré une identité RP dans l'espace client (hors patron et employés) : photo, nom RP, pseudo, ID, badge 🧑 Client, date d'inscription. Recherche par nom, pseudo ou ID. Lecture seule.

Candidatures

« N candidature(s) · M en attente ». Filtres : Toutes, En attente (par défaut), Acceptées, Employés, Refusées. Chaque carte montre l'avatar et le pseudo Discord, le nom RP, la date, l'âge, le téléphone, le passé illégal (⚠️ Oui / ✅ Non / ⚡ Anciennement), les disponibilités et les deux réponses de motivation.

Boutons de statut : ✅ Accepter, 👷 Employé, ❌ Refuser, ⏳ En attente. Le candidat voit le statut et le message correspondant dans son espace client.

Rendez-vous

« N demande(s) — M en attente ». Filtres : Tous, En attente (par défaut), Traités, Non traités. Chaque carte : nom, téléphone, pseudo Discord, date, demande et disponibilités. Boutons ✅ Traité et ❌ Non traité ; le client voit le résultat dans son espace. Recontacte le client sur Discord pour fixer le créneau.

Avertissements

Les sanctions de l'équipe, regroupées par employé (compteur en rouge), filtrables par employé et par raison.

• Nouvel Avertissement : employé, date (aujourd'hui par défaut), raison, détails.
• Raisons : Inactivité, Non respect du règlement, Comportement inapproprié, Absence non justifiée, Retard répétitif, Manque de professionnalisme, Autre.
• L'auteur de l'avertissement est enregistré. Suppression avec confirmation.
• Les avertissements apparaissent aussi dans la fiche de l'employé (visible par le patron).

Administratif

Deux documents par employé, regroupés par grade : 📋 Règlement signé et 🏥 Visite médicale. Pour chacun : « ✓ Fourni » ou « Manquant », 👁 Voir (ouvre le document dans le navigateur), 📎 Uploader / Remplacer, 🗑 supprimer. Formats PDF ou PNG, 10 Mo maximum. Le compteur indique combien de documents sont fournis sur le total attendu.

« Ta compta, réglée au millimètre. » Menu réservé au patron (et aux grades Co-Patron et Gouvernement). En haut à droite, l'état en direct : licence, société, nombre de prestations actives, taxe et quota. Cinq volets, le dernier ouvert est retenu sur ton navigateur.

Général

• Licence : voir Changer ou revérifier la clé.
• Nom de la société (40 caractères max) : remplace « LS Custom » sur l'accueil, l'espace client, les candidatures, les rendez-vous et le panel. Visible au prochain chargement de page.
• Thème de couleur : voir Thème.
• Configuration serveur : rappel de l'application Discord, du webhook et de l'Owner ID, avec un bouton « Ouvrir » vers /config (si ton compte y a accès).

Prestations & tarifs (le catalogue)

Ici tu définis ce que ton entreprise vend et comment c'est payé. Toute modification est diffusée en direct à tous les panels ouverts.

• Taxe sur facture : 0 à 100 % (par pas de 0,5), 10 % par défaut. Bouton 💾 pour l'enregistrer.
• Nouvelle prestation et Réinitialiser : remet les 6 prestations d'origine ainsi que la taxe (10 %), les coefficients de grade (100 %) et le quota (désactivé). Tes prestations créées déjà utilisées sont archivées ; celles jamais utilisées sont supprimées.
• Pour chaque type : ▲ ▼ pour l'ordre, résumé (prix, prime, client, plaque, contrats, remises, grade minimum, « Sans taxe »), interrupteur actif / inactif (une prestation inactive disparaît du formulaire), ✏ Modifier, Dupliquer, 🗑 Supprimer.
• Supprimer un type jamais utilisé l'efface ; un type déjà utilisé est archivé : l'historique, la banque et les primes passées restent intacts, et il peut être restauré depuis « Prestations supprimées ». Il doit toujours rester au moins un type.

L'éditeur de prestation

Six onglets et un simulateur en bas qui montre le résultat en direct.

Limites : nom 40 caractères, description 200, 30 options, 30 remises, 15 champs personnalisés. L'identifiant interne d'une prestation ne change jamais, même si tu la renommes : l'historique reste cohérent.

Primes & grades

Un coefficient de prime par grade (Patron, Co-Patron, Responsable, Expérimenté, Novice, Stagiaire, Recrue), de 0 à 1 000 % par pas de 5 (100 % = prime normale). Exemple affiché : « prime de 1 000 $ → 800 $ » pour un coefficient de 80 %. Bouton « Tout à 100 % » et Enregistrer (les primes sont recalculées immédiatement). Le grade retenu est celui au moment de la prestation. Gouvernement et Administrateur n'ont pas de coefficient : leurs primes sont toujours à 100 %. Le quota hebdomadaire se règle dans le Panel Patron.

Fonctions du panel

Les changements s'appliquent en direct chez tous les membres connectés.

Le même moteur de calcul tourne dans le navigateur (pour l'aperçu) et sur le serveur (qui fait foi). Voici l'ordre exact des opérations.

Ordre de calcul

1. Sous-total

   Prix fixe ou prix de l'option × quantité ; en mode usine : coût usine × quantité × (1 + marge %) ; en prix libre : le montant saisi × quantité.

2. Remises « sur coût usine » mode usine

   Elles réduisent d'abord le coût usine, puis le prix plein = coût usine remisé × (1 + marge %).

3. Remise du contrat

   Le pourcentage du contrat pour ce type est appliqué sur le prix plein.

4. Remises « sur le prix »

   Appliquées ensuite, l'une après l'autre, sur le montant restant.

5. Prix final

   Arrondi au dollar, jamais négatif. C'est la FACTURE CLIENT.

6. Taxe

   Prix final × taxe % (arrondi), si le type est taxé.

7. Bénéfice net

   Prix final − coût usine total − taxe. C'est le montant crédité en banque.

8. Prime

   Voir ci-dessous.

Le coût usine déduit est le coût réel saisi : une remise sur coût usine baisse le prix pour le client, pas le coût pour l'entreprise.

Calcul de la prime

1. Si le type utilise la prime du contrat et qu'un contrat est appliqué → prime du contrat (× quantité si « par unité »).
2. Sinon → la prime précise du grade si elle existe, sinon la valeur normale, selon le mode : montant fixe (× quantité si par unité), % du coût usine, % du prix facturé ou % du bénéfice net (jamais négatif).
3. Le coefficient du grade s'applique (sauf si une prime précise par grade a été utilisée).
4. Puis le minimum (si la prime est supérieure à 0) et le plafond.
5. Enfin le quota, appliqué par employé et par semaine compta.

Exemples chiffrés (catalogue d'origine, taxe 10 %, coefficients à 100 %)

Exemple de quota (10 prestations / semaine)

Les prestations sont prises dans l'ordre chronologique. Les customs perso et paiements de contrat ne comptent pas. Avec « Compter les quantités », une vente de 5 kits compte pour 5.

La semaine compta

Elle commence le vendredi à 0 h et se termine le jeudi à 23 h 59. Le webhook envoie le classement final le jeudi à 23 h 58. Les statistiques « Aujourd'hui » commencent à minuit.

Les estimations du panel

Ces taux sont fixes : ils ne suivent pas le réglage de taxe du catalogue.

À l'installation, la compta contient 6 prestations d'exemple (un garage). Modifie-les, désactive-les ou crée les tiennes : restaurant, taxi, bar, armurerie… tout est configurable. « Réinitialiser » les remet à tout moment.

Remises d'origine de la Custom (seule la première applicable est utilisée) : Remise Premier Client (−5 % sur le coût usine pour un nouveau client, hors contrat, suit l'interrupteur — désactivé par défaut) et Remise Gros Client (−5 % sur le coût usine si le client a déjà dépensé plus de 2 000 000 $ en customs, hors contrat).

Réglages d'origine : taxe 10 %, coefficients de prime à 100 % pour tous les grades, quota désactivé (10 / semaine, mode « si le quota est atteint »).

La page d'accueil / est la vitrine de ton entreprise. Presque tout se personnalise dans Paramètres compta → Site public (sous-onglets Identité, Page d'accueil, Qui sommes-nous ?, Images & logo) ; chaque bloc a un bouton « Voir sur le site ». Les changements sont visibles au prochain chargement de la page.

Les sections de l'accueil

1. Barre de navigation : logo, nom, liens vers les sections, bouton Connexion Discord. Une fois connecté : avatar, nom (nom RP pour un employé), menu « Mon compte » et « Déconnexion ».
2. En-tête : image de fond, petit titre, nom de la société en grand, phrase d'accroche et boutons (Postuler, Mon Espace Client, Rendez-vous, Catalogue de Jantes, Panel Employé — ce dernier visible seulement pour l'équipe).
3. Bandeau de 4 chiffres animés.
4. Équipe en service : les membres qui ont le panel ouvert, en temps réel (rafraîchi toutes les 30 s), avec leur grade et depuis quand ils sont en ligne. Sans personne : « Aucun mécanicien en ligne — Le garage est momentanément fermé. »
5. Nos services : jusqu'à 12 cartes.
6. Qui sommes-nous ? : texte, points forts et photo de l'équipe.
7. Mon espace client : invitation à se connecter.
8. Pied de page et crédits.

Identité : type d'entreprise, ville, nom des employés

Le site d'origine parle d'un garage à Los Santos et de mécaniciens. Trois réglages remplacent ces mots partout (accueil, espace client, candidatures, rendez-vous, panel), en respectant les majuscules et le pluriel :

Seul le texte visible est modifié (jamais le code de la page). Les accords grammaticaux (le/la) ne sont pas adaptés : relis tes textes après un changement. Le lien du règlement se règle aussi ici, avec un bouton « Tester » ; l'adresse courte ton-site/reglement y redirige.

Page d'accueil

En-tête

Petit titre (80 caractères) et phrase d'accroche (300 caractères). « Texte d'origine » pour revenir en arrière.

Boutons

• Les 5 boutons d'origine : texte (40 car.), lien (https://… ou /chemin), case « Masquer ».
• Jusqu'à 4 boutons ajoutés : icône (20 au choix), texte et lien obligatoires, case « nouvel onglet ».
• Sur les boutons d'origine, un lien externe s'ouvre toujours dans un nouvel onglet ; sur les boutons ajoutés, seulement si la case est cochée.
• « Boutons d'origine » efface aussi les boutons ajoutés.

Chiffres

4 cases, chacune avec un libellé (60 car.), une case « Masquer » et une source :

Les customs perso et les types décochés « Compter dans les stats du site public » ne sont jamais comptés.

Nos services

• Masquer toute la section (le lien du menu disparaît aussi), petit titre, titre en deux parties (blanche et grisée).
• Jusqu'à 12 cartes : icône (42 icônes ou un emoji), nom (obligatoire, 60 car.), description (400 car.), prix (120 car. ; **texte** s'affiche en couleur), compteur (une source de chiffres ou un type) et son texte (80 car. ; {n} = le nombre, (s) et (x) = pluriel automatique, ex. {n} réparation(s) réalisée(s)), case « Masquer », ordre ▲ ▼.
• Importer depuis mes prestations crée des cartes à partir de ton catalogue. « Remettre les services d'origine » restaure les 6 cartes d'exemple.

Qui sommes-nous ?

• Petit titre (60 car., vide = masqué) et titre principal (obligatoire, 150 car.).
• Jusqu'à 10 paragraphes de 2 000 caractères.
• Jusqu'à 8 points forts (icône, titre 120 car., texte 300 car.). Variables : {employes} ou {mecaniciens} = nombre d'employés actifs, {prestations} = nombre total de prestations.
• Image (PNG, JPG, WEBP ou GIF, 8 Mo max, enregistrée immédiatement) et sa description. « Image par défaut » revient à la photo d'origine.

Images & logo

Trois images remplaçables, au même endroit que sur /config : Logo, image de fond de l'accueil, photo de l'équipe. PNG, JPG, WEBP ou GIF, 8 Mo max ; le changement est immédiat, et ↺ remet l'image d'origine.

Espace client /client

1. Connexion Discord

   Sans connexion : « Connexion requise » et un bouton « Connexion Discord ».

2. Ton identité

   À la première visite, une fenêtre demande le Nom Prénom RP (obligatoire, avec suggestions dès 2 lettres parmi les clients existants), l'âge et le téléphone. Elle revient tant qu'il manque une information.

3. Ton historique

   Le nom RP fait le lien avec les prestations : il doit être identique (majuscules mises à part) au nom saisi par les employés.

Ce que le client voit :

• Bienvenue, son avatar et « Client depuis … ».
• 5 chiffres : nombre de prestations, total dépensé, classement parmi tous les clients (🥇🥈🥉 ou #rang / N clients), dernière visite, nombre de véhicules (plaques différentes).
• Mon profil : nom RP, Discord, âge, téléphone, date d'arrivée, avec un bouton Modifier.
• Mes customs : les prestations des types « visibles dans l'espace client » (plaque, description, employé, prix, date).
• Mes candidatures et Mon rendez-vous, avec leur statut.

Candidature /postuler

Connexion Discord obligatoire (le pseudo Discord est rempli automatiquement et ne peut pas être modifié). Tous les champs sont obligatoires :

Après l'envoi : « CANDIDATURE ENVOYÉE ! … Tu seras contacté sur Discord. » Le candidat suit ensuite sa candidature dans son espace client :

Rendez-vous /rdv

Connexion Discord obligatoire. Champs obligatoires : Nom & Prénom (60 car.), Numéro de téléphone (30 car.), Ta demande (800 car.), Tes créneaux disponibles (400 car.). Message : « Demande envoyée ! On te contacte sur Discord. »

• Une seule demande par compte Discord : ensuite, la page /rdv affiche directement le statut de la demande au lieu du formulaire.
• Statuts : ⏳ En attente « en cours de traitement », ✅ Traité « Rendez-vous confirmé ! Vérifie tes messages Discord », ❌ Non traité « Ta demande n'a pas pu être traitée ».

Les candidatures et les rendez-vous ne déclenchent pas de notification Discord : consulte régulièrement les onglets Candidatures et Rendez-vous du Panel Patron (le nombre de rendez-vous en attente s'affiche sur la tuile).

Une seule couleur principale habille tout : panel, site public, espace client, candidatures, rendez-vous, assistant. Réglage : Paramètres compta → Général → Thème de couleur, puis « Appliquer le thème ».

• Perso : n'importe quelle couleur au format #RRGGBB. Une couleur trop sombre est éclaircie automatiquement (même teinte) pour que les boutons restent lisibles.
• À partir de la couleur choisie, la compta calcule une palette complète (clair, foncé, très clair…) et l'applique aux pages, styles et scripts.
• Le changement est immédiat pour tout le monde : les panels ouverts se recolorent avec le message « Le thème de la compta a changé ».
• Les embeds Discord du webhook gardent leur couleur dorée.

Si un webhook est configuré (sur /config), la compta poste automatiquement le classement des primes de la semaine dans ton salon Discord.

Quand ?

• Au démarrage du serveur.
• Toutes les 12 heures.
• Chaque jeudi à 23 h 58 (heure du serveur) : la clôture de la semaine.

Contenu du message

Les primes envoyées tiennent compte des grades et du quota. Le bouton Envoyer un test de /config poste « ✅ Webhook connecté » pour vérifier que tout fonctionne. Sans webhook, rien n'est envoyé.

Toutes les données sont des fichiers JSON lisibles, rangés dans le dossier data/ (et les photos de profil dans pp/). Pas de base de données : sauvegarder ces deux dossiers suffit.

Sauvegarder et restaurer

# archive datée de toutes les données
tar -czf sauvegarde-compta-$(date +%F).tar.gz data pp .env

• Fais une sauvegarde avant chaque mise à jour et régulièrement (une fois par jour, par exemple avec une tâche cron).
• Pour restaurer : arrête la compta, remets les dossiers data/ et pp/, relance.
• Pour déménager la compta sur un autre serveur : copie tout le dossier (code + data/ + pp/), lance npm install (garder data/memorycompta.json conserve la liaison de ta licence ; sur une installation neuve, demande au support de détacher la licence), puis mets à jour le lien de redirection sur /config et dans le portail Discord si l'adresse change.
• N'édite pas les fichiers JSON pendant que la compta tourne : un fichier mal formé est lu comme vide.

Ce qui n'est pas enregistré sur le disque

Les sessions (qui est connecté) sont enregistrées dans data/sessions.json : personne n'est déconnecté par un redémarrage. La présence (qui est en ligne) est gardée en mémoire : la liste « en ligne » se reconstitue en quelques secondes après un redémarrage.

Données personnelles

• Via Discord, la compta ne reçoit que l'identifiant, le pseudo, le nom affiché et l'avatar (permission identify). Le jeton Discord n'est pas conservé.
• Toute personne qui se connecte obtient une fiche de profil (infos Discord, date de dernière connexion).
• Les clients, candidats et employés renseignent eux-mêmes leur âge et leur téléphone RP.
• La présence publique (« Équipe en service ») affiche le nom, le grade et l'avatar des membres connectés au panel.

La licence ne limite ni le nombre d'employés, ni le nombre de prestations, ni le nombre de clients. Voici toutes les valeurs fixes de la compta.

Les situations les plus courantes, avec le message affiché et la solution.

Installation et connexion

Licence

Dans le panel

Site et clients

Messages d'erreur du serveur

Pour les développeurs qui veulent comprendre ou intégrer la compta. Toutes les routes répondent en JSON. Une session Discord (cookie) est nécessaire sauf mention « public ».

Événements temps réel

Diffusés sur /api/live : connected, presence_update, new_presta, delete_presta, client_renamed, client_deleted, client_unhidden, settings_update, catalogue_update, banque_update. Un signal de maintien est envoyé toutes les 15 secondes.