Compyo — MVP

Assistant IA pour artisans du bâtiment : transformez une demande client en devis structuré.

Ce qu'il y a dans ce dossier

Un projet Next.js complet (code de l'application). Il ne fonctionne pas "tout seul" en double-cliquant dessus — contrairement à une page HTML simple, une application comme celle-ci doit être lancée sur ton ordinateur avec quelques outils gratuits. Suis les étapes ci-dessous dans l'ordre, ça prend 15-20 minutes la première fois.

---

Étape 1 — Installer Node.js (si ce n'est pas déjà fait)

Va sur https://nodejs.org, télécharge la version "LTS" (recommandée), installe-la comme n'importe quel logiciel (Suivant, Suivant, Terminer).

Pour vérifier que ça a fonctionné, ouvre une invite de commande (touche Windows, tape "cmd", Entrée) et tape :

node -v

Si un numéro de version s'affiche (ex: v20.11.0), c'est bon.

Étape 2 — Créer un projet Supabase (base de données + connexion)

1. Va sur https://supabase.com, crée un compte gratuit
2. Clique sur "New Project"
3. Donne-lui un nom (ex: "compyo"), choisis un mot de passe pour la base de données (note-le quelque part), choisis une région proche de toi (ex: Paris/Frankfurt)
4. Attends 1-2 minutes que le projet soit prêt
5. Une fois dans le projet, va dans l'onglet "SQL Editor" (menu de gauche)
6. Ouvre le fichier supabase/schema.sql de ce dossier, copie tout son contenu, colle-le dans l'éditeur SQL de Supabase, et clique sur "Run" → ça crée les tables et la sécurité (chaque artisan ne voit que ses données)
7. Va dans Project Settings > API (menu de gauche, en bas)
8. Note quelque part deux valeurs : Project URL et anon public key

Étape 3 — Récupérer une clé API Anthropic (pour l'IA)

1. Va sur https://console.anthropic.com, crée un compte
2. Va dans "API Keys", clique sur "Create Key"
3. Copie la clé générée (elle ne sera affichée qu'une seule fois, note-la bien)

Étape 4 — Configurer le projet

1. Dans ce dossier, trouve le fichier .env.local.example
2. Fais-en une copie, et renomme la copie en .env.local (sans ".example")
3. Ouvre .env.local et remplace les valeurs par celles que tu as notées aux étapes 2 et 3

Étape 5 — Installer et lancer

Ouvre une invite de commande dans ce dossier (sur Windows : ouvre le dossier dans l'explorateur, puis tape cmd dans la barre d'adresse et appuie sur Entrée).

Tape ensuite, une ligne à la fois :

npm install

(ça installe tout ce dont le projet a besoin, ça prend 1-2 minutes)

npm run dev

Une fois que c'est lancé, ouvre ton navigateur et va sur :

http://localhost:3000/signup

Tu peux maintenant créer un compte artisan et tester le produit.

---

Étape 6 — Activer la bêta privée (candidatures + panneau admin)

Depuis cette mise à jour, un visiteur ne crée plus de compte directement : il dépose une candidature (/demander-acces), et c'est vous qui l'acceptez ou la refusez depuis un panneau admin. Voici comment le configurer.

0. Mettez à jour votre base de données : ouvrez supabase/schema.sql, copiez uniquement la nouvelle section "Bêta privée : candidatures" (tout en bas du fichier), collez-la dans le SQL Editor de Supabase et cliquez sur "Run" — ça ajoute la nouvelle table sans toucher à ce qui existe déjà
1. Récupérez votre clé "service_role" (différente de la clé "anon" utilisée jusqu'ici) : Supabase → Project Settings > API → section "Project API keys" → copiez la clé service_role (⚠️ jamais dans le navigateur, uniquement dans .env.local)
2. Créez-vous un compte administrateur : allez sur http://localhost:3000/login, puis "Créer un compte" (ou directement /signup) avec votre propre email
3. Dans .env.local, remplissez :
   • SUPABASE_SERVICE_ROLE_KEY (récupérée à l'étape 1)
   • ADMIN_EMAIL = l'email exact utilisé à l'étape 2
   • NEXT_PUBLIC_SITE_URL=http://localhost:3000 (à changer une fois en ligne)
4. Autorisez le lien d'invitation : dans Supabase → Authentication → URL Configuration, ajoutez http://localhost:3000/** dans "Redirect URLs" (sinon le lien envoyé aux artisans acceptés ne fonctionnera pas)
5. Relancez npm run dev

Utilisation

• Un artisan candidate sur /demander-acces
• Vous consultez les candidatures sur /admin/candidatures (connecté avec votre compte admin)
• Vous cliquez sur "Accepter" → Compyo crée le compte et envoie un email à l'artisan avec un lien pour définir son mot de passe → il arrive ensuite directement sur son tableau de bord

Pour recevoir un email à chaque nouvelle candidature (optionnel), créez un compte gratuit sur resend.com, récupérez une clé API, et ajoutez-la dans RESEND_API_KEY. Sans cette clé, tout fonctionne quand même — il faut juste penser à consulter /admin/candidatures de temps en temps.

Étape 7 — Sprint 1 : Projet, paramètres entreprise et moteur métier

Cette mise à jour change en profondeur comment les devis sont calculés : l'IA ne décide plus jamais d'un prix, c'est un moteur de calcul séparé (100% code, sans IA) qui s'en charge, à partir de vos propres paramètres d'entreprise.

1. Mettez à jour votre base de données : ouvrez supabase/schema.sql, copiez tout ce qui se trouve après le commentaire -- Module 1 —, collez-le dans le SQL Editor de Supabase, cliquez sur "Run"
2. Relancez npm run dev
3. Allez sur /dashboard/parametres et remplissez au moins votre coût horaire et votre TVA — sans ça, Compyo utilise des valeurs par défaut (45€/h, 20% de TVA) pour ne jamais bloquer un devis, mais vos vrais chiffres seront plus justes
4. Testez à nouveau la génération d'un devis sur un projet : vous verrez maintenant le détail complet (sous-total, déplacement, marge, TVA) au lieu d'un simple total

This is the beginning of the README. Read the rest at the original. Read the full README ↗