@sinoia/hubdoc-tools 1.0.4 → 1.2.1

package/CHANGELOG.md

@@ -1,134 +0,0 @@
-# Changelog
-
-All notable changes to the HubDoc Tools project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.2.0] - 2025-01-XX
-
-### Added
-- **Auto-Classify Feature**: Added support for per-document auto-classification
-  - New `Auto Classify` column in CSV mapping files (default: `false`)
-  - Supports `true`/`false`, `1`/`0`, `yes`/`no` values
-  - When set to `true`, document is automatically classified by HubDoc
-  - Parameter passed to API via `auto_classify` form field
-  - Integrated into `DocumentMapping` interface
-- **BulkUpload Integration**: Full support for Corex API BulkUpload workflow
-  - Creates a single BulkUpload session at the start of each import
-  - Tracks upload progress with real-time statistics (processed/successful/failed files)
-  - Displays detailed BulkUpload status in import summary
-  - Supports concurrent uploads with shared BulkUpload ID
-- **Resume Capability**: Import process can be stopped and resumed
-  - CSV tracking with status columns (`pending`, `processing`, `completed`, `failed`)
-  - Automatic detection of existing BulkUpload sessions
-  - Skips already completed files on resume
-  - Preserves Document IDs and error messages in CSV
-  - Stores BulkUpload ID for session continuity
-- **Enhanced Import Summary**: Added BulkUpload status section with ID, progress percentage, and file counts
-- **API Types**: New `HubDocBulkUpload` interface matching Corex API schema
-- **API Service Methods**:
-  - `createBulkUpload()`: Create BulkUpload session with total file count
-  - `getBulkUploadStatus()`: Retrieve real-time BulkUpload status
-- **CSV Manager Methods**:
-  - `updateMappingStatus()`: Update individual file status in CSV
-  - `updateAllMappingsWithBulkUploadId()`: Link all files to same BulkUpload session
-
-### Changed
-- **Import Workflow**: Refactored to use BulkUpload-first approach
-  - `createBulkUpload()` called before file processing (or reuses existing)
-  - All uploaded files attached to the same BulkUpload session
-  - Final status retrieved via `getBulkUploadStatus()`
-  - CSV updated in real-time after each file upload
-- **Upload Field**: Changed from `uploaded_files[]` to `uploaded_file` (singular) to match Corex API v1 specification
-- **API Service Methods**:
-  - `uploadDocument()` now accepts optional `bulkUploadId` parameter
-  - `importDocument()` passes `bulkUploadId` to upload operation
-- **CSV Schema**: Extended with tracking columns
-  - `Auto Classify`: Enable auto-classification per document (true/false, default: false)
-  - `Status`: Current file status (pending/processing/completed/failed)
-  - `Error`: Error message if upload failed
-  - `Document ID`: Corex document ID after successful upload
-  - `Bulk Upload ID`: Associated BulkUpload session ID
-
-### Technical Details
-- **BulkUpload Features**:
-  - Single session creation with total file count
-  - Source automatically set to `hubdoc-tools`
-  - Support for concurrent jobs sharing the same BulkUpload
-  - Progress tracking: `pending` → `in_progress` → `completed`/`failed`
-  - Real-time statistics: total, processed, successful, failed files
-  - Session resumption maintains same BulkUpload ID
-- **Parallel Import**: Works seamlessly with `--concurrent-jobs` option
-  - All workers share the same BulkUpload ID
-  - Backend atomically updates file counts
-  - Final status reflects aggregated results from all concurrent uploads
-  - CSV updates are thread-safe (sequential writes)
-- **Resume Workflow**:
-  1. Detect existing BulkUpload ID in CSV
-  2. Fetch current status from API
-  3. Filter out completed files
-  4. Resume upload with same BulkUpload session
-  5. Continue updating CSV in real-time
-
-## [1.1.0] - 2024-01-XX
-
-### Added
-- **Flexible Source Directories**: New `--source` option for import command as alternative to `--direct`
-- **Enhanced generate-mapping**: Support for `--source` option and positional arguments
-- **Core Plugin**: New plugin for importing documents from Core DMS with local buffer strategy
-- **Workflow Examples**: Added documentation for common usage scenarios
-- **Comprehensive Test Suite**: Added Jest testing framework with TypeScript support
-- **Path Validation**: Improved validation for conflicting options and invalid paths
-
-### Changed
-- `generate-mapping` command now supports optional source directory argument
-- Improved help messages with examples for all commands
-- Enhanced error messages for better user experience
-
-### Fixed
-- Better handling of absolute vs relative paths
-- Validation prevents conflicting options (`--direct` and `--source` together)
-
-### Documentation
-- Updated README with new options and workflow examples
-- Added Core plugin documentation and examples
-- Added changelog for version tracking
-- Enhanced command reference with detailed examples
-
-### Technical Details
-- **Core Plugin Features**:
-  - Bearer token authentication with Core API
-  - Paginated document scanning via `/api/d2/docs`
-  - Local buffer strategy for document transfer
-  - Metadata preservation (Core ID, type, tags, etc.)
-  - Support for filtering by size, date, and MIME type
-
-## [1.0.0] - 2024-01-XX
-
-### Added
-- Initial release of HubDoc Tools
-- **API v2 Integration**: Full integration with official HubDoc Swagger API
-- **Plugin System**: Extensible architecture for external sources (OneDrive, Google Drive, Dropbox)
-- **Direct Import Mode**: Import all files from directory with folder structure preservation
-- **Mapping Import Mode**: CSV-based import with custom metadata and permissions
-- **Interactive Mode**: Guided workflows with validation and previews
-- **Export Capabilities**: Scan and export documents from HubDoc
-- **Configuration Wizard**: First-time setup for API credentials
-- **Permission Management**: Support for user and group permissions on documents
-- **Project Integration**: Support for HubDoc projects and classification plans
-
-### Features
-- Command-line interface with multiple operation modes
-- CSV mapping file generation and validation
-- Automatic folder creation in HubDoc
-- Progress tracking for import/export operations
-- Error handling and detailed logging
-- TypeScript implementation with full type safety
-
-### Commands
-- `generate-mapping`: Generate CSV mapping files from directory structures
-- `import`: Import documents using direct or mapping modes
-- `export`: Export documents from HubDoc with mapping support
-- `config`: Interactive configuration wizard
-- `plugins`: Plugin management and external source integration

package/DEMO-DOCUMENTATION.html

@@ -1,356 +0,0 @@
-<h1 id="hubdoc-tool---cas-dusage-import-massif-btp">🏗️ HubDoc Tool - Cas
-d’Usage : Import Massif BTP</h1>
-<h2 id="scénario-groupe-immobilier-bautech">📋 Scénario : Groupe
-Immobilier BAUTECH</h2>
-<p><strong>Client :</strong> BAUTECH Construction &amp; Promotion
-Immobilière<br />
-<strong>Secteur :</strong> BTP, Promotion immobilière, Gestion de
-patrimoine<br />
-<strong>Volume :</strong> 15,000 documents à importer<br />
-<strong>Projets :</strong> 8 programmes immobiliers en cours + archives
-historiques</p>
-<h3 id="objectif">🎯 Objectif</h3>
-<p>Centraliser tous les documents de construction dans HubDoc pour
-faciliter : - Suivi des chantiers en temps réel - Conformité
-réglementaire (RT2020, normes sécurité) - Gestion des sous-traitants et
-fournisseurs - Archivage légal (10 ans minimum)</p>
-<hr />
-<h2 id="répartition-des-documents">📊 Répartition des Documents</h2>
-<pre><code>📁 BAUTECH - Documents (15,000 total)
-├── 🏢 Projets Actifs (8,500 docs)
-│   ├── Les Jardins de Meudon (1,800 docs)
-│   ├── Résidence Harmony Levallois (2,100 docs)
-│   ├── Éco-Quartier Boulogne (1,900 docs)
-│   ├── Villa Prestige Neuilly (1,200 docs)
-│   ├── Loft Industrial Montreuil (700 docs)
-│   ├── Green Towers La Défense (600 docs)
-│   └── Campus Student Créteil (200 docs)
-│
-├── 📋 Administration (3,200 docs)
-│   ├── Contrats &amp; Marchés (1,100 docs)
-│   ├── Certifications &amp; Agréments (800 docs)
-│   ├── Assurances &amp; Garanties (700 docs)
-│   └── RH &amp; Formation (600 docs)
-│
-├── 🛠️ Techniques (2,100 docs)
-│   ├── Plans &amp; Études (900 docs)
-│   ├── DOE - Dossiers Ouvrages Exécutés (800 docs)
-│   └── Maintenance &amp; SAV (400 docs)
-│
-└── 📜 Archives (1,200 docs)
-    ├── Projets 2020-2022 (800 docs)
-    └── Documents Historiques (400 docs)</code></pre>
-<hr />
-<h2 id="organisation-hubdoc-domaines-projets">🏢 Organisation HubDoc :
-Domaines &amp; Projets</h2>
-<h3 id="domaines-notions-métier-transverses">🌐
-<strong>Domaines</strong> (Notions Métier Transverses)</h3>
-<p>Les domaines regroupent les documents par expertise métier,
-indépendamment des projets :</p>
-<ul>
-<li><strong>🏗️ BTP &amp; Construction</strong> : Plans, permis, études
-techniques, PV chantier</li>
-<li><strong>💼 Administration</strong> : Contrats, assurances, RH,
-comptabilité<br />
-</li>
-<li><strong>🔧 Technique &amp; Maintenance</strong> : DOE, manuels,
-rapports, certifications</li>
-<li><strong>📜 Légal &amp; Conformité</strong> : Autorisations, audits,
-certifications ISO</li>
-</ul>
-<h3 id="projets-avec-plans-de-classement-spécifiques">🏢
-<strong>Projets</strong> (avec Plans de Classement Spécifiques)</h3>
-<p>Chaque projet dispose de son plan de classement adapté au type
-d’opération :</p>
-<p><strong>Projet: 🏡 Les Jardins de Meudon</strong></p>
-<pre><code>📁 Plan de Classement BTP
-├── 📜 Administrative/
-│   ├── Permis &amp; Autorisations
-│   ├── Contrats &amp; Marchés
-│   └── Assurances
-├── 🏗️ Technique/
-│   ├── Plans Architecture
-│   ├── Plans Structure  
-│   ├── Plans Fluides
-│   └── Études &amp; Calculs
-├── 💰 Financier/
-│   ├── Devis
-│   ├── Factures
-│   └── Situations Travaux
-└── 🔍 Suivi/
-    ├── PV Chantier
-    ├── PV Réception
-    └── Photos &amp; Constats</code></pre>
-<p><strong>Projet: 🏢 Résidence Harmony Levallois</strong> (même
-structure)<br />
-<strong>Projet: 🌃 Éco-Quartier Boulogne</strong> (même structure)<br />
-<strong>Projet: 📁 BAUTECH Corporate</strong> (documents transverses
-groupe)</p>
-<hr />
-<h2 id="exemple-de-mapping-csv">📝 Exemple de Mapping CSV</h2>
-<h3 id="définition-des-projets">🆕 <strong>Définition des
-Projets</strong></h3>
-<p>Le CSV peut contenir des lignes spéciales pour <strong>créer des
-projets</strong> avec leur plan de classement :</p>
-<p><strong>Format :</strong> - <strong>File Path</strong> : Chemin vers
-le dossier projet (terminé par <code>/</code>) - <strong>Target
-Folder</strong> : <code>CREATE_PROJECT</code> (mot-clé spécial) -
-<strong>Workspace</strong> : Nom du projet à créer (champ technique) -
-<strong>Domain</strong> : Domaine métier associé - <strong>Plan
-Classement</strong> : Template de plan de classement à appliquer</p>
-<p><strong>Plans de Classement Disponibles :</strong> -
-<code>BTP_PROMOTION_IMMOBILIERE</code> : Plan standard pour projets
-immobiliers - <code>BTP_INFRASTRUCTURE</code> : Plan pour travaux
-publics/infrastructures<br />
-- <code>ADMINISTRATION_GENERALE</code> : Plan pour documents corporate -
-<code>MAINTENANCE_TECHNIQUE</code> : Plan pour gestion maintenance -
-<code>JURIDIQUE_CONTENTIEUX</code> : Plan pour dossiers juridiques</p>
-<pre class="csv"><code>File Path,Target Folder,Workspace,Domain,Plan Classement,Metadata (JSON),Read Permissions,Write Permissions
-# === DÉFINITION DES PROJETS ===
-./docs/projets/meudon/,CREATE_PROJECT,Les Jardins de Meudon,BTP &amp; Construction,BTP_PROMOTION_IMMOBILIERE,&quot;{\&quot;type\&quot;:\&quot;projet\&quot;,\&quot;client\&quot;:\&quot;Ville de Meudon\&quot;,\&quot;surface\&quot;:\&quot;15000m2\&quot;,\&quot;budget\&quot;:8500000}&quot;,groups:direction,architectes,conducteurs_travaux,groups:direction,architectes
-./docs/projets/levallois/,CREATE_PROJECT,Résidence Harmony Levallois,BTP &amp; Construction,BTP_PROMOTION_IMMOBILIERE,&quot;{\&quot;type\&quot;:\&quot;projet\&quot;,\&quot;client\&quot;:\&quot;SCI Harmony\&quot;,\&quot;surface\&quot;:\&quot;8500m2\&quot;,\&quot;budget\&quot;:12000000}&quot;,groups:direction,architectes,conducteurs_travaux,groups:direction,architectes
-./docs/admin/,CREATE_PROJECT,BAUTECH Corporate,Administration,ADMINISTRATION_GENERALE,&quot;{\&quot;type\&quot;:\&quot;projet\&quot;,\&quot;description\&quot;:\&quot;Documents transverses groupe\&quot;}&quot;,groups:direction,rh,comptabilite,groups:direction
-
-# === DOCUMENTS ===
-./docs/projets/meudon/plans/plan_masse_v3.pdf,Technique/Plans Architecture,Les Jardins de Meudon,BTP &amp; Construction,,&quot;{\&quot;type\&quot;:\&quot;plan\&quot;,\&quot;version\&quot;:\&quot;3.0\&quot;,\&quot;date\&quot;:\&quot;2024-03-15\&quot;,\&quot;architecte\&quot;:\&quot;Cabinet Dubois\&quot;}&quot;,users:j.martin,m.dupont|groups:architectes,conducteurs_travaux,groups:architectes
-./docs/projets/meudon/permis/pc_2024_001.pdf,Administrative/Permis &amp; Autorisations,Les Jardins de Meudon,Légal &amp; Conformité,,&quot;{\&quot;type\&quot;:\&quot;permis_construire\&quot;,\&quot;numero\&quot;:\&quot;PC-2024-001\&quot;,\&quot;commune\&quot;:\&quot;Meudon\&quot;,\&quot;statut\&quot;:\&quot;accordé\&quot;}&quot;,groups:direction,juridique,conducteurs_travaux,groups:direction
-./docs/projets/levallois/devis/gros_oeuvre_entreprise_martin.pdf,Financier/Devis,Résidence Harmony Levallois,BTP &amp; Construction,,&quot;{\&quot;type\&quot;:\&quot;devis\&quot;,\&quot;corps_etat\&quot;:\&quot;gros_oeuvre\&quot;,\&quot;entreprise\&quot;:\&quot;Martin TP\&quot;,\&quot;montant\&quot;:285000}&quot;,users:c.bernard,a.rousseau|groups:conducteurs_travaux,groups:conducteurs_travaux,direction
-./docs/projets/boulogne/pv/pv_reception_lot_3.pdf,Suivi/PV Réception,Éco-Quartier Boulogne,BTP &amp; Construction,,&quot;{\&quot;type\&quot;:\&quot;pv_reception\&quot;,\&quot;lot\&quot;:\&quot;3_electricite\&quot;,\&quot;date_reception\&quot;:\&quot;2024-02-20\&quot;,\&quot;entreprise\&quot;:\&quot;Elec Pro\&quot;}&quot;,groups:conducteurs_travaux,maitrise_oeuvre,quality,groups:conducteurs_travaux
-./docs/admin/contrats/marche_public_ville_paris.pdf,Contrats &amp; Marchés,BAUTECH Corporate,Administration,,&quot;{\&quot;type\&quot;:\&quot;marche_public\&quot;,\&quot;client\&quot;:\&quot;Ville de Paris\&quot;,\&quot;montant\&quot;:1200000,\&quot;duree_mois\&quot;:18}&quot;,groups:direction,commercial,groups:direction
-./docs/technique/doe/doe_chauffage_meudon.pdf,Documentation Technique,Les Jardins de Meudon,Technique &amp; Maintenance,,&quot;{\&quot;type\&quot;:\&quot;doe\&quot;,\&quot;lot\&quot;:\&quot;chauffage\&quot;,\&quot;projet\&quot;:\&quot;meudon\&quot;,\&quot;entreprise\&quot;:\&quot;Thermique Plus\&quot;}&quot;,users:tech.leader|groups:maintenance,technique,groups:technique</code></pre>
-<hr />
-<h2 id="workflow-dimport">⚙️ Workflow d’Import</h2>
-<h3 id="phase-1-préparation-j-7">📋 Phase 1 : Préparation (J-7)</h3>
-<div class="sourceCode" id="cb4"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="co"># 1. Scan du serveur de fichiers BAUTECH</span></span>
-<span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a><span class="ex">hubdoc-tool</span> generate-mapping /srv/bautech/documents/</span></code></pre></div>
-<p><strong>Résultat :</strong></p>
-<pre><code>🔍 Scanning directory: /srv/bautech/documents/
-📁 Found 14,847 files to import
-✅ Mapping file generated: mapping.csv
-📝 Edit the file to specify target folders, projets, and permissions</code></pre>
-<h3 id="phase-2-configuration-mapping-j-5-à-j-1">📋 Phase 2 :
-Configuration &amp; Mapping (J-5 à J-1)</h3>
-<p><strong>Équipe mobilisée :</strong> - <strong>Chef de Projet
-:</strong> Mapping des dossiers et projets - <strong>Responsable Qualité
-:</strong> Définition des métadonnées<br />
-- <strong>DSI :</strong> Configuration des permissions utilisateurs</p>
-<p><strong>Exemple d’enrichissement CSV :</strong></p>
-<pre class="csv"><code># Avant (généré automatiquement)
-./srv/bautech/plans/meudon/archi/facade_sud.pdf,,,
-
-# Après (enrichi par l&#39;équipe)  
-./srv/bautech/plans/meudon/archi/facade_sud.pdf,Les Jardins de Meudon/Plans,BAUTECH Production,&quot;{\&quot;type\&quot;:\&quot;plan\&quot;,\&quot;vue\&quot;:\&quot;facade_sud\&quot;,\&quot;phase\&quot;:\&quot;exe\&quot;}&quot;,groups:architectes,maitrise_oeuvre,groups:architectes</code></pre>
-<h3 id="phase-3-import-en-production-j-day">📋 Phase 3 : Import en
-Production (J-Day)</h3>
-<div class="sourceCode" id="cb7"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="co"># Configuration API HubDoc</span></span>
-<span id="cb7-2"><a href="#cb7-2" aria-hidden="true" tabindex="-1"></a><span class="ex">hubdoc-tool</span> config</span></code></pre></div>
-<pre><code>🔧 HubDoc Importer Configuration
-HubDoc API URL: https://bautech.hubdoc.sinoia.cloud/api/v1
-API Token: [HIDDEN]
-✅ Configuration saved to .hubdoc-config.json</code></pre>
-<div class="sourceCode" id="cb9"><pre
-class="sourceCode bash"><code class="sourceCode bash"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a><span class="co"># Lancement de l&#39;import</span></span>
-<span id="cb9-2"><a href="#cb9-2" aria-hidden="true" tabindex="-1"></a><span class="ex">hubdoc-tool</span> import <span class="at">--mapping</span> mapping_bautech_15k.csv</span></code></pre></div>
-<hr />
-<h2 id="métriques-dimport-en-temps-réel">📈 Métriques d’Import en Temps
-Réel</h2>
-<h3 id="dashboard-dimport">📊 Dashboard d’Import</h3>
-<pre><code>🚀 HubDoc Import - BAUTECH Construction
-📅 Date: 15/03/2024 09:30:00
-⏱️  Durée: 2h 34m 18s
-
-📊 Progression Globale
-██████████████████████████████████████ 100%
-15,000 / 15,000 documents traités
-
-✅ Succès:        14,847 (98.98%)
-❌ Échecs:           153 (1.02%)
-⚠️  Avertissements:   89
-
-💾 Volume traité: 47.3 GB
-📈 Vitesse moy.: 97 docs/min
-🏆 Pic performance: 145 docs/min</code></pre>
-<h3 id="détail-par-projet">📋 Détail par Projet</h3>
-<pre><code>📁 BAUTECH Production
-   ├── Les Jardins de Meudon      ✅ 1,798/1,800 (99.9%)
-   ├── Résidence Harmony          ✅ 2,095/2,100 (99.8%)  
-   ├── Éco-Quartier Boulogne     ✅ 1,887/1,900 (99.3%)
-   ├── Villa Prestige Neuilly     ✅ 1,200/1,200 (100%)
-   ├── Administration             ✅ 3,156/3,200 (98.6%)
-   └── Technique                  ✅ 2,089/2,100 (99.5%)
-
-📁 BAUTECH Archives              ✅ 1,177/1,200 (98.1%)</code></pre>
-<h3 id="erreurs-avertissements">🚨 Erreurs &amp; Avertissements</h3>
-<pre><code>❌ Échecs d&#39;import (153 docs):
-  • 89x Fichiers corrompus (PDF endommagés)
-  • 34x Permissions insuffisantes (serveur source)
-  • 30x Fichiers trop volumineux (&gt;50MB)
-
-⚠️  Avertissements (89 docs):
-  • 45x Métadonnées JSON invalides (corrigées auto)
-  • 28x Utilisateurs inexistants (permissions ignorées)  
-  • 16x Doublons détectés (suffixe ajouté)</code></pre>
-<hr />
-<h2 id="configuration-technique">🔧 Configuration Technique</h2>
-<h3 id="architecture-déployée">🌐 Architecture Déployée</h3>
-<pre><code>🏢 BAUTECH Infrastructure
-│
-├── 🖥️  Serveur HubDoc Cloud
-│   ├── URL: https://bautech.hubdoc.sinoia.cloud
-│   ├── Stockage: 500GB SSD
-│   └── Backup: 3x/jour (Paris + Londres)
-│
-├── 🔐 Active Directory Integration  
-│   ├── SSO via SAML 2.0
-│   ├── Groupes: 12 corps d&#39;état
-│   └── Sync auto utilisateurs
-│
-└── 📱 Applications
-    ├── Web App (Chrome, Edge, Safari)
-    ├── Mobile iOS/Android  
-    └── Plugin AutoCAD/Revit</code></pre>
-<h3 id="gestion-des-permissions">👥 Gestion des Permissions</h3>
-<div class="sourceCode" id="cb14"><pre
-class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb14-1"><a href="#cb14-1" aria-hidden="true" tabindex="-1"></a><span class="co"># Configuration des groupes BAUTECH</span></span>
-<span id="cb14-2"><a href="#cb14-2" aria-hidden="true" tabindex="-1"></a><span class="fu">groups</span><span class="kw">:</span></span>
-<span id="cb14-3"><a href="#cb14-3" aria-hidden="true" tabindex="-1"></a><span class="at">  </span><span class="fu">direction</span><span class="kw">:</span></span>
-<span id="cb14-4"><a href="#cb14-4" aria-hidden="true" tabindex="-1"></a><span class="at">    </span><span class="fu">permissions</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">read</span><span class="kw">,</span><span class="at"> write</span><span class="kw">,</span><span class="at"> admin</span><span class="kw">]</span></span>
-<span id="cb14-5"><a href="#cb14-5" aria-hidden="true" tabindex="-1"></a><span class="at">    </span><span class="fu">users</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">p.dubois</span><span class="kw">,</span><span class="at"> m.lambert</span><span class="kw">,</span><span class="at"> c.martin</span><span class="kw">]</span></span>
-<span id="cb14-6"><a href="#cb14-6" aria-hidden="true" tabindex="-1"></a><span class="at">    </span></span>
-<span id="cb14-7"><a href="#cb14-7" aria-hidden="true" tabindex="-1"></a><span class="at">  </span><span class="fu">conducteurs_travaux</span><span class="kw">:</span></span>
-<span id="cb14-8"><a href="#cb14-8" aria-hidden="true" tabindex="-1"></a><span class="at">    </span><span class="fu">permissions</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">read</span><span class="kw">,</span><span class="at"> write</span><span class="kw">]</span><span class="at">  </span></span>
-<span id="cb14-9"><a href="#cb14-9" aria-hidden="true" tabindex="-1"></a><span class="at">    </span><span class="fu">users</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">j.martin</span><span class="kw">,</span><span class="at"> a.rousseau</span><span class="kw">,</span><span class="at"> c.bernard</span><span class="kw">,</span><span class="at"> m.durand</span><span class="kw">]</span></span>
-<span id="cb14-10"><a href="#cb14-10" aria-hidden="true" tabindex="-1"></a><span class="at">    </span></span>
-<span id="cb14-11"><a href="#cb14-11" aria-hidden="true" tabindex="-1"></a><span class="at">  </span><span class="fu">architectes</span><span class="kw">:</span></span>
-<span id="cb14-12"><a href="#cb14-12" aria-hidden="true" tabindex="-1"></a><span class="at">    </span><span class="fu">permissions</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">read</span><span class="kw">,</span><span class="at"> write</span><span class="kw">]</span></span>
-<span id="cb14-13"><a href="#cb14-13" aria-hidden="true" tabindex="-1"></a><span class="at">    </span><span class="fu">users</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">s.architect</span><span class="kw">,</span><span class="at"> l.designer</span><span class="kw">,</span><span class="at"> m.urbaniste</span><span class="kw">]</span></span>
-<span id="cb14-14"><a href="#cb14-14" aria-hidden="true" tabindex="-1"></a><span class="at">    </span></span>
-<span id="cb14-15"><a href="#cb14-15" aria-hidden="true" tabindex="-1"></a><span class="at">  </span><span class="fu">bureaux_etudes</span><span class="kw">:</span></span>
-<span id="cb14-16"><a href="#cb14-16" aria-hidden="true" tabindex="-1"></a><span class="at">    </span><span class="fu">permissions</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">read</span><span class="kw">,</span><span class="at"> write</span><span class="kw">]</span></span>
-<span id="cb14-17"><a href="#cb14-17" aria-hidden="true" tabindex="-1"></a><span class="at">    </span><span class="fu">users</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">tech.leader</span><span class="kw">,</span><span class="at"> calc.struct</span><span class="kw">,</span><span class="at"> ing.fluides</span><span class="kw">]</span></span>
-<span id="cb14-18"><a href="#cb14-18" aria-hidden="true" tabindex="-1"></a><span class="at">    </span></span>
-<span id="cb14-19"><a href="#cb14-19" aria-hidden="true" tabindex="-1"></a><span class="at">  </span><span class="fu">sous_traitants</span><span class="kw">:</span></span>
-<span id="cb14-20"><a href="#cb14-20" aria-hidden="true" tabindex="-1"></a><span class="at">    </span><span class="fu">permissions</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">read</span><span class="kw">]</span></span>
-<span id="cb14-21"><a href="#cb14-21" aria-hidden="true" tabindex="-1"></a><span class="at">    </span><span class="fu">users</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">ext.martin</span><span class="kw">,</span><span class="at"> ext.elecpro</span><span class="kw">,</span><span class="at"> ext.thermique</span><span class="kw">]</span></span></code></pre></div>
-<hr />
-<h2 id="guide-dutilisation-post-import">📚 Guide d’Utilisation
-Post-Import</h2>
-<h3 id="recherche-avancée-hubdoc">🔍 Recherche Avancée HubDoc</h3>
-<p><strong>Fonctionnalités natives HubDoc (post-import) :</strong></p>
-<p><strong>🤖 Recherche Intelligente par IA</strong></p>
-<pre><code># Recherche sémantique sur le contenu OCR
-&quot;façade sud Meudon&quot; → trouve tous les plans même sans ces mots exacts
-&quot;devis électricité &gt; 50000€&quot; → utilise l&#39;IA pour détecter montants
-&quot;permis accordé 2024&quot; → recherche dans le contenu OCR des documents</code></pre>
-<p><strong>📊 Filtres Métadonnées (enrichies par notre
-import)</strong></p>
-<pre><code># Utilise les métadonnées injectées lors de l&#39;import
-metadata.type:&quot;plan&quot; AND metadata.projet:&quot;Meudon&quot;
-metadata.entreprise:&quot;Martin TP&quot; AND metadata.montant:&gt;100000
-folder:&quot;Les Jardins de Meudon&quot; AND status:&quot;validé&quot;</code></pre>
-<p><strong>🔍 Recherche OCR dans Documents Scannés</strong></p>
-<pre><code># HubDoc extrait automatiquement le texte des PDF scannés
-&quot;article 15 du CCTP&quot; → trouve dans documents scannés
-&quot;réception définitive&quot; → recherche OCR multi-formats</code></pre>
-<h3 id="workflows-hubdoc-post-import">📋 Workflows HubDoc
-(Post-Import)</h3>
-<p><strong>Ce que fait notre outil d’import :</strong> - ✅ Place les
-documents dans les bons dossiers - ✅ Applique les permissions
-read/write - ✅ Injecte les métadonnées initiales (projet, type,
-entreprise…)</p>
-<p><strong>Ce que fait HubDoc automatiquement après :</strong></p>
-<p><strong>🏗️ Validation de Plans</strong> 1. <strong>Import</strong> →
-Documents placés dans “Plans/À Classer” 2. <strong>IA HubDoc</strong> →
-Classification automatique par type de plan 3. <strong>OCR</strong> →
-Extraction des cotes, références, dates 4. <strong>Workflow</strong> →
-Circuit de validation selon les règles métier 5.
-<strong>Notification</strong> → Alerts automatiques aux équipes
-concernées 6. <strong>Indexation</strong> → Recherche sémantique sur le
-contenu technique</p>
-<p><strong>💰 Circuit Devis</strong> 1. <strong>Import</strong> →
-Documents avec métadonnées de base (entreprise, projet) 2. <strong>IA
-HubDoc</strong> → Détection automatique des montants dans le PDF 3.
-<strong>Classification</strong> → Tri par corps d’état et seuils de
-validation 4. <strong>Workflow</strong> → Routage selon montant
-(Direction si &gt;100k€) 5. <strong>OCR Avancé</strong> → Extraction des
-détails techniques et prix 6. <strong>Signature</strong> → Circuit
-d’approbation électronique intégré</p>
-<p><strong>🔄 Gestion Automatique des Versions</strong> 1.
-<strong>Import initial</strong> → Version 1.0 avec métadonnées 2.
-<strong>IA HubDoc</strong> → Détection automatique des révisions 3.
-<strong>Liens intelligents</strong> → Relations entre plans et devis 4.
-<strong>Historique</strong> → Traçabilité complète des modifications</p>
-<hr />
-<h2 id="répartition-des-rôles-import-tool-vs-hubdoc">🔄 Répartition des
-Rôles : Import Tool vs HubDoc</h2>
-<h3 id="hubdoc-importer-notre-outil">🛠️ <strong>HubDoc Importer</strong>
-(Notre Outil)</h3>
-<p><strong>✅ Ce qu’il fait :</strong> - <strong>Import massif</strong>
-de documents existants (15k+ en quelques heures) - <strong>Mapping
-CSV</strong> pour organisation précise des dossiers -
-<strong>Permissions granulaires</strong> read/write par
-utilisateur/groupe - <strong>Métadonnées initiales</strong> (projet,
-type, entreprise, montant…) - <strong>Création automatique</strong> des
-dossiers et projets - <strong>Gestion des erreurs</strong> et reprise
-d’import - <strong>Intégration API</strong> HubDoc native</p>
-<p><strong>🎯 Idéal pour :</strong> - Migration depuis serveurs de
-fichiers - Centralisation de documents éparpillés<br />
-- Setup initial avec permissions complexes - Import one-shot de gros
-volumes</p>
-<h3 id="hubdoc-solution-native">🤖 <strong>HubDoc</strong> (Solution
-Native)</h3>
-<p><strong>✅ Ce qu’il fait automatiquement après l’import
-:</strong></p>
-<p><strong>🔍 Intelligence Artificielle</strong> - <strong>OCR
-avancé</strong> : Extraction texte dans tous formats (PDF scannés,
-images, CAD) - <strong>Classification IA</strong> : Détection
-automatique du type de document - <strong>Extraction
-métadonnées</strong> : Montants, dates, références techniques -
-<strong>Recherche sémantique</strong> : Compréhension du contexte
-technique</p>
-<p><strong>📋 Gestion Documentaire Avancée</strong> - <strong>Plans de
-classement</strong> intelligents par métier BTP - <strong>Workflows
-automatisés</strong> : Validation selon règles métier - <strong>Gestion
-des versions</strong> : Détection automatique des révisions -
-<strong>Relations documents</strong> : Liens intelligents plan ↔︎ devis ↔︎
-PV</p>
-<p><strong>👥 Collaboration &amp; Workflows</strong> -
-<strong>Notifications contextuelles</strong> : Alerts selon le rôle
-utilisateur - <strong>Signature électronique</strong> intégrée -
-<strong>Tableau de bord temps réel</strong> : KPIs par projet/chantier -
-<strong>Mobile app</strong> : Capture et consultation terrain</p>
-<p><strong>🔒 Sécurité &amp; Conformité</strong> - <strong>Traçabilité
-complète</strong> : Qui, quand, quoi sur chaque document -
-<strong>Sauvegarde cloud</strong> haute disponibilité (99.9%) -
-<strong>Conformité légale</strong> : Archivage réglementaire 10 ans BTP
-- <strong>Intégrations</strong> : Sage, AutoCAD, logiciels métier</p>
-<h2 id="roadmap-évolutions">🎯 Roadmap Évolutions</h2>
-<h3 id="import-tool---prochaines-versions">🚀 <strong>Import
-Tool</strong> - Prochaines versions</h3>
-<ul class="task-list">
-<li><label><input type="checkbox" /><strong>Import incrémental</strong>
-: Synchronisation serveurs de fichiers</label></li>
-<li><label><input type="checkbox" /><strong>Templates métier</strong> :
-Configurations pré-définies (BTP, juridique, santé)</label></li>
-<li><label><input type="checkbox" /><strong>API avancée</strong> :
-Intégration directe logiciels métier</label></li>
-<li><label><input type="checkbox" /><strong>Monitoring</strong> :
-Dashboard temps réel des imports</label></li>
-</ul>
-<h3 id="hubdoc-native---évolutions-continues">🤖 <strong>HubDoc
-Native</strong> - Évolutions continues</h3>
-<ul class="task-list">
-<li><label><input type="checkbox" /><strong>IA générative</strong> :
-Résumés automatiques de documents techniques</label></li>
-<li><label><input type="checkbox" /><strong>Réalité augmentée</strong> :
-Consultation plans sur chantier</label></li>
-<li><label><input type="checkbox" /><strong>Prédictif</strong> : Alertes
-avant expiration permis/garanties</label></li>
-<li><label><input type="checkbox" /><strong>Intégration BIM</strong> :
-Liaison directe maquettes numériques</label></li>
-</ul>
-<hr />
-<p><em>Documentation générée le 15/03/2024 - HubDoc Importer
-v1.0.0</em></p>