Une plateforme e-commerce complète et moderne, optimisée pour le marché sénégalais avec intégration de Wave et Orange Money.
- 🇸🇳 Adapté au Sénégal: Formats locaux (FCFA, téléphone +221), français (fr-SN)
- 💳 Paiements locaux: Wave et Orange Money intégrés (frontend prêt)
- 🎨 Design moderne: Interface élégante et responsive (Tailwind CSS)
- 🚀 Performance: Next.js 15 + Laravel 11
- 🔐 Sécurisé: Authentification Laravel Sanctum
- 📱 Responsive: Compatible mobile, tablette et desktop
- 👨💼 Dashboard Admin: Gestion complète des produits, commandes et stock
T-Express/
├── T-Express-Frontend/ # Next.js 15 + TypeScript + Redux + Tailwind
└── T-Express-backend/ # Laravel 11 + MySQL + Sanctum
- Framework: Next.js 15 (App Router)
- Langage: TypeScript
- État: Redux Toolkit
- Styling: Tailwind CSS
- UI: Design actuel conservé et amélioré
- Framework: Laravel 11
- Base de données: MySQL
- Authentification: Laravel Sanctum
- API: RESTful JSON
- PHP 8.2+
- Composer
- Node.js 18+
- MySQL 8+
- npm ou yarn
# 1. Installer les dépendances
.\install.ps1
# 2. Configurer la base de données dans T-Express-backend\.env
# 3. Créer la base de données
mysql -u root -p
CREATE DATABASE t_express;
exit;
# 4. Lancer les migrations
cd T-Express-backend
php artisan migrate
php artisan storage:link
# 5. Démarrer les serveurs
cd ..
.\start-project.ps1cd T-Express-backend
# Installation
composer install
copy .env.example .env
php artisan key:generate
# Configuration de la base de données dans .env
# DB_DATABASE=t_express
# DB_USERNAME=root
# DB_PASSWORD=votre_mot_de_passe
# Migrations
php artisan migrate
php artisan storage:link
# Démarrage
php artisan serveBackend accessible sur: http://localhost:8000
cd T-Express-Frontend
# Installation
npm install
copy .env.example .env.local
# Démarrage
npm run devFrontend accessible sur: http://localhost:3000
- 📖 QUICKSTART.md - Guide de démarrage rapide
- 🔌 INTEGRATION.md - Documentation d'intégration complète
- 🔧 API_DOCUMENTATION.md - Documentation API Backend
Frontend (T-Express-Frontend/)
src/
├── app/ # Pages Next.js
├── components/ # Composants React (design conservé)
│ ├── Payment/ # Wave & Orange Money
│ ├── Admin/ # Dashboard admin
│ └── ...
├── config/ # Configuration API et localisation
├── context/ # Contexts React (Auth, Panier, Favoris)
├── hooks/ # Hooks personnalisés
├── lib/ # Utilitaires (format FCFA, téléphone)
├── services/ # Services API
├── redux/ # État Redux
└── types/ # Types TypeScript
Backend (T-Express-backend/)
app/
├── Http/
│ └── Controllers/
│ └── Api/
│ ├── Admin/ # Contrôleurs admin (NOUVEAUX)
│ │ ├── AdminProduitController.php
│ │ ├── AdminCategorieController.php
│ │ ├── AdminCommandeController.php
│ │ ├── AdminStockController.php
│ │ └── AdminDashboardController.php
│ └── ... # Autres contrôleurs API
├── Models/ # Modèles Eloquent
└── Services/ # Logique métier
POST /api/auth/register- InscriptionPOST /api/auth/login- ConnexionPOST /api/catalogue/index- Liste des produitsPOST /api/catalogue/rechercher- Recherche avec filtresPOST /api/catalogue/produit- Détail produit
POST /api/panier/contenu- Contenu du panierPOST /api/panier/ajouter- Ajouter au panierPOST /api/commande/creer- Créer une commandePOST /api/favoris/toggle- Gérer les favoris- Et 20+ autres endpoints...
POST /api/admin/produits- CRUD produitsPOST /api/admin/categories- CRUD catégoriesPOST /api/admin/commandes- Gestion commandesPOST /api/admin/stock- Gestion stockPOST /api/admin/dashboard/stats- Statistiques
Voir API_DOCUMENTATION.md pour la liste complète.
- Composants d'interface Wave et Orange Money créés
- Sélecteur de mode de paiement fonctionnel
- Formulaires de paiement avec validation
À compléter par l'équipe fintech:
- Intégration des API Wave et Orange Money
- Gestion des webhooks
- Vérification des transactions
Les hooks et placeholders sont déjà en place dans:
T-Express-Frontend/src/services/paiement.service.tsT-Express-Frontend/src/components/Payment/
Le système gère automatiquement:
import { formatPrice, formatPhone, formatDate } from '@/lib/utils';
formatPrice(50000); // "50 000 FCFA"
formatPhone('771234567'); // "+221 77 123 45 67"
formatDate(new Date()); // "26 octobre 2025"Un dashboard admin complet est disponible avec:
- 📊 Statistiques en temps réel
- 🛍️ Gestion des produits (CRUD)
- 📁 Gestion des catégories
- 📦 Gestion des commandes et statuts
- 📦 Gestion du stock
- 🔔 Alertes de stock faible
Exemple: T-Express-Frontend/src/components/Admin/Dashboard.tsx
- Services API complets pour tous les endpoints
- Hooks React personnalisés (useAuth, usePanier, useFavoris)
- Contexts globaux (Auth, Panier, Favoris)
- Client HTTP avec gestion d'erreurs
- Types TypeScript pour toute l'API
- Utilitaires de formatage sénégalais
- Composants de paiement (Wave, Orange Money)
- Dashboard admin exemple
- Design actuel conservé et amélioré
- Tous les endpoints API créés
- Contrôleurs admin complets (5 nouveaux)
- Authentification Sanctum configurée
- CORS configuré pour le frontend
- Gestion des images (upload/storage)
- Modèles et relations Eloquent
- Services métier
- Migrations complètes
- Implémenter l'API Wave côté backend
- Implémenter l'API Orange Money côté backend
- Configurer les webhooks
- Tests en sandbox
- Mise en production
- Middleware 'admin' pour sécuriser les routes admin
- Notifications par email
- Cache Redis
- Tests unitaires
npm run build
npm run startcomposer install --optimize-autoloader --no-dev
php artisan config:cache
php artisan route:cache
php artisan storage:link- Frontend: Voir
T-Express-Frontend/src/services/et/hooks/ - Backend: Voir
T-Express-backend/app/Http/Controllers/Api/ - API: Voir
T-Express-backend/routes/api.php
Le frontend est 100% prêt à recevoir le backend !
- ✅ Tous les services et hooks sont créés
- ✅ Le design actuel est conservé
- ✅ L'intégration est complète et professionnelle
- ✅ Le code est propre et bien documenté
- ✅ Les formats sénégalais sont gérés automatiquement
- ✅ Le dashboard admin est fonctionnel
- ✅ Les paiements locaux sont intégrés (frontend)
Il suffit de démarrer les deux serveurs et tout fonctionne ensemble !
T-Express - Votre boutique en ligne au Sénégal 🇸🇳
Développé avec ❤️ par des développeurs seniors pour le marché sénégalais