@sinoia/hubdoc-tools 1.0.4 → 1.2.1

package/TESTING.md

@@ -1,129 +0,0 @@
-# Tests des Nouveaux Connecteurs
-
-## ✅ Statut des Tests
-
-Tous les 7 nouveaux connecteurs ont été implémentés, intégrés et testés :
-
-### Connecteurs Cloud Storage
-- **✅ Box** - Box Cloud Storage
-- **✅ AWS S3** - Amazon S3 et services compatibles  
-- **✅ Azure Blob** - Azure Blob Storage
-
-### Connecteurs ECM/GED
-- **✅ Alfresco** - Alfresco Content Management
-- **✅ Nuxeo** - Nuxeo Platform
-- **✅ OpenText** - OpenText Content Server
-
-### Connecteurs Microsoft 365
-- **✅ SharePoint** - SharePoint Online via Graph API
-
-## 🧪 Scripts de Test Disponibles
-
-```bash
-# Tests individuels
-npm run test-box          # Test Box connector
-npm run test-s3           # Test AWS S3 connector  
-npm run test-azure        # Test Azure Blob connector
-
-# Tests globaux
-npm run test-all          # Test tous les nouveaux connecteurs
-npm run test-connectors   # Test d'intégration complète
-
-# Utilisation réelle
-npm run dev -- --interactive              # Sélection interactive
-npm run dev -- --engine box --limit 5    # Test Box avec 5 docs
-npm run dev -- --engine s3 --limit 10    # Test S3 avec 10 docs
-```
-
-## 📋 Résultats des Tests
-
-### Tests de Structure ✅
-- [x] Tous les plugins se chargent correctement
-- [x] Interface `DocumentSourcePlugin` respectée
-- [x] Méthodes requises implémentées
-- [x] Schémas de configuration valides
-- [x] Support scan/import/export
-
-### Tests d'Intégration ✅  
-- [x] CLI mis à jour avec tous les connecteurs
-- [x] Sélection interactive fonctionnelle
-- [x] Arguments en ligne de commande supportés
-- [x] Service de gestion des plugins compatible
-- [x] Logging intégré
-
-### Tests de Configuration ✅
-- [x] Fichiers d'exemple créés
-- [x] Validation des paramètres
-- [x] Gestion des credentials
-- [x] Protection .gitignore
-
-## 🎯 Tests avec Vraies Credentials
-
-Pour tester avec de vraies instances :
-
-### 1. Copier les exemples de config
-```bash
-cp config-examples/box-config.example.json box-config.json
-# Éditer avec vos vraies credentials
-```
-
-### 2. Tester la connexion
-```bash
-npm run dev -- --engine box --limit 5
-```
-
-### 3. Exemple de sortie attendue
-```
-🚀 Starting HubDoc Tool with box engine...
-🔍 Scanning Box bucket...
-✅ Found 5 documents
-📥 Starting import...
-✅ Operation completed
-```
-
-## 📊 Couverture des Tests
-
-| Connecteur | Structure | Intégration | Config | Docs |
-|------------|-----------|-------------|---------|------|
-| Box        | ✅        | ✅          | ✅      | ✅   |
-| AWS S3     | ✅        | ✅          | ✅      | ✅   |
-| Azure Blob | ✅        | ✅          | ✅      | ✅   |
-| Alfresco   | ✅        | ✅          | ✅      | ✅   |
-| SharePoint | ✅        | ✅          | ✅      | ✅   |
-| Nuxeo      | ✅        | ✅          | ✅      | ✅   |
-| OpenText   | ✅        | ✅          | ✅      | ✅   |
-
-## 🔍 Prochaines Étapes
-
-1. **Tests avec vraies instances** - Tester avec de vraies credentials
-2. **Tests de performance** - Tester avec de gros volumes
-3. **Tests d'erreurs** - Tester les cas d'échec
-4. **Tests de sécurité** - Validation des credentials
-
-## 🛠️ Dépendances Ajoutées
-
-```json
-{
-  "@aws-sdk/client-s3": "^3.0.0",
-  "@aws-sdk/lib-storage": "^3.0.0", 
-  "@azure/storage-blob": "^12.0.0"
-}
-```
-
-## 📚 Documentation
-
-- [README.md](./README.md) - Vue d'ensemble
-- [docs/connectors/](./docs/connectors/) - Docs détaillées par connecteur
-- [config-examples/](./config-examples/) - Exemples de configuration
-
-## ✨ Fonctionnalités Implémentées
-
-- ✅ 7 nouveaux connecteurs
-- ✅ Interface unifiée
-- ✅ Sélection interactive  
-- ✅ Configuration flexible
-- ✅ Logging complet
-- ✅ Documentation détaillée
-- ✅ Tests automatisés
-- ✅ Exemples de configuration
-- ✅ Protection des credentials

package/config-examples/README.md

@@ -1,36 +0,0 @@
-# Configuration Examples
-
-Ce dossier contient des exemples de fichiers de configuration pour chaque connecteur.
-
-## Utilisation
-
-1. Copiez l'exemple qui vous intéresse : `cp box-config.example.json box-config.json`
-2. Éditez le fichier avec vos vraies credentials
-3. Lancez le test : `npm run dev -- --engine box --limit 5`
-
-## Connecteurs disponibles
-
-### Cloud Storage
-- `box-config.example.json` - Box Cloud Storage
-- `s3-config.example.json` - AWS S3
-- `azure-blob-config.example.json` - Azure Blob Storage
-
-### ECM/GED
-- `alfresco-config.example.json` - Alfresco
-- `nuxeo-config.example.json` - Nuxeo
-- `opentext-config.example.json` - OpenText
-
-### Microsoft 365
-- `sharepoint-config.example.json` - SharePoint Online
-
-## Sécurité
-
-⚠️ **Important** : Ne jamais commiter vos vraies credentials dans Git !
-
-Les fichiers `*-config.json` (sans `.example`) sont dans `.gitignore` pour éviter les fuites de credentials.
-
-## Documentation
-
-Pour plus de détails sur chaque connecteur, consultez :
-- [docs/connectors/](../docs/connectors/) - Documentation détaillée
-- [README.md](../README.md) - Vue d'ensemble

package/config-examples/alfresco-config.example.json

@@ -1,8 +0,0 @@
-{
-  "baseUrl": "http://localhost:8080/alfresco",
-  "username": "admin",
-  "password": "admin",
-  "siteId": "my-site",
-  "includeFolders": true,
-  "limit": 10
-}

package/config-examples/azure-blob-config.example.json

@@ -1,7 +0,0 @@
-{
-  "accountName": "your-storage-account-name",
-  "accountKey": "your-storage-account-key-base64",
-  "containerName": "your-container-name",
-  "prefix": "documents/",
-  "limit": 10
-}

package/config-examples/box-config.example.json

@@ -1,5 +0,0 @@
-{
-  "accessToken": "YOUR_BOX_ACCESS_TOKEN_HERE",
-  "rootFolderId": "0",
-  "limit": 10
-}

package/config-examples/nuxeo-config.example.json

@@ -1,8 +0,0 @@
-{
-  "baseUrl": "http://localhost:8080/nuxeo",
-  "username": "Administrator",
-  "password": "Administrator",
-  "repository": "default",
-  "rootPath": "/default-domain/workspaces",
-  "limit": 10
-}

package/config-examples/opentext-config.example.json

@@ -1,7 +0,0 @@
-{
-  "baseUrl": "http://localhost/otcs/cs.exe/api/v1",
-  "username": "admin",
-  "password": "admin",
-  "startingFolderId": 2000,
-  "limit": 10
-}

package/config-examples/s3-config.example.json

@@ -1,8 +0,0 @@
-{
-  "accessKeyId": "YOUR_AWS_ACCESS_KEY_ID",
-  "secretAccessKey": "YOUR_AWS_SECRET_ACCESS_KEY",
-  "region": "us-east-1",
-  "bucketName": "your-bucket-name",
-  "prefix": "documents/",
-  "limit": 10
-}

package/config-examples/sharepoint-config.example.json

@@ -1,7 +0,0 @@
-{
-  "siteUrl": "https://contoso.sharepoint.com/sites/mysite",
-  "accessToken": "YOUR_MICROSOFT_GRAPH_TOKEN_HERE",
-  "driveId": "optional-specific-drive-id",
-  "folderId": "optional-folder-id",
-  "limit": 10
-}

package/demo/README.md

@@ -1,199 +0,0 @@
-# 🎬 Documentation de Démonstration HubDoc Importer
-
-## 📋 Vue d'Ensemble
-
-Cette documentation présente un cas d'usage complet et réaliste pour **HubDoc Importer** avec le client fictif **BAUTECH Construction & Promotion Immobilière**.
-
-### 🎯 Objectif de la Démonstration
-
-Montrer la puissance et la simplicité de l'outil sur un scénario enterprise réel :
-- **15,000 documents** à importer
-- **8 projets immobiliers** actifs
-- **Permissions granulaires** read/write
-- **Métadonnées enrichies** par type de document
-- **ROI mesurable** dès les premiers mois
-
----
-
-## 📁 Contenu de la Démonstration
-
-### 📄 Documents Principaux
-
-1. **[DEMO-DOCUMENTATION.md](./DEMO-DOCUMENTATION.md)**
-   - Cas d'usage complet BAUTECH Construction
-   - Métriques d'import détaillées  
-   - ROI et gains business
-   - Configuration technique
-
-2. **[demo-script.md](./demo-script.md)**
-   - Script de présentation (20 min)
-   - Timing précis et messages clés
-   - Étapes clic par clic
-   - Points de différenciation
-
-### 🛠️ Outils de Simulation
-
-3. **[generate-sample-csv.js](./generate-sample-csv.js)**
-   ```bash
-   # Génère un CSV de 15,000 documents réalistes
-   node demo/generate-sample-csv.js
-   ```
-   - Données BTP authentiques (plans, permis, devis, PV...)
-   - Métadonnées JSON enrichies
-   - Permissions read/write réalistes
-   - Projets et équipes crédibles
-
-4. **[simulate-import.js](./simulate-import.js)**
-   ```bash
-   # Simule un import temps réel avec progress bar
-   node demo/simulate-import.js  
-   ```
-   - Progress bar animée
-   - Métriques temps réel (vitesse, succès, échecs)
-   - Dashboard final avec ROI
-   - Effet visuel saisissant pour les démos
-
-### 📊 Fichiers Générés
-
-5. **[mapping_bautech_15k.csv](./mapping_bautech_15k.csv)**
-   - 15,001 lignes (headers + 15,000 documents)
-   - 4.16 MB de données réalistes
-   - Prêt pour import en live demo
-
----
-
-## 🎬 Utilisation pour les Démonstrations
-
-### 📋 Préparation (5 minutes)
-
-```bash
-# 1. Générer les données de demo
-cd /Users/olivier/dev/hubdoc-tools/demo
-node generate-sample-csv.js
-
-# 2. Tester la simulation
-node simulate-import.js
-
-# 3. Vérifier les fichiers
-ls -la mapping_bautech_15k.csv
-```
-
-### 🎯 Démonstration Live (20 minutes)
-
-1. **Contexte** (3 min) - Présenter BAUTECH et ses défis
-2. **Configuration** (2 min) - `hubdoc-importer config`
-3. **Génération mapping** (3 min) - Montrer le CSV généré
-4. **Import simulation** (8 min) - `node simulate-import.js`
-5. **Résultats & ROI** (4 min) - Métriques business
-
-### ⚡ Demo Express (5 minutes)
-
-Pour les présentations courtes :
-1. Montrer le CSV prêt (1 min)
-2. Lancer la simulation (3 min)
-3. Conclusion ROI (1 min)
-
----
-
-## 📊 Métriques Clés à Retenir
-
-### 🚀 Performance Technique
-- **15,000 documents** en 2h34m
-- **97 docs/minute** en moyenne
-- **98.98% de succès** d'import
-- **47.3 GB** de données traitées
-
-### 💰 Impact Business
-- **ROI de 1,200%** sur 6 mois
-- **De 15 min à 30 sec** pour trouver un document
-- **920€ d'économies** par jour
-- **16h pour amortir** le coût d'import
-
-### 🔐 Sécurité & Conformité
-- **Permissions granulaires** par utilisateur/groupe
-- **Traçabilité complète** des accès
-- **Métadonnées enrichies** automatiquement
-- **Backup cloud** sécurisé
-
----
-
-## 🎯 Messages Clés
-
-### ✨ Simplicité
-*"3 commandes suffisent : config, generate, import"*
-
-### ⚡ Performance  
-*"15,000 documents importés en moins de 3 heures"*
-
-### 💰 ROI Immédiat
-*"Amortissement en 16 heures d'utilisation"*
-
-### 🔒 Sécurité Enterprise
-*"Permissions read/write granulaires par équipe métier"*
-
----
-
-## 🛠️ Personnalisation
-
-### 🏢 Adapter à d'Autres Secteurs
-
-Le générateur peut être facilement adapté pour :
-
-**🏥 Santé**
-- Dossiers patients, imagerie, protocoles
-- Permissions par service hospitalier
-- Conformité RGPD/HDS
-
-**⚖️ Juridique**  
-- Contrats, jurisprudence, correspondances
-- Permissions par cabinet/associé
-- Archivage légal réglementaire
-
-**🏭 Industrie**
-- Documentation technique, certifications
-- Permissions par site/équipe
-- Traçabilité qualité ISO
-
-### ⚙️ Modification des Paramètres
-
-```javascript
-// Dans generate-sample-csv.js
-const CLIENT_CONFIG = {
-  name: 'VOTRE ENTREPRISE',
-  projects: [
-    { name: 'Projet A', docs: 2000, code: 'PROJ_A' },
-    // ... adapter selon le contexte
-  ]
-};
-```
-
----
-
-## 📞 Support Démonstration
-
-### 🆘 Problèmes Courants
-
-**CSV trop volumineux ?**
-```javascript
-// Réduire le nombre de documents
-const totalDocs = 1500; // au lieu de 15000
-```
-
-**Simulation trop longue ?**
-```javascript  
-// Accélérer la simulation
-const avgSpeed = 500; // au lieu de 97
-```
-
-**Données pas assez réalistes ?**
-- Modifier les arrays `DOC_TYPES` et `USERS_GROUPS`
-- Adapter les métadonnées par secteur
-
-### 📧 Contact Technique
-- **Documentation :** README-hubdoc-importer.md
-- **Issues :** Créer un issue sur le repo
-- **Demos :** Utiliser ce dossier `/demo`
-
----
-
-*Démonstration préparée avec ❤️ pour HubDoc Importer v1.0.0*