✨ Nouveautés — bandeau défilant

En haut de chaque écran, un bandeau défilant résume les dernières évolutions. Cliquez dessus (ou sur « Voir tout → ») pour ouvrir le panneau avec le détail de chaque nouveauté et des liens directs.

• Bloc 1 — Extraction documentaire unifiée (PDF, Word, OCR, classification Claude)
• Bloc 2 — Pipeline intelligent, organisation fichiers, Google Drive, filtres, transport
• Bloc 3 — Fiches engins, alertes J-7/J-3 multi-canal, tampon PDF, suivi

🧠 Bloc 1 — Extraction documentaire unifiée

Objectif : analyser automatiquement tout document importé (PDF scanné, Word, image, texte).

• Service central — extraction_service : lecture multi-format, OCR (Tesseract), classification du type (devis location, contrat, transport, facture…), extraction des tarifs, dates, fournisseur.
• Import classique — Menu Documents → Upload, ou bouton 📎 Import rapide (barre du haut). Associez ensuite le document à un chantier via la modale.
• Cas ambigus — Si l’IA n’est pas sûre, un AgentFinding est créé et apparaît dans le panneau latéral droit (alertes temps réel).

📁 Bloc 2 — Pipeline document intelligent

Objectif : après extraction, organiser, synchroniser et retrouver les documents facilement.

1. Import intelligent — Page Upload → « Pipeline intelligent Bloc 2 ». Analyse + modale chantier si besoin.
2. Organisation locale — Fichiers rangés dans OFT_DOCUMENTS/CHANTIERS/{année}/{chantier}/Location_{mois}/…
3. Google Drive — Sync en arrière-plan (credentials dans data/google_drive_credentials.json).
4. Filtres avancés — Page Filtres documents : statut, type, fournisseur, période, tarif, durée, chantier.
5. Transport — Si statut « À transporter », bouton 🚛 → popup (GPS, km, prix, notification Telegram).

🚜 Bloc 3 — Suivi locations engins

Objectif : piloter le cycle de vie des locations (devis/contrats) avec alertes et décisions.

• Création auto — Dès qu’un devis ou contrat location est associé à un chantier, une FicheEngin est créée (tarif/j, dates, fournisseur).
• Page suivi — /engins/suivi : tableau, KPI, filtres (En cours, Pause, Urgents…), refresh auto 60 s.
• Décisions — Prolonger / Pause -50% / Stopper → tampon sur le PDF + historique + sync Drive.
• Alertes J-7 — Telegram seul, 7 jours avant la fin.
• Alertes J-3 — Telegram (boutons inline) + WhatsApp + SMS via Twilio, 3 jours avant la fin.
• Bot Telegram — Commandes /prolonger_{id}, /pause_{id}, /stopper_{id} avec confirmation.

🤖 Alertes agent (temps réel)

Le panneau à droite affiche les documents que l’agent n’a pas pu classifier avec certitude.

• Traiter — Saisir une réponse / classification manuelle.
• Ignorer — Marquer comme traité sans action.
• Donner un ordre — Envoyer une consigne texte à l’agent.

Flux SSE : mise à jour sans recharger la page (GET /documents/api/stream-findings).

Barre du haut (toutes les pages)

Bandeau nouveautés : sous la barre de titre, texte défilant — cliquez pour le panneau détaillé ou consultez ce guide.

Recherche : champ « Rechercher » — saisissez au moins 2 caractères pour chercher chantiers, documents, etc. dans toute l’app.

Mode urgence (en bas du menu) : raccourci pour concentrer l’attention sur les alertes et la checklist matériel.

Vue opérationnelle

• Dashboard — Vue d’ensemble : indicateurs, bloc livraisons type Rexel (cut-off 18h), matériel à traiter, raccourcis. C’est le point de départ de la journée.
• Mes tâches — Liste des tâches à faire ; cochez-les au fil de l’eau.
• Rapport semaine — Génération de synthèse / export pour le suivi de période.
• Pilotage chantiers — Raccourci vers le tableau « Pilotage » sur le dashboard : statut prêt / risque / bloqué par chantier, étape en cours et alertes (matériel, engins).

Chantiers & relations

• Chantiers — Créez et ouvrez les fiches. Sur une fiche : infos, photos par phase (AVANT / PENDANT / APRÈS), engins affectés, texte « matériels », et surtout le pilotage : workflow en 5 étapes (préparation → … → ajustements). Une étape ne se débloque que si la précédente est « Terminé ». Le tableau matériel structuré (materiels_json) alimente le dashboard : cochez commandé / livré sur la fiche ou via les imports.
• Groupements — Regroupe plusieurs chantiers (stocks, tournées, calculs communs).
• Clients & donneurs — Référentiels liés aux chantiers (sélection sur la fiche chantier).

Logistique & matériel

• Stock & transport (hub) — Point d’entrée unique vers groupements (carte), simulateur transport, logistique transport, checklist livraisons, stock multi-sites, transferts, ERP logistique et commande WhatsApp.
• Suivi locations engins — Fiches IA, alertes J-7/J-3, décisions Prolonger/Pause/Stopper (/engins/suivi).
• Coûts temps réel — Synthèse des coûts liés aux engins en location ; badge si alertes proches.
• Engins & locations — Catalogue engins, mouvements, affectation aux chantiers.
• Planning Gantt — Vue temporelle des affectations.
• Équipes — Équipes terrain, lien possible avec chantiers.
• Fournisseurs — Fiches fournisseurs (locations, matériel).
• Planning livraisons — Calendrier des livraisons.
• Checklist livraisons — (Aussi depuis le hub.) Validation étape par étape des livraisons sur chantier.
• Simulateur transport — (Hub.) Estimation / simulation et dispatch stock lié aux tournées.
• Logistique transport — (Hub.) Dépôts, demandes d’engin, envois PDF / email / SMS.
• Stock multi-sites — (Hub.) Stocks dépôts : quantités ± ou fixe. Alias produits pour les messages WhatsApp.
• Transferts stock — (Hub.) Lignes désignation ; quantité, puis Exécuter : débit / crédit entre sites.
• ERP logistique — (Hub.) Besoins et flux stocks côté ERP.
• Commande WhatsApp — (Hub.) Message structuré vers le matériel chantier.

Documents & signature

• Upload PDF — Déposez des PDF dans la base pour les classer et les retrouver.
• Devis & factures — Suivi des devis / factures liés au cycle commercial.
• Listes matériel — Listes type documents matériel.
• Historique signé — Documents déjà signés.
• Signature & tampons — Apposer signature / tampon sur PDF (paramètres par défaut dans Paramètres).

Importer

• Dossier PDF (DE) — Extraction / import depuis un dossier d’exécution PDF (données chantier, matériel, géolocalisation selon l’écran).
• Tournée livraison — Import de fichier de tournée pour alimenter la logistique.
• Offre / contrat PDF — Import depuis offres ou contrats PDF (données engins / pièces).
• Dossier ZIP — Import groupé de pièces / données packagées en ZIP.

En complément : Commande WhatsApp pour du texte structuré vers le matériel chantier.

Carte

• Carte terrain — Google Maps : chantiers, engins, équipes. Nécessite GOOGLE_MAPS_API_KEY dans .env (API Maps JavaScript). Les suggestions « à proximité » utilisent encore des données OpenStreetMap côté serveur.

Outils & IA

• Assistant lecture — Analyse de documents (IA) selon la configuration API (voir .env).
• Messagerie IA — Connexion boîte mail, tri / réponses assistées.

Tarifs nacelles

• Catalogue — Référentiel matériel / nacelles.
• Simulateur coût — Simulation de coûts selon durée et type d’engin.

Système

• Paramètres — Société, équipe, TVA, alertes engins ; SMTP pour les mails automatiques ; tampon / signature PDF ; bloc Dashboard — équipe & Rexel (coût jour équipe, mémo chef, journal commandes).
• Alertes email — Résumé du service d’alertes planifiées + lien vers la configuration SMTP.