LogiFlow/PRODUCTION_DEBUG.md

🐛 DEBUG PRODUCTION - Module Avoirs

⚠️ Problème identifié

D'après votre capture d'écran, l'erreur "Failed to create avoir" indique un problème côté serveur.

🔍 ÉTAPES DE DÉBOGAGE

1️⃣ Vérifier que la table avoirs existe

# Connectez-vous à votre base PostgreSQL
psql -d votre_database_name

# Vérifiez si la table existe
\dt avoirs

# Si elle n'existe pas, vous verrez "Did not find any relation named avoirs"

2️⃣ Créer la table manquante

Si la table n'existe pas, exécutez le script SQL fourni :

# Depuis votre serveur, exécutez :
psql -d votre_database_name -f sql/create_avoirs_table.sql

# Ou copiez-collez le contenu du fichier directement :

-- Script de création de la table avoirs pour la production
CREATE TABLE IF NOT EXISTS avoirs (
  id SERIAL PRIMARY KEY,
  supplier_id INTEGER NOT NULL REFERENCES suppliers(id) ON DELETE CASCADE,
  group_id INTEGER NOT NULL REFERENCES groups(id) ON DELETE CASCADE,
  invoice_reference VARCHAR(255),
  amount DECIMAL(10,2),
  comment TEXT,
  commercial_processed BOOLEAN DEFAULT FALSE,
  status VARCHAR(50) DEFAULT 'En attente de demande' CHECK (status IN ('En attente de demande', 'Demandé', 'Reçu')),
  webhook_sent BOOLEAN DEFAULT FALSE,
  nocodb_verified BOOLEAN DEFAULT FALSE,
  nocodb_verified_at TIMESTAMP,
  processed_at TIMESTAMP,
  created_by VARCHAR(255) NOT NULL REFERENCES users(id) ON DELETE CASCADE,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- Index pour améliorer les performances
CREATE INDEX IF NOT EXISTS idx_avoirs_supplier_id ON avoirs(supplier_id);
CREATE INDEX IF NOT EXISTS idx_avoirs_group_id ON avoirs(group_id);
CREATE INDEX IF NOT EXISTS idx_avoirs_created_by ON avoirs(created_by);
CREATE INDEX IF NOT EXISTS idx_avoirs_status ON avoirs(status);
CREATE INDEX IF NOT EXISTS idx_avoirs_created_at ON avoirs(created_at DESC);

-- Trigger pour mettre à jour automatically updated_at
CREATE OR REPLACE FUNCTION update_avoirs_updated_at()
RETURNS TRIGGER AS $$
BEGIN
  NEW.updated_at = CURRENT_TIMESTAMP;
  RETURN NEW;
END;
$$ language 'plpgsql';

DROP TRIGGER IF EXISTS update_avoirs_updated_at_trigger ON avoirs;
CREATE TRIGGER update_avoirs_updated_at_trigger
  BEFORE UPDATE ON avoirs
  FOR EACH ROW
  EXECUTE FUNCTION update_avoirs_updated_at();

3️⃣ Vérifier les logs serveur

# Sur votre serveur, surveillez les logs :
tail -f /var/log/your_app.log

# Ou si vous utilisez PM2 :
pm2 logs your_app_name

# Ou Docker :
docker logs your_container_name -f

4️⃣ Tester manuellement l'API

# Test avec curl pour vérifier l'API
curl -X POST http://votre-serveur.com/api/avoirs \
  -H "Content-Type: application/json" \
  -H "Cookie: connect.sid=your_session_cookie" \
  -d '{
    "supplierId": 1,
    "groupId": 1,
    "invoiceReference": "TEST123",
    "amount": 100.00,
    "comment": "Test avoir",
    "commercialProcessed": false
  }'

5️⃣ Vérifier les permissions de base

-- Vérifiez que votre utilisateur de base de données a les bonnes permissions
GRANT ALL PRIVILEGES ON TABLE avoirs TO your_db_user;
GRANT USAGE, SELECT ON SEQUENCE avoirs_id_seq TO your_db_user;

🛠️ SOLUTIONS COMMUNES

Erreur : Table 'avoirs' doesn't exist

➡️ Exécutez le script SQL ci-dessus

Erreur : Permission denied

➡️ Vérifiez les droits sur la table et la séquence

Erreur : Foreign key constraint fails

➡️ Vérifiez que les IDs supplierId et groupId existent dans leurs tables respectives

Erreur : Webhook timeout

➡️ Le webhook n'est pas bloquant, l'avoir sera créé même si le webhook échoue

🔧 COMMANDES DE DIAGNOSTIC

-- Vérifier la structure de la table
\d avoirs

-- Voir les contraintes
SELECT conname, contype FROM pg_constraint WHERE conrelid = 'avoirs'::regclass;

-- Compter les enregistrements
SELECT COUNT(*) FROM avoirs;

-- Tester une insertion basique
INSERT INTO avoirs (supplier_id, group_id, invoice_reference, amount, created_by) 
VALUES (1, 1, 'TEST-001', 50.00, 'admin') 
RETURNING id;

⚡ RESTART RAPIDE

Si tout semble correct mais ça ne marche toujours pas :

# Redémarrez votre application
pm2 restart your_app_name

# Ou Docker
docker restart your_container_name

# Ou service systemd
sudo systemctl restart your_app_service

---

💡 Une fois la table créée et les permissions correctes, l'interface devrait fonctionner immédiatement !