← Retour à l'application📥 Télécharger le PDF (identique)

Mode d'emploi — QUOTELUI (ARTISAN ENGINE)

Guide utilisateur de l'application web. Cette plateforme gère toute l'activité d'une entreprise artisanale : clients, chantiers, catalogue, devis (avec PDF et envoi par email), relevés de terrain, et administration. Les données sont isolées par entreprise.


1. Se connecter

  1. Ouvrez l'adresse de l'application dans un navigateur (ex. http://localhost:8000/).
  2. Saisissez votre adresse email et votre mot de passe, puis Se connecter.

Sur cette page de connexion : liens publics « Confidentialité » (politique RGPD) et « Mentions légales » — accessibles sans compte.

Les comptes sont créés par l'administrateur de l'entreprise (voir §14) ou via la commande de démonstration seed_demo :

RôleEmailMot de passe
Adminadmin@demo.artisan-engine.frdemo-artisan-2026!
Managermanager@demo.artisan-engine.frdemo-artisan-2026!
Commercialcommercial@demo.artisan-engine.frdemo-artisan-2026!
Technicientech@demo.artisan-engine.frdemo-artisan-2026!

Le mot de passe inclut le ! final.

Installer QUOTELUI sur un smartphone (PWA, V2.15)

QUOTELUI est une application web installable (Progressive Web App) :


2. Choisir son entreprise

Un même compte peut appartenir à plusieurs entreprises.

Le rôle affiché dans le menu correspond à celui que vous avez dans l'entreprise sélectionnée (le rôle global ne s'applique que si aucun rôle d'entreprise n'est défini).


3. Rôles et droits

Les actions sont contrôlées côté serveur (masquer un bouton ne suffit jamais). La hiérarchie des rôles est cumulative.

RôlePeut faire
LECTEURConsulter le catalogue, les clients, les chantiers, les relevés et les devis.
TECHNICIENTout « LECTEUR » + saisir les relevés de terrain (mesures, champs spécifiques, photos, observations) et les valider.
COMMERCIALTout « TECHNICIEN » + créer / modifier / gérer les clients, créer, éditer, envoyer et réviser les devis, créer/envoyer les factures (V2.1), les bons de livraison (V2.10) et le pipeline d'affaires / relances (V2.11).
MANAGERTout « COMMERCIAL » + gérer le catalogue (types de produits, attributs), les prix/TVA, le stock, les fournisseurs et les commandes fournisseurs, et consulter l'audit.
ADMINTout « MANAGER » + gérer les membres, les modules métiers et les réglages de l'entreprise.

Le menu s'adapte à votre rôle : un Technicien ne voit pas « Clients » ni « Devis », mais voit « Relevés », « Catalogue » et ses alertes.


4. Le menu (colonne de gauche)

EntréeRôlesDescription
Tableau de bordTousVue adaptée au rôle (voir §5).
Devis≠ TechnicienListe et création des devis (§10).
Factures≠ TechnicienDevis acceptés → factures, états, PDF/email (§10 bis).
Clients≠ TechnicienListe et gestion des clients (§7).
Chantiers≠ TechnicienListe et gestion des chantiers/projets (§8).
RelevésTousRelevés de chantier, workflow terrain → bureau (§11).
CatalogueTousProduits et types de produits (§9).
StockTous (mouvements : Manager+)Suivi des quantités, seuils, mouvements (§13 quater).
FournisseursTous (gestion : Manager+)Fiches fournisseurs et tarifs d'achat (§13 quinquies).
CommandesTous (gestion : Manager+)Commandes fournisseurs, réception → stock (§13 quinquies).
LivraisonsTous (gestion : Commercial+)Bons de livraison client, sortie de stock (§13 sexies).
AffairesTous (gestion : Commercial+)Pipeline commercial, relances CRM (§13 septies).
PlanningTousCalendrier semaine des chantiers, relevés, RDV et livraisons, avec conflits par technicien (§13 quattuordecies).
RechercheTousRecherche globale multi-objets (§6).
Alertes (+ badge)TousRappels automatiques (§6 bis).
StatistiquesManager+Pilotage commercial (§5 bis).
HistoriqueManager+Journal d'audit (§15).
RéglagesAdminParamètres de l'entreprise (§13).
Administration → MembresAdminComptes et rôles de l'entreprise (§14).
Administration → ModulesAdminActivation des modules métiers (§14 bis).

En bas du menu : la liste des entreprises, votre nom et votre rôle, et le bouton de déconnexion (↪).

Sur mobile, le menu se replie ; le bouton ☰ en haut à droite l'ouvre.


5. Tableau de bord

Vue d'accueil adaptée au rôle :

Chaque bloc renvoie vers la liste ou la fiche concernée.


5 bis. Statistiques — pilotage commercial (V2.7)

Statistiques dans le menu (Manager+) agrège l'activité commerciale de l'entreprise sur les 12 derniers mois :

Détails techniques : les brouillons, modes intermédiaires et devis annulés / expirés sont exclus des CA et des ratios ; les devis refusés sont comptés dans la transformation mais jamais dans le CA.


6. Recherche globale

Une seule zone de recherche interroge tous les objets : clients, contacts, chantiers, devis, produits, documents et relevés.


6 bis. Alertes (automatiques)

L'application surveille en continu et affiche un badge orange avec le nombre de rappels. Rien à configurer : les règles sont celles du cahier des charges.

Type d'alerteRègle
Devis à relancerDevis envoyé depuis plus de 30 jours sans réponse.
Devis expirantValidité qui arrive à échéance (< 7 jours).
Devis expiréValidité dépassée (le devis passe automatiquement à EXPIRE).
Factures non régléesFacture dont l'échéance est dépassée (montant affiché).
Stock bas / ruptureProduit suivi dont le solde est ≤ seuil (rouge si rupture, ≤ 0).
Relances en retardActivité commerciale (appel, email…) à faire dont l'échéance est dépassée.
Conflit de planningUn technicien a 2+ interventions le même jour sur les 14 prochains jours (chantier + relevé + RDV…).
Relevé incompletRelevé en TERRAIN sans éléments.
Photos manquantesRelevé en TERRAIN/VALIDE sans photo.

Ouvrez Alertes pour voir le détail ; chaque alerte mène à l'objet concerné.


7. Clients

  1. Clients → Nouveau client : type (Particulier / Professionnel / Entreprise), coordonnées, adresse de facturation (modèle Address lié en billing_address), n° TVA intracommunautaire (normalisé en majuscules) et SIRET optionnel (Customer.siret, migration customers/0002 — validé : exactement 14 chiffres).
  2. Le formulaire s'adapte au type (Alpine) : raison sociale + TVA + SIRET visibles pour Professionnel/Entreprise, prénom/nom pour Particulier (les champs masqués restent dans le DOM et sont donc soumis — aucune perte de données à l'édition).
  3. set_billing_address(customer, …) crée l'adresse à la demande, la met à jour sur place (pas de doublon) et la retire si tous les champs sont vides.
  4. Le snapshot figé du destinataire (_snapshot_customer) emporte address / vat_number / siret : les PDF de devis et de facture affichent « TVA : … » / « SIRET : … » quand renseignés — figés à l'envoi, jamais rétro-impactés sur les versions antérieures.
  5. La fiche client résume ses coordonnées et liste ses chantiers et devis.

La gestion des clients est réservée au Commercial et au-dessus.


8. Chantiers (projets)

Un chantier est un projet rattaché à un client : lieu d'intervention, dates.

  1. Chantiers → Nouveau chantier : client, nom, adresse du site.
  2. La fiche chantier liste les devis et les relevés associés.

9. Catalogue

Le catalogue est entièrement dynamique : chaque type de produit (fenêtre, chaudière, radiateur…) possède ses propres attributs (largeur, débit, puissance, matériau, énergie…).

Catalogue ≠ stock : le catalogue est un référentiel d'offre (ce que vous pouvez proposer, y compris des produits fournisseurs, avec leurs prix). Il ne représente pas votre inventaire : pour suivre ce que vous détenez réellement, utilisez le Stock (§13 quater), qui ne suit que les produits que vous choisissez de suivre.

Les données de base (types, attributs, champs de relevé) sont injectées automatiquement à l'activation d'un module métier (§14 bis). Vous pouvez aussi créer vos propres types de produits sans aucune programmation.


10. Devis

10.1 Création

  1. Devis → Nouveau devis. Le numéro est attribué automatiquement (DEV-2026-0001, séquence propre à l'entreprise).
  2. Renseignez l'état brouillon : client, chantier éventuel, date de validité (proposée automatiquement d'après les réglages).
  3. Ajoutez des lignes : soit depuis un produit du catalogue (attributs et prix repris), soit en saisie libre (libellé, prix unitaire HT).
  4. chaque ligne porte sa quantité, son prix unitaire HT et son taux de TVA (choisi ligne par ligne — il est figé à l'envoi).
  5. Remises :
  6. par ligne : un pourcentage ou un montant fixe (jamais les deux) ;
  7. globale : pourcentage ou fixe, appliquée sur l'ensemble du devis. Les totaux (HT, TVA par taux, TTC) se recalculent en continu (arrondis à 2 décimales).
  8. Actions par ligne (tableau des lignes, tant que le devis est modifiable) : Modifier (libellé, description, quantité, prix unitaire HT — saisie en place), Remise (% ou € fixe sur la ligne) et Supprimer (confirmation). Le service update_line recalcule les totaux ; la TVA figée et le produit lié restent intacts. Les mêmes opérations existent côté API (set_line_discount, remove_line).

10.2 États et cycle de vie

Le devis suit une machine d'état stricte :

BROUILLON → A_COMPLETER → EN_REVISION → PRET → ENVOYE → ACCEPTE / REFUSE / EXPIRE
                                              ↘ (révision) → nouvelle version
ÉtatSignification
BROUILLONCréé, en cours de saisie.
A_COMPLETERVous signalez qu'il manque des informations.
EN_REVISIONCorrection en cours.
PRETComplet, prêt à l'envoi.
ENVOYEEnvoyé au client : le contenu est figé.
ACCEPTE / REFUSE / EXPIREIssue finale du devis.
ANNULEDevis abandonné.

Règle d'or : les états modifiables sont BROUILLON, A_COMPLETER, EN_REVISION, PRET. Dès l'envoi, le contenu est gelé (aucune modification silencieuse) ; pour le changer, repassez en EN_REVISION : une nouvelle version est créée (v1 → v2 → …), les versions précédentes restent consultables.

À l'envoi, remarque : l'email du destinataire et les coordonnées de l'entreprise sont pris dans la version figée, jamais dans les données vivantes — c'est une garantie de traçabilité.

10.3 PDF et email

Après envoi (contenu figé) :

Tant que le devis est en brouillon ou en état intermédiaire, le bouton PDF n'apparaît pas : son contenu n'est pas encore figé (§10.4). Une fois envoyé, le bouton devient disponible. Si l'URL du PDF est saisie directement sur un devis non envoyé, un message l'indique (aucune erreur serveur).

10.4 Versions

Sur la fiche du devis, l'historique des versions (v1, v2…) est consultable : chaque version montre le contenu exact envoyé à ce moment-là.


10 bis. Factures (V2.1)

La facturation est le prolongement naturel d'un devis accepté.

10 bis.1 Création

Menu Factures → + Nouvelle facture :

10 bis.2 États et cycle de vie

BROUILLON → PRETE → ENVOYEE → EN_RETARD → PAYEE
              ↘ (retour)              ↘
BROUILLON ⇄ PRETE                     ANNULEE (à tout moment)
ÉtatSignification
BROUILLONEn cours de fabrication, modifiable.
PRETEPrête à envoyer, modifiable.
ENVOYEEEnvoyée au client : le contenu est figé.
EN_RETARDÉchéance dépassée (passage automatique).
PAYEERèglement reçu.
ANNULEEAnnulée.

Règle d'or : identique au devis. Editable uniquement en BROUILLON/PRETE. Dès ENVOYEE, le contenu est figé (PDF, totaux, TVA, destinataire). Pour la modifier, annulez et créez une nouvelle facture — c'est la garantie de traçabilité d'un document financier.

10 bis.3 PDF, email et relances

Après envoi : boutons PDF (téléchargement du document figé, mention d'échéance, numéro du devis d'origine) et Envoyer par email (PDF en pièce jointe, destinataire = la version figée, jamais le client vivant). Chaque envoi est journalisé (Emails) et tracé dans l'historique.

Le bouton PDF n'apparaît que lorsque le contenu est figé (dès ENVOYEE) : tant que la facture est en brouillon ou prête, elle n'a pas de PDF associé (même règle que le devis, §10.3).

Une facture EN_RETARD est mise en évidence (bandeau « RAPPEL » sur le PDF). La bascule ENVOYEE → EN_RETARD est automatique lorsque la date d'échéance est dépassée (commande/boucle de maintenance).

10 bis.4 Relance de paiement (V2.2.1)

Pour une facture Envoyée ou En retard, le bouton Relancer (fiche ou liste de factures) envoie au client le même PDF figé avec l'objet « Relance de paiement : FAC-… ». La date de dernière relance est affichée sur la fiche, et l'envoi est journalisé dans Emails (historique de relances).

Si la facture n'est pas EN_RETARD alors que l'échéance est passée, la commande périodique s'en charge :

À planifier quotidiennement côté serveur (cron / systemd timer). Seules les entreprises actives sont affectées ; aucun ré-envoi intempestif grâce au délai.

10 bis.5 Export comptable (V2.3)

Un point d'export réunit les documents destinés au comptable, accessible depuis Factures → Export comptable :

ÉlémentOùContenu
Synoptique annuel (PDF)bouton « Synoptique PDF »Total HT/TVA/TTC par mois, ventilation par taux de TVA (base + TVA), encaissement (payées / en attente / en retard, montant TTC). Choisir l'année en haut de page.
Export CSVbouton « CSV des factures »Une ligne par facture : numéro, date émission, échéance, client, statut, HT, TVA, TTC, devis d'origine, devise. Séparateur ;, UTF-8 (compatible tableur).

Règles : les factures annulées sont comptées mais exclues des montants (coches * dans le PDF) ; les montants sont en Decimal arrondis à deux décimales ; chaque ligne figeant sa TVA, une modification ultérieure d'un taux ne change pas l'historique.

10 bis.6 Déclaration TVA (V2.16)

Depuis Factures → Déclaration TVA, sélectionnez une période (mois ou trimestre) pour afficher la synthèse :

Les factures annulées et les commandes annulées / brouillon sont exclues. Les taux sont ceux figés sur chaque ligne au moment de l'émission (§9) — la modification ultérieure d'un taux ne change pas cet historique.

Exports : - CSV : bouton « CSV » — format comptable (;, UTF-8 avec BOM). - PDF : bouton « PDF » — document A4 synthétique avec les deux tableaux et la TVA nette en encadré.

10 bis.7 Facture électronique — plateforme de dématérialisation (V3.1)

Réglages → Facture électronique connecte QUOTELUI à la plateforme de dématérialisation (PDP) choisie par l'entreprise :

Qui pilote la connexion ? Deux options :

Sur la fiche d'une facture (figée / envoyée) : un bloc « Facture électronique (PDP) » liste les soumissions avec le retour de la plateforme : SOUMISE / EN_ATTENTE / ACCEPTEE / MISE_A_DISPOSITION (mise à disposition chez le destinataire) / REJETEE / ECHEC, plus l'identifiant message PDP, la date de soumission et le détail (couleur : vert = accepté, violet = remis au destinataire, rouge = rejet/échec, ambre = en attente) avec :

Lire un refus de la plateforme — le message affiché indique la conduite à tenir :

La colonne « retour » affiche, sous le message, la réponse telle quelle de la plateforme (plateforme : …) : c'est l'état déclaré par la plateforme, même si notre vocabulaire ne le connaît pas encore (codes métier propres au fournisseur).

API : POST /api/invoices/{pk}/electronic/ et POST /api/invoices/{pk}/electronic-status/.


11. Relevés de chantier

Le relevé (métier) est le document de terrain réalisé par le technicien avant élaboration du devis. Il est cloisonné par métier : Survey.module_key (choisi à la création, parmi les modules activés) impose côté serveur les types/produits acceptés — un relevé menuiserie refuse un produit plomberie, web comme API. Les champs proposés dépendent du métier car ils viennent des schémas d'attributs du catalogue (ProductType → AttributeSchema) :

11.1 Cycle de vie

TERRAIN → VALIDE → BUREAU → EN_VERIFICATION → CLOTURE
   ↕          ↕         ↕
 retours possibles (VALIDE → TERRAIN, BUREAU → VALIDE)
ÉtatQuiRôle
TERRAINTechnicienSaisie autorisée : éléments, mesures, champs, photos, observations.
VALIDETechnicienRelevé relu et validé par le technicien.
BUREAUCommercial/ManagerTraitement au bureau (élaboration du devis).
EN_VERIFICATIONBureauVérification finale.
CLOTURETout le fluxTerminé — plus aucune modification.
ANNULE—Relevé abandonné.

Règle : seul un relevé au TERRAIN est modifiable. Les retours permettent de renvoyer un relevé en arrière sans jamais perdre son historique.

11.2 Composer un relevé (saisie guidée)

  1. Relevés → Nouveau relevé : chantier, date prévue, métier du relevé (module activé ; obligatoire dès qu'un module l'est). Un relevé déjà rempli ne peut plus changer de métier.
  2. Ajouter un élément : type du métier (chips) → produit du catalogue (chips, pré-remplissant les attributs) ou « Pas au catalogue » → dimensions + caractéristiques guidées. Repère facultatif.
  3. Côté terrain, reste une saisie manuelle : les dimensions (et les rares attributs TEXT). L'unité vient du schéma : jamais d'unité à taper.
  4. Édition en place : sur la fiche de l'élément, chaque dimension (H, L, Ø… une par mesure du type) s'affiche pré-remplie avec son libellé court et l'unité du schéma — on corrige la valeur, Enregistrer (service update_dimensions, refus des clés inconnues, champ vide = inchangé). Aucune mesure libre sur un relevé cloisonné. Le formulaire Mesures libres (libellé + valeur + unité, unité résolue et créée à la demande, clé facultative — §11.3) reste réservé aux relevés génériques.
  5. Photos (format/taille validés, minutaires) et Observations.
  6. Statut TERRAIN → … → CLOTURE.

Les relevés génériques (créés sans module, data legacy ou API) gardent le comportement historique : libellé libre, aucun filtre.

La suppression est gérée en « corbeille » : un relevé supprimé reste traçable dans l'historique et restauré si besoin par l'administrateur (il garde son numéro).

11.3 La clé d'une mesure — à quoi elle sert

Chaque mesure possède un libellé (« Hauteur baie ») et une clé technique : un mot court en minuscules, sans accents ni espaces (ex. largeur, hauteur, surface).

Le rôle de la clé est de relier la mesure au reste de l'application :

Vous saisissezClé produite (si vide)Effet sur le devis
« Surface » 1,5 m²surfacedevient la quantité d'une ligne tarifée en m²
« Longueur » 4 mllongueurdevient la quantité d'une ligne au mètre linéaire
« Remarque » 2remarquedescriptive uniquement

Astuce : pour forcer la liaison avec un tarif, utilisez précisément la clé de l'attribut de quantité définie dans Réglages → Tarifs (pose) (§13 bis).


12. Recherche d'objets dans les listes

Chaque liste (devis, clients, chantiers, relevés, produits) peut être parcourue via Recherche (§6) ou directement sur les cartes du tableau de bord.


13. Réglages de l'entreprise (Admin)

Réglages (menu) permet de configurer l'entreprise, avec effet immédiat sur les nouveaux devis (l'envoi fige ces informations dans la version) :

ParamètreEffet
Logo de l'entrepriseVotre propre logo d'artisan, affiché en en-tête des PDF de devis (et uniquement là — jamais dans les emails, et distinct du logo applicatif QUOTELUI). Sans logo, le PDF affiche à la place une case avec le nom de l'entreprise. Il est figé dans le devis à l'envoi.
Adresse (rue, code, ville, pays)Affichée sur les PDF et les emails.
Nom commercial / SIRET / TVA intracom.Identité légale de l'éditeur.
Conditions de règlementFigées sur le devis.
Conditions générales (CGV)Textes des CGV figurant sur le devis.
Numérotation des devisModèle par défaut DEV-{year}-{seq} (modifiable).
TVA par défaut des lignesPréremplie sur les nouvelles lignes.
Durée de validitéDate de validité proposée automatiquement.
Couleur de marqueUtilisée dans l'interface.
Email de contact (PDF)Pied de page des devis/factures/livraisons (« Toute question sur ce devis : … »). Défaut contact@quotelui.fr ; figé à l'envoi.

Configuration par entreprise : chaque société conserve ses réglages. Un réglage ne modifie jamais un devis déjà envoyé (celui-ci est figé).

À noter : si l'entreprise ne possède encore aucun taux de TVA, QUOTELUI crée automatiquement les taux standards français (20 %, 10 %, 5,5 %, 2,1 %) à l'ouverture des Réglages et fixe la TVA par défaut à 20 % — cela évite le message « Chaque ligne doit figer son taux de TVA » lors de la création d'un devis depuis un relevé (§13 ter).

Réglages → Notifications (V2.13) configure un digest d'alertes par email : destinataires (séparés par des virgules) et catégories à inclure (devis, factures en retard, stock bas, relances commerciales, relevés, licences). L'envoi est déclenché par une commande périodique (voir §13 octies).


13 bis. Tarifs (pose) — référentiel de prix (V2.5)

Réglages → Tarifs (pose) (Admin) permet de constituer un référentiel de prix par type de produit : pour chaque type du catalogue (fenêtre, porte, pose…), vous enregistrez une prestation type avec son prix unitaire HT.

Quand un commercial ajoute une ligne de devis et choisit un produit du catalogue, l'application propose automatiquement :

Le tarif proposé reste modifiable : le commercial peut valider, corriger le prix ou la quantité avant l'ajout de la ligne. La proposition ne modifie jamais le devis elle-même.

Points de fonctionnement :

13 ter. Devis depuis un relevé (V2.6)

Un relevé de chantier peut devenir un devis en un clic :

  1. Reliez chaque élément relevé à un produit du catalogue : au moment de l'ajout, ou plus tard via le sélecteur « Relier à un produit… » de la carte de l'élément (service link_item_product — produit actif de la même entreprise, type cohérent avec l'élément, métier du relevé sur un relevé cloisonné). L'élément affiche alors « · produit : … ». Un élément typé sans produit (« Pas au catalogue ») reste chiffrable via la règle du type (rule_for_product_type).
  2. Une fois le relevé reçu au bureau (statut au moins VALIDE/BUREAU), un bouton vert « Devis depuis ce relevé » s'affiche en haut de la fiche.
  3. QUOTELUI crée un devis BROUILLON avec :
  4. le client et le chantier du relevé ;
  5. une ligne par élément chiffrable : relié à un produit, ou — sans produit — dont le type figure au référentiel (§13 bis) ;
  6. le libellé et le prix depuis le référentiel de tarifs (§13 bis) si le type de produit y figure — sinon le nom et le prix de vente du produit ;
  7. la quantité depuis une mesure du relevé (§11.3) dont la clé correspond à l'attribut de quantité de la règle (ex. surface en m²), sinon l'attribut du référentiel, sinon 1 ;
  8. la TVA par défaut de l'entreprise (réglages §13).

Points importants :


13 quater. Stock (V2.8)

Stock dans le menu permet de suivre les quantités par produit (Manager+ pour les mouvements, tous les rôles en lecture).

Dépôts et transferts (V2.14)

Le stock est organisé en dépôts (dépôt principal, atelier, camion…) :


13 quinquies. Fournisseurs & commandes fournisseurs (V2.9)

Fournisseurs

Fournisseurs (menu) : fiches d'achat (coordonnées, conditions de règlement, délai indicatif) et tarifs d'achat par produit (prix d'achat, référence fournisseur). La gestion est réservée aux rôles Manager+ ; les autres rôles consultent. Une fiche affiche aussi l'historique de ses commandes.

Commandes fournisseurs

Commandes (menu) gère les bons de commande (BC-YYYY-NNNN) :

BROUILLON → ENVOYEE → CONFIRMEE → PARTIELLEMENT_RECUE → RECUE
                                        ANNULÉE (depuis tout état non reçu)

13 sexies. Bons de livraison client (V2.10)

Livraisons (menu) gère les bons de livraison (BL-YYYY-NNNN) — utiles pour tracer ce qui est réellement remis au client, indépendamment de la facturation.

BROUILLON → PARTIELLEMENT_LIVREE → LIVREE
                ANNULÉE (depuis BROUILLON / PARTIELLEMENT_LIVREE)

13 septies. Affaires & relances — CRM (V2.11)

Affaires (menu) pilote le pipeline commercial avant le devis.


13 octies. Notifications par email (V2.13)

Réglages → Notifications (Admin) active un digest d'alertes envoyé par email : destinataires et catégories à inclure (devis, factures en retard, stock bas, relances commerciales, relevés, licences).

13 novies. Sous-traitants (V2.17)

Sous-traitants (menu) gère les artisans externes à qui vous confiez des parties de chantier.

13 duodecies. Multi-devises (V2.18)

Le système supporte 6 devises : EUR (€), CHF (franc suisse), USD ($), GBP (£), CAD (dollar canadien), XOF (franc CFA).

Règle : la devise est un label d'affichage. Tous les calculs (restes à payer, reporting, totaux) sont dans la devise d'origine du document. Le change sera une phase ultérieure si besoin.

13 tredecies. Documents & photos de chantier (V2.19)

Chaque chantier dispose d'un espace documents & photos accessible depuis la fiche chantier.

Aucune migration — tout repose sur le GFK existant (Document + MediaItem).


13 quattuordecies. Planning des interventions (V3.0)

Planning dans le menu ouvre un calendrier hebdomadaire qui regroupe automatiquement tout ce qui a une date, sans rien à saisir en plus :

SourceDate utilisée
ChantiersDate de début du chantier (les personnes affectées sont les techniciens).
RelevésDate de relevé prévue (TERRAIN).
ActivitésRDV, visites, appels à faire (CRM).
LivraisonsDate de livraison (non annulées).

Fonctionnement :

Le planning est en lecture seule : il se remplit à partir de la date de début des chantiers (§8), de la date des relevés (§11) et des activités (§13 septies). Pour faire vivre l'agenda, renseignez ces dates au quotidien.

Aucune migration : le planning ne fait que lire des objets existants.


14. Administration — Membres (Admin)

Administration → Membres gère les comptes de l'entreprise.

Chaque ajout/retrait/changement de rôle est journalisé dans l'audit.


14 quater. Limites de membres — espace Éditeur (V4.4)

Quotas par rôle : par entreprise, le nombre maximal de comptes actifs est limité par défaut à 1 ADMIN, 1 MANAGER, 1 COMMERCIAL, 3 TECHNICIEN (LECTEUR et EDITEUR illimités). La règle est appliquée côté serveur dans add_member (ajouts ET changements de rôle) — un dépassement produit un message clair, jamais une erreur 500.


14 bis. Administration — Modules métiers (Admin)

Administration → Modules active les spécialités de l'entreprise.

ModuleTypes de produits injectés
MenuiserieFenêtres, portes, portes-fenêtres, baies vitrées, portails, volets, stores, accessoires, pose.
PlomberieRobinets, mitigeurs, lavabos, WC, chauffe-eau, chaudières, radiateurs, pose plomberie.
ChauffagePompes à chaleur, poêles, sèche-serviettes, planchers chauffants, ventilo-convecteurs, ballons thermodynamiques, régulation, pose chauffage.
ÉlectricitéTableaux, disjoncteurs, interrupteurs, prises, luminaires, détecteurs ; prestations : préparation et passage des câbles, pose des appareillages, compteur et tableau électrique, mise en sécurité et fin de chantier.
CouvertureTuiles, ardoises, bac acier, zinc, gouttières, isolation, étanchéité ; prestations : dépose, pose, reprise faîtages/noues.
CarrelageCarrelage sol/mur, faïence, tomettes, parquet, plinthes, joints, préparation des supports ; prestations : dépose, pose, joints.
Peinture / PlaquistePlaques de plâtre, doublage, cloisons, plafonds, enduits, peintures, papiers peints ; prestations : pose, enduits, peinture.
MaçonnerieParpaings, bétons, dalles, fondations, murs, crépis, clôtures, terrasses ; prestations : fondations, élévation, dalles, crépis.

Verrouillage par clé d'activation (installation chez un installateur)

Selon l'installation, les modules peuvent être verrouillés : seuls les métiers livrés d'office (Menuiserie) se passent de clé. Pour activer un autre métier (Plomberie, …), il faut la clé d'activation fournie par ton installateur :


15. Historique (audit)

Historique (menu, Manager+) journalise toutes les opérations importantes de l'entreprise :

Filtres et export :

Le journal est filtré par entreprise : rien ne fuite entre deux sociétés.


15 bis. Emails envoyés (Manager+)

Emails (menu, Manager+) montre qui a reçu quoi et quand, avec le statut de chaque envoi.

Tant que la case « Activer cette boîte » est cochée, les envois passent par cette boîte. Sinon, l'application utilise la configuration serveur (variables d'environnement EMAIL_*, ou journal console en développement).

Configuration SMTP (à défaut, configurée côté serveur)

VariableExemple (Gmail)Exemple (OVH hébergement)
EMAIL_BACKENDdjango.core.mail.backends.smtp.EmailBackendidem
EMAIL_HOSTsmtp.gmail.comssl0.ovh.net
EMAIL_PORT587587
EMAIL_HOST_USERmon-artisan@gmail.comcontact@mondomaine.fr
EMAIL_HOST_PASSWORDmot de passe d'applicationmot de passe de la boîte
EMAIL_USE_TLSTrueTrue
DEFAULT_FROM_EMAILQUOTELUI <mon-artisan@gmail.com>QUOTELUI <contact@mondomaine.fr>

Gmail impose « mot de passe d'application » (2 étapes l'activation requise). Sans SMTP configuré (mode développement/démo), les emails sont imprimés dans le journal du serveur et marqués « Envoyé » — rien ne part réellement.

Les emails envoyés avec le devis (PDF en pièce jointe) utilisent l'email du client figé dans la version envoyée, jamais le client mis à jour ensuite.



16 bis. Exemple complet guidé (démo multi-modules)

Parcours de bout en bout sur l'entreprise de démonstration « Artisan Démo SARL » (compte admin@demo.artisan-engine.fr / demo-artisan-2026!), montrant qu'un même devis cumule des cotations de plusieurs modules métier.

  1. Se connecter (voir §1) depuis un ordinateur ou un téléphone (http://<IP-du-PC>:8000, même Wi-Fi, §1).
  2. L'entreprise active doit être « Artisan Démo SARL » ; sinon basculez en bas du menu (§2).
  3. Catalogue — Produits : ouvrez Produits (menu). Les 8 modules sont activés sur cette entreprise (Administration → Modules) ; vous y retrouvez les produits de chaque métier : fenêtres (Menuiserie), PAC (Chauffage), disjoncteurs (Électricité), tuiles (Couverture), parpaings (Maçonnerie), grès cérame (Carrelage), peinture (Peinture).
  4. Devis — créer : ouvrez Devis → bouton Nouveau devis avec le chantier visé. La création reprend l'exemple prêt à l'emploi DEV-2026-0007 : 11 lignes couvrant 7 modules, chacune avec sa TVA figée (fenêtre 5,5 %, PAC et disjoncteurs 20 %, tuiles/parpaings/carrelage/peinture/main-d'œuvre 10 %), totaux HT / TVA / TTC affichés (17 580 € TTC).
  5. États du devis : passez le devis de <BROUILLON> (ou A_COMPLETER) vers PRET, puis Envoyer : le contenu est figé dans une version (v1 → v2 …), le PDF est généré (bouton PDF) et envoi par email possible (Envoyer). Une fois envoyé, plus aucune ligne n'est modifiable sans créer une nouvelle version (retour EN_REVISION).
  6. Relance : depuis un devis ENVOYE, le bouton Relancer renvoie le même PDF figé au même destinataire (objet « Relance : … »), journalisé dans Emails (§15 bis). la relance peut être automatisée par la commande périodique :

    CommandeEffet
    Relance automatique tout devis envoyé il y a plus de 30 jours sans réponse, sauf si relancé depuis moins de 7 jours (délais ajustables). Mode simulation disponible.

    Seules les entreprises actives sont affectées ; aucune version n'est créée (le PDF figé d'origine est renvoyé). 7. Relevé de chantier : ouvrez Relevés → RELEV-2026-0003 (statut VALIDE, workflow §11) : l'item « PAC air-eau » porte des mesures (surface 85 m²) et des champs spécifiques au métier Chauffage §15 (pièces, énergie, mode d'émission) ; l'item « Tableau existant » porte des champs Électricité (prise de terre, puissance souscrite). Même relevé, deux métiers : les champs proviennent des schémas de chaque module actif. 8. Historique : ouvrez Historique (§15) : l'envoi du devis, le changement d'état du relevé, l'activation des modules et la création des produits y sont tracés.

À retenir : rien n'est codé « métier » dans le moteur. Les modules contribuent uniquement des données (types de produits, attributs, champs de relevé). On peut donc librement mélanger Menuiserie, Plomberie, Chauffage, Électricité, Couverture, Carrelage, Peinture, Maçonnerie — sur le même devis comme sur le même relevé — et désactiver un module sans jamais perdre l'historique.


17. Conseils d'utilisation


18. Dépannage rapide

ProblèmeSolution
« Connexion refusée »Vérifiez email + mot de passe (le ! final compte).
Impossible de modifier un devisLe devis est envoyé (figé) : repassez en EN_REVISION pour créer une nouvelle version.
Un champ métier manque dans le relevéLe module du métier est peut-être inactif : activez-le (Administration → Modules).
Le PDF/email ne fonctionne pasLe devis doit d'abord être envoyé (contenu figé). Pour l'email, le client doit avoir une adresse email.
Un devis est « expiré »Sa validité est dépassée ; relancez via EN_REVISION (nouvelle version) avec une nouvelle date.
Bouton d'administration absentVous n'avez pas le rôle ADMIN dans cette entreprise.

18 bis. Signature électronique des devis (V2.2)

Lorsque vous envoyez un devis par email, un lien de signature est inclus dans le message (vert, bien visible). Le client peut :

  1. Consulter le devis (résumé + PDF intégré) depuis n'importe quel appareil.
  2. Accepter ou refuser en un clic — sans créer de compte.
  3. La décision est immédiatement enregistrée dans QUOTELUI (statut du devis + historique audit avec date, IP et navigateur du client).

Comment ça marche :

ÉtapeAction
EnvoiLe lien est ajouté automatiquement à l'email de devis (ou relance).
Fiche devisLe bloc Signature électronique affiche le statut (« En attente » / « Accepté le … » / « Refusé le … ») et un bouton Copier le lien.
DécisionLe lien mène à une page claire : résumé du devis + 2 boutons (Accepter / Refuser). La page est lisible même sur smartphone.
AprèsLe statut passe à ACCEPTE ou REFUSE. L'historique montre « Accepté le 12/09/2026 à 14:30 · IP 203.0.113.7 ».

Points importants :

18 ter. Confidentialité & RGPD (données personnelles)

QUOTELUI est une plateforme métier : chaque entreprise utilise son propre compte et reste responsable de traitement des données qu'elle y enregistre (clients, chantiers, devis…).

Ce qui est réellement mis en œuvre (mesures techniques) :

Droits des personnes (RGPD) : accès, rectification, effacement, limitation, portabilité et opposition s'exercent auprès de l'entreprise qui traite vos données (votre artisan/client) ; l'éditeur QUOTELUI est sous-traitant et applique ces demandes transmises par l'entreprise.

Politique complète : application → « Confidentialité » (page /confidentialite/, visible dès la page de connexion, sans compte) et Mentions légales (/mentions-legales/).

QUOTELUI · Mode d'emploi · Confidentialité (RGPD) · Mentions légales