@sinoia/hubdoc-tools 1.2.1 → 1.3.1

package/README.md

@@ -5,541 +5,348 @@
 [![npm version](https://badge.fury.io/js/%40sinoia%2Fhubdoc-tools.svg)](https://www.npmjs.com/package/@sinoia/hubdoc-tools)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A powerful Node.js command-line tool for bulk document import/export with HubDoc solution. Import documents from local filesystem or cloud sources to HubDoc, or export documents from HubDoc to local filesystem with customizable folder structures.
+Outil CLI puissant pour l'import/export en masse de documents avec HubDoc. Importez depuis le système de fichiers local ou des sources cloud, exportez avec structures personnalisées et metadata XML.
+
+---
 
 ## 📦 Installation
 
 ```bash
-# Global installation (recommended)
+# Installation globale (recommandé)
 npm install -g @sinoia/hubdoc-tools
 
-# Verify installation
+# Vérifier l'installation
 hubdoc-tool --version
 ```
 
-**🚀 Latest Features:**
-- **🔐 Automatic OAuth2**: Zero-config authentication with automatic token refresh
-- **📦 NPM Package**: Install globally with `npm install -g @sinoia/hubdoc-tools`
-- **🔌 API Integration**: Full integration with official HubDoc Swagger/OpenAPI API
-- **🧩 Plugin System**: Extensible architecture for external sources (OneDrive, Google Drive, S3, Dropbox)
-- **✅ Enhanced Validation**: Pre-import validation and detailed error reporting
-- **🎯 Interactive Mode**: Guided workflows with previews and confirmations
-
-### Features
-
-**📥 Import Capabilities**
-- **Direct Import Mode**: Import all files from a directory, preserving folder structure
-- **Mapping Import Mode**: Use CSV mapping file for precise control over document placement
-- **Project Support**: Assign documents to specific projects with classification plans
-- **Permissions Management**: Set user and group permissions (read/write) on imported documents
-
-**📤 Export Capabilities**  
-- **Scan Mode**: Generate export mapping from existing HubDoc documents
-- **Export Mode**: Download documents with customizable folder structure recreation
-- **XML Metadata Export**: Generate `*_metadata.xml` files with HubDoc metadata for each exported document
-- **Project/Domain Filtering**: Export specific subsets of documents
-- **Path Customization**: Specify custom target directories for exported files
-
-**⚙️ General Features**
-- **🔐 Automatic OAuth2**: Zero-config authentication with automatic token refresh and expiration handling
-- **🎯 Interactive & CLI Modes**: Both interactive wizard and command-line interface
-- **📁 Folder Management**: Automatic folder creation in HubDoc
-- **📊 Progress Tracking**: Real-time import/export progress with detailed feedback
-- **🔄 Token Management**: Automatic token refresh before expiration (60s buffer)
-
-## 🚀 Quick Start
-
-### 1. Installation
-```bash
-npm install -g @sinoia/hubdoc-tools
-```
-
-### 2. Configuration
+---
 
-#### Automatic Setup (OAuth2 - Recommended)
+## ⚡ Quick Start
 
-**Configuration is now fully automatic!** Simply set environment variables and run any command:
+### 1. Configuration (30 secondes)
 
 ```bash
-# Set OAuth2 credentials (one time)
+# Définir les credentials OAuth2
 export HUBDOC_API_URL=https://rec.hubdoc.sinoia.cloud
 export HUBDOC_OAUTH_CLIENT_ID=your-client-id
 export HUBDOC_OAUTH_CLIENT_SECRET=your-client-secret
 export HUBDOC_OAUTH_SCOPES="read write"
-
-# Run any command - authentication is automatic!
-hubdoc-tool import --source ./documents
 ```
 
-**What happens automatically:**
-1. ✅ CLI checks for valid token
-2. 🔄 Refreshes token if expired (using refresh_token)
-3. 🌐 Opens browser for OAuth authentication if needed
-4. 💾 Saves token to `.hubdoc-config.json`
-5. ▶️ Proceeds with your command
-
-**No manual token management required!**
-
-#### Alternative: Configuration File
-
-Create a `.hubdoc-config.json` file (environment variables override this):
+**L'authentification est ensuite 100% automatique !** ✨
 
-```json
-{
-  "apiUrl": "https://rec.hubdoc.sinoia.cloud",
-  "clientId": "your-client-id",
-  "clientSecret": "your-client-secret",
-  "scopes": ["read", "write"]
-}
-```
+### 2. Import Basique
 
-Or use `.env` file:
 ```bash
-HUBDOC_API_URL=https://rec.hubdoc.sinoia.cloud
-HUBDOC_OAUTH_CLIENT_ID=your-client-id
-HUBDOC_OAUTH_CLIENT_SECRET=your-client-secret
-HUBDOC_OAUTH_SCOPES="read write"
-```
+# Import direct (préserve la structure)
+hubdoc-tool import --direct ./invoices
 
-### 3. Basic Usage
-```bash
-# Generate mapping from local directory
+# Ou avec mapping CSV
 hubdoc-tool generate-mapping ./documents
-
-# Import documents (authentication is automatic!)
-hubdoc-tool import --source /path/to/documents
 hubdoc-tool import --mapping mapping.csv
-hubdoc-tool import --direct ./invoices
+```
 
-# Export documents
-hubdoc-tool export --scan                    # Generate export mapping
-hubdoc-tool export --mapping export-mapping.csv
-hubdoc-tool export --generate-xml-metadata   # With XML metadata
+### 3. Export
 
-# Interactive mode
-hubdoc-tool --interactive
+```bash
+# Générer mapping depuis HubDoc
+hubdoc-tool export --scan
 
-# Use different engines for import
-hubdoc-tool --engine onedrive
-hubdoc-tool --engine googledrive
-hubdoc-tool --engine s3
+# Exporter avec metadata XML
+hubdoc-tool export --mapping export-mapping.csv --generate-xml-metadata
 ```
 
-### 4. Plugin-based Sources
-```bash
-# Microsoft OneDrive/SharePoint
-hubdoc-tool --engine onedrive
+---
 
-# Google Drive
-hubdoc-tool --engine googledrive
+## 🎯 Fonctionnalités Clés
 
-# AWS S3
-hubdoc-tool --engine s3
+### Import
+- ✅ **Import direct** : Structure de dossiers préservée automatiquement
+- ✅ **Import avec mapping** : Contrôle précis via CSV
+- ✅ **Permissions** : Gestion read/write par utilisateur/groupe
+- ✅ **Metadata** : Format simplifié `key: value, parent.child: value`
+- ✅ **Sources multiples** : Local, OneDrive, Google Drive, AWS S3
 
-# Local filesystem with XML metadata
-hubdoc-tool --engine filesystem --source /path/to/docs
-```
+### Export
+- ✅ **Scan automatique** : Génération du mapping depuis HubDoc
+- ✅ **Structure personnalisée** : Recréation de l'arborescence
+- ✅ **Metadata XML** : Fichiers `*_metadata.xml` générés automatiquement
+- ✅ **Filtrage** : Par projet, domaine, workspace
 
-### Documentation
+### Général
+- ✅ **OAuth2 automatique** : Zéro config manuelle, refresh automatique
+- ✅ **Mode interactif** : Assistant guidé étape par étape
+- ✅ **Validation** : Pré-validation des fichiers avant import
+- ✅ **Concurrent** : Import/export parallèle configurable
+- ✅ **Plugins** : Architecture extensible pour sources externes
 
-See [README-hubdoc-tool.md](./README-hubdoc-tool.md) for detailed documentation, including:
+---
 
-- Complete installation and configuration instructions
-- CSV mapping format and examples
-- Permission system (read/write permissions)
-- Command reference
-- API integration details
-- Error handling
+## 📚 Documentation
 
-### CSV Mapping Format
+| Sujet | Description |
+|-------|-------------|
+| **[Configuration](./docs/configuration.md)** | OAuth2, variables d'environnement, fichiers config |
+| **[Permissions](./docs/permissions.md)** | Format naturel : `users:r:email users:w:email | groups:Name` |
+| **[Metadata](./docs/metadata.md)** | Format simplifié : `key: value, parent.child: value` |
+| **[Exemples](./docs/examples.md)** | Cas d'usage, scripts, automatisation |
 
-The tool generates CSV files with the following columns:
+---
 
-- **File Path**: Path to the source file
-- **Target Folder**: Destination folder in HubDoc (created if doesn't exist)
-- **Projet**: Project name (optional)
-- **Domain**: Business domain for transverse classification
-- **Metadata (JSON)**: Additional metadata as JSON object
-- **Read Permissions**: Users/groups with read access (`users:user1,user2|groups:group1,group2`)
-- **Write Permissions**: Users/groups with write access (`users:user1,user2|groups:group1,group2`)
+## 🚀 Commandes Principales
 
-### Example Usage
+### Import
 
 ```bash
-# 1. Generate mapping file (from current directory)
-npm run dev -- generate-mapping ./invoices
+# Import direct (structure préservée)
+hubdoc-tool import --direct ./documents
 
-# OR from any directory
-npm run dev -- generate-mapping --source /path/to/invoices
+# Import avec mapping CSV
+hubdoc-tool import --mapping mapping.csv
 
-# 2. Edit the generated mapping.csv file to specify:
-#    - Target folders
-#    - Projects & domains
-#    - Permissions
-#    - Metadata
+# Import depuis source externe
+hubdoc-tool --engine onedrive import --source "/Shared Documents"
+hubdoc-tool --engine googledrive import --source "My Drive/Invoices"
+hubdoc-tool --engine s3 import --source "s3://bucket/docs"
 
-# 3. Import using the mapping
-npm run dev -- import --mapping mapping.csv
+# Options
+--concurrent 5          # 5 jobs parallèles
+--skip-existing         # Skip documents déjà importés
+--dry-run              # Test sans importer
+--validate-all         # Validation stricte avant import
+```
 
-# 4. Export documents from HubDoc
-npm run dev -- export --scan           # Generate export mapping
-npm run dev -- export                  # Download documents
-npm run dev -- export --generate-xml-metadata  # Export with XML metadata files
+### Export
 
-# Test API integration
-npm run test-api
-```
+```bash
+# Générer mapping depuis HubDoc
+hubdoc-tool export --scan
+
+# Exporter selon mapping
+hubdoc-tool export --mapping export-mapping.csv
 
-### XML Metadata Export
+# Export avec XML metadata
+hubdoc-tool export --generate-xml-metadata
 
-When exporting documents from HubDoc, you can generate XML metadata files that contain all the document information:
+# Options
+--target ./output      # Dossier de destination
+--concurrent 5         # 5 downloads parallèles
+```
+
+### Mapping
 
 ```bash
-# Export with XML metadata generation
-npm run dev -- export --generate-xml-metadata
+# Générer mapping depuis dossier local
+hubdoc-tool generate-mapping ./documents
 
-# Interactive export with XML metadata
-npm run dev -- export --interactive
-# Then select "Yes" for XML metadata generation
+# Générer avec sortie spécifique
+hubdoc-tool generate-mapping ./docs --output custom-mapping.csv
 ```
 
-**Generated Files Structure:**
-```
-export/
-├── Project Name/
-│   ├── document.pdf                    # Original document
-│   ├── document_metadata.xml           # Document metadata
-│   └── Subfolder/
-│       ├── another-doc.docx
-│       └── another-doc_metadata.xml
-└── export_summary.xml                  # Overall export summary
-```
+### Mode Interactif
 
-**XML Metadata File Content:**
-Each `*_metadata.xml` file contains:
-- Document ID and name from HubDoc
-- Project and folder path information  
-- All custom metadata fields
-- Export timestamp
-- Original download URL
-- User-defined metadata
-
-**Example XML:**
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<document fileName="Contract">
-  <documentId>doc_123</documentId>
-  <documentName>Contract.pdf</documentName>
-  <project>
-    <name>Client Project</name>
-  </project>
-  <folderPath>Legal/Contracts</folderPath>
-  <author>John Doe</author>
-  <createdDate>2024-01-15T10:30:00Z</createdDate>
-  <exportedAt>2024-09-11T13:42:10.829Z</exportedAt>
-  <originalDownloadUrl>https://hubdoc.example.com/download/doc_123</originalDownloadUrl>
-</document>
+```bash
+# Lancer l'assistant guidé
+hubdoc-tool --interactive
+hubdoc-tool -i
 ```
 
-## 🔐 OAuth2 Authentication
+---
 
-The tool uses **OAuth 2.0 Authorization Code Flow** with automatic token management:
+## 📋 Format CSV Mapping
 
-### How It Works
+### Structure Basique
+
+```csv
+File Path;Target Folder;Workspace;Metadata (key: value, parent.child: value);Permissions (users:r:email users:w:email | groups:Name);Auto Classify;Status;Error;Document ID;Bulk Upload ID
+```
 
-1. **First Run**: If no valid token exists, the CLI automatically:
-   - Starts a local HTTP server on `localhost:8082`
-   - Opens your browser to the OAuth authorization page
-   - Receives the authorization code via callback
-   - Exchanges the code for an access token
-   - Saves the token and refresh token to `.hubdoc-config.json`
+### Exemple Simple
 
-2. **Subsequent Runs**: The CLI automatically:
-   - Loads the saved token from config file or environment
-   - Checks if token is expired (with 60s buffer)
-   - Refreshes the token using refresh_token if needed
-   - Proceeds with your command
+```csv
+File Path;Target Folder;Workspace;Metadata (key: value, parent.child: value);Permissions (users:r:email users:w:email | groups:Name);Auto Classify;Status;Error;Document ID;Bulk Upload ID
+/invoices/inv-001.pdf;Factures/2024;Comptabilité;invoice_number: INV-001, amount: 1500;;true;pending;;;
+/contracts/c-a.pdf;Contrats;Juridique;type: service, duration: 24;users:r:legal@ex.com users:w:ceo@ex.com;false;pending;;;
+```
 
-3. **No Manual Intervention**: You never need to manually manage tokens!
+**Voir [Exemples](./docs/examples.md) pour plus de cas d'usage**
 
-### Environment Variables
+---
 
-Priority order (highest to lowest):
-1. **Environment variables** (override everything)
-2. **`.env` file** (loaded automatically)
-3. **`.hubdoc-config.json`** (saved tokens)
+## 🔐 Permissions (Format Naturel)
 
-```bash
-# Required for automatic OAuth
-export HUBDOC_API_URL=https://rec.hubdoc.sinoia.cloud
-export HUBDOC_OAUTH_CLIENT_ID=your-client-id
-export HUBDOC_OAUTH_CLIENT_SECRET=your-client-secret
-export HUBDOC_OAUTH_SCOPES="read write admin"
+### Format
 
-# Optional: provide a valid token directly (skips OAuth flow)
-export HUBDOC_TOKEN=your-existing-token
 ```
+users:email1,email2 | users:w:admin@ex.com | groups:Group Name | groups:w:Admin Group
+```
+
+### Règles
 
-### Token Expiration
+- **Sans suffixe** = READ par défaut : `users:john@ex.com | groups:Finance`
+- **:r** = READ explicite : `users:r:viewer@ex.com`
+- **:w** = WRITE : `users:w:editor@ex.com | groups:w:Admins`
+- **Espaces supportés** dans les noms de groupes : `groups:Senior Management`
 
-- Tokens typically expire after **2 hours** (7200 seconds)
-- The CLI checks expiration **60 seconds before** actual expiration
-- Automatic refresh using the refresh_token (no browser required)
-- If refresh fails, a new OAuth flow is initiated automatically
+### Exemples
 
-### Security Notes
+```csv
+# Lecture seule
+users:john@ex.com,jane@ex.com | groups:All Staff
 
-- Tokens are stored in `.hubdoc-config.json` (add to `.gitignore`!)
-- Client secrets should be stored in environment variables or `.env` file
-- The local OAuth callback server only binds to `127.0.0.1` (localhost)
-- Authorization codes are single-use and expire quickly
+# Mixte READ + WRITE
+users:viewer@ex.com | users:w:admin@ex.com | groups:Finance | groups:w:Direction
 
-### API Configuration
+# Groupes avec espaces et accents
+groups:Comptabilité France | groups:w:Présidence Direction
+```
 
-The tool supports HubDoc APIs with endpoints like:
-- `https://rec.hubdoc.sinoia.cloud`
-- `https://demo.hubdoc.sinoia.cloud`
+**Voir [Documentation Permissions](./docs/permissions.md) pour détails complets**
 
-Configuration can be stored as:
-- Environment variables (recommended for credentials)
-- `.env` file (for local development)
-- `.hubdoc-config.json` file (for saved tokens)
+---
 
-## Plugin Architecture
+## 📝 Metadata (Format Simplifié)
 
-Le système supporte des plugins pour différentes sources documentaires avec sélection interactive :
+### Format
 
-```bash
-# Interface unifiée avec sélection d'engine
-npm run dev -- --interactive          # Mode interactif
-npm run dev -- --engine onedrive      # OneDrive direct
-npm run dev -- --engine core --limit 10  # Core avec limite
-npm run dev                            # Filesystem par défaut
+```
+key: value, parent.child: value
 ```
 
-### Engines disponibles
+### Exemples
 
-#### 🗂️ **Filesystem** (par défaut)
-Import depuis le système de fichiers local avec support des métadonnées XML.
+```csv
+# Simple
+invoice_number: INV-001, amount: 1500, paid: true
 
-**Fonctionnalités :**
-- 📋 **Métadonnées XML** : Support automatique des fichiers `*_metadata.xml`
-- 🔍 **Détection intelligente** : Association automatique document ↔ métadonnées
-- 📊 **Mapping HubDoc** : Conversion vers champs standard (title, author, project, etc.)
-- ⚡ **Formats supportés** : Excel XML, XML simple
+# Objets imbriqués (notation point)
+supplier.name: Acme Corp, supplier.vat: FR123, amount: 2500
 
-```bash
-npm run dev -- --engine filesystem --source /path/to/documents
+# Types auto-détectés
+year: 2024, amount: 1500.50, active: true, optional: null
 ```
 
-**Exemple avec métadonnées XML :**
-```
-documents/
-├── rapport.pdf                    # Document principal
-├── rapport_metadata.xml          # Métadonnées XML associées
-└── autre-doc.docx                # Autre document
-```
+**Voir [Documentation Metadata](./docs/metadata.md) pour détails complets**
 
-Le système détecte automatiquement `rapport_metadata.xml` et associe les métadonnées (author, title, project, phase, etc.) au document `rapport.pdf`.
+---
 
-#### ☁️ **OneDrive** - Microsoft OneDrive/SharePoint
+## 🔌 Plugins / Sources Externes
 
-**Obtention du token :**
-1. Aller sur [Microsoft Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer)
-2. Se connecter avec votre compte Microsoft/Office 365
-3. Demander les permissions `Files.Read.All`
-4. Copier le token généré
+### OneDrive/SharePoint
 
 ```bash
-npm run dev -- --engine onedrive --limit 5
-# Le système demande le token interactivement
-```
+export ONEDRIVE_CLIENT_ID=your-client-id
+export ONEDRIVE_CLIENT_SECRET=your-client-secret
+export ONEDRIVE_TENANT_ID=your-tenant-id
 
-#### 📁 **Core** - Core Document Management System
+hubdoc-tool --engine onedrive import --source "/Shared Documents/Invoices"
+```
 
-**Obtention du token :**
-1. Aller sur votre instance Core (ex: `https://rec.plugandwork.fr`)
-2. Naviguer vers : `/users/token`
-3. Copier le token Bearer affiché
+### Google Drive
 
 ```bash
-npm run dev -- --engine core --limit 10
-# Configuration requise: baseUrl, bearerToken
-```
+export GOOGLE_DRIVE_CLIENT_ID=your-client-id
+export GOOGLE_DRIVE_CLIENT_SECRET=your-client-secret
+export GOOGLE_DRIVE_CREDENTIALS_PATH=./credentials.json
 
-#### 🟢 **Google Drive**
+hubdoc-tool --engine googledrive import --source "My Drive/Documents"
+```
 
-**Obtention du token :**
-1. Créer une application dans [Google Cloud Console](https://console.cloud.google.com/)
-2. Activer l'API Google Drive
-3. Créer des identifiants OAuth 2.0
-4. Configurer les permissions `https://www.googleapis.com/auth/drive.readonly`
-5. Obtenir `clientId`, `clientSecret`, et effectuer le flow OAuth2
+### AWS S3
 
 ```bash
-npm run dev -- --engine googledrive
-# Configuration requise: clientId, clientSecret, redirectUri, accessToken
+export AWS_ACCESS_KEY_ID=your-key
+export AWS_SECRET_ACCESS_KEY=your-secret
+export AWS_REGION=us-east-1
+
+hubdoc-tool --engine s3 import --source "s3://my-bucket/documents/"
 ```
 
-#### 📦 **Dropbox**
+**Voir [Exemples](./docs/examples.md) pour configuration détaillée**
 
-**Obtention du token :**
-1. Créer une app sur [Dropbox App Console](https://www.dropbox.com/developers/apps)
-2. Choisir "Scoped access" et "Full Dropbox"
-3. Générer un access token dans les settings de l'app
-4. Copier le token généré
+---
+
+## 🛠️ Développement
+
+### Installation pour Développement
 
 ```bash
-npm run dev -- --engine dropbox
-# Configuration requise: accessToken
+git clone https://github.com/your-org/hubdoc-tools.git
+cd hubdoc-tools
+npm install
+npm run build
 ```
 
-## 🔌 Connecteurs disponibles
+### Tests
 
-Le système supporte de nombreux connecteurs pour différentes sources documentaires :
+```bash
+# Tous les tests
+npm test
 
-| Connecteur | Type | Documentation |
-|------------|------|---------------|
-| 📁 **Filesystem** | Local | Intégré (défaut) |
-| ☁️ **OneDrive** | Cloud | Intégré |
-| 🗂️ **Google Drive** | Cloud | Intégré |
-| 📦 **Dropbox** | Cloud | Intégré |
-| 📋 **Core DMS** | GED | Intégré |
-| 📦 **Box** | Cloud | [📖 docs/connectors/box.md](./docs/connectors/box.md) |
-| ☁️ **AWS S3** | Cloud | [📖 docs/connectors/aws-s3.md](./docs/connectors/aws-s3.md) |
-| 🔵 **Azure Blob** | Cloud | [📖 docs/connectors/azure-blob.md](./docs/connectors/azure-blob.md) |
-| 📚 **Alfresco** | ECM | [📖 docs/connectors/alfresco.md](./docs/connectors/alfresco.md) |
-| 📄 **SharePoint** | Office 365 | [📖 docs/connectors/sharepoint.md](./docs/connectors/sharepoint.md) |
-| 🏛️ **Nuxeo** | ECM | [📖 docs/connectors/nuxeo.md](./docs/connectors/nuxeo.md) |
-| 🏢 **OpenText** | ECM | [📖 docs/connectors/opentext.md](./docs/connectors/opentext.md) |
+# Tests spécifiques
+npm test -- permissions
+npm test -- metadata
 
-### Utilisation des connecteurs
+# Coverage
+npm run test:coverage
+```
 
-```bash
-# Sélection interactive
-npm run dev -- --interactive
+### Build
 
-# Connecteur spécifique
-npm run dev -- --engine [nom-connecteur]
+```bash
+# Build TypeScript
+npm run build
 
-# Avec options
-npm run dev -- --engine box --limit 10
-npm run dev -- --engine s3 --limit 100
+# Watch mode
+npm run dev
 ```
 
-Chaque connecteur a sa propre documentation détaillée avec :
-- ✅ Instructions de configuration
-- 🔑 Obtention des tokens/credentials  
-- ⚙️ Paramètres supportés
-- 🛠️ Troubleshooting
-- 📋 Bonnes pratiques
+---
 
-### Configuration des tokens
+## 📖 Documentation Complète
 
-#### Option 1: Interface interactive
-```bash
-npm run dev -- --engine onedrive
-# Le système demande automatiquement les paramètres requis
-```
+- **[Configuration Détaillée](./docs/configuration.md)** : OAuth2, env vars, troubleshooting
+- **[Système de Permissions](./docs/permissions.md)** : Format, exemples, cas d'usage
+- **[Gestion des Metadata](./docs/metadata.md)** : Format simplifié, objets imbriqués
+- **[Exemples Pratiques](./docs/examples.md)** : Scripts, automatisation, cron jobs
 
-#### Option 2: Fichiers de configuration
-```bash
-# Créer onedrive-config.json
-{
-  "accessToken": "votre_token_graph_explorer",
-  "limit": 10
-}
-
-# Créer core-config.json  
-{
-  "baseUrl": "https://votre-instance.core.fr",
-  "bearerToken": "votre_token_depuis_/users/token",
-  "limit": 10
-}
-```
+---
 
-### 🔑 Guide détaillé d'obtention des tokens
-
-#### **Core Token (le plus simple)**
-1. 🌐 Ouvrez votre instance Core : `https://rec.plugandwork.fr` (ou votre URL)
-2. 🔐 Connectez-vous avec vos identifiants
-3. 📍 Naviguez vers : `https://rec.plugandwork.fr/users/token`
-4. 📋 Copiez le token Bearer affiché sur la page
-
-#### **OneDrive Token (Graph Explorer)**
-1. 🌐 Ouvrez [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer)
-2. 🔐 Cliquez "Sign in to Graph Explorer" 
-3. 🔑 Connectez-vous avec votre compte Microsoft/Office 365
-4. ⚙️ Cliquez sur l'onglet "Permissions" 
-5. ✅ Recherchez et demandez `Files.Read.All`
-6. 🔄 Acceptez les permissions demandées
-7. 📋 Copiez le token depuis l'en-tête `Authorization: Bearer ...`
-
-#### **Dropbox Token (App Console)**
-1. 🌐 Ouvrez [Dropbox App Console](https://www.dropbox.com/developers/apps)
-2. ➕ Créez une nouvelle app
-3. 🔧 Choisissez "Scoped access" et "Full Dropbox"
-4. ⚙️ Allez dans les settings de votre app
-5. 🔑 Générez un "Access Token" 
-6. 📋 Copiez le token généré
-
-#### **Google Drive Token (plus complexe)**
-1. 🌐 Ouvrez [Google Cloud Console](https://console.cloud.google.com/)
-2. 📁 Créez un nouveau projet ou sélectionnez-en un
-3. 🔧 Activez l'API Google Drive
-4. 🔑 Créez des identifiants OAuth 2.0 
-5. ⚙️ Configurez les permissions et redirections
-6. 🔄 Effectuez le flow OAuth2 pour obtenir un access token
-
-💡 **Conseil** : Pour les tests, commencez par **Core** (le plus simple) ou **OneDrive** (Graph Explorer).
-
-### Utilisation avancée
+## 🤝 Support & Contributions
 
-```bash
-# Lister les plugins disponibles
-npm run dev -- plugins
+### Signaler un Bug
 
-# Configurer une connexion manuellement
-npm run dev -- connect onedrive --interactive
+[Ouvrir une issue](https://github.com/your-org/hubdoc-tools/issues)
 
-# Scanner une source externe
-npm run dev -- plugin-scan connection-id --limit 5
+### Proposer une Fonctionnalité
 
-# Importer depuis une source externe
-npm run dev -- plugin-import mapping.csv
-```
+[Créer une Feature Request](https://github.com/your-org/hubdoc-tools/issues/new?template=feature_request.md)
 
-## Project Structure
+### Contribuer
 
-```
-hubdoc-tools/
-├── src/
-│   ├── commands/        # Import commands
-│   ├── services/        # HubDoc API integration
-│   ├── types/          # TypeScript type definitions
-│   ├── utils/          # Utilities (CSV, config)
-│   └── cli.ts          # Main CLI entry point
-├── plugins/            # External source plugins
-│   ├── core/           # Core DMS plugin
-│   ├── onedrive/       # OneDrive plugin
-│   ├── googledrive/    # Google Drive plugin
-│   ├── dropbox/        # Dropbox plugin
-│   ├── box/            # Box cloud storage plugin
-│   ├── aws-s3/         # AWS S3 plugin
-│   ├── azure-blob/     # Azure Blob Storage plugin
-│   ├── alfresco/       # Alfresco ECM plugin
-│   ├── sharepoint/     # SharePoint Online plugin
-│   ├── nuxeo/          # Nuxeo ECM plugin
-│   └── opentext/       # OpenText Content Server plugin
-├── package.json
-├── tsconfig.json
-└── README-hubdoc-tool.md  # Detailed documentation
-```
+1. Fork le repo
+2. Créer une branche : `git checkout -b feature/amazing-feature`
+3. Commit : `git commit -m 'Add amazing feature'`
+4. Push : `git push origin feature/amazing-feature`
+5. Ouvrir une Pull Request
+
+---
+
+## 📄 Licence
+
+MIT © [Sinoia]
+
+---
 
-## Contributing
+## 🎯 Roadmap
 
-This project is part of the Sinoia CoreX ecosystem for HubDoc document management.
+- [ ] Support Azure Blob Storage
+- [ ] Support Dropbox
+- [ ] Interface Web (dashboard)
+- [ ] Webhooks pour import temps-réel
+- [ ] API REST pour intégrations
+- [ ] Support multi-tenant
 
-## License
+---
 
-MIT License
+**Made with ❤️ by Sinoia**