# OTO — ARCHITECTURE COMPTE CLIENT + COURRIELS SPÉCIALISÉS
**Directive maîtresse · 2026-08-10 · Michel Roy · Co-Président WAG**
**Statut: OFFICIELLE — À exécuter par Claude Code DTP**

## Intégration ERPNext

### INSTRUCTION IMPORTANTE

Il faut séparer clairement :

**A. LE COMPTE CLIENT OTO**

et

**B. LES COURRIELS SPÉCIALISÉS OTO**

Ce sont deux systèmes complémentaires mais distincts.

ERPNext reste le système central pour les données métier et administratives.
OTO reste l'interface client Premium.

---

# 1. COMPTE CLIENT OTO

Le client doit pouvoir créer lui-même son compte depuis le site OTO.
Il ne faut PAS attendre qu'il remplisse un formulaire de contact pour lui créer automatiquement un compte.

Parcours:
SITE OTO → CRÉER UN COMPTE → Email + infos + mot de passe → Validation email → Compte activé → Espace client

# 2. LE CLIENT CONTRÔLE SON COMPTE

Le client choisit lui-même: email, mot de passe, infos personnelles, préférences, langue, préférences comms, infos complémentaires.

Système prévu: création, connexion, déconnexion, mdp oublié, changement mdp, vérif email, modif profil, gestion préférences, sécurité session.

# 3. LE COMPTE OTO N'EST PAS UN SIMPLE CONTACT ERPNEXT

Distinguer:
- **Identité numérique OTO** — compte de connexion portail
- **Fiche métier ERPNext** — Contact / Customer / Lead

Lien sécurisé quand nécessaire. Ne PAS utiliser l'email comme seul mécanisme d'autorisation.

# 4. CRÉATION DU COMPTE

CRÉER MON COMPTE → identité utilisateur portail → validation email → compte activé → puis création/association Contact ERPNext.
Rechercher si email existe déjà. Si oui → associer. Si non → créer selon règles. **JAMAIS de doublons.**

# 5. COMPTE SANS DEMANDE — PARFAITEMENT NORMAL

Michel visite OTO → crée compte → aucun service demandé = Compte actif + aucune demande active.
Dashboard: "Bienvenue Michel. Vous n'avez actuellement aucune demande active."

# 6. DEMANDE APRÈS COMPTE

Compte → Nouvelle demande → Formulaire (préremplis prénom/nom/email/tel/société/langue) → ERPNext.
Demande auto-associée au compte.

# 7. DEMANDE SANS COMPTE

Permis. Demande sans compte → ERPNext → Email confirmation → Proposition [CRÉER MON COMPTE].
**JAMAIS de création auto sans consentement.**

# 8-10. COURRIELS ACCOUNT

Templates séparés du système ACCOUNT (pas des Business Emails):
- **Confirmation email** — "OTO — Confirmez votre adresse email"
- **Compte activé** — "OTO — Votre compte est maintenant activé"
- **Mot de passe oublié** — "OTO — Réinitialisation de votre mot de passe"

# 11. COURRIELS SPÉCIALISÉS (BUSINESS)

Déclenchés par événements métier depuis ERPNext:
- **Immobilier** — intérêt unité, dispo, changement prix, réservation, confirmation, docs, paiement, échéance, contrat, signature, livraison
- **Projet** — demande reçue, dossier assigné, doc manquant, analyse terminée, approbation, échéance, changement statut
- **Support** — ticket reçu, assigné, réponse, info demandée, résolution, fermeture
- **Finance** — facture, paiement reçu, retard, reçu, solde, échéance

# 12-15. EXEMPLES BUSINESS EMAILS

Templates fournis pour: intérêt unité A-304, document manquant, confirmation paiement, changement prix.
**Prix affiché DOIT provenir de la source officielle ERPNext.**

# 16. DEUX CATÉGORIES — SÉPARATION TECHNIQUE

## ACCOUNT EMAILS
Compte: confirmation, activation, mdp oublié, changement mdp, sécurité, connexion importante, préférences.

## BUSINESS EMAILS
Activités: demande, projet, immobilier, vente, paiement, docs, support, contrats, notifications.

**NE PAS MÉLANGER.**

# 17. ERPNEXT COMME SYSTÈME CENTRAL

Business Emails: ERPNext → Email Template / Notification / Communication → Client.
Account Emails: mécanisme portail OTO approprié. **Ne pas forcer emails auth dans templates comms commerciales.**

# 18. DASHBOARD CLIENT OTO

Après connexion — BIENVENUE [PRÉNOM]:
- **Mon compte** — profil, sécurité, préférences, langue
- **Mes demandes** — nouvelles, en cours, en attente, terminées
- **Mes projets** — Projet 01, Projet 02
- **Mes documents** — disponibles, demandés, à signer
- **Mes communications** — messages, courriels, notifications
- **Mes paiements** — factures, paiements, soldes

Selon droits du client.

# 19. PORTAIL CLIENT ≠ ERPNEXT BACK OFFICE

Client → Portail OTO Luxury → API/Backend → ERPNext.
Client voit expérience OTO. Employés voient ERPNext/Dashboard selon permissions.
**Client ne voit JAMAIS l'interface ERPNext complète.**

# 20. PERMISSIONS

Client ne consulte QUE: son propre compte, ses demandes, ses projets, ses documents, ses paiements, ses communications.
**JAMAIS les données d'un autre client.**

# 21. EMAILS SPÉCIALISÉS ET COMPTE CLIENT

Événement métier → ERPNext identifie client → identifie compte OTO → génère courriel spécialisé → envoie → enregistre communication → client clique [VOIR MON DOSSIER] → Portail OTO → arrive directement sur le bon dossier.

# 22. LIENS PROFONDS DANS COURRIELS

**JAMAIS envoyer client à la page d'accueil.** Deep-links contextuels:
- Paiement → [VOIR MON PAIEMENT]
- Document → [DÉPOSER LE DOCUMENT]
- Projet → [VOIR MON PROJET]
- Demande → [VOIR MA DEMANDE]
- Général → [MON COMPTE]

# 23. WHATSAPP

Canal complémentaire. Ne remplace PAS: compte client, ERPNext, documents officiels, comms contractuelles.
Bouton WhatsApp possible dans certains courriels quand pertinent. Message auto avec référence "#OTO-2026-0810-00427".

# 24. RÈGLE DE CONCEPTION — 5 SYSTÈMES DISTINCTS

Architecture:
CLIENT → **OTO ACCOUNT** (auth) → **OTO PORTAL** (UX) → **OTO COMMUNICATION** (email/WA/notif) → **ERPNEXT** (data) → **OTOAI** (intelligence)

# 25. NE PAS CRÉER COMPTE AUTOMATIQUEMENT

"Contactez-nous" ≠ "Créer un compte client".
Compte créé UNIQUEMENT quand:
- Client choisit "CRÉER UN COMPTE"
- OU accepte explicitement proposition

**Respecter le choix du visiteur.**

# 26. OBJECTIF FINAL

Expérience plateforme institutionnelle Premium. Client fait tout self-service. Derrière: ERPNext système central officiel.

# 27. INSTRUCTION FINALE À CLAUDE CODE DTP

**AUDITER D'ABORD, avant toute modification:**
1. Système compte client OTO déjà prévu
2. Portail client
3. ERPNext
4. DocTypes existants
5. Système d'authentification
6. Email Accounts
7. Templates
8. Notifications
9. Communications
10. Intégrations WhatsApp
11. **Ne pas reconstruire ce qui existe déjà**
12. Connecter les systèmes proprement

**PUIS test complet end-to-end:**
Création compte → Validation email → Connexion → Formulaire → ERPNext → Dossier → Courriel spécialisé → Lien profond → Portail client → Action client → ERPNext → Nouvelle communication → Historique complet

**RÉSULTAT ATTENDU:** Système unique et cohérent, avec séparation technique claire entre **IDENTITÉ/COMPTE** et **COMMUNICATIONS MÉTIER**.

---

## Références liées
- Memory: `otov7_mandat_compte_client_courriels.md`
- Directive Financement Bancaire: `DIRECTIVE_FINANCEMENT_BANCAIRE_COMPLET_20260803.md`
- Directive PIE: `DIRECTIVE_PIE_PROJECT_IDENTITY_ENGINE_20260803.md`

## Priorité
🔴 **P0 — Compte Client (§1-10, §18-20, §24)** — bloque tout le reste
🔴 **P0 — Séparation ACCOUNT vs BUSINESS emails (§8-17)** — bloque comms clients
🟡 **P1 — Business Emails spécialisés (§11-15, §21-22)** — après P0
🟢 **P2 — Intégration WhatsApp complémentaire (§23)** — après P1
