mirror of
https://github.com/R0m1k3/LogiFlow.git
synced 2026-10-11 17:27:31 +02:00
Create a comprehensive guide for using the platform's features
Add a detailed README.md file outlining installation, configuration, and core functionalities of the enterprise weather management platform. Replit-Commit-Author: Agent Replit-Commit-Session-Id: d43bd811-9372-45a7-8ac9-4a954c0538e1 Replit-Commit-Checkpoint-Type: full_checkpoint Replit-Commit-Screenshot-Url: https://storage.googleapis.com/screenshot-production-us-central1/1957c339-2757-4d1f-8e92-e9f71a1ce58e/d43bd811-9372-45a7-8ac9-4a954c0538e1/Awjwx2q
This commit is contained in:
michaelschal committed
1 parent
ed3f6668f0
commit
0c47c69619
1 file changed
+228
@@ -0,0 +1,228 @@
|
|||||||
|
# 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
|
||||||
|
- Node.js 18+
|
||||||
|
- PostgreSQL 13+
|
||||||
|
- Clé API Visual Crossing (gratuite sur [visualcrossing.com](https://www.visualcrossing.com/))
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
```bash
|
||||||
|
# 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
|
||||||
|
|
||||||
|
# Initialiser la base de données
|
||||||
|
npm run db:push
|
||||||
|
|
||||||
|
# Démarrer l'application
|
||||||
|
npm run dev
|
||||||
|
```
|
||||||
|
|
||||||
|
### Configuration de l'API Météo
|
||||||
|
1. Créez un compte gratuit sur [Visual Crossing](https://www.visualcrossing.com/)
|
||||||
|
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
|
||||||
|
- **Node.js** : Runtime JavaScript haute performance
|
||||||
|
- **Express** : Framework web minimaliste
|
||||||
|
- **TypeScript** : Développement sécurisé côté serveur
|
||||||
|
- **Drizzle ORM** : ORM moderne et type-safe
|
||||||
|
- **Zod** : Validation de schémas robuste
|
||||||
|
|
||||||
|
### 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/ # Backend Express
|
||||||
|
│ ├── routes.ts # Définition des routes API
|
||||||
|
│ ├── storage.ts # Interface de stockage
|
||||||
|
│ ├── weatherService.ts # Service météorologique
|
||||||
|
│ └── index.ts # Point d'entrée du serveur
|
||||||
|
├── shared/ # Code partagé
|
||||||
|
│ └── schema.ts # Schémas de base de données
|
||||||
|
├── migrations/ # Migrations de base de données
|
||||||
|
└── backups/ # Dossier des sauvegardes
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🔧 Configuration Avancée
|
||||||
|
|
||||||
|
### Variables d'Environnement
|
||||||
|
```env
|
||||||
|
# Base de données
|
||||||
|
DATABASE_URL=postgresql://user:password@localhost:5432/dbname
|
||||||
|
|
||||||
|
# Météo
|
||||||
|
VISUAL_CROSSING_API_KEY=votre_clé_api_ici
|
||||||
|
|
||||||
|
# Application
|
||||||
|
NODE_ENV=production
|
||||||
|
PORT=3000
|
||||||
|
```
|
||||||
|
|
||||||
|
### 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
|
||||||
Reference in new issue
Block a user