@sinoia/hubdoc-tools 1.0.4 → 1.2.1

package/docs/connectors/opentext.md

@@ -1,234 +0,0 @@
-# OpenText Content Server Connector
-
-Plugin pour importer/exporter des documents depuis/vers OpenText Content Server.
-
-## Configuration
-
-### Paramètres requis
-- `baseUrl` : URL de base Content Server (ex: http://localhost/otcs/cs.exe/api/v1)
-
-### Authentification (une des options requises)
-- **Option 1** : `username` + `password` - Authentification standard
-- **Option 2** : `ticket` - Ticket OTDS (OpenText Directory Services)
-
-### Paramètres optionnels
-- `startingFolderId` : ID du dossier de départ (défaut: 2000 = Enterprise workspace)
-- `limit` : Nombre maximum de documents à scanner
-
-## Configuration OpenText
-
-### Prérequis
-- OpenText Content Server 16.x ou 20.x+
-- API REST activée
-- Utilisateur avec permissions appropriées ou ticket OTDS valide
-
-### Structure des nœuds OpenText
-- **2000** : Enterprise (racine principale)
-- **Type 0** : Folder (dossier)
-- **Type 144** : Document (document standard)
-- **Type 136** : Shortcut (raccourci)
-- Autres types selon configuration
-
-## Authentification
-
-### Option 1: Username/Password
-```json
-{
-  "baseUrl": "http://content-server/otcs/cs.exe/api/v1",
-  "username": "admin",
-  "password": "admin",
-  "startingFolderId": 2000
-}
-```
-
-### Option 2: Ticket OTDS
-```json
-{
-  "baseUrl": "http://content-server/otcs/cs.exe/api/v1", 
-  "ticket": "otds-ticket-string-here",
-  "startingFolderId": 2000
-}
-```
-
-## Obtention du ticket OTDS
-
-### Via interface OTDS
-1. Se connecter à OpenText Directory Services
-2. Obtenir un ticket d'authentification valide
-3. Utiliser ce ticket dans la configuration
-
-### Via API d'authentification
-1. Appeler l'endpoint d'authentification Content Server
-2. Récupérer le ticket de la réponse
-3. Le ticket expire selon la politique configurée
-
-## Utilisation
-
-```bash
-# Mode interactif
-hubdoc-tool --engine opentext
-
-# Avec dossier de départ spécifique
-hubdoc-tool --engine opentext
-# Configurer startingFolderId: 123456
-```
-
-## Fichier de configuration
-
-Créer `opentext-config.json` :
-
-```json
-{
-  "baseUrl": "https://contentserver.example.com/otcs/cs.exe/api/v1",
-  "username": "serviceuser",
-  "password": "secure-password",
-  "startingFolderId": 2000,
-  "limit": 200
-}
-```
-
-## Fonctionnalités supportées
-
-### Scan (✅)
-- Parcours récursif des nœuds/dossiers
-- Support de tous les types de nœuds
-- Métadonnées complètes OpenText
-- États de réservation (check-out)
-- Filtrage par taille, date, type MIME
-
-### Import (✅)
-- Téléchargement du contenu binaire
-- Préservation de la hiérarchie de nœuds
-- Conservation des métadonnées OpenText
-- Support des versions de documents
-
-### Export (✅)
-- Upload multipart pour gros fichiers
-- Création automatique de l'arborescence de nœuds
-- Assignment du type Document (144)
-- Métadonnées de base
-
-## Types de nœuds OpenText
-
-### Types standard
-- **0** : Folder (Dossier)
-- **144** : Document (Document standard)
-- **136** : Shortcut (Raccourci)
-- **207** : URL (Lien web)
-- **298** : Email (Message email)
-
-### Propriétés des nœuds
-- **ID** : Identifiant unique du nœud
-- **Name** : Nom d'affichage
-- **Type** : Type de nœud (numérique)
-- **Parent ID** : ID du nœud parent
-- **Created/Modified** : Dates de création/modification
-- **Size** : Taille du contenu (pour documents)
-- **Reserved** : État de réservation
-
-## API OpenText utilisée
-
-### Version API
-- **API REST** : Content Server REST API v1 ou v2
-- **Base Path** : `/api/v1` ou `/api/v2`
-- **Documentation** : OpenText Developer Portal
-
-### Endpoints utilisés
-- `GET /nodes/{id}/nodes` : Liste les nœuds enfants
-- `GET /nodes/{id}/content` : Télécharge le contenu
-- `POST /nodes/{id}/nodes` : Crée un nouveau nœud
-- `GET /nodes/{id}/ancestors` : Obtient la hiérarchie parente
-- `POST /auth` : Authentification
-
-## Métadonnées OpenText
-
-### Propriétés standard extraites
-- **Basic** : id, name, type, type_name, container
-- **Audit** : create_date, modify_date, created_by, modified_by
-- **Content** : size, mime_type, version_number
-- **Status** : reserved, reserved_by, reserved_date
-- **Hierarchy** : parent_id, ancestors
-
-### Catégories et attributs
-OpenText supporte des catégories avec attributs personnalisés :
-- Attributs texte, numérique, date
-- Listes de valeurs contrôlées
-- Attributs multi-valuées
-
-## Permissions OpenText
-
-### Niveaux de permission
-- **See** : Voir le nœud dans les listes
-- **See Contents** : Voir le contenu d'un dossier
-- **Modify** : Modifier les propriétés
-- **Edit Attributes** : Modifier les catégories
-- **Add Items** : Ajouter des éléments
-- **Reserve** : Réserver pour modification
-- **Full Control** : Contrôle total
-
-## Limitations
-
-### Content Server
-- Limite de 32 000 nœuds par requête de listing
-- Nom de nœud max : 248 caractères
-- Profondeur max recommandée : 20 niveaux
-
-### API REST
-- Timeout par défaut variable selon configuration
-- Pagination requise pour gros volumes
-- Certaines opérations avancées nécessitent des permissions élevées
-
-### Performance
-- Les requêtes sur de gros volumes peuvent être lentes
-- L'indexation peut impacter les performances
-- Les permissions complexes ralentissent les accès
-
-## Troubleshooting
-
-### Erreur 401: Authentication required
-- Vérifier username/password ou validité du ticket
-- Contrôler que l'utilisateur existe et est actif
-- Tester l'accès via interface web
-
-### Erreur 403: Insufficient privileges
-- Vérifier les permissions sur le nœud de départ
-- Contrôler les droits de l'utilisateur/groupe
-- S'assurer des permissions See Contents sur les dossiers parents
-
-### Erreur 404: Node not found
-- Vérifier que le startingFolderId existe
-- Contrôler l'ID du nœud (numérique)
-- Tester l'accès via interface Content Server
-
-### Performance lente
-- Réduire la portée avec startingFolderId approprié
-- Utiliser des filtres pour limiter les résultats
-- Vérifier les performances du serveur de base de données
-- Contrôler l'état de l'indexation Verity/FAST
-
-## Bonnes pratiques
-
-### Organisation
-- Utiliser une hiérarchie de dossiers logique et équilibrée
-- Éviter les dossiers avec trop de nœuds enfants
-- Implémenter des conventions de nommage cohérentes
-- Utiliser les catégories pour la classification
-
-### Sécurité
-- Créer des utilisateurs techniques avec permissions minimales
-- Utiliser HTTPS pour les connexions
-- Configurer l'authentification LDAP/AD
-- Auditer les accès aux contenus sensibles
-
-### Performance
-- Optimiser les index de base de données
-- Configurer le cache Content Server approprié
-- Planifier les opérations lourdes en maintenance
-- Surveiller l'utilisation des ressources système
-
-### Maintenance
-- Surveiller les logs Content Server (oscript.log, server.log)
-- Effectuer des sauvegardes régulières
-- Nettoyer les nœuds supprimés et versions anciennes
-- Maintenir les statistiques de base de données à jour
-- Surveiller l'espace disque (contenu et logs)

package/docs/connectors/sharepoint.md

@@ -1,207 +0,0 @@
-# SharePoint Online Connector
-
-Plugin pour importer/exporter des documents depuis/vers SharePoint Online via Microsoft Graph API.
-
-## Configuration
-
-### Paramètres requis
-- `siteUrl` : URL du site SharePoint (ex: https://contoso.sharepoint.com/sites/mysite)
-- `accessToken` : Token d'accès Microsoft Graph
-
-### Paramètres optionnels
-- `driveId` : ID du drive spécifique (optionnel, utilise le drive par défaut)
-- `folderId` : ID du dossier de départ (optionnel, utilise la racine)
-- `limit` : Nombre maximum de documents à scanner
-
-## Obtention du token Microsoft Graph
-
-### Option 1: Graph Explorer (Recommandé pour tests)
-1. Aller sur [Microsoft Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer)
-2. Se connecter avec votre compte Microsoft 365
-3. Dans l'onglet "Permissions", demander les permissions nécessaires :
-   - `Sites.Read.All` : Lecture des sites SharePoint
-   - `Files.Read.All` : Lecture des fichiers
-   - `Files.ReadWrite.All` : Lecture/écriture (pour export)
-4. Copier le token depuis les en-têtes de requête
-
-### Option 2: Azure App Registration (Production)
-1. Créer une app registration dans [Azure Portal](https://portal.azure.com)
-2. Configurer les permissions d'API :
-   - Microsoft Graph API
-   - Permissions déléguées ou d'application selon besoin
-3. Implémenter le flow OAuth 2.0 approprié
-4. Obtenir un access token valide
-
-## Structure SharePoint
-
-### Sites et drives
-SharePoint organise le contenu en :
-- **Sites** : Collections de listes, bibliothèques et pages
-- **Drives** : Bibliothèques de documents au sein des sites
-- **Items** : Fichiers et dossiers dans les drives
-
-### Exemples d'URL SharePoint
-```
-https://contoso.sharepoint.com/sites/project-alpha
-https://contoso.sharepoint.com/sites/hr/finance  
-https://contoso-my.sharepoint.com/personal/user_contoso_com
-```
-
-## Utilisation
-
-```bash
-# Mode interactif
-hubdoc-tool --engine sharepoint
-
-# Avec limite de documents
-hubdoc-tool --engine sharepoint --limit 100
-```
-
-## Fichier de configuration
-
-Créer `sharepoint-config.json` :
-
-```json
-{
-  "siteUrl": "https://contoso.sharepoint.com/sites/documents",
-  "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs...",
-  "limit": 50
-}
-```
-
-### Avec drive spécifique
-```json
-{
-  "siteUrl": "https://contoso.sharepoint.com/sites/project",
-  "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs...",
-  "driveId": "b!-RIj2DuyvEyV1T4NlOaMHk8XkS_I8MdFlUCq1BlcjgmhRfAj3-Z8RY2VpuvV_tpd",
-  "folderId": "01BYE5RZ6QN3ZWBTUBEFD3GSPGOHDJD36K"
-}
-```
-
-## Fonctionnalités supportées
-
-### Scan (✅)
-- Parcours récursif de tous les dossiers
-- Support des drives multiples
-- Métadonnées SharePoint complètes
-- Versions de fichiers et historique
-- Filtrage par taille, date, type MIME
-
-### Import (✅)
-- Téléchargement avec streaming
-- Préservation de la structure de dossiers
-- Conservation des métadonnées SharePoint
-- Support des gros fichiers
-
-### Export (✅)
-- Upload simple pour fichiers < 4MB
-- Sessions d'upload résistantes pour gros fichiers
-- Création automatique de l'arborescence
-- Métadonnées personnalisées
-
-## Permissions Microsoft Graph
-
-### Permissions déléguées (utilisateur connecté)
-- `Sites.Read.All` : Lecture de tous les sites
-- `Files.Read.All` : Lecture de tous les fichiers
-- `Files.ReadWrite.All` : Lecture/écriture de tous les fichiers
-
-### Permissions d'application (daemon)
-- `Sites.Read.All` : Lecture de tous les sites sans utilisateur connecté
-- `Files.Read.All` : Lecture de tous les fichiers
-- `Files.ReadWrite.All` : Lecture/écriture de tous les fichiers
-
-## API Microsoft Graph utilisée
-
-### Version API
-- **API Version** : Microsoft Graph v1.0
-- **Base URL** : `https://graph.microsoft.com/v1.0`
-- **Documentation** : [Microsoft Graph SharePoint API](https://docs.microsoft.com/en-us/graph/api/resources/sharepoint)
-
-### Endpoints utilisés
-- `GET /sites/{hostname}:{path}` : Obtient les infos du site
-- `GET /sites/{siteId}/drive` : Drive par défaut du site
-- `GET /drives/{driveId}/items/{itemId}/children` : Contenu d'un dossier
-- `GET /drives/{driveId}/items/{itemId}/content` : Télécharge un fichier
-- `PUT /drives/{driveId}/items/{parentId}:/{filename}:/content` : Upload un fichier
-
-## Types de fichiers SharePoint
-
-### Bibliothèques de documents
-- Documents généraux
-- Images et médias
-- Formulaires et modèles
-- Pages SharePoint
-
-### Métadonnées disponibles
-- **Standard** : nom, taille, dates de création/modification
-- **SharePoint** : colonnes personnalisées, types de contenu
-- **Versions** : historique des versions du document
-- **Check-out** : statut de réservation
-- **Audit** : qui a créé/modifié et quand
-
-## Limitations
-
-### Quotas et limites
-- Taille max par fichier : 250GB
-- Stockage par site : 25TB par défaut
-- API throttling : jusqu'à 10 000 requêtes par 10 minutes
-
-### Restrictions de noms
-- Caractères interdits : `" * : < > ? / \ |`
-- Noms de fichiers réservés : `CON`, `PRN`, `AUX`, etc.
-- Longueur max du chemin : 400 caractères
-
-### Performances
-- Upload simultané recommandé : max 2-3 fichiers
-- Taille minimum pour upload résistant : 4MB
-- Timeout par défaut : 30 secondes
-
-## Troubleshooting
-
-### Erreur 401: Token invalide/expiré
-- Vérifier que le token n'a pas expiré
-- Régénérer un nouveau token Graph Explorer
-- Vérifier les permissions demandées
-
-### Erreur 403: Accès refusé
-- Vérifier les permissions sur le site SharePoint
-- S'assurer que l'utilisateur a accès au contenu
-- Contrôler les permissions Graph API accordées
-
-### Erreur 404: Site/Drive non trouvé
-- Vérifier l'URL du site SharePoint
-- S'assurer que le site existe et est accessible
-- Contrôler l'orthographe de l'URL
-
-### Erreur 429: Too Many Requests
-- Le plugin gère automatiquement le throttling
-- Réduire le nombre de requêtes simultanées
-- Utiliser des pauses entre les lots
-
-## Bonnes pratiques
-
-### Sécurité
-- Utiliser des tokens avec durée de vie limitée
-- Appliquer le principe du moindre privilège
-- Auditer les accès aux contenus sensibles
-- Utiliser Azure Conditional Access
-
-### Performance
-- Organiser les fichiers en hiérarchies équilibrées
-- Éviter les dossiers avec trop de fichiers (>5000)
-- Utiliser la fonctionnalité de recherche SharePoint
-- Implémenter des règles de rétention
-
-### Gouvernance
-- Définir des types de contenu SharePoint appropriés
-- Configurer des colonnes de métadonnées obligatoires
-- Utiliser les politiques de conformité Microsoft 365
-- Planifier la sauvegarde et la récupération
-
-### Développement
-- Implémenter une gestion robuste des erreurs
-- Utiliser les notifications webhook pour les changements
-- Optimiser les requêtes Graph avec $select et $expand
-- Mettre en cache les informations de structure