Skip to content

babsacademy/perfectbox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

My Perfect Box 🎁

Plateforme e-commerce de coffrets cadeaux personnalisés — Dakar, Sénégal


Description

My Perfect Box est une boutique en ligne haut de gamme proposant des coffrets cadeaux personnalisés pour particuliers et entreprises au Sénégal. Le client choisit une box prête-à-offrir depuis le catalogue, configure sa propre box sur mesure via un tunnel interactif, ou soumet une demande de devis B2B pour des cadeaux d'entreprise et objets publicitaires.


Problème résolu

Au Sénégal, offrir un cadeau personnalisé, soigné et livré rapidement est une démarche fragmentée : il faut trouver les produits, les faire emballer, personnaliser et livrer séparément. My Perfect Box centralise l'ensemble — sélection, personnalisation, emballage premium et livraison — en une seule commande en ligne.


Stack technique

Couche Technologie
Frontend Livewire 3 + Flux UI (composants temps-réel sans JS manuel)
Backend Laravel 11, PHP 8.3
CSS Tailwind CSS v4 (config via @theme en CSS, Vite)
Base de données MySQL
Dev local Laravel Herd · URL : perfectbox.test
Hébergement À définir (VPS Hetzner ou Hostinger envisagé)
Paiement Wave API + Orange Money (intégration en cours)
Email SMTP Laravel Mailer (notifications commandes et devis)
WhatsApp Lien direct wa.me/221777216581 + bouton flottant

Fonctionnalités principales

B2C — Cadeaux individuels

  • Catalogue avec filtres (catégorie, prix, recherche texte) et tri, pagination
  • Fiche produit avec galerie d'images, personnalisation (prénom destinataire + message)
  • Configurateur sur mesure : sélection occasion → choix des articles → aperçu → panier
  • Panier persistant en session avec gestion des quantités
  • Checkout 3 étapes : coordonnées → livraison (Dakar 2 000 FCFA / national 5 000 FCFA) → paiement
  • Confirmation de commande avec référence MPB-XXXX et suivi par lien

B2B — Entreprises & objets publicitaires

  • Page Entreprise : offre cadeaux corporatifs, processus, formulaire de devis
  • Page Objets Publicitaires : galerie catalogue (mugs, tote bags, agendas, high-tech…), formulaire devis
  • Sauvegarde des devis en base (quotes table) + notification email admin

Admin & exploitation

  • Suivi de commande public par référence (/suivre-ma-commande/{ref})
  • Notifications email à l'admin à chaque nouvelle commande et devis

Pages de l'application

URL Description
/ Page d'accueil — hero, collections, produits vedettes, témoignages, CTA
/catalogue Catalogue filtrable — toutes les box & coffrets
/catalogue/{slug} Fiche produit détaillée
/configurer-ma-box Configurateur interactif sur mesure
/entreprises Offre B2B — cadeaux d'entreprise
/objets-publicitaires Catalogue objets promo + formulaire devis
/panier Panier session
/commander Checkout 3 étapes
/a-propos À propos de la marque
/contact Formulaire de contact + coordonnées
/suivre-ma-commande Suivi de commande par référence

Modèles de données

Product       — nom, slug, prix, description, images (JSON), catégorie, is_featured, is_personalizable, actif
Category      — nom, slug (anniversaire, amour, noël, bébé, corporate…)
Order         — référence MPB-XXXX, items (JSON), client, adresse, mode paiement, statut, total
Quote         — entreprise, contact, email, téléphone, quantité, type box, message, statut

Identité visuelle

Couleur HEX Usage
Bleu nuit #060E26 Texte principal, footer, boutons sombres
Bleu profond #0D2F53 Topbar, hero sections sombres
Bleu acier #1B496C Sections stats mid-tone
Bleu lumineux #1A6496 CTAs, liens, focus states
Or / Doré #CD9430 Accent, prix, boutons primaires, badges
Beige clair #EAE3D5 Fond de page, cartes, sections neutres
Gris chaud #A39D93 Bordures, éléments atténués
Gris foncé #6D665E Texte secondaire, labels, eyebrows

Typographie : Cormorant Garamond (display / titres italiques) + Jost (labels, boutons, navigation)


Utilisateurs cibles

  • Particuliers au Sénégal souhaitant offrir un cadeau personnalisé (anniversaire, mariage, naissance, fête…)
  • PME et grandes entreprises sénégalaises cherchant des cadeaux d'entreprise et objets publicitaires en lot
  • Diaspora voulant envoyer un cadeau à un proche à Dakar

Modèle économique

  • Vente directe de coffrets prêts-à-l'emploi (catalogue)
  • Marge sur configurateur (box sur mesure avec tarif à la composition)
  • B2B volume : commandes groupées pour entreprises avec devis personnalisé
  • Objets publicitaires : impression/gravure en lot avec marge sur production

Statut actuel

MVP en développement — frontend complet, tunnel commande fonctionnel (session panier → checkout → confirmation), paiement mobile en cours d'intégration.


Ce qui reste à faire

  • Intégration Wave API — paiement en ligne (Wave, Orange Money)
  • Tableau de bord admin — gestion commandes, produits, devis, statuts
  • Envoi emails automatiques — confirmation commande client + notification admin
  • Notifications SMS/WhatsApp — statuts commande en temps réel
  • SEO & meta tags — Open Graph, sitemap, balises structurées
  • Mise en production — déploiement serveur, SSL, domaine perfectbox.sn
  • Gestion des stocks — quantités disponibles par produit
  • Avis clients — système de témoignages après livraison
  • Tableau de bord commandes client — historique, suivi, re-commande

Installation locale

# Cloner le projet
git clone <repo-url>
cd perfectbox

# Dépendances PHP
composer install

# Dépendances JS
npm install

# Environnement
cp .env.example .env
php artisan key:generate

# Base de données
php artisan migrate --seed

# Compilation assets
npm run dev

Requiert PHP 8.3+, MySQL, Node 20+, Laravel Herd recommandé en local.


Variables d'environnement clés

APP_URL=http://perfectbox.test

DB_DATABASE=perfectbox
DB_USERNAME=root
DB_PASSWORD=

MAIL_FROM_ADDRESS=hello@perfectbox.sn
MAIL_FROM_NAME="My Perfect Box"
MAIL_ADMIN_ADDRESS=thiambabs77@gmail.com

# À venir
WAVE_API_KEY=
WAVE_SECRET=

Contact & liens

Site perfectbox.sn (à venir)
Email hello@perfectbox.sn
WhatsApp +221 77 721 65 81
Admin thiambabs77@gmail.com
Localisation Dakar, Sénégal

My Perfect Box — l'attention qui compte.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages