Projet personnel

Retail Plus

Un réseau social interne pour les équipes de magasin.

Application web que j'ai conçue et développée seul à partir de problématiques rencontrées en magasin. Elle réunit un fil d'actualité par magasin, des tâches et des checklists, des outils métier et un back-office de gestion des droits.

Statut
En développement
Code source
Dépôt privé
Technologies
Tableau de bord personnel de Retail Plus : indicateurs, raccourcis et planning du jour
Tableau de bord
Tableau de bord de Retail Plus sur mobile
Mobile
Tableau des tâches de Retail Plus en colonnes : à faire, en cours, à valider
Tâches
Tableau de bord d'administration de Retail Plus : utilisateurs, sites, contenus et droits
Administration

Captures de l'environnement de démonstration (données fictives, logo et identifiants de magasin floutés).

Mon rôle et le périmètre

Conception et développement en solo, à partir de besoins rencontrés en magasin. Les captures montrent un environnement de démonstration ; aucune adoption officielle ni résultat d’usage en entreprise n’est revendiqué.

Vue d’ensemble de l’architecture

  1. Interface React et navigation Inertia : les écrans utilisés par les équipes.

  2. Laravel : sessions, validation, contexte magasin et règles métier.

  3. Policies et permissions : autoriser les actions selon le rôle et le site.

  4. MariaDB et Redis : données relationnelles, cache et temps réel avec Reverb.

Interface, règles métier, données et temps réel : les principales couches du projet.

Le point de départ

Après des années en magasin, j'ai vu les mêmes difficultés revenir : des informations dispersées entre plusieurs canaux, des consignes difficiles à retrouver, un suivi des tâches et des checklists fait à la main. Retail Plus est ma réponse technique à ces problèmes, pensée pour les équipes plutôt que pour la direction.

Ce que fait l’application

  • Fil d'actualité par magasin

    Publications catégorisées, commentaires, mentions et dates d’expiration. Le fil distingue les contenus du magasin, les publications régionales et les communications nationales.

  • Tâches et checklists

    Tableau de tâches en temps réel, affectation, validation par un responsable, modèles réutilisables et récurrences. Checklists hebdomadaires par magasin.

  • Boîte à outils

    Générateurs de QR codes et de codes-barres, suivi des produits retournés, diagnostic guidé et formulaire de demande avec export PDF.

  • Apprentissage et documents

    Catalogue de modules de formation et bibliothèque de documents métier avec recherche.

  • Équipe et organigramme

    Annuaire, responsables directs et organigramme interactif pour chaque site.

  • Notifications et mobile

    Notifications push et temps réel par WebSocket ; application web installable sur téléphone (PWA).

  • Administration

    Gestion des utilisateurs, des sites, des contenus, des postes et des droits.

Choix de conception

  1. Un monolithe Laravel avec des pages React

    Laravel garde les sessions, le CSRF, les droits, les validations et la logique métier. Inertia ne remplace que la navigation et l'affichage des pages connectées : je n'ai pas à dupliquer la logique dans une API séparée.

  2. Une API JSON authentifiée

    Des routes protégées par Sanctum exposent les données métier. Les contrôleurs s’appuient sur des FormRequests, des policies et des ressources JSON ; les écrans interactifs peuvent consommer ces données sans recharger toute la page.

  3. Un contexte magasin et des périmètres explicites

    Le magasin actif est déterminé côté serveur. Les scopes Eloquent et les policies encadrent les requêtes et les actions selon la ressource. Le fil prévoit aussi des publications nationales et régionales, sans les confondre avec les données propres à un magasin.

  4. Des droits à plusieurs niveaux

    Rôle système, poste métier configurable et droits fonctionnels (Spatie Permission), avec des exceptions individuelles possibles. Les contrôles reposent sur des policies et des FormRequests ; le contenu riche est assaini avec HTMLPurifier.

  5. Un organigramme interactif avec React Flow

    React Flow affiche les relations entre collaborateurs. La logique de rattachement reste dans un service Laravel : appartenance au même magasin, comptes actifs, autorisations et refus des cycles sont contrôlés côté serveur.

  6. Des changements de hiérarchie transactionnels

    Le déplacement d’un collaborateur se déroule dans une transaction avec verrouillage en base. Les placements sont relus avant modification, l’historique est conservé et un événement de mise à jour est émis après la transaction.

Le compromis principal

Laravel conserve la logique métier et les sessions web, tandis qu’Inertia sert les pages React. Les routes JSON protégées par Sanctum complètent cette navigation pour les interactions métier et les sessions mobiles. Les règles d’accès restent côté serveur, quel que soit le client.

Problèmes concrets, réponses techniques

  • Un magasin ne doit pas voir les contenus d'un autre.

    Contexte magasin, scopes des requêtes et policies ; le partage régional ou national reste explicite.

  • Chaque métier a besoin de droits différents, sans toucher au code.

    Postes et droits configurables depuis le back-office, avec exceptions individuelles.

  • Une hiérarchie d'équipe doit rester cohérente.

    Validation côté serveur : pas de cycle, pas de compte inactif, pas de lien entre sites.

  • Les équipes doivent être prévenues sans recharger la page.

    Laravel Reverb pour le temps réel et notifications push pour le mobile.

Technologies

  • Laravel 13
  • PHP 8.5
  • React 19
  • Inertia 3
  • Tailwind CSS 3
  • MariaDB
  • Redis
  • Laravel Reverb
  • Spatie Permission
  • React Flow
  • PWA

Scénarios de tests présents dans le projet

  • Tâches : affectation au même magasin, refus d’accès entre magasins, soumission et validation selon les droits, puis création de la prochaine occurrence.
  • Hiérarchie : refus des cycles, mutations limitées au magasin autorisé et historique borné sans adresse e-mail.
  • Contenu riche et interface : assainissement HTML, tests de composants React et vérifications de navigation.

Ces scénarios sont versionnés dans le dépôt. Aucun chiffre de couverture ni résultat de charge n’est revendiqué ici.

Les prochaines étapes

Poursuivre les tests de non-régression sur les droits, les changements de hiérarchie et les récurrences, puis mesurer le comportement sous charge du temps réel et des traitements en file. Ces mesures ne sont pas présentées comme déjà réalisées.

Ce qu’il faut savoir

Retail Plus est un projet personnel. Il n'est ni adopté ni déployé officiellement par Boulanger. Le dépôt est privé et le code n'est pas publié. Les captures proviennent d'un environnement de démonstration avec des données fictives ; le logo de l'entreprise et les identifiants de magasin sont floutés.