Protocole d'Accord de Partenariat
Entre :
Jeremy Bouznah LTD | גרמי בוזנה בע"מ
Numero d'immatriculation : 517110912
Societe a responsabilite limitee (Private Limited Company) | Statut : Active (פעילה)
Date de constitution : 29/01/2025
68 כנפי נשרים, Jerusalem 9546457, Israel
Et :
Noah Israel | נח ישראל
Numero d'immatriculation : 516398864
Hevrat BAAM (חברת בע"מ)
81 Rue Shahal, Jerusalem 9372116, Israel
Tel : 054.992.28.59
Email : contact@noahisrael.co.il
Date :
Preambule
Noah Israel est une entreprise israelienne reconnue, specialisee depuis plus de 20 ans dans le diagnostic, le traitement et la prevention des pathologies du batiment en Israel. Leader dans son domaine, Noah Israel intervient sur l'ensemble des problematiques liees a l'humidite, aux fuites, aux infiltrations et a la qualite de l'air interieur, au service d'une clientele exigeante de particuliers, de syndics et de professionnels de l'immobilier. Fort d'une expertise terrain inegalee, d'une connaissance approfondie des specificites climatiques et constructives israeliennes, et d'un engagement constant envers la qualite et la satisfaction client, Noah Israel s'est impose comme une reference incontournable du secteur sur la region de Jerusalem et dans tout Israel.
Les parties collaborent depuis plusieurs mois sur le developpement d'une plateforme SaaS dediee au diagnostic humidite, fuites et qualite de l'air dans le batiment en Israel. Cette collaboration repose sur la complementarite de leurs expertises respectives : Noah Israel apporte son expertise terrain inegalee et sa connaissance approfondie du marche israelien ; Jeremy Bouznah LTD, en la personne de Jeremy Bouznah, en sa qualite de consultant senior en strategie d'entreprise, specialise en transformation digitale des organisations, deploiement operationnel de l'intelligence artificielle, et developpement de solutions logicielles sur mesure (sites web, applications metier, plateformes SaaS), apporte son expertise technique et strategique au service du projet.
Les parties souhaitent formaliser par ecrit les termes de leur partenariat, conformement au principe selon lequel tout accord commercial doit etre consigne pour eviter toute ambiguite future. Le present protocole vise a definir les engagements de chacun, les conditions financieres, les indicateurs de performance, et les modalites de sortie.
Article 1 — Objet
Le present protocole definit les termes et conditions du partenariat entre Jeremy Bouznah LTD et Noah Israel pour :
- Le developpement, la maintenance et l'exploitation d'une plateforme SaaS de diagnostic IA et de gestion commerciale (CRM)
- L'accompagnement strategique de l'activite de Noah Israel : definition des processus metier, structuration du parcours client et fournisseur, digitalisation des operations, optimisation de la conversion commerciale
- La mise en place d'outils de pilotage et de suivi de la performance de l'activite
Article 2 — Perimetre d'intervention
2.1 — Jeremy Bouznah LTD :a) Strategie digitale :
- Definition de la strategie d'acquisition de leads (SEO, publicite payante, WhatsApp, bouche-a-oreille digital, optimisation des mots-cles pour la reconnaissance par les moteurs IA). Jeremy Bouznah LTD definit la strategie ; le deploiement operationnel est a la charge de Noah Israel.
- Conception du tunnel de conversion : premier contact → diagnostic IA → devis automatique → signature → chantier
- Analyse des donnees et recommandations d'optimisation basees sur les KPIs de la plateforme
b) Processus operationnels :
- Modelisation des parcours client : de la prise de contact au SAV post-chantier
- Modelisation des parcours fournisseur/sous-traitant : qualification, attribution, suivi qualite
- Standardisation des temps d'intervention par type de prestation
- Mise en place du suivi de marge par chantier
c) Developpement technique :
- Developpement frontend (interface utilisateur, responsive, multilingue FR/HE/EN/AR)
- Developpement backend (API REST, base de donnees PostgreSQL, authentification, autorisations)
- Integration IA (diagnostic par Claude Sonnet/Haiku, analyse photo, synthese automatique)
- Integrations tierces : iCount (comptabilite), Evolution API (WhatsApp), MinIO (stockage), Google Agenda (planification rendez-vous et interventions), Waze / Plan (navigation et geolocalisation des chantiers)
- Infrastructure et deploiement (hebergement, CI/CD, monitoring, backups)
d) Maintenance :
- Corrections de bugs (sous 12 heures ouvrees pour les bugs critiques, sous 1 jour ouvre pour les non-critiques), sauf cas de force majeure
- Evolutions fonctionnelles selon le planning defini conjointement
- Mises a jour de securite et de dependances
- Apres mise en production de la V1 : allocation de 8 (huit) heures par semaine maximum durant les 20 premiers jours ouvres, puis 3 (trois) heures par semaine a compter de J+20 ouvres
e) Propriete intellectuelle :
- Jeremy Bouznah LTD reste proprietaire a 100% du code source, de l'architecture logicielle, des algorithmes, des prompts IA et de toute la propriete intellectuelle de la plateforme
a) Expertise terrain :
- Realisation des diagnostics humidite, fuites, infiltrations et qualite de l'air
- Redaction des rapports d'expertise
- Fourniture des templates de rapports existants a Jeremy Bouznah LTD pour integration a la plateforme
- Coordination et supervision des travaux correctifs
b) Relation client :
- Prospection active (reponse aux leads generes par la plateforme sous 24h)
- Etablissement et envoi des devis via la plateforme
- Suivi des chantiers et communication client
- Gestion du SAV et de la satisfaction client
c) Engagement operationnel :
- Utilisation exclusive de la plateforme pour 100% de l'activite des la mise en production de la V1
- Tout chantier ou prestation de conseil lie a l'activite de Noah Israel realise hors plateforme constitue une violation grave du present accord apres mise en livraison de la V1
- Saisie systematique des donnees dans la plateforme (leads, devis, chantiers, pointages, encaissements) liees a l'activite de Noah Israel
d) Retour post-mise a jour :
- Apres toute mise a jour effectuee par Jeremy Bouznah LTD sur la plateforme, Noah Israel s'engage a remonter sous 24 heures ouvrees l'ensemble des bugs constates, demandes de correction et suggestions d'amelioration
- Ces retours devront etre transmis au format structure JSON via le canal defini conjointement (plateforme ou outil de suivi dedie)
- L'absence de retour dans le delai de 7 jours ouvrables vaut acceptation tacite de la mise a jour
e) WhatsApp et communication :
- Mise en place d'un numero WhatsApp Business professionnel dedie, connecte a l'API Evolution via la plateforme
- Le numero personnel du dirigeant sert de backup et de redirection en cas d'indisponibilite du numero professionnel
- Les numeros WhatsApp existants de Noah Israel seront progressivement migres vers le numero professionnel dedie
- Le numero professionnel et le compte WhatsApp Business associe sont la propriete de Noah Israel
Article 3 — Conditions financieres
3.1 — Acompte de cadrage :Un montant de 6 000 NIS (six mille nouveaux shekels israeliens) est du par Noah Israel a Jeremy Bouznah LTD a la signature du present protocole, au titre du cadrage du projet.
3.2 — Remuneration recurrente :Jeremy Bouznah LTD percoit 10% (dix pour cent) de la marge brute sur chaque chantier. La marge brute est definie comme :
Chiffre d'affaires facture au client MOINS les couts directs (materiaux, sous-traitants, deplacements).
Le reglement est du a chaque chantier termine et encaisse. Cette remuneration est due de maniere continue pendant toute la duree du contrat, sans plafond, et constitue la contrepartie du maintien en condition operationnelle de la plateforme par Jeremy Bouznah LTD.
Des la mise en production de la V1, un versement minimum de 3 000 NIS HT par mois est garanti a Jeremy Bouznah LTD. Si le cumul des 10% de marge brute sur un mois donne n'atteint pas ce montant, Noah Israel verse la difference pour atteindre ce minimum.
3.3 — Condition d'acces a la plateforme :L'acces a la plateforme et son maintien en condition operationnelle sont conditionnes au paiement regulier des 10% de marge brute par Noah Israel. En cas de non-paiement, Jeremy Bouznah LTD se reserve le droit de suspendre l'acces a la plateforme apres mise en demeure restee sans effet pendant 30 jours.
3.4 — Allocation horaire post-V1 :Apres la mise en production de la V1, Jeremy Bouznah LTD alloue durant les 20 premiers jours ouvres un maximum de 8 (huit) heures par semaine exclusivement dediees a la maintenance corrective (correction de bugs, ajustements mineurs, mises a jour de securite et conformite au Cahier des Charges V1), incluses dans la remuneration des 10% de marge. A compter de J+20 ouvres, l'allocation passe a 3 (trois) heures par semaine.
Si aucun bug n'est constate sur une periode donnee, les 3 heures hebdomadaires pourront etre consacrees au developpement de nouvelles fonctionnalites validees conjointement. Les heures non utilisees sont cumulables d'un mois sur l'autre.
Toute demande de developpement portant sur des fonctionnalites non prevues au Cahier des Charges V1 (annexe au present accord) necessite :
- a) Un devis prealable valide par Noah Israel
- b) Une facturation au taux horaire de reference de 300 NIS/heure
Le taux horaire de reference de Jeremy Bouznah LTD est de 300 NIS/heure. Ce taux sert de base pour :
- La facturation de toute prestation complementaire ou developpement non prevu au Cahier des Charges V1
Noah Israel s'engage a prendre en charge l'integralite des frais suivants :
- Licences IA (Anthropic/Claude et tout autre fournisseur)
- Appels API (Claude, WhatsApp/Evolution, iCount, Vapi.ai)
- Infrastructure d'hebergement (serveurs, stockage, CDN)
- Licences logicielles necessaires au fonctionnement de la plateforme
La mise en production de la V1 de la plateforme constitue la date de demarrage des calculs de marge. A compter de cette date, 100% des chantiers (nouveaux et existants) transitant par la plateforme sont soumis au calcul des 10%.
3.8 — Cahier des Charges V1 et perimetre de livraison :La plateforme est consideree comme livree et fonctionnelle a 100% lorsque l'ensemble des fonctionnalites decrites dans le Cahier des Charges V1 (annexe au present accord) sont operationnelles et validees par les deux parties. Le Cahier des Charges V1 constitue le seul document de reference pour determiner la conformite de la plateforme aux engagements de Jeremy Bouznah LTD.
Toute fonctionnalite ou evolution non prevue dans le Cahier des Charges V1 constitue un developpement supplementaire soumis a devis prealable accepte par Noah Israel et facture au taux horaire de reference.
Article 4 — Duree, evaluation et clauses de sortie
4.1 — Duree initiale :Le present accord est conclu pour une duree initiale de 3 (trois) mois a compter de sa signature.
4.2 — Renouvellement :A l'issue de chaque periode de 3 mois, un point d'etape devra obligatoirement avoir lieu. Apres la premiere periode de 3 mois, le contrat est renouvele tacitement pour une nouvelle periode de 12 (douze) mois, sauf denonciation par l'une des parties avec un preavis de 30 jours avant l'echeance.
4.3 — Evaluation initiale (Baseline) :En debut de mission, une evaluation de l'activite de Noah Israel pourra etre realisee sur la base des 2 annees precedentes, a l'appreciation de Jeremy Bouznah LTD. Si elle est realisee, cette evaluation servira de reference (baseline) pour mesurer l'impact concret du partenariat. Les indicateurs mesures incluent notamment :
- Chiffre d'affaires annuel et mensuel moyen
- Nombre de chantiers realises
- Taux de conversion leads → chantiers
- Marge brute moyenne par chantier
- Cout d'acquisition client
- Satisfaction client moyenne
A chaque echeance de 3 mois, un bilan sera realise comparant les KPIs actuels a la baseline. Les deux parties evalueront conjointement la viabilite et la performance du partenariat.
4.5 — KPIs de suivi (suivis dans la plateforme) :| KPI | Source | Frequence |
|---|---|---|
| Chiffre d'affaires mensuel | iCount + plateforme | Mensuel |
| Nombre de leads generes | Plateforme (CRM) | Hebdomadaire |
| Taux de conversion lead → devis | Plateforme | Mensuel |
| Taux de conversion devis → chantier | Plateforme | Mensuel |
| Marge brute par chantier | Plateforme + iCount | Par chantier |
| Marge brute mensuelle cumulee | Plateforme | Mensuel |
| Nombre de chantiers realises | Plateforme | Mensuel |
| Cout d'acquisition client | Plateforme + depenses pub | Mensuel |
| Satisfaction client moyenne | Plateforme (SAV) | Mensuel |
| Ratio valeur dev / marge reversee | Calcule | Trimestriel |
Un lancement est considere comme reussi si, a l'issue des 3 premiers mois, les conditions suivantes sont remplies par mois de production :
- Au moins 15 leads qualifies generes via la plateforme
- Au moins 12 visites terrain realisees
- Au moins 12 devis envoyes via la plateforme
- Au moins 7 devis valides et signes par les clients
- Taux de conversion lead → devis superieur a 70%
- La plateforme est utilisee quotidiennement par Noah Israel
- L'investissement en communication externe a demarre
Une augmentation de 10% de ces seuils est envisagee tous les trimestres pour considerer, au regard de Noah Israel, le partenariat comme reussi.
A titre d'information (non determinant dans l'accord) : en moyenne, 1 chantier represente environ 10 000 NIS de marge.
Le partenariat est considere en echec si, a l'issue des 3 premiers mois :
- Les seuils de lancement reussi (4.6) ne sont pas atteints
- Noah Israel n'utilise pas la plateforme de maniere reguliere (moins de 3 connexions par semaine)
- Aucun investissement en communication externe n'a ete realise
- Les donnees ne sont pas saisies dans la plateforme (chantiers hors plateforme constates)
En cas d'echec constate, chaque partie peut resilier le contrat selon les modalites de l'article 6.
Article 5 — Obligations de Noah Israel
5.1 — Transparence comptable :Noah Israel accorde a Jeremy Bouznah LTD un acces total au logiciel iCount, permettant de verifier les factures emises, les encaissements et les marges declarees.
5.2 — Declaration sur l'honneur :Noah Israel s'engage moralement a declarer l'integralite de ses revenus lies a l'activite, y compris les prestations reglees en especes, et a les faire transiter par la plateforme.
5.3 — Utilisation exclusive :Des la mise en production de la V1, Noah Israel s'engage a faire transiter 100% de son activite (leads, devis, chantiers, facturation) par la plateforme. Tout contournement est considere comme une violation grave du present accord.
5.4 — Communication :Noah Israel s'engage a investir un minimum de NIS par mois (montant a definir au premier jalon) dans la communication externe (publicite digitale, marketing, referencement).
Article 6 — Propriete intellectuelle, resiliation et clauses de sortie
6.1 — Propriete du code :Le code source, l'architecture logicielle, les algorithmes, les prompts IA et toute la propriete intellectuelle de la plateforme restent la propriete exclusive et inalienable de Jeremy Bouznah LTD pendant toute la duree du contrat et apres sa resiliation.
Les donnees metier (clients, leads, devis, chantiers, factures, rapports) saisies par Noah Israel dans la plateforme restent la propriete exclusive de Noah Israel. Jeremy Bouznah LTD s'engage a en assurer la restitution au format CSV/JSON sur simple demande.
6.2 — Causes de resiliation :a) Resiliation a l'amiable :
Les deux parties peuvent convenir d'une resiliation a l'amiable a tout moment. Les consequences financieres sont celles definies aux articles 6.3 et 6.4.
b) Resiliation pour faute grave :
Constituent une faute grave justifiant une resiliation immediate et sans preavis :
Fautes graves de Noah Israel :
- Realisation de chantiers ou de prestations de conseil lies a l'activite de Noah Israel en dehors de la plateforme, apres mise en production de la V1
- Refus ou obstruction de l'acces au logiciel iCount
- Declarations frauduleuses sur le chiffre d'affaires, les couts ou les marges
- Non-saisie systematique des donnees dans la plateforme (leads, devis, chantiers, pointages, encaissements) liees a l'activite de Noah Israel
- Non-paiement des 10% de marge brute ou des frais techniques pendant plus de 30 jours apres relance ecrite
- Utilisation non autorisee du code source ou de la propriete intellectuelle de Jeremy Bouznah LTD
Fautes graves de Jeremy Bouznah LTD :
- Interruption de service de la plateforme de plus de 7 jours consecutifs sans motif legitime
- Perte ou divulgation de donnees clients
Consequences d'une faute grave de Jeremy Bouznah LTD :
- Noah Israel obtient automatiquement une licence perpetuelle de la plateforme en l'etat au moment de la resiliation, sans surcout
- Si le cumul des 10% verses est superieur ou egal a 140 000 NIS, Noah Israel recoit egalement le code source complet
- Exportation complete des donnees fournie au format CSV/JSON
c) Resiliation pour non-performance :
Si les criteres d'echec (article 4.7) sont constates a l'issue du jalon de 3 mois :
- Notification ecrite a l'autre partie
- Delai de 30 jours pour correction
- Si aucune amelioration : la resiliation prend effet 30 jours apres la notification finale
d) Non-renouvellement :
Apres la premiere periode de 3 mois, chaque partie peut denoncer le contrat avec un preavis de 30 jours avant l'echeance. Les consequences financieres des articles 6.3 et 6.4 s'appliquent.
Quelle que soit la cause de resiliation a l'initiative de Noah Israel :
- Les sommes deja versees au titre des 10% de marge brute restent integralement acquises a Jeremy Bouznah LTD
- Si le cumul des 10% verses est superieur ou egal a 140 000 NIS : Noah Israel beneficie automatiquement d'une licence perpetuelle de la plateforme dans son etat au moment de la resiliation, sans maintenance incluse. Le surplus verse au-dela de 140 000 NIS reste acquis a Jeremy Bouznah LTD.
- Si le cumul des 10% verses est inferieur a 140 000 NIS : Noah Israel dispose de 30 jours pour choisir :
Dans tous les cas, Jeremy Bouznah LTD fournit une exportation des donnees (clients, leads, devis, chantiers) au format CSV/JSON.
6.4 — Consequences financieres — Resiliation par Jeremy Bouznah LTD :- Jeremy Bouznah LTD maintient la plateforme accessible pendant 60 jours de transition
- Si le cumul des 10% est superieur ou egal a 140 000 NIS : licence perpetuelle automatique, sans surcout ni maintenance
- Si le cumul des 10% est inferieur a 140 000 NIS : Noah Israel choisit Option A ou B (article 6.3)
- Exportation complete des donnees fournie au format CSV/JSON
En cas de resiliation pour faute grave de Noah Israel (article 6.2.b) :
- Noah Israel doit regler la difference entre 140 000 NIS et le cumul des 10% deja verses (si positive en faveur de Jeremy Bouznah LTD)
- Paiement du dans un delai de 60 jours
- Aucune licence n'est accordee sans paiement integral des 140 000 NIS
- La partie fautive supporte l'integralite des couts de sortie
Quelle que soit l'option choisie, aucune maintenance, mise a jour ni evolution n'est incluse apres la fin du contrat. Un contrat de maintenance separe pourra etre negocie si souhaite.
Article 7 — Confidentialite
7.1 —Les deux parties s'engagent mutuellement a la confidentialite sur :
- Les donnees clients et prospects
- Les processus metier et strategies commerciales
- Le code source et l'architecture technique
- Les conditions financieres du present accord
- Toute information echangee dans le cadre du partenariat
Cette obligation de confidentialite survit a la resiliation du contrat pour une duree de 2 (deux) ans.
Article 8 — Resolution des litiges
8.1 — Mediation amiable :En cas de differend, les parties s'engagent a solliciter en premier lieu Hillel et Ouriel, personnes de confiance mutuellement designees, pour tenter une resolution amiable.
8.2 — Din Torah :Si la mediation amiable echoue, les parties s'engagent a soumettre le litige exclusivement a un Din Torah (tribunal rabbinique). Les deux parties renoncent expressement a tout recours devant les tribunaux civils.
Article 9 — Droit applicable
Le present protocole est redige en francais et soumis exclusivement au Din Torah.
Article 9 bis — Deces et force majeure
9 bis.1 — Deces de Noah Israel :En cas de deces ou d'incapacite permanente du dirigeant de Noah Israel, les ayants droit disposent d'un delai de 90 jours pour choisir entre :
- Continuer le contrat en designant un representant legal habilite a poursuivre les obligations du present protocole
- Resilier le contrat : les consequences financieres de l'article 6.3 s'appliquent (licence perpetuelle si cumul ≥ 140 000 NIS, ou choix Option A/B si cumul < 140 000 NIS)
Dans tous les cas, une exportation complete des donnees au format CSV/JSON est fournie aux ayants droit.
9 bis.2 — Deces du dirigeant ou dissolution de Jeremy Bouznah LTD :En cas de deces du dirigeant de Jeremy Bouznah LTD, de dissolution ou de cessation d'activite de la societe :
- Noah Israel recoit automatiquement une licence perpetuelle de la plateforme en l'etat au moment de l'evenement, quel que soit le cumul des sommes versees
- Le code source complet est remis a Noah Israel
- Une exportation complete des donnees au format CSV/JSON est fournie
Constituent des cas de force majeure : guerre, conflit arme, mobilisation militaire (tsav 8), catastrophe naturelle, pandemie, acte de terrorisme, decision gouvernementale rendant l'execution impossible, ou tout evenement imprevisible, irresistible et exterieur aux parties.
En cas de force majeure :
- Les obligations des deux parties sont suspendues pendant la duree de l'evenement
- La partie affectee en informe l'autre dans les meilleurs delais
- Si l'evenement se prolonge au-dela de 90 jours consecutifs, chaque partie peut resilier le contrat sans penalite par notification ecrite
- Les sommes deja versees restent integralement acquises a Jeremy Bouznah LTD
- Une exportation des donnees au format CSV/JSON est fournie a Noah Israel
Article 10 — Dispositions finales
10.1 — Le present protocole porte exclusivement sur la V1 de la plateforme, telle que definie dans le Cahier des Charges V1 annexe au present accord. Toute evolution au-dela du perimetre V1 fera l'objet d'un avenant ecrit ou d'un nouveau protocole.
10.2 — Le present protocole constitue l'integralite de l'accord entre les parties et remplace tout accord anterieur, ecrit ou verbal.
10.3 — Toute modification du present protocole devra faire l'objet d'un avenant ecrit signe par les deux parties.
10.4 — Si une clause du present protocole est declaree nulle ou inapplicable, les autres clauses restent en vigueur.
Signatures
Fait en deux exemplaires originaux.
En presence de
Cahier des Charges V1
Plateforme SaaS de diagnostic IA et gestion commerciale (CRM) dediee a l'expertise humidite, fuites et qualite de l'air dans le batiment en Israel.
Sommaire
- Stack Technique et Justifications
- Architecture Globale
- Module A — Diagnostic Bot IA (Public)
- Module B — CRM & Pipeline
- Module C — Devis & Facturation
- Module D — Gestion Projets
- Module E — Pointage / Timesheet
- Module F — SAV & Satisfaction
- Module G — Contrats Numeriques
- Module H — Admin / QCM CMS
- Module I — Catalogue Produits & Services
- Module J — Analytics & Dashboard
- Fonctionnalites a Finaliser
- Fonctionnalites Prevues Non Developpees
- Criteres de Recette V1
- Matrice RBAC
- Integrations Externes
- Securite & Conformite
- Performance & SLA
1. Stack Technique
| Technologie | Version | Role | Justification |
|---|---|---|---|
| Next.js | 16 | Framework fullstack | SSR/SSG natif, Route Handlers API, App Router, optimisations images et fonts automatiques |
| React | 19 | Rendu UI | Server Components, Suspense, transitions concurrentes pour une UX fluide |
| PostgreSQL | 16+ | Base de donnees | Robustesse, JSONB pour donnees flexibles, indexation avancee, contraintes CHECK |
| Drizzle ORM | latest | ORM TypeScript | Type-safe, zero overhead, migrations declaratives, compatible edge runtime |
| Better Auth | latest | Authentification | Sessions serveur 7 jours, RBAC 4 roles, compatible Next.js App Router |
| Claude IA | Sonnet 4 / Haiku 4.5 | Diagnostic IA | Meilleur rapport qualite/cout pour analyse d'images et raisonnement batiment |
| iCount | API REST | ERP Comptable | ERP israelien de reference, sync bidirectionnelle clients/devis/factures |
| Evolution API | v2 | Auto-hebergeable, envoi PDF/documents, pas de dependance cloud tiers | |
| MinIO S3 | latest | Stockage objets | Compatible S3, auto-heberge, presigned URLs, cout fixe |
| next-intl | latest | i18n | 4 langues (FR/HE/EN/AR), support RTL natif, interpolation et pluralisation |
2. Architecture Globale
Schema d'architecture globale de la plateforme Noah Israel
Module A — Diagnostic Bot IA (Public)
Ecran 1 : Page d'accueil publique
Hero section avec presentation Noah Israel, 3 cards services (curatif / controle / recherche de fuite), section "3 etapes pour diagnostiquer", widget bot IA integre en bas de page. Design responsive, 4 langues (FR/HE/EN/AR).
Ecran 2 : Widget Bot IA (QCM)
Barre de progression par etapes. Question affichee avec sous-texte explicatif. Choix multiples (boutons) ou saisie texte/nombre. Boutons "Retour" et "Suivant". Upload photo avec guide visuel. Redirection conditionnelle entre parcours.
Ecran 3 : Resultat diagnostic + Devis
Synthese diagnostique IA (hypothese principale, secondaires, elements manquants). Alertes red flags. Devis automatique avec lignes produits, main d'oeuvre, deplacement, TVA 18%. Bouton telecharger PDF (ref DIAG-YYYY-NNNN). Option envoi WhatsApp.
Parcours QCM disponibles
| Slug | Intitule | Declencheur |
|---|---|---|
triage | Triage initial | Parcours par defaut, oriente vers le parcours specifique |
humidite_moisissures | Humidite et moisissures | Condensation, moisissures, murs humides |
infiltration_eau | Infiltration d'eau | Fuites, infiltrations par toiture ou murs |
humidite_sol | Humidite du sol | Remontees capillaires, sous-sol, cave |
qualite_air | Qualite de l'air interieur | Odeurs, allergies, ventilation deficiente |
Red Flags (signaux d'alerte)
| Categorie | Exemples | Severite |
|---|---|---|
| Technique (batiment) | Fissures structurelles, affaissement visible, infiltration massive | critical high medium |
| Sante (occupants) | Moisissures noires etendues, difficultes respiratoires, enfants/personnes agees | critical high medium |
Formule de scoring lead (0-100)
| Critere | Points | Condition |
|---|---|---|
| Base | +10 | Toujours attribue |
| Red flags technique | +30 | Au moins 1 red flag technique present |
| Red flags sante | +20 | Au moins 1 red flag sante present |
| Surface > 80 m2 | +10 | Reponse surface dans [80_120, 120_200, plus_200] |
| Probleme > 6 mois | +5 | Anciennete dans [6_12_mois, plus_12_mois, plus_1_an, plus_2_ans] |
| 3+ pieces touchees | +10 | Reponse pieces dans [3_4, 5_plus, toute_la_maison] ou 3+ selections |
| Photos fournies | +5 | Au moins 1 photo uploadee |
| Email fourni | +5 | Adresse email renseignee |
| Proprietaire | +5 | Statut occupant = proprietaire |
Override urgence : urgente = score min 80, elevee = score min 60. Plafond a 100.
Devis automatique (Quote Builder)
| Parametre | Valeur |
|---|---|
| TVA | 18% (ma'am israelien) |
| Main d'oeuvre simple | 1 500 EUR |
| Main d'oeuvre intermediaire | 2 500 EUR |
| Main d'oeuvre complexe | 3 500 EUR |
| Etude de dimensionnement | 159 EUR (ref 1103.0003) |
| Deplacement Centre | 0 EUR |
| Deplacement Nord | 150 EUR |
| Deplacement Jerusalem | 100 EUR |
| Deplacement Sud | 150 EUR |
| Deplacement Peripherie | 200 EUR |
| Devise | EUR (conversion ILS via taux parametre, defaut 3.95) |
| Reference PDF | DIAG-YYYY-NNNN, upload S3, envoi WhatsApp optionnel |
Rate Limiting
| Endpoint | Limite |
|---|---|
/api/qcm/start | 10 req / 5 min |
/api/qcm/answer | 60 req / 5 min |
/api/qcm/diagnostic | 5 req / 5 min |
/api/qcm/pdf | 3 req / 5 min |
Regles metier
- Le triage initial oriente automatiquement vers le parcours specifique selon les reponses
- Les questions conditionnelles s'affichent uniquement si les conditions JSON sont satisfaites
- Les red flags declenchent une elevation automatique du niveau d'urgence
- Le devis n'est genere que si
commercialExit = noah_prend_en_charge - Les prix des produits sont recuperes en temps reel depuis la base de donnees
- La complexite de la main d'oeuvre est evaluee automatiquement selon les produits recommandes
- Le PDF genere recoit une reference unique et est uploade sur MinIO S3
- Les CGV sont integrees au PDF dans la langue selectionnee par l'utilisateur
Endpoints API
| Methode | URL | Roles | Description |
|---|---|---|---|
| POST | /api/qcm/start | public | Demarre une session QCM, cree conversation + lead |
| POST | /api/qcm/answer | public | Enregistre une reponse, retourne la question suivante |
| POST | /api/qcm/diagnostic | public | Genere le diagnostic IA (Claude) + devis automatique |
| POST | /api/qcm/pdf | public | Genere le PDF du diagnostic + devis, upload S3 |
Flux Diagnostic Complet
- ✓ Triage initial → classification pathologie
- ✓ QCM adaptatif avec questions conditionnelles
- ✓ Photo intelligence (Claude Vision)
- ✓ Synthese diagnostique IA
- ✓ Red flags detection
- ✓ Devis auto-genere
Capture de l'interface — Module Diagnostic Bot IA
Module B — CRM & Pipeline
Ecran 1 : Liste des leads
Tableau pagine (20/page, max 100) avec filtres (pipeline_stage, source, pillar, recherche texte), tri par date de creation, score ou nom. Actions : voir, editer, supprimer. Badge score colore (vert ≥ 70, jaune ≥ 40, gris sinon).
Ecran 2 : Fiche lead
Formulaire complet avec onglets : Informations generales, Adresse, iCount, QCM, Notes. Champs editables avec validation temps reel. Historique d'activite en sidebar.
Ecran 3 : Pipeline Kanban
6 colonnes (nouveau, qualifie, devis_envoye, negocie, gagne, perdu). Cards lead avec nom, telephone, score, pilier. Drag-and-drop avec mise a jour optimiste.
Champs lead principaux
| Champ | Type | Obligatoire | Valeurs / Validation |
|---|---|---|---|
name | text | Non | Nom complet |
first_name / last_name | text | Non | Prenom et nom (sync iCount) |
phone / mobile | text | Non | Telephone fixe et mobile |
email | text | Non | Format email valide |
city / address | text | Non | Ville et adresse complete |
country | text | Oui | Defaut : IL |
pillar | enum | Non | curatif | controle | recherche_fuite | vmi | autre |
pipeline_stage | enum | Oui | nouveau | qualifie | devis_envoye | negocie | gagne | perdu |
source | enum | Non | web | whatsapp | phone | referral | other |
score | integer | Non | 0-100, CHECK constraint |
assigned_to | uuid FK | Non | Reference vers profiles.id |
language | enum | Oui | fr | he | en | ar (defaut fr) |
surface_m2 | numeric | Non | Surface en m2 |
building_type | text | Non | Type de batiment |
urgency_level | text | Non | standard | moyenne | elevee | urgente |
red_flags | jsonb | Non | Tableau red flags technique + sante |
qcm_answers | jsonb | Non | Reponses QCM brutes |
metadata | jsonb | Non | Donnees extensibles |
Champs iCount supplementaires : vat_id, company_name, bus_street/no/city/country/zip, home_street/no/city/country/zip, bank_name/branch/account, payment_terms, website, icount_tags.
Pipeline CRM
Regles metier
- Les leads crees depuis le bot recoivent automatiquement les reponses QCM, le score et le niveau d'urgence
- Le scoring est recalcule a chaque mise a jour des red flags ou des reponses
- L'assignation est manuelle (admin/assistante) ou automatique selon le pilier
- Le technicien ne voit que les leads qui lui sont assignes (politique RLS)
- La synchronisation iCount est bidirectionnelle avec debounce de 2 minutes
- Le drag-and-drop du pipeline met a jour le stage avec optimistic update
Endpoints API
| Methode | URL | Roles | Description |
|---|---|---|---|
| GET | /api/admin/leads | admin assistante commercial | Liste paginee avec filtres |
| POST | /api/admin/leads | admin commercial | Creer un lead |
| GET | /api/admin/leads/:id | admin assistante commercial technicien* | Detail d'un lead |
| PATCH | /api/admin/leads/:id | admin commercial | Modifier un lead |
| DELETE | /api/admin/leads/:id | admin | Supprimer un lead |
- ✓ Leads (40+ champs, qualification)
- ✓ Pipeline 6 stages avec Kanban
- ✓ Lead assignment
- ✓ Scoring automatique (0-100)
- ✓ Sync iCount bidirectionnelle
| Nom | Telephone | Ville | Pilier | Etape | Score | Actions |
|---|---|---|---|---|---|---|
| David Cohen | 054-XXX-XXXX | Jerusalem | VMI | Nouveau | 👁 ✏️ 🗑 | |
| Sarah Levy | 052-XXX-XXXX | Tel Aviv | Curatif | Qualifie | 👁 ✏️ 🗑 | |
| Moshe Ben Ari | 050-XXX-XXXX | Haifa | Controle | Devis envoye | 👁 ✏️ 🗑 | |
| Rachel Peretz | 058-XXX-XXXX | Netanya | Fuite | Gagne | 👁 ✏️ 🗑 |
Capture de l'interface — Module CRM & Pipeline
Module C — Devis & Facturation
Ecran 1 : Liste des devis
Tableau avec colonnes : N. devis (auto-increment), client, montant TTC, statut (badge couleur), date, actions. Filtre par statut. Bouton "Nouveau devis".
Ecran 2 : Edition devis
Formulaire : selection lead, ajout lignes (designation, reference, quantite, prix unitaire, remise %), frais de deplacement, remise globale, notes. Apercu calculs en temps reel. Boutons : sauvegarder brouillon, envoyer, generer PDF.
Champs devis
| Champ | Type | Description |
|---|---|---|
quote_number | serial | Auto-increment |
lead_id | uuid FK | Client associe |
status | enum | brouillon | en_attente_validation | envoye | accepte | refuse | expire |
line_items | jsonb | Lignes : type, designation, reference, quantite, prix_unitaire, remise, total |
subtotal_ht | numeric(10,2) | Sous-total hors taxe |
tva_rate | numeric(5,2) | Taux TVA (defaut 17%) |
displacement_fee | numeric(10,2) | Frais de deplacement |
discount | numeric(10,2) | Remise globale |
total_ttc | numeric(10,2) | Total TTC calcule |
requires_validation | boolean | Necesssite validation manager |
icount_doc_id | text | ID document iCount synce |
Regles metier
- Formule : sous_total_HT + frais_deplacement - remise_globale = base_HT, puis base_HT * (1 + TVA) = total_TTC
- Le devis peut necessiter une validation (flag
requires_validation) avant envoi - Passage a "envoye" : creation automatique d'une offre dans iCount
- Passage a "accepte" : conversion en facture iCount (doctype 305)
- PDF bilingue FR/HE genere a la demande
- Les regles de calcul (majoration, reduction, forfait) sont configurables dans
quote_rules
Endpoints API
| Methode | URL | Roles | Description |
|---|---|---|---|
| GET | /api/admin/quotes | admin commercial | Liste des devis |
| POST | /api/admin/quotes | admin commercial | Creer un devis |
| GET | /api/admin/quotes/:id | admin commercial | Detail d'un devis |
| PATCH | /api/admin/quotes/:id | admin commercial | Modifier un devis |
| GET | /api/admin/quotes/:id/pdf | admin commercial | Generer le PDF |
- ✓ Generation devis (QCM ou manuel)
- ✓ PDF export bilingue
- ✓ iCount sync (offres + factures)
- ✓ Regles calcul (majoration/reduction/forfait)
- ✓ Suivi paiements (acompte, solde, avoir)
| N. Devis | Client | Montant TTC | Statut | Date | Actions |
|---|---|---|---|---|---|
| DEV-2026-042 | David Cohen | 12 500 ₪ | Accepte | 15/04/2026 | 👁 📋 📥 |
| DEV-2026-041 | Sarah Levy | 8 200 ₪ | Envoye | 14/04/2026 | 👁 📋 📥 |
| DEV-2026-040 | Moshe Ben Ari | 5 800 ₪ | En attente | 13/04/2026 | 👁 📋 📥 |
| DEV-2026-039 | Rachel Peretz | 15 400 ₪ | Brouillon | 12/04/2026 | 👁 📋 📥 |
Capture de l'interface — Module Devis & Facturation
Module D — Gestion Projets
Champs projet
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
name | text | Oui | Nom du chantier |
address | text | Non | Adresse du chantier |
status | enum | Oui | planifie | en_cours | termine | annule |
date_debut / date_fin_prevue | date | Non | Dates de planification |
lead_id / quote_id | uuid FK | Non | Client et devis associes |
subcontractor_id | uuid FK | Non | Sous-traitant assigne |
cout_materiaux / cout_transport | numeric(10,2) | Non | Couts detailles |
marge_prevue / marge_reelle | numeric(10,2) | Non | Suivi des marges |
Endpoints API
| Methode | URL | Roles | Description |
|---|---|---|---|
| GET | /api/admin/projects | admin commercial | Liste des projets |
| POST | /api/admin/projects | admin | Creer un projet |
| PATCH | /api/admin/projects/:id | admin | Modifier un projet |
| DELETE | /api/admin/projects/:id | admin | Supprimer un projet |
- ✓ Chantiers (planning, couts detailles)
- ✓ Sous-traitants (autonomie 1-5, qualite, fiabilite)
- ✓ Suivi marges prevues vs reelles
- ✓ Temps standards par service
| Nom | Client | Statut | Debut | Marge prevue | Marge reelle | Ecart |
|---|---|---|---|---|---|---|
| Traitement murs - Cohen | David Cohen | En cours | 10/04 | 45% | 48% | +3% |
| VMI annuelle - Levy | Sarah Levy | Termine | 05/04 | 55% | 52% | -3% |
| Infiltration toiture | Moshe Ben Ari | Planifie | 20/04 | 38% | -- | -- |
Capture de l'interface — Module Gestion Projets & Production
Module E — Pointage / Timesheet
/terrain/timesheet.Champs time entry
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
date | date | Oui | Jour de travail |
hours | numeric(4,1) | Oui | Heures travaillees (pas de 0.5), CHECK > 0 |
task_type | text | Non | installation | reparation | inspection | maintenance | deplacement | administratif | autre |
project_id | uuid FK | Non | Projet associe (cascade on delete) |
subcontractor_id | uuid FK | Non | Sous-traitant |
user_id | uuid FK | Non | Utilisateur (employe interne) |
Regles metier
- Navigation par semaine avec boutons precedent/suivant
- Selecteur de sous-traitant pour saisie a la place du sous-traitant
- Le technicien ne voit et ne modifie que ses propres entrees (politique RLS)
- L'admin voit toutes les entrees et peut filtrer par projet ou sous-traitant
- Interface terrain (
/terrain/timesheet) : version mobile simplifiee pour saisie sur chantier
Endpoints API
| Methode | URL | Roles | Description |
|---|---|---|---|
| GET | /api/admin/timesheet | admin technicien* | Entrees de la semaine |
| POST | /api/admin/timesheet | admin technicien | Ajouter/modifier une entree |
| DELETE | /api/admin/timesheet/:id | admin | Supprimer une entree |
- ✓ Grille hebdomadaire lun-dim
- ✓ 7 types de taches
- ✓ Interface terrain mobile
- ✓ Pointage par sous-traitant
Module F — SAV & Satisfaction
Champs ticket SAV
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
type | enum | Oui | reception | reserve | reclamation | satisfaction | rappel |
status | enum | Oui | ouvert | en_cours | resolu | ferme |
project_id | uuid FK | Non | Projet concerne |
lead_id | uuid FK | Non | Client concerne |
satisfaction_score | integer | Non | 1 a 5, CHECK constraint |
photos | text[] | Non | URLs des photos jointes |
description | text | Non | Description du probleme |
follow_up_dates | jsonb | Non | Dates de suivi planifiees |
Endpoints API
| Methode | URL | Roles | Description |
|---|---|---|---|
| GET | /api/admin/sav | admin commercial | Liste des tickets |
| POST | /api/admin/sav | admin commercial | Creer un ticket |
| PATCH | /api/admin/sav/:id | admin commercial | Modifier un ticket |
- ✓ Tickets (5 types : reception, reserve, reclamation, satisfaction, rappel)
- ✓ Satisfaction 1-5 etoiles avec histogramme
- ✓ Photos jointes
- ✓ Follow-ups planifies
| Projet | Client | Type | Statut | Satisfaction |
|---|---|---|---|---|
| Murs Cohen | David Cohen | Reclamation | En cours | ★★★★☆ |
| VMI Levy | Sarah Levy | Garantie | Resolu | ★★★★★ |
Capture de l'interface — Module SAV & Satisfaction
Module G — Contrats Numeriques
Champs contrat
| Champ | Type | Description |
|---|---|---|
type | enum | cadre | ordre_mission | avenant |
status | enum | brouillon | envoye | signe | expire |
subcontractor_id | uuid FK | Sous-traitant concerne |
project_id | uuid FK | Projet associe (optionnel) |
template_name | text | Nom du template HTML |
variables | jsonb | Variables interpolees dans le template |
signature_donneur | text | Signature base64 du donneur d'ordre |
signature_soustraitant | text | Signature base64 du sous-traitant |
signed_donneur_at / signed_soustraitant_at | timestamp | Horodatage des signatures |
Regles metier
- Un contrat n'est considere "signe" que lorsque les deux signatures (donneur + sous-traitant) sont presentes
- Les variables du template sont interpolees a la generation : nom, telephone, projet, adresse, dates, tarif jour, description mission
- Le contrat signe est accessible via un lien public (
/api/admin/contracts/:id/view) - Seul l'admin peut creer et gerer les contrats
Endpoints API
| Methode | URL | Roles | Description |
|---|---|---|---|
| GET | /api/admin/contracts | admin | Liste des contrats |
| POST | /api/admin/contracts | admin | Creer un contrat |
| POST | /api/admin/contracts/:id/sign | admin | Enregistrer une signature |
| GET | /api/admin/contracts/:id/view | public | Visualiser le contrat signe |
- ✓ Signatures digitales (pad HTML5, double signature)
- ✓ Ordres de mission + contrats cadre + avenants
- ✓ Templates avec variables interpolees
| Type | Sous-traitant | Projet | Statut | Date | Actions |
|---|---|---|---|---|---|
| Contrat cadre | Avi Plomberie | -- | Signe | 01/04/2026 | 🔗 ✏️ |
| Ordre de mission | Avi Plomberie | Infiltration toiture | Envoye | 12/04/2026 | 🔗 ✏️ ✅ |
| Avenant | Dror Etancheite | Murs Cohen | Brouillon | 14/04/2026 | 🔗 ✏️ 🗑 |
Capture de l'interface — Module Contrats Numeriques
Module H — Admin / QCM CMS
Ecran : Dashboard Bot
3 KPIs : statut API Anthropic (connecte/erreur), prompt actif (versione), nombre entrees KB. Cartes de navigation : Prompts, Parcours QCM, Analytics, Base de connaissance, Config devis, Documents IA.
Sous-modules
| Sous-module | Route | Description |
|---|---|---|
| Parcours QCM | /admin/bot/flows | CRUD parcours : label, slug, description, icone, actif, duplication |
| Editeur questions | /admin/bot/flows/:id | Questions par bloc (A-F), type, conditions, options, red flags, photos |
| Prompts systeme | /admin/bot (prompts) | Gestion des prompts IA versiones (version, actif) |
| Base de connaissance | /admin/bot (KB) | Entrees KB pour enrichir le contexte IA |
| Config devis bot | /admin/bot/devis | Matrice produits, couts main d'oeuvre, deplacement, TVA, CGV |
| Analytics bot | /admin/bot/analytics | Funnel (demarres/completes/abandonnes), etape d'abandon, export |
| Documents IA | /admin/bot (docs) | Bibliotheque de documents (PDF/images) utilises par le bot |
Tables QCM CMS
8 tables : qcm_flows, qcm_questions, qcm_options, qcm_photo_slots, qcm_documents, qcm_prompt_rules, qcm_devis_config, qcm_sessions_analytics.
- ✓ Flow builder (5 parcours, CRUD, duplication)
- ✓ Question editor (blocs, conditions, options, red flags)
- ✓ Prompt manager (versioning)
- ✓ Base de connaissance
- ✓ Config devis bot (matrice, couts, TVA, CGV)
- ✓ Analytics bot (funnel, export)
Capture de l'interface — Module Admin / QCM CMS
Module I — Catalogue Produits & Services
Champs produit
| Champ | Type | Description |
|---|---|---|
reference | text (unique) | Reference produit unique |
designation | text | Nom du produit (obligatoire) |
famille / gamme | text | Classification |
prix_achat_ht / prix_vente_ht | numeric(10,2) | Prix achat et vente HT |
marge_cible | numeric(5,2) | Marge cible en % |
is_strategic | boolean | Toggle produit strategique |
is_active | boolean | Toggle actif/inactif |
prix_achat_eur | numeric(10,2) | Prix achat en EUR (source) |
frais_transport / frais_douane / frais_transitaire / frais_annexes | numeric(10,2) | Couts import |
marge_pourcent | numeric(5,2) | Marge appliquee au calcul |
prix_vente_calcule | numeric(10,2) | Prix final calcule en ILS |
Calculateur de prix
cout_revient_ILS = cout_revient_EUR x taux_change_eur_ils
prix_vente_HT = cout_revient_ILS x (1 + marge_pourcent / 100)
Endpoints API
| Methode | URL | Roles | Description |
|---|---|---|---|
| GET | /api/admin/products | admin assistante | Liste des produits |
| POST | /api/admin/products | admin assistante | Ajouter un produit |
| PATCH | /api/admin/products/:id | admin assistante | Modifier un produit |
| DELETE | /api/admin/products/:id | admin | Supprimer un produit |
- ✓ Catalogue produits avec reference unique
- ✓ Import JSON (VMI), export CSV
- ✓ Calculateur prix EUR → ILS
- ✓ Toggle strategique / actif
- ✓ Taux de change EUR/ILS affiche
Module J — Analytics & Dashboard
KPIs Dashboard
Audit Log
| Champ | Type | Description |
|---|---|---|
entity_type | enum | lead | quote | project | subcontractor | product | kb_entry | prompt | contract | setting |
entity_id | uuid | ID de l'entite modifiee |
action | enum | created | updated | deleted | status_changed | validated | rejected |
old_value / new_value | jsonb | Valeurs avant/apres modification |
user_id | uuid FK | Auteur de l'action |
Endpoints API
| Methode | URL | Roles | Description |
|---|---|---|---|
| GET | /api/admin/stats | admin | KPIs, graphe leads/jour, funnel |
| GET | /api/admin/audit-log | admin | Journal d'audit pagine (50/page) avec filtres |
- ✓ Dashboard executif avec KPIs temps reel
- ✓ Graphe leads/jour (30 jours)
- ✓ Funnel conversion 5 etapes
- ✓ Audit log complet avec filtres
- ✓ Activites recentes (5 dernieres)
Capture de l'interface — Module Analytics & Reporting
Capture de l'interface — Module Integrations
| Date | Utilisateur | Entite | Action | Detail |
|---|---|---|---|---|
| 15/04 14:32 | Noah | Lead | Create | Nouveau lead: David Cohen |
| 15/04 14:28 | Noah | Quote | Update | Statut: brouillon → envoye |
| 15/04 13:15 | System | Sync | Create | iCount sync: 3 produits importes |
| 15/04 11:02 | Noah | Project | Update | Statut: planifie → en_cours |
Capture de l'interface — Module Securite & Audit
Fonctionnalites a Finaliser
Modules existants necessitant des enrichissements ou completions pour atteindre le niveau de production.
- ● Dashboard Executif — Page existante, contenu a enrichir avec KPIs avances (marge globale, satisfaction moyenne, taux retour SAV, performance sous-traitants)
- ● Module Prospection — Configuration des canaux WhatsApp / Voice / Web pour la prospection sortante, templates de messages, sequencage automatique
- ● Droits d'acces avances — Interface de gestion RBAC detaillee : visualisation des permissions par role, modification des droits, creation de roles personnalises
- ● Module Voice / Vapi.ai — Integration telephonie IA pour qualification leads par telephone, transcription automatique, scoring vocal
- ● Systeme de notifications — Alertes in-app (nouvelle assignation, devis accepte, ticket SAV), notifications push optionnelles
- ● Personnalisation apparence — Themes et branding : logo, couleurs, police personnalisable par instance
- ● Workflow de validation — Circuit de validation devis/contrats configurable : approbation simple ou multi-niveaux
- ● Comparaison prevu/reel timesheet — Dashboard heures planifiees vs realisees par projet, ecarts, alertes de depassement
Fonctionnalites Prevues Non Developpees
Fonctionnalites identifiees dans la roadmap produit mais non encore implementees dans la V1.
- ☐ Application mobile native (iOS/Android) — React Native, acces terrain et diagnostic hors bureau
- ☐ Mode hors-ligne avec synchronisation — Saisie timesheet et photos sans connexion, sync au retour reseau
- ☐ Reporting PDF automatique periodique — Generation et envoi automatique de rapports hebdomadaires/mensuels
- ☐ Calendrier/planning visuel chantiers — Vue Gantt ou calendrier des interventions et disponibilites
- ☐ Facturation automatique depuis projets termines — Generation facture iCount a la cloture d'un projet
- ☐ Relances automatiques devis non repondus — Sequences WhatsApp/email automatiques a J+1, J+3, J+7, J+14, J+30
- ☐ Scoring predictif IA (machine learning) — Prediction de conversion basee sur l'historique des leads
- ☐ Multi-tenant (plusieurs entreprises) — Isolation des donnees par tenant, gestion multi-compagnies
- ☐ API publique documentee (OpenAPI/Swagger) — Documentation interactive, cles API, webhooks configurables
- ☐ Portail client — Acces client a ses projets, factures, devis et tickets SAV
Criteres de Recette V1
| # | Critere | Condition de validation | Statut |
|---|---|---|---|
| 1 | Diagnostic Bot IA fonctionnel | Un visiteur peut completer le QCM (5 parcours), envoyer des photos (Claude Vision), recevoir un diagnostic IA et un devis PDF automatique avec reference DIAG-YYYY-NNNN | |
| 2 | Pipeline CRM operationnel | Les leads transitent dans les 6 etapes du pipeline avec scoring (0-100), assignation, filtres et vue Kanban drag-and-drop fonctionnelle | |
| 3 | Devis & Facturation | Generation devis PDF bilingue FR/HE, calcul TVA 18%, sync iCount (offre a l'envoi, facture a l'acceptation), suivi paiements (acompte/solde) | |
| 4 | Gestion chantiers | Creation projet depuis devis accepte, suivi statut (planifie/en_cours/termine/annule), couts detailles, marges prevues vs reelles | |
| 5 | Timesheet operationnel | Grille hebdomadaire fonctionnelle, 7 types de taches, interface terrain mobile, pointage par sous-traitant | |
| 6 | WhatsApp operationnel | Envoi de documents PDF via Evolution API depuis la plateforme, configuration instance | |
| 7 | Signatures numeriques | Contrats (cadre, ordre de mission, avenant) generables, double signature pad HTML5 fonctionnelle | |
| 8 | QCM CMS administrable | Parcours QCM editables (CRUD), questions par bloc, prompts versiones, config devis, analytics funnel | |
| 9 | Catalogue produits | Import JSON VMI, calculateur prix EUR/ILS, references uniques, toggle strategique/actif | |
| 10 | Securite | Better Auth avec sessions 7j, 25 politiques RLS, CSP/HSTS headers, rate limiting par endpoint, webhook signing | |
| 11 | Dashboard analytics | KPIs temps reel (leads, devis, conversion, CA), graphe leads/jour, funnel, audit log avec filtres | |
| 12 | Multi-langue | Interface utilisable en FR, HE, EN, AR avec support RTL | |
| 13 | Performance | Temps de chargement < 3s, uptime > 99%, rate limiting respecte |
Matrice RBAC (Role-Based Access Control)
| Ressource | Admin | Assistante | Commercial | Technicien |
|---|---|---|---|---|
| Leads | CRUD | Lecture | CRUD | Lecture (assignes) |
| Devis | CRUD + Validation | Lecture | CRUD | Lecture (assignes) |
| Projets | CRUD | Lecture | CRUD | Lecture (assignes/sous-traitant) |
| Contrats | CRUD + Validation | Lecture | Lecture | Lecture |
| Timesheet | CRUD | Lecture | Lecture | CRUD (les siens) |
| SAV / Tickets | CRUD | Lecture | CRUD | Lecture (assignes) |
| Catalogue produits | CRUD | CRUD | Lecture | Lecture |
| Bot IA (QCM CMS) | CRUD | CRUD (KB, prompts) | -- | -- |
| Parametres | CRUD | Lecture | Lecture | Lecture |
| Audit log | Lecture | Lecture | Lecture | Lecture |
| Dashboard executif | Acces | -- | -- | -- |
| Sous-traitants | CRUD | Lecture | Lecture | -- |
| Prix d'achat / Marges | Visible | -- | -- | -- |
* Technicien avec filtre row-level : ne voit que les entites liees a ses leads assignes ou a son profil sous-traitant.
Integrations Externes
Synchronisation bidirectionnelle : clients (leads), offres (devis envoyes), factures (devis acceptes, doctype 305). Debounce 2 minutes. Champs synces : vat_id, company_name, adresses, coordonnees bancaires, payment_terms, tags.
Envoi de documents (PDF devis, contrats) via WhatsApp Business. Instance auto-hebergee (noah-israel). Configuration instance, numero de telephone, connexion QR code.
Sonnet 4 pour le diagnostic complet (raisonnement, hypotheses, red flags). Haiku 4.5 pour les taches legeres (triage, extraction). Vision pour l'analyse de photos. Base de connaissance (KB) pour enrichir le contexte.
Stockage de fichiers (PDF devis, photos diagnostic, contrats signes, documents IA). Compatible S3, auto-heberge. Presigned URLs avec expiration 7 jours pour acces securise.
Securite & Conformite
| Composant | Implementation | Details |
|---|---|---|
| Authentification | Better Auth | Sessions serveur 7 jours, cookies HTTPOnly/Secure/SameSite, CSRF protection |
| Autorisation | 25 politiques RLS | Row-level filtering applicatif via Drizzle, 7 politiques avec filtre par ligne (leads, conversations, messages, quotes, projects, time_entries, sav_tickets) |
| RBAC | 4 roles | admin (16 permissions), assistante (4), commercial (3), technicien (3) |
| Headers HTTP | CSP, HSTS, X-Frame-Options | Content Security Policy stricte, HSTS preload, X-Content-Type-Options: nosniff |
| Webhook Signing | HMAC-SHA256 | Verification d'integrite pour les webhooks iCount et Evolution API |
| Rate Limiting | Par endpoint | QCM: 3-60 req/5min. API admin : limite configurable par route |
| Audit Trail | Table activities | Toute creation/modification/suppression tracee avec old_value/new_value et user_id |
| Donnees sensibles | Encryption at rest | PostgreSQL avec chiffrement disque. Secrets en variables d'environnement. |
Performance & SLA
| Metrique | Objectif | Mesure |
|---|---|---|
| First Contentful Paint | < 1.5s | Lighthouse / Web Vitals |
| Time to Interactive | < 3s | Lighthouse |
| API Response (95th percentile) | < 500ms | Monitoring serveur |
| Diagnostic IA (Claude) | < 15s | Temps total appel Anthropic |
| Generation PDF | < 5s | Temps generation + upload S3 |
| Sync iCount | < 3s | Temps aller-retour API |
| Disponibilite mensuelle | > 99.5% | Uptime monitoring |
| Rate limiting QCM start | 10 req / 5 min | Par IP |
| Rate limiting QCM diagnostic | 5 req / 5 min | Par IP |
| Rate limiting QCM PDF | 3 req / 5 min | Par IP |
Compteur d'Heures
Suivi des heures investies par Jeremy Bouznah LTD dans le developpement de la plateforme.
Taux horaire de reference : 300 NIS / heure
Le compteur d'heures est un outil de suivi et de transparence. Il n'est pas lie a la valorisation de la plateforme, celle-ci etant regie par les conditions definies aux articles 3 et 6 du present accord.
| Date | Description | Heures | Montant (NIS) | Cumul (NIS) |
|---|---|---|---|---|
| Pre-contrat | Cadrage du projet (acompte) | — | 6 000 NIS | 6 000 NIS |
| TOTAL | — | 6 000 NIS | 6 000 NIS | |
Note : Ce compteur est un outil de suivi indicatif. La valorisation de la plateforme est regie par les articles 3 et 6 du protocole (seuil de 140 000 NIS pour la licence perpetuelle).
Ce tableau sera mis a jour manuellement ou via le compteur integre dans la plateforme une fois celle-ci en production.
Suivi de Projet
Plateforme Noah Israel V1 — Suivi d'avancement detaille
Derniere mise a jour : 17 avril 2026
Avancement par module
| Mod. | Description | Prev. | Livrees | % | Statut | Priorite | Notes |
|---|---|---|---|---|---|---|---|
| A | Diagnostic Bot IA | 6 | 6 | 100% | Livre | — | QCM 5 parcours, Claude Vision, devis auto |
| B | CRM & Pipeline | 4 | 4 | 100% | Livre | — | 60+ champs, Kanban drag-drop, scoring |
| C | Devis & Facturation | 5 | 5 | 100% | Livre | — | PDF FR/HE, sync iCount, calculs auto |
| D | Gestion Projets | 4 | 4 | 100% | Livre | — | Planning, couts, marges prevue/reelle |
| E | Pointage / Timesheet | 4 | 3 | 75% | En cours | Haute | Comparaison prevu/reel a finaliser |
| F | SAV & Satisfaction | 3 | 3 | 100% | Livre | — | Tickets, scores 1-5, distribution |
| G | Contrats Numeriques | 3 | 3 | 100% | Livre | — | 3 types, signature pad HTML5 |
| H | Admin / QCM CMS | 4 | 4 | 100% | Livre | — | Flow builder, prompts, KB, analytics |
| I | Catalogue Produits | 4 | 4 | 100% | Livre | — | Import/export, calculateur prix |
| J | Analytics & Dashboard | 3 | 3 | 100% | Livre | — | KPIs, funnel, audit log |
Fonctionnalites a finaliser
| # | Fonctionnalite | Statut | Priorite | Description |
|---|---|---|---|---|
| 1 | Dashboard Executif | En cours | Moyenne | Page existante, enrichissement KPIs |
| 2 | Module Prospection | A faire | Haute | Configuration canaux multi-source |
| 3 | Droits d'acces | A faire | Haute | Interface RBAC complete |
| 4 | Voice / Vapi.ai | A faire | Basse | Integration telephonie IA |
| 5 | Notifications | A faire | Moyenne | Alertes in-app |
| 6 | Apparence / Theme | A faire | Basse | Personnalisation branding |
| 7 | Workflow validation | En cours | Haute | Circuit validation configurable |
| 8 | Comparaison timesheet | En cours | Moyenne | Prevu vs realise |
Risques & Blocages identifies
| # | Risque | Niveau | Description | Mitigation |
|---|---|---|---|---|
| 1 | Dependance API iCount | Moyenne | Latence sync, indisponibilite possible | Retry auto + fallback cache |
| 2 | Cout API Claude | Haute | Volume diagnostic → cout tokens eleve | Rate limiting + cache reponses |
| 3 | WhatsApp Evolution API | Faible | Deconnexion instance possible | Reconnexion auto + alerte |
| 4 | Performance multi-langue | Moyenne | Chargement i18n 4 langues simultanees | Lazy loading traductions |
Prochaines etapes
Taches manuelles
| # | Tache | Categorie | Date ajout | Statut | Actions |
|---|
Protocole V2 — Prix Fixe
Entre :
Jeremy Bouznah LTD | גרמי בוזנה בע"מ
Numero d'immatriculation : 517110912
Societe a responsabilite limitee (Private Limited Company) | Statut : Active (פעילה)
Date de constitution : 29/01/2025
68 כנפי נשרים, Jerusalem 9546457, Israel
Et :
Noah Israel | נח ישראל
Numero d'immatriculation : 516398864
Hevrat BAAM (חברת בע"מ)
81 Rue Shahal, Jerusalem 9372116, Israel
Tel : 054.992.28.59
Email : contact@noahisrael.co.il
Date :
Preambule
Noah Israel est une entreprise israelienne reconnue, specialisee depuis plus de 20 ans dans le diagnostic, le traitement et la prevention des pathologies du batiment en Israel. Leader dans son domaine, Noah Israel intervient sur l'ensemble des problematiques liees a l'humidite, aux fuites, aux infiltrations et a la qualite de l'air interieur, au service d'une clientele exigeante de particuliers, de syndics et de professionnels de l'immobilier.
Jeremy Bouznah LTD developpe une plateforme SaaS de diagnostic IA et de gestion commerciale (CRM) au service de l'activite de Noah Israel. Le present protocole definit les conditions d'un partenariat a prix fixe, dans lequel Jeremy Bouznah LTD porte le financement du developpement et Noah Israel s'acquitte d'une mensualite fixe jusqu'a l'atteinte du seuil de transfert.
Article 1 — Objet
Le present protocole definit les conditions du developpement, de la mise a disposition et du transfert de la plateforme SaaS de diagnostic IA et de gestion commerciale, pour un prix forfaitaire global de 140 000 NIS (cent quarante mille nouveaux shekels israeliens).
Article 2 — Perimetre
2.1 — Jeremy Bouznah LTD :- Developpement complet de la plateforme conformement au Cahier des Charges V1 (annexe au present accord)
- Mise a disposition de la plateforme fonctionnelle pendant toute la duree du contrat
- Maintenance corrective (bugs, securite) pendant la duree du contrat
- Financement initial du developpement (Jeremy Bouznah LTD porte le risque financier)
- Paiement de la mensualite fixe definie a l'article 3
Aucune obligation de performance, de KPI, d'utilisation minimale ou de volume d'activite n'est imposee a Noah Israel dans le cadre du present protocole.
Article 3 — Conditions financieres
3.1 — Prix forfaitaire global :Le prix total de la plateforme est fixe a 140 000 NIS (cent quarante mille nouveaux shekels israeliens). Ce montant couvre le developpement, la mise a disposition et la maintenance corrective pendant toute la duree du contrat.
3.2 — Mensualite fixe :Noah Israel s'acquitte d'une mensualite fixe de 5 000 NIS (cinq mille nouveaux shekels israeliens) par mois, payable le 1er de chaque mois. Cette mensualite constitue le seul paiement du par Noah Israel.
3.3 — Duree estimee :Au rythme de 5 000 NIS/mois, le seuil de 140 000 NIS est atteint en 28 mois. Cette duree est indicative et peut varier en cas de paiements anticipes ou de modification de la mensualite convenue entre les parties.
3.4 — Frais techniques et licences :Noah Israel s'engage a prendre en charge l'integralite des frais techniques suivants, en sus de la mensualite :
- Licences IA (Anthropic/Claude et tout autre fournisseur)
- Appels API (Claude, WhatsApp/Evolution, iCount, Vapi.ai)
- Infrastructure d'hebergement (serveurs, stockage, CDN)
- Licences logicielles necessaires au fonctionnement de la plateforme
Toute fonctionnalite ou evolution non prevue dans le Cahier des Charges V1 constitue un developpement supplementaire soumis a devis prealable accepte par Noah Israel et facture au taux horaire de reference de 300 NIS/heure.
Article 4 — Condition d'acces et maintien de la plateforme
4.1 — Acces conditionne :L'acces a la plateforme et son maintien en condition operationnelle sont conditionnes au paiement regulier de la mensualite de 5 000 NIS. En cas de non-paiement, Jeremy Bouznah LTD se reserve le droit de suspendre l'acces a la plateforme apres mise en demeure restee sans effet pendant 15 jours.
4.2 — Cahier des Charges V1 :La plateforme est consideree comme livree et fonctionnelle a 100% lorsque l'ensemble des fonctionnalites decrites dans le Cahier des Charges V1 (annexe au present accord) sont operationnelles. Le CDC V1 constitue le seul document de reference.
Article 5 — Propriete intellectuelle et transfert
5.1 — Propriete pendant le contrat :Pendant toute la duree du contrat et tant que le seuil de 140 000 NIS n'est pas atteint, le code source, l'architecture logicielle, les algorithmes, les prompts IA et toute la propriete intellectuelle de la plateforme restent la propriete exclusive de Jeremy Bouznah LTD.
5.2 — Transfert a l'atteinte du seuil de 140 000 NIS :Lorsque le cumul des mensualites versees par Noah Israel atteint 140 000 NIS, Jeremy Bouznah LTD remet a Noah Israel une copie integrale du code source de la plateforme dans son etat au moment de l'atteinte du seuil.
Noah Israel obtient une licence d'exploitation illimitee, perpetuelle et transferable, lui permettant d'utiliser, modifier et exploiter le code librement, sans restriction.
Jeremy Bouznah LTD conserve la pleine propriete intellectuelle du code et le droit de l'utiliser, le modifier et l'exploiter pour tout autre projet, client ou marque, sans restriction.
5.3 — Options post-transfert :Une fois le seuil de 140 000 NIS atteint et le code source remis, Noah Israel choisit parmi les options suivantes :
Article 6 — Resiliation
6.1 — Resiliation par Noah Israel :Noah Israel peut resilier le present protocole a tout moment, sans justification, avec un preavis de 30 jours.
En cas de resiliation :
- L'acces a la plateforme est immediatement coupe a l'expiration du preavis
- Les sommes deja versees par Noah Israel restent integralement acquises a Jeremy Bouznah LTD et ne font l'objet d'aucun remboursement
- Noah Israel ne peut pretendre a aucun droit sur le code source, la plateforme, les donnees techniques ou la propriete intellectuelle
- Jeremy Bouznah LTD fournira une exportation des donnees commerciales (clients, leads, devis, chantiers) dans un format exploitable (CSV/JSON)
Jeremy Bouznah LTD peut resilier le present protocole en cas de non-paiement de la mensualite pendant 2 mois consecutifs apres mise en demeure restee sans effet.
Les consequences sont identiques a celles de l'article 6.1 : sommes acquises, acces coupe, aucun droit sur le code.
6.3 — Aucune obligation post-resiliation :Apres resiliation, Jeremy Bouznah LTD n'a aucune obligation envers Noah Israel : pas de maintenance, pas de mise a jour, pas de transition, pas de support. La plateforme est coupee et le contrat prend fin.
Article 7 — Confidentialite
7.1 —Les deux parties s'engagent mutuellement a la confidentialite sur l'ensemble des informations echangees dans le cadre du partenariat : donnees clients, processus metier, code source, conditions financieres.
7.2 —Cette obligation survit a la resiliation pour une duree de 2 (deux) ans.
Article 8 — Resolution des litiges
8.1 — Mediation amiable :En cas de differend, les parties sollicitent en premier lieu Hillel et Ouriel pour tenter une resolution amiable.
8.2 — Din Torah :Si la mediation echoue, le litige est soumis exclusivement a un Din Torah. Les deux parties renoncent expressement a tout recours devant les tribunaux civils.
Article 9 — Droit applicable
Le present protocole est redige en francais et soumis exclusivement au Din Torah.
Article 10 — Dispositions finales
10.1 — Le present protocole constitue l'integralite de l'accord entre les parties et remplace tout accord anterieur.
10.2 — Toute modification devra faire l'objet d'un avenant ecrit signe par les deux parties.
10.3 — Si une clause est declaree nulle, les autres clauses restent en vigueur.
10.4 — Le present protocole est independant et exclusif de tout autre protocole. En cas de signature du present protocole, aucun autre accord de partenariat entre les parties ne s'applique.
Signatures
Fait en deux exemplaires originaux.