Files
LogiFlow/tmp/nocodb-setup/COMPLETE_SETUP.md
T
michaelschal 5a16936591 Improve NocoDB configuration handling for production deployments
Update client and server logic to gracefully handle missing NocoDB configurations, providing more informative error messages and ensuring optional NocoDB fields are handled correctly.

Replit-Commit-Author: Agent
Replit-Commit-Session-Id: c52a701b-4841-4d00-b8cf-5a41c12abdf3
Replit-Commit-Checkpoint-Type: full_checkpoint
Replit-Commit-Screenshot-Url: https://storage.googleapis.com/screenshot-production-us-central1/1957c339-2757-4d1f-8e92-e9f71a1ce58e/c52a701b-4841-4d00-b8cf-5a41c12abdf3/3uCfEKb
2025-08-13 09:21:08 +00:00

3.1 KiB

Guide Complet - Configuration NocoDB Production

❌ PROBLÈME IDENTIFIÉ

Votre serveur de production n'a aucune configuration NocoDB dans la base de données. C'est pourquoi vous ne voyez rien.

✅ SOLUTION : Configuration Complète

Étape 1 : Ajout Configuration NocoDB

Connectez-vous à votre base PostgreSQL de production et exécutez :

-- 1. Vérifier si la table existe
\d nocodb_config

-- 2. Insérer votre configuration NocoDB
INSERT INTO nocodb_config (
  name, 
  base_url, 
  project_id, 
  api_token, 
  description, 
  is_active
) VALUES (
  'Production Principal', 
  'https://app.nocodb.com',  -- ou votre URL NocoDB
  'VOTRE_PROJECT_ID',        -- À remplacer
  'VOTRE_API_TOKEN',         -- À remplacer  
  'Configuration principale pour vérification automatique factures',
  true
);

-- 3. Vérifier l'insertion
SELECT * FROM nocodb_config;

Étape 2 : Configuration des Magasins

-- Lister vos magasins existants
SELECT id, name FROM groups;

-- Configurer chaque magasin (exemple pour ID 1)
UPDATE groups SET 
  nocodb_config_id = 1,  -- ID de la config créée
  nocodb_table_name = 'VOTRE_TABLE_FACTURES',  -- Nom réel de votre table NocoDB
  invoice_column_name = 'reference_facture',    -- Colonne référence
  nocodb_bl_column_name = 'numero_bl',          -- Colonne BL
  nocodb_amount_column_name = 'montant',        -- Colonne montant
  nocodb_supplier_column_name = 'fournisseur'   -- Colonne fournisseur
WHERE id = 1;  -- Remplacer par l'ID réel

-- Répéter pour chaque magasin avec ses propres paramètres

Étape 3 : Obtenir les Informations NocoDB

  1. Project ID : Dans NocoDB, aller dans Project Settings
  2. API Token : Account Settings > Tokens > Create new token
  3. Table Names : Noter les noms exacts de vos tables
  4. Column Names : Noter les noms exacts de vos colonnes

Étape 4 : Test de Configuration

Une fois configuré, redémarrez votre serveur et vous devriez voir :

  • Boutons loupe et coche dans le rapprochement
  • Logs de débogage dans la console serveur
  • Notifications de succès/erreur

Étape 5 : Vérification

-- Voir toutes les configurations
SELECT 
  g.id,
  g.name as magasin,
  g.nocodb_config_id,
  g.nocodb_table_name,
  g.invoice_column_name,
  nc.base_url,
  nc.is_active
FROM groups g
LEFT JOIN nocodb_config nc ON g.nocodb_config_id = nc.id;

🔧 Structure Attendue de vos Tables NocoDB

Chaque table de factures doit contenir au minimum :

  • Référence Facture (ex: FAC-2024-001)
  • Numéro BL (ex: BL123456)
  • Montant (ex: 150.75)
  • Fournisseur (ex: "Fournisseur ABC")

🚨 Points Critiques

  1. API Token : Doit avoir accès lecture à vos tables
  2. Noms Exacts : Table/colonne names doivent être exacts (sensible à la casse)
  3. Données Test : Ayez quelques factures test dans NocoDB
  4. Connexion : Vérifiez que votre serveur peut accéder à NocoDB

📞 Support

Si ça ne marche toujours pas après configuration :

  1. Vérifiez les logs serveur Node.js
  2. Testez l'API NocoDB manuellement avec curl
  3. Confirmez que les noms de colonnes sont corrects