MENAO
Plateforme de mise en relation entre particuliers et artisans du bâtiment vérifiés, avec un outil tout-en-un pour les artisans : demandes, devis, signature électronique, paiement via Stripe Connect, suivi de chantier, réception et avis.
Stack
Monorepo pnpm + Turborepo · Next.js (web) · Expo (iOS/Android) · Supabase (Postgres + PostGIS, Auth, Storage, Realtime) · Stripe (Billing + Connect)
Structure
apps/web Next.js 16 : site public, espaces connectés (Vercel)
packages/core Logique métier pure (rôles, règles) — testée avec Vitest
packages/validation Schémas Zod partagés web / app / serveur
packages/ui-tokens Design tokens (TypeScript + thème Tailwind v4)
packages/db Types Supabase générés
packages/config tsconfig, ESLint, Prettier partagés
supabase/ Migrations SQL, tests pgTAP, seed, modèles d'e-mails
docs/adr/ Décisions d'architecture
Démarrage local
Prérequis : Node 22, pnpm 9, Docker (Docker Desktop ou OrbStack) pour Supabase local.
pnpm install
pnpm db:start # Supabase local : migrations + seed
cp apps/web/.env.example apps/web/.env.local
# renseigner NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY avec la clé affichée par db:start
pnpm --filter web dev # http://localhost:3000
- E-mails envoyés en local (confirmation, lien magique) : Mailpit sur http://127.0.0.1:54324
- Comptes fictifs du seed :
[email protected], [email protected], [email protected], [email protected] (en onboarding), mot de passe menao-local-dev-only (local uniquement)
- Edge Functions : secrets lus dans l'environnement au démarrage de Supabase. Copier les valeurs dans
supabase/functions/.env (ignoré par Git), puis set -a; . supabase/functions/.env; set +a avant pnpm db:start. Variables : INSEE_API_BASE_URL (https://api.insee.fr/api-sirene/3.11) et INSEE_API_KEY (portail-api.insee.fr, API Sirene, plan « Accès public »).
Commandes
| Commande | Rôle |
|---|
pnpm lint · pnpm typecheck · pnpm test | Qualité et tests unitaires (Turbo) |
pnpm format | Prettier |
pnpm db:reset | Recrée la base locale (migrations + seed) |
pnpm db:test | Tests RLS pgTAP |
pnpm db:types | Régénère packages/db/src/types.ts |
pnpm exec supabase migration new <nom> | Nouvelle migration |
pnpm functions:check | Vérifie les Edge Functions (Deno) |
pnpm --filter web build && pnpm --filter web test:e2e | Tests de bout en bout (Supabase local requis ; faux serveur Sirene lancé automatiquement, Supabase démarré avec INSEE_API_BASE_URL=http://host.docker.internal:18399) |
Stripe (abonnements, F-15)
Clé de test dans .env.staging (STRIPE_SECRET_KEY=sk_test_…), puis, après application des migrations :
set -a; . ./.env.staging; set +a
SUPABASE_URL=https://izwdfxynzegntubminth.supabase.co SUPABASE_PUBLISHABLE_KEY=<clé publishable> \
pnpm stripe:setup --env-file .env.staging --webhook-url https://izwdfxynzegntubminth.supabase.co/functions/v1/stripe-webhook
Le script crée les produits, prix, TVA, portail et webhook, et écrit STRIPE_WEBHOOK_SECRET, STRIPE_TAX_RATE_ID, STRIPE_PORTAL_CONFIGURATION_ID dans le fichier. Secrets des Edge Functions : STRIPE_SECRET_KEY, ces trois valeurs et SITE_URLS (origines autorisées pour le retour depuis Stripe). Ouvrir une formule : ouverte = true dans plans, puis relancer le script.
Recherche IA (F-05 à F-07)
Analyse du besoin (analyze-need, Claude Haiku 5.5, repli Sonnet 5.5) et dictée (transcribe, Voxtral). Secrets des Edge Functions : OPENROUTER_API_KEY (tests et staging) ou, en production, ANTHROPIC_API_KEY et MISTRAL_API_KEY (prioritaires). Facultatifs : AI_ANALYZE_MODEL, AI_ANALYZE_FALLBACK_MODEL, AI_TRANSCRIBE_MODEL. Les sessions anonymes doivent être activées dans Auth (enable_anonymous_sign_ins). En e2e, OPENROUTER_BASE_URL et GEOCODING_BASE_URL pointent sur le faux serveur apps/web/e2e/mock-ai.mjs (port 18398). Voir l'ADR 0012.
Créer un administrateur
Depuis le back-office : « Personnes », filtre « Équipe MENAO », formulaire « Inviter un membre de l'équipe » (admin ou support, ADR 0210). La personne reçoit un e-mail pour choisir son mot de passe.
Premier admin d'un nouveau projet, ou recours : le rôle se trouve dans app_metadata, jamais modifiable depuis l'application. Dans l'éditeur SQL du projet Supabase (après inscription normale de la personne) :
update auth.users set raw_app_meta_data = raw_app_meta_data || '{"role": "admin"}'
where email = '[email protected]';
À la connexion suivante, le back-office (/admin) impose l'activation de la double authentification (TOTP). Sans elle, la base refuse tout droit admin (ADR 0008).
Application mobile : build de développement (iPhone)
Une vraie version de MENAO sur l'iPhone, reliée au serveur Expo du Mac comme Expo Go, avec les fonctions natives en plus : notifications push, retour menao:// après Google ou Apple. Le build se fait dans le cloud d'Expo (EAS), sans Xcode.
Prérequis : compte Apple Developer, projet Expo rattaché (EAS_PROJECT_ID dans apps/mobile/.env), iPhone en mode développeur (Réglages, puis Confidentialité et sécurité, puis Mode développeur).
Une seule fois, depuis apps/mobile. L'outil EAS ne lit pas .env : l'identifiant du projet lui est passé par la variable EAS_PROJECT_ID, sinon il propose de créer un second projet Expo (à refuser).
export EAS_PROJECT_ID="$(grep '^EAS_PROJECT_ID=' .env | cut -d= -f2-)"
# Identifiant du projet pour les serveurs de build (sans l'afficher).
npx eas-cli env:create --name EAS_PROJECT_ID --value "$EAS_PROJECT_ID" \
--environment development --environment preview --environment production --visibility plaintext
# Enregistrement de l'iPhone (QR code à ouvrir sur le téléphone).
npx eas-cli device:create
# Build (connexion au compte Apple demandée ; certificats et clé des notifications push créés par EAS).
npx eas-cli build --profile development --platform ios
Installer l'app depuis le lien donné à la fin du build, puis lancer le serveur et ouvrir « MENAO » sur l'iPhone :
REACT_NATIVE_PACKAGER_HOSTNAME="$(scutil --get LocalHostName).local" pnpm --filter mobile start
Le nom .local remplace l'adresse IP, refusée par Supabase comme adresse de retour (ADR 0108). Pour continuer avec Expo Go : pnpm --filter mobile start --go. Un nouveau build n'est nécessaire que si un module natif change.
CI
GitHub Actions sur chaque PR et sur main : format, lint, typecheck, tests unitaires ; migrations + tests pgTAP + contrôle des types générés ; build + Playwright (inscription, confirmation e-mail, connexion). Aucun secret requis : Supabase tourne dans le runner.
Environnements
Mise en production (passage de staging à la production, ouverture du site) : docs/MISE_EN_PRODUCTION.md.
Supabase staging (menao-staging)
- Secrets GitHub (environnement
staging) : SUPABASE_ACCESS_TOKEN, SUPABASE_STAGING_PROJECT_REF, SUPABASE_STAGING_DB_PASSWORD, puis lancer le workflow Migrations → staging (migrations + Edge Functions).
Secrets des Edge Functions (tableau de bord → Edge Functions → Secrets) : INSEE_API_KEY (et INSEE_API_BASE_URL si différente de la valeur par défaut).
- Auth → URL Configuration : Site URL = URL Vercel de staging ; Redirect URLs =
https://<domaine>/** et https://*-<équipe>.vercel.app/** (previews).
- Auth → Providers → Email : confirmation obligatoire, mot de passe ≥ 8 caractères.
- Auth → Email Templates : reprendre
supabase/templates/*.html (liens /auth/confirm?token_hash=…).
- Auth → SMTP : Resend (ADR 0002).
État au 9 octobre 2026 : migrations de main appliquées, Edge Function sirene-check déployée (--use-api, import de packages/core vérifié), secret INSEE_API_KEY défini, Site URL http://localhost:3000. À faire : SMTP Resend (requis pour personnaliser les modèles d'e-mails sur l'offre gratuite), mot de passe minimum 12 et liste des URL de redirection dans Auth.
Aperçu local branché sur staging : apps/web/.env.local avec l'URL et la clé « publishable » de menao-staging. Sur l'offre gratuite sans SMTP, Supabase n'envoie les e-mails d'authentification qu'aux membres de l'équipe du projet (environ 2 par heure).
Vercel
Projet lié au dépôt, Root Directory = apps/web, plafond de dépenses activé (spec §4.4). Variables : NEXT_PUBLIC_SITE_URL, NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY, et pour Sentry NEXT_PUBLIC_SENTRY_DSN, SENTRY_ORG, SENTRY_PROJECT, SENTRY_AUTH_TOKEN. Aucune clé secrète Supabase en phase 0.
