AluMg

Plateforme pour la menuiserie aluminium et les volets roulants à Madagascar. Vision complète : mettre en relation menuisiers vérifiés et clients (profils, avis, devis en ligne, suivi de chantier).

Version actuelle : une place de marché complète en deux espaces.

• Public (sans compte) : annuaire des menuisiers (recherche, filtres, notes, avis, badge vérifié) et profil détaillé avec réalisations en photos.
• Menuisier : devis configurables (fenêtres, nacos, portes, volets roulants, rideaux métalliques, garde-corps, cloisons ; tailles standard ou sur mesure, série de profilé, aperçu 3D réaliste et coupe) avec calcul du besoin en profilés, plan d'achat selon les prix et longueurs du marché, vue 3D animée, PDF professionnel ; réception des demandes des clients, négociation, suivi des chantiers en pourcentage, clients, portfolio, profil public.
• Client : demande de devis à un menuisier, suivi (demande, devis reçu, accepté, en cours, terminé), acceptation, refus ou demande de modification/remise, messages, évaluation en fin de chantier, signalement.

Le contact (e-mail et téléphone) est obligatoire à l'inscription, pour les deux types de compte.

Démarrer

npm install --legacy-peer-deps   # contourne un bug npm avec les peer deps optionnelles
npm run dev                       # http://localhost:3000 → créez un compte sur /inscription

Node 20+. Aucune installation de base de données : en développement, une base Postgres embarquée (PGlite) est créée dans .data/ au premier lancement.

Commande	Rôle
npm test	Tests unitaires du calcul et des accès base (base en mémoire)
npm run test:e2e:fresh	Tests de bout en bout (API + navigateur Chrome) sur une base jetable et un autre port : recommandé
npm run test:e2e	Mêmes tests contre le serveur déjà lancé (npm run dev) : ajoute des comptes de test à votre base locale
npm run lint · npm run build	Qualité et build de production
npm run demo:photos · npm run demo:assets · npm run seed:demo	Données de démonstration : vraies photos libres (Pexels, Internet requis), logos et portraits (SVG), puis 12 menuisiers, 4 clients, 15 devis à tous les stades et des conversations (mot de passe motdepasse123)
npm run admin:create	Crée un compte administrateur avec mot de passe généré (voir ci-dessous)
npx drizzle-kit generate	Génère une migration après une modification de lib/db/schema.ts

Données de démonstration

npm run dev                 # dans un terminal
npm run seed:demo           # dans un autre (ADMIN_EMAIL / ADMIN_PASSWORD optionnels : accordent le badge « Vérifié »)

Les photos de réalisations viennent de Pexels (voir public/demo/CREDITS.md) : elles illustrent le type d'ouvrage et non de vrais chantiers ; les logos et portraits sont des illustrations générées (aucune vraie personne). Comptes : [email protected], [email protected], [email protected], [email protected], [email protected], [email protected] (menuisiers) ; [email protected], [email protected], [email protected], [email protected] (clients).

Compte administrateur

npm run admin:create                                          # [email protected] + mot de passe généré
npm run admin:create -- --email [email protected] --name "Moi"   # e-mail et nom choisis
npm run admin:create -- --password "MonMotDePasse"            # mot de passe imposé

Le mot de passe généré est affiché une seule fois : notez-le. Relancer la commande avec le même e-mail réinitialise le mot de passe, lève une éventuelle suspension et ferme les sessions ouvertes. L'e-mail du compte est tenu pour vérifié. Les comptes protégés (PROTECTED dans lib/admin.ts) sont refusés. En local, arrêtez npm run dev avant (la base embarquée est prévue pour un seul processus à la fois) ; PGLITE_DIR désigne une autre base locale. En production, définissez DATABASE_URL pour viser la bonne base.

L'administrateur se connecte comme tout le monde et arrive sur /admin : vue d'ensemble (comptes, connectés, inscriptions, connexions, devis, chantiers terminés), gestion des comptes (/admin/comptes, avec la configuration et les devis de chaque compte), liste de tous les devis (/admin/devis, filtrable par menuisier et par client) avec, pour chacun, la feuille, le PDF, les remarques par ouvrage et la discussion (lecture seule) messagerie directe avec n'importe quel client ou menuisier (sous le profil AluMg), nombre de téléchargements de PDF de chaque devis, réseaux sociaux affichés dans le pied de page (/admin/reseaux) et journal des actions (/admin/journal). Voir docs/architecture.md, « Administration ».

Écrans

Zone	Écran	Rôle
Public	/	Accueil : présentation, menuisiers les mieux notés, comment ça marche
Public	/menuisiers, /menuisiers/[slug]	Annuaire filtrable, profil (à propos, réalisations, avis) ; la demande de devis exige un compte client
Public	/connexion, /inscription	Accès ; l'inscription choisit client ou menuisier
Menuisier	/tableau-de-bord	Indicateurs, demandes à traiter, chantiers en cours, montants par mois
Menuisier	/devis, /devis/[id]	Liste filtrable ; éditeur (client, ouvrages, remise, envoi au client, historique)
Menuisier	/devis/[id]/profils, /devis/[id]/profils/[ligne]	Besoin en profilés : achats, coût, marge, ouvrages partageant un profilé, vue 3D
Menuisier	/chantiers, /clients	Avancement des chantiers en %, liste des clients
Menuisier	/realisations, /profil-public	Portfolio photos, profil public et publication
Menuisier	/reglages, /reglages/profils	Entête, signature, tarifs, majorations, longueur de barre ; marché des profilés (prix et longueurs)
Client	/espace-client, /espace-client/nouvelle, /espace-client/devis/[id]	Mes demandes, nouvelle demande, suivi d'un devis
Commun	/compte	Nom, téléphone, mot de passe
Admin	/admin, /admin/comptes, /admin/comptes/[id], /admin/devis, /admin/devis/[id], /admin/journal	Statistiques de la plateforme, comptes (recherche, création, réinitialisation, suspension, rôle, badge, suppression, configuration et devis du compte), devis de toute la plateforme (lecture seule), journal

Transversal : thème clair/sombre (barre latérale identique), 3 langues (français, English, Malagasy), mobile-first, accessible au clavier et aux lecteurs d'écran.

Documentation

• User stories et feuille de route
• Architecture, sécurité, conventions, déploiement

Limites connues

• Les formules de débit sont génériques ; elles doivent être calibrées avec un vrai menuisier, série de profilés par série.
• Les tarifs et majorations affichés au départ sont des exemples.
• Les listes d'options (couleurs, verres, gammes) viennent de lib/model.ts et restent à valider avec des menuisiers malgaches.
• Pas de limitation des tentatives de connexion ni des demandes de devis, pas de vérification d'e-mail ni de mot de passe oublié : à ajouter avant l'ouverture au public.
• Le traitement des signalements n'a pas encore d'écran d'administration (les données existent en base).
• Un devis envoyé au client est verrouillé ; pour un devis sans compte client, « Créer une nouvelle version » en repart d'une copie.
• Les photos sont stockées en base (réduites côté navigateur) : à déplacer vers un stockage de fichiers avant la montée en charge.
• Le client ne peut pas encore télécharger le PDF du devis (le menuisier l'envoie).
• Les traductions malgaches doivent être relues par un locuteur natif.