LogiFlow/README.md

Plateforme de Gestion Logistique avec Météo Intégrée

Une plateforme d'entreprise moderne pour la gestion logistique, le suivi des livraisons et l'intégration météorologique, conçue pour optimiser les opérations commerciales avec des insights météorologiques en temps réel.

🌟 Fonctionnalités Principales

📦 Gestion des Commandes et Livraisons

• Création et suivi des commandes : Interface complète pour gérer les commandes clients
• Gestion des livraisons : Suivi détaillé des livraisons avec statuts en temps réel
• Liaison commandes-livraisons : Association automatique et manuelle des commandes aux livraisons
• Historique complet : Traçabilité complète de toutes les opérations

🌤️ Widget Météo Intelligent

• Météo actuelle : Affichage de la température et conditions météorologiques du jour
• Comparaison annuelle : Comparaison avec la même date de l'année précédente
• Géolocalisation automatique : Détection automatique de votre localisation
• Interface bilingue : Support complet du français
• Mise à jour automatique : Données rafraîchies toutes les 30 minutes

🛠️ Service Après-Vente (SAV)

• Gestion des tickets : Système complet de tickets de support
• Historique des interventions : Suivi détaillé de tous les échanges
• Statuts personnalisés : Gestion flexible des états de tickets
• Notifications : Alertes automatiques pour les mises à jour

📊 Réconciliation et Facturation

• Réconciliation BL/Factures : Rapprochement automatique des bons de livraison et factures
• Vérification intelligente : Cache optimisé pour les vérifications répétées
• Gestion des conflits : Résolution automatique des incohérences
• Mise à jour en temps réel : Interface réactive avec feedback immédiat

👥 Gestion Multi-Tenant

• Groupes d'utilisateurs : Organisation par entreprise ou département
• Permissions granulaires : Contrôle d'accès fin par fonctionnalité
• Rôles personnalisés : Admin, employé, client avec droits spécifiques
• Isolation des données : Séparation stricte entre les organisations

💾 Sauvegarde et Sécurité

• Sauvegardes automatiques : Backup quotidien programmé à 2h du matin
• Sauvegardes manuelles : Possibilité de créer des sauvegardes à la demande
• Authentification sécurisée : Sessions chiffrées et gestion des mots de passe
• Logs détaillés : Traçabilité complète des opérations

🚀 Installation et Configuration

Prérequis

• Rust stable (serveur) et Node.js 20+ (construction de l'interface uniquement)
• PostgreSQL 13+ et pg_dump (sauvegardes)
• Clé API Visual Crossing (gratuite sur visualcrossing.com)

Installation

# Cloner le projet
git clone [URL_DU_PROJET]
cd weather-management-platform

# Installer les dépendances
npm install

# Configurer la base de données
cp .env.example .env
# Éditer .env avec vos paramètres de base de données

# Démarrer le serveur (API, migrations au démarrage) sur le port 3000
npm run dev:server

# Dans un autre terminal : l'interface avec rechargement à chaud (Vite),
# qui relaie /api vers le serveur
npm run dev

En production : npm run build (interface dans dist/public, binaire dans server-rs/target/release/logiflow) puis npm start, ou l'image Docker (docker compose up -d).

Configuration de l'API Météo

1. Créez un compte gratuit sur Visual Crossing
2. Obtenez votre clé API
3. Connectez-vous avec admin/admin
4. Allez dans Utilitaires → Paramètres Météo
5. Entrez votre clé API et votre localisation
6. Testez la connexion et sauvegardez

📱 Utilisation

Première Connexion

• Identifiants par défaut : admin / admin
• Changement obligatoire : Modifiez le mot de passe lors de la première connexion
• Configuration météo : Configurez l'API météo dans les utilitaires

Navigation Principale

• Tableau de bord : Vue d'ensemble avec météo et statistiques
• Commandes : Gestion complète des commandes clients
• Livraisons : Suivi et gestion des livraisons
• SAV : Service après-vente et tickets de support
• Réconciliation : Rapprochement BL/Factures
• Utilitaires : Configuration et outils administrateur

Fonctionnalités Courantes

Créer une Commande

1. Allez dans Commandes → Nouvelle Commande
2. Remplissez les informations client
3. Ajoutez les articles et quantités
4. Validez et sauvegardez

Suivre une Livraison

1. Accédez à Livraisons
2. Recherchez par numéro ou client
3. Consultez le statut et l'historique
4. Mettez à jour si nécessaire

Gérer un Ticket SAV

1. Ouvrez SAV → Nouveau Ticket
2. Décrivez le problème
3. Assignez la priorité
4. Suivez les échanges dans l'historique

🛠️ Technologies Utilisées

Frontend

• React 18 : Interface utilisateur moderne
• TypeScript : Typage statique pour la robustesse
• Tailwind CSS : Design system cohérent
• Shadcn/UI : Composants UI professionnels
• React Query : Gestion d'état et cache intelligent
• Wouter : Routage léger et performant

Backend

• Rust (axum, tokio, sqlx) : serveur unique, binaire statique (voir server-rs/README.md)
• Schéma : shared/schema.ts (Drizzle) reste la source, d'où est généré server-rs/src/schema.rs
• Zod : validation côté interface ; mêmes règles et mêmes messages côté serveur

Base de Données

• PostgreSQL : Base de données relationnelle performante
• Migrations automatiques : Évolution de schéma sécurisée
• Backup intégré : Système de sauvegarde automatique

APIs Externes

• Visual Crossing Weather API : Données météorologiques fiables
• OpenStreetMap Nominatim : Géocodage inverse pour la géolocalisation

📁 Structure du Projet

├── client/                 # Frontend React
│   ├── src/
│   │   ├── components/     # Composants réutilisables
│   │   ├── pages/         # Pages de l'application
│   │   ├── lib/           # Utilitaires et configuration
│   │   └── hooks/         # Hooks React personnalisés
├── server-rs/             # Serveur Rust (API, interface, migrations, tâches de fond)
│   └── src/
│       ├── router.rs      # Table des adresses de l'API
│       ├── modules/       # Une famille de routes par fichier
│       ├── startup.rs     # Migrations au démarrage
│       └── jobs.rs        # Sauvegardes automatiques, purge des caches
├── shared/                # Code partagé
│   ├── schema.ts         # Schémas de base de données (source de schema.rs)
│   └── permissions.json  # Matrice des droits (interface et serveur)
├── scripts/bench/         # Banc de comparaison avec l'ancien serveur Node
├── migrations/           # Migrations de base de données
└── backups/             # Dossier des sauvegardes

🔧 Configuration Avancée

Variables d'Environnement

# Base de données
DATABASE_URL=postgresql://user:password@localhost:5432/dbname

# Météo
VISUAL_CROSSING_API_KEY=votre_clé_api_ici

# Application
PORT=3000
SESSION_SECRET=…            # signe le cookie de session
ENCRYPTION_KEY=…            # chiffre les secrets en base (repli : SESSION_SECRET)
STATIC_DIR=dist/public      # interface construite par Vite
BACKUP_DIR=/app/backups
ALLOWED_ORIGINS=            # autres origines acceptées pour les écritures (facultatif)
RUST_LOG=info

Personnalisation

• Thèmes : Mode sombre/clair automatique
• Localisation : Interface entièrement en français
• Permissions : Système de rôles configurable
• Notifications : Alertes personnalisables

📈 Monitoring et Maintenance

Logs

• Développement : Logs détaillés en console
• Production : Logs optimisés pour les performances
• Erreurs : Gestion gracieuse avec fallbacks

Performance

• Cache intelligent : Mise en cache des données météo
• Lazy loading : Chargement optimisé des composants
• Optimisation bundle : Build production optimisé

Sauvegardes

• Automatiques : Tous les jours à 2h du matin
• Manuelles : Via l'interface d'administration
• Restauration : Processus guidé de restauration

🆘 Support et Dépannage

Problèmes Courants

L'API météo ne fonctionne pas

• Vérifiez votre clé API Visual Crossing
• Testez la connexion dans les paramètres
• Vérifiez votre quota API

Données manquantes

• Vérifiez la connexion à la base de données
• Consultez les logs serveur
• Vérifiez les permissions utilisateur

Interface lente

• Videz le cache navigateur
• Vérifiez votre connexion internet
• Redémarrez l'application

Contact

Pour toute question technique ou fonctionnelle, consultez les logs de l'application ou contactez l'équipe de développement.

📄 Licence

Ce projet est développé pour un usage d'entreprise. Tous droits réservés.

---

Version actuelle : 2.27.9
Dernière mise à jour : Août 2025
Compatibilité : Node.js 18+, PostgreSQL 13+, Navigateurs modernes