# Prompt Claude Code — Application de suivi de chantier pour maîtres d'œuvre > Version 1 — 11 novembre 2026 > Nom de travail de l'application : **Chantier Libre** (à remplacer si besoin, partout, par une seule variable de configuration). --- ## 1. Ton rôle et l'objectif Tu es l'architecte et le développeur principal d'une application web originale de **suivi de chantier**, destinée aux architectes, maîtres d'œuvre et petites entreprises du bâtiment (5 à 20 personnes). Le besoin métier se résume ainsi : pendant une visite ou une réunion de chantier, l'utilisateur relève des remarques et des réserves sur tablette ou téléphone, les situe sur un plan, y joint des photos, puis envoie le compte rendu en PDF à toutes les entreprises avant de quitter le chantier. Aujourd'hui ce travail lui prend une à deux heures de ressaisie au bureau. Tu construis un **MVP utilisable en conditions réelles par un client pilote**, pas une démonstration. ## 2. Règles de conception indépendante (obligatoires) Cette application est une création originale, écrite à partir du besoin métier décrit ici. - N'utilise, ne consulte et ne reproduis aucun code, écran, texte, icône, nom de fonctionnalité ou identité visuelle d'un logiciel existant du marché. - N'appelle aucune API d'un éditeur tiers de suivi de chantier. - Ne cite aucune marque concurrente dans le code, l'interface ou la documentation. - Utilise le vocabulaire courant du bâtiment français (lot, réserve, OPR, compte rendu, intervenant), qui appartient au métier et non à un éditeur. - Conçois ta propre interface : ne cherche pas à ressembler à un produit connu. ## 3. Périmètre exclu (ne pas développer) Ces domaines sont volontairement hors périmètre, pour des raisons réglementaires ou de complexité. Si une tâche t'y amène, arrête-toi et signale-le. - Devis, facturation, situations de travaux, toute pièce comptable. - Pointage, feuilles d'heures, géolocalisation des personnes, éléments de paie. - Paiement en ligne. - Signature électronique à valeur probante (les procès-verbaux sont générés en PDF pour être imprimés et signés à la main). - Maquette numérique (BIM), planning Gantt, gestion budgétaire, constructeur de formulaires générique, messagerie instantanée. ## 4. Utilisateurs et rôles | Rôle | Qui | Droits | |---|---|---| | Administrateur | Gérant du cabinet | Tout, y compris utilisateurs et paramètres du cabinet | | Collaborateur | Architecte, conducteur de travaux | Crée et modifie chantiers, remarques, comptes rendus | | Invité | Entreprise intervenante | Accès par lien personnel sans compte : voit ses remarques, peut commenter et proposer une levée avec photo | Une seule organisation (le cabinet) par installation. Pas de multi-clients dans le MVP. ## 5. Modèle de données attendu Propose le schéma PostgreSQL définitif, mais couvre au minimum ces entités : - **Cabinet** : nom, logo, coordonnées, mentions de pied de page des PDF. - **Utilisateur** : nom, e-mail, rôle, mot de passe haché. - **Chantier** : nom, référence, adresse, maître d'ouvrage, dates, statut (en préparation, en cours, en réception, clos, archivé). - **Lot** : numéro, intitulé, chantier. Une bibliothèque de lots types est réutilisable d'un chantier à l'autre. - **Intervenant** : entreprise, contact, e-mail, téléphone, rôle sur le chantier, lots attribués. - **Plan** : chantier, dossier, intitulé, fichier (PDF ou image), numéro de version, plan remplacé. Une nouvelle version conserve l'ancienne et propose de reporter les repères. - **Remarque** : numéro séquentiel par chantier, type (observation, réserve, point à traiter, information), texte, lot, intervenant responsable, localisation libre (bâtiment, niveau, pièce), échéance, priorité, statut, auteur, dates. - **Repère** : remarque, plan, coordonnées normalisées (x et y entre 0 et 1), indépendantes du zoom et de la résolution. - **Photo** : remarque ou visite, fichier original, version annotée, date de prise de vue. - **Visite** : chantier, numéro, date, type (réunion de chantier, visite, OPR, réception, levée de réserves), présences (présent, absent, excusé, convoqué à la prochaine), date de la prochaine réunion, texte libre d'introduction, avancement par lot en pourcentage. - **Compte rendu** : visite, PDF généré, date d'envoi, destinataires, accusés d'ouverture si disponibles. - **Journal** : historique de chaque changement de statut d'une remarque (qui, quand, quoi). Statuts d'une remarque : ouverte → en cours → levée proposée (par l'entreprise) → levée validée (par le cabinet), ou refusée avec retour à ouverte. ## 6. Fonctionnalités du MVP ### 6.1 Préparer un chantier - Créer un chantier en moins de deux minutes à partir d'un **chantier modèle** (lots, intervenants habituels, gabarit de compte rendu). - Importer des plans par glisser-déposer, plusieurs fichiers à la fois, y compris un PDF multi-pages découpé automatiquement en feuilles. - Nommer les plans en masse : nom tiré du nom de fichier, modifiable dans une grille, jamais un par un dans une fenêtre. - Importer les intervenants depuis un CSV. ### 6.2 Sur le chantier (mobile et tablette, hors connexion) - Ouvrir un plan, zoomer, poser un repère numéroté d'un geste, saisir la remarque dans la foulée. - Dictée vocale du texte via le clavier du système. - Prendre une ou plusieurs photos depuis l'appareil natif, puis les annoter (flèche, cercle, trait libre, texte). - Bibliothèque de **phrases types** par lot pour saisir une remarque fréquente en deux touches. - Dupliquer une remarque. - Tout fonctionne sans réseau ; la synchronisation se fait seule au retour de la connexion, avec un indicateur visible et une gestion des conflits (la modification la plus récente gagne, l'autre est conservée dans le journal). ### 6.3 Réunion de chantier et compte rendu - Démarrer une visite : les remarques non levées de la visite précédente sont reprises automatiquement, classées par lot. - Pour chaque remarque reprise : la maintenir, la modifier, la lever, en une touche. - Saisir les présences et l'avancement par lot. - Générer le **compte rendu PDF** : en-tête du cabinet, présences, avancement, remarques par lot avec photos et extraits de plan repérés, date de la prochaine réunion. - Prévisualiser, puis envoyer par e-mail à tous les intervenants ou à une sélection, chacun pouvant aussi recevoir la seule liste de ce qui le concerne. ### 6.4 OPR, réception et levée de réserves - Mode OPR : saisie rapide de réserves par pièce et par lot. - Générer la liste des réserves par entreprise et le procès-verbal de réception à imprimer. - Suivre la levée : l'entreprise propose la levée depuis son lien personnel avec une photo, le cabinet valide ou refuse. - Tableau de bord par chantier : réserves ouvertes, en retard, par lot et par entreprise. ### 6.5 Recherche, filtres et sorties - Recherche plein texte dans les remarques de tous les chantiers. - Filtres combinables : lot, intervenant, statut, type, priorité, plan, échéance. - Champs obligatoires paramétrables par le cabinet (par exemple : lot et responsable exigés pour toute réserve). - Export CSV des remarques et export ZIP complet d'un chantier (plans, photos, PDF), sans restriction : le client reste propriétaire de ses données. - Import CSV de remarques pour reprendre l'existant d'un autre outil. ## 7. Points d'attention tirés des retours d'utilisateurs du marché Ces irritants reviennent dans les avis publics sur les outils existants. Traite-les comme des exigences de qualité : 1. La création d'un chantier et le nommage des plans sont trop longs : vise l'import en masse et les chantiers modèles. 2. Les outils d'annotation sont jugés datés : peu d'outils, mais rapides et précis au doigt comme au stylet. 3. L'application ralentit avec beaucoup de plans : affichage par tuiles, chargement paresseux, miniatures. 4. L'export PDF ne doit dépendre d'aucune option payante ni d'aucun palier. 5. Les utilisateurs veulent pouvoir imposer des règles de saisie : champs obligatoires et listes fermées. 6. Les photos doivent être classables et retrouvables hors des remarques : galerie par chantier, par date et par lot. 7. Le compte rendu doit être lié aux réserves d'OPR, avec recherche, priorités et filtres. 8. Disponibilité égale sur iOS, Android et ordinateur : d'où le choix d'une PWA. 9. Le poids des données sur l'appareil doit rester maîtrisé : compression des photos, choix des chantiers gardés hors ligne. ## 8. Contraintes techniques - **Type** : application web progressive (PWA) installable, adaptée au téléphone, à la tablette et à l'ordinateur. - **Base de données** : PostgreSQL. - **Fichiers** : stockage compatible S3 (MinIO en local), jamais en base. - **Conteneurs** : un `Dockerfile` et un `docker-compose.yml` qui lancent l'ensemble avec une seule commande. - **Hors connexion** : service worker, IndexedDB, file d'attente de synchronisation. - **Plans** : rendu des PDF côté serveur en tuiles d'images ; les repères sont stockés en coordonnées normalisées. - **PDF** : génération côté serveur à partir de gabarits HTML, pour un rendu identique sur tous les appareils. - **E-mail** : SMTP paramétrable, avec un outil de capture des e-mails en développement. - **Pile par défaut** : TypeScript de bout en bout, React avec Vite pour l'interface, Node.js avec Fastify pour l'API, Prisma pour l'accès aux données. Tu peux proposer mieux si tu le justifies en trois lignes avant de commencer. - **Langue** : interface en français, textes externalisés pour traduction ultérieure. - **Licence** : libre (MIT par défaut), dépendances compatibles uniquement. ## 9. Sécurité et données personnelles - Authentification par e-mail et mot de passe, hachage Argon2, sessions par cookie sécurisé, limitation des tentatives. - Liens des invités : jetons longs, aléatoires, révocables, limités aux remarques de l'intervenant. - Contrôle des droits côté serveur sur chaque requête. - Validation de tous les fichiers importés (type réel, taille). - RGPD : les contacts des intervenants sont des données personnelles. Prévois l'export et la suppression d'un contact, une page de mentions paramétrable, et aucun traceur tiers. - Sauvegarde : script de sauvegarde et de restauration de la base et des fichiers, documenté et testé. ## 10. Déroulement attendu Travaille par étapes et arrête-toi à la fin de chacune pour validation. **Étape 0 — Cadrage (aucun code).** Rédige `SPEC.md` : schéma de données, liste des écrans, parcours principaux, choix techniques, questions ouvertes. Attends ma validation. **Étape 1 — Socle.** Dépôt, conteneurs, base, authentification, rôles, chantiers, lots, intervenants, jeu de données de démonstration. **Étape 2 — Plans et remarques.** Import et versions de plans, repères, remarques, photos annotées, filtres et recherche. **Étape 3 — Hors connexion.** Service worker, stockage local, synchronisation, gestion des conflits. **Étape 4 — Visites et comptes rendus.** Visites, reprise des remarques, présences, avancement, PDF, envoi par e-mail. **Étape 5 — OPR et levée de réserves.** Mode OPR, procès-verbal, liens invités, validation des levées, tableau de bord. **Étape 6 — Finitions.** Imports et exports, chantiers modèles, phrases types, champs obligatoires, sauvegarde, documentation. À chaque étape : tests automatisés des règles métier, tests de bout en bout des parcours principaux, et une courte note de ce qui est fait, de ce qui ne l'est pas et de ce qui reste incertain. ## 11. Critères d'acceptation du MVP 1. Un chantier complet (10 lots, 12 intervenants, 30 plans) se crée en moins de 10 minutes à partir d'un modèle. 2. En mode avion, on saisit 20 remarques avec repères et photos ; elles se synchronisent sans perte ni doublon au retour du réseau. 3. Un plan de format A0 en PDF s'ouvre et se manipule de façon fluide sur une tablette de milieu de gamme. 4. Le compte rendu d'une visite de 40 remarques se génère en moins de 30 secondes et part par e-mail aux intervenants. 5. La visite suivante reprend seule les remarques non levées. 6. Une entreprise invitée ne voit que ses remarques et peut proposer une levée avec photo. 7. L'export ZIP d'un chantier contient tous les plans, toutes les photos, tous les PDF et le CSV des remarques. 8. `docker compose up` suffit à lancer l'application sur une machine vierge. 9. Aucune fonctionnalité de la section 3 n'est présente. ## 12. Livrables - Le code source dans un dépôt Git avec un historique lisible. - `README.md` : installation, configuration, sauvegarde, mise à jour. - `SPEC.md` tenu à jour. - `PROMPT_REGENERATION.md` : document autonome décrivant le besoin, le modèle de données, les règles métier et les critères d'acceptation, suffisant pour reconstruire l'application dans une autre pile technique sans ce dépôt. - `LICENSE`. - Un guide utilisateur de deux pages pour le client pilote. ## 13. Façon de travailler - Pose tes questions à l'étape 0 plutôt que de supposer. - Si une exigence te paraît contradictoire ou irréaliste, dis-le avant de coder. - Ne déclare jamais une étape terminée si des tests échouent ; dis ce qui échoue. - Préfère une solution simple qui marche à une architecture ambitieuse.