CRM Custom - Guide de démarrage

Structure complète du projet

4. Instructions de démarrage

Option 1: Avec Docker (Recommandé)

# 1. Dans le dossier du projet CRM

# 2. Démarrer avec Docker Compose
docker-compose up -d

# L'application sera disponible sur:
# - Frontend: http://localhost:5173
# - Backend API: http://localhost:3000
# - PostgreSQL: localhost:5432

Option 2: Sans Docker (Développement local)

# 1. Installer PostgreSQL et créer la base de données
psql -U postgres -c "CREATE DATABASE crm_db;"
psql -U postgres -d crm_db -f init.sql

# 2. Backend
cd backend
npm install
npm run dev

# 3. Frontend (dans un nouveau terminal)
cd frontend
npm install
npm run dev

5. Utilisation avec n8n

Configuration n8n

Ajoutez un noeud HTTP Request avec ces paramètres:

Récupérer des enregistrements:

• Method: GET
• URL: http://localhost:3000/api/records/{tableId}
• Query Parameters:
  • page: 1
  • limit: 50
  • filters: {"nom": "test"}

Créer un enregistrement:

• Method: POST
• URL: http://localhost:3000/api/records/{tableId}
• Body (JSON):

{
  "data": {
    "nom": "Nouveau client",
    "email": "client@example.com",
    "telephone": "0123456789"
  }
}

Mise à jour:

• Method: PUT
• URL: http://localhost:3000/api/records/{tableId}/{recordId}

Export en masse:

• Method: GET
• URL: http://localhost:3000/api/records/{tableId}/export

Endpoints disponibles pour n8n

• GET /api/bases - Liste des bases
• GET /api/tables - Liste des tables
• GET /api/columns/{tableId} - Colonnes d'une table
• GET /api/records/{tableId} - Enregistrements
• POST /api/records/{tableId} - Créer
• PUT /api/records/{tableId}/{recordId} - Modifier
• DELETE /api/records/{tableId}/{recordId} - Supprimer
• POST /api/records/{tableId}/bulk - Création en masse
• GET /api/audit?recordId={id} - Historique

6. Fonctionnalités implémentées

✅ Types de colonnes:

• Texte, Nombre, Date, Checkbox
• Select/Multiselect avec options
• Email, Téléphone, URL
• Devise, Formule

✅ Fonctionnalités:

• Tables multiples personnalisables
• Relations entre tables
• Édition inline dans la grille
• Tri et filtrage
• Import/Export CSV et Excel
• Historique des modifications
• API REST complète pour n8n

✅ Interface:

• Mode sombre uniquement
• Design moderne avec Tailwind CSS
• Grille style Airtable
• Responsive désactivé (desktop only)

7. Personnalisation

Pour ajouter une nouvelle table:

1. Utiliser l'API ou modifier directement dans PostgreSQL
2. Les colonnes sont dynamiques et configurables
3. Les relations se définissent via la table table_relations

Pour personnaliser l'interface:

• Modifier frontend/src/App.tsx
• Les couleurs sont dans tailwind.config.js
• Les icônes utilisent Lucide React

Support

• API Documentation: http://localhost:3000/
• Logs: Vérifier les logs Docker avec docker-compose logs -f
• Base de données: Se connecter avec pgAdmin ou DBeaver