Aller au contenu
Mehdi Messaoudene
Application interne · client2026livré en local

Suivi Commercial

Le suivi des visites, des ventes et des objectifs d'une équipe commerciale, depuis le téléphone jusqu'au tableau de bord.

Le point de départ

Une équipe commerciale terrain notait ses visites, ses clients et ses ventes dans des fichiers séparés. Impossible de savoir, sans reconstituer à la main, qui avait vu quel client, où en étaient les objectifs de chacun et quelles alertes demandaient une action.

Ce qui a été construit

Une application interne où les commerciaux saisissent leurs visites sur téléphone, où les ventes et objectifs s'importent depuis Excel ou CSV avec aperçu et annulation exacte, et où 31 indicateurs, des tableaux de bord et des alertes sont calculés à partir de ces données. Les exports Excel reprennent les mêmes totaux que les écrans.

Résultats

31
indicateurs calculés (K01 à K31)
6
exports Excel filtrés
26
tables restaurées à l'identique
70
tests unitaires, plus 16 sur PostgreSQL

De l'interface jusqu'aux données

  1. 01

    Interface mobile et bureau

    Visites et brouillons sur téléphone (application installable), tableaux de bord et alertes sur ordinateur, composants shadcn/ui.

  2. 02

    Droits et périmètres

    Sessions Better Auth, mot de passe changé à la première connexion, rôles et périmètres d'équipe. Chaque modification est validée, auditée et rafraîchit les écrans concernés.

  3. 03

    Moteur commercial

    Agrégations SQL et fonctions pures pour les indicateurs K01 à K31 : décimaux exacts, calendrier local, proratisation, couverture avec remplacements, plafonnement du plan.

  4. 04

    Livraison

    Application Linux sans droits administrateur dans Docker, HTTPS par Caddy, migrations et données initiales précompilées, sauvegarde et restauration vérifiées.

Décisions d'ingénierie

Les choix qui méritent d'être défendus, et pourquoi.

  • 01

    Un import qui se défait exactement

    Les imports de clients, de ventes et d'objectifs passent par un aperçu, des rapprochements et un lot brouillon, puis une confirmation. Un import qui remplace une période peut être annulé : les ventes remplacées sont restaurées avec leurs identifiants et leurs montants d'origine, ce qui a été vérifié sur des échantillons fournis.

  • 02

    Les mêmes chiffres à l'écran et dans Excel

    Six exports Excel filtrés reprennent les totaux affichés, et le rapport hebdomadaire à trois feuilles compte chaque visite une seule fois. Ils ont été ouverts dans Excel et dans LibreOffice : la cohérence est contrôlée, pas supposée.

  • 03

    Un chargement initial rejouable sans écraser l'administrateur

    Les référentiels, le calendrier et le compte administrateur sont chargés par un script idempotent, sous verrou consultatif. Relancé, il ne duplique rien et conserve les paramètres et mots de passe modifiés par l'administrateur, ce qui est testé sur une base PostgreSQL isolée.

  • 04

    Une restauration prouvée, pas seulement une sauvegarde

    Une sauvegarde qu'on n'a jamais restaurée n'en est pas une. La base a été restaurée vers une base vide séparée et les 26 tables sont revenues identiques, vérifiées par volumes et par empreintes.

Pile technique

  • Next.js
  • React
  • TypeScript
  • PostgreSQL 16
  • Prisma 7
  • Better Auth
  • shadcn/ui
  • ExcelJS
  • Docker
  • Caddy

Autres réalisations