Espace Personnel

Contexte et objectif de l'Addendum

Ce document est le premier addendum à la Bible des Opérations GoWeBa (version 1.0, publiée le 06 mai 2026). Il documente l'ensemble des modifications apportées par le projet « Espace Personnel », déployé en trois phases entre le 06 et le 07 mai 2026. L'Espace Personnel est une fonctionnalité structurante qui introduit la notion d'organisation personnelle dans GoWeBa, permettant à chaque utilisateur de séparer ses activités personnelles de ses activités professionnelles, tout en ayant accès aux deux depuis une seule interface.

Portée de l'Addendum

Cet addendum couvre :

• La création automatique d'un Espace Personnel pour chaque utilisateur (Phase 1)
• La composition d'emails cross-organisation et les onglets de filtrage des contacts (Phase 2)
• L'agrégation des messages Webabox à travers toutes les organisations de l'utilisateur (Phase 3)
• Les modifications au schéma de données (enum OrgType, champ orgType)
• Les nouveaux endpoints API introduits
• Les nouvelles clés de traduction (i18n) en français, anglais et espagnol
• L'impact sur les modules existants du Guide Opérationnel

Conventions du document

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Vue d'ensemble — Concept d'Espace Personnel

L'Espace Personnel est un espace privé automatiquement créé pour chaque utilisateur de GoWeBa. Il fonctionne comme une organisation à part entière, mais dédiée aux activités personnelles de l'utilisateur.

Pourquoi un Espace Personnel ?

Avant l'introduction de l'Espace Personnel, un utilisateur GoWeBa ne pouvait appartenir qu'à des organisations professionnelles (entreprises, équipes). Cela posait plusieurs problèmes :

• Mélange des contacts personnels et professionnels
• Impossibilité de recevoir des emails personnels sans les partager avec l'équipe
• Pas de séparation entre les données privées et les données d'entreprise
• Confusion lors du passage entre plusieurs mandats/clients L'Espace Personnel résout ces problèmes en créant un cloisonnement naturel tout en permettant une vue unifiée quand l'utilisateur le souhaite.

Organisation PERSONAL vs STANDARD

Schéma visuel du concept

Structure multi-organisation d'un utilisateur GoWeBa : ┌─────────────────────────────────────────────────────┐ │ Utilisateur GoWeBa │ │ │ │ 🏠 Espace Personnel (PERSONAL) │ │ ├── Mes contacts personnels │ │ ├── Ma boîte email personnelle │ │ └── Mon Webabox personnel │ │ │ │ 🏢 Organisation A — GoWeBa.com (STANDARD) │ │ ├── Contacts d'équipe │ │ ├── Boîte email partagée │ │ └── Webabox de l'équipe │ │ │ │ 🏢 Organisation B — AlainBessette.com (STANDARD) │ │ ├── Contacts d'équipe │ │ ├── Boîte email partagée │ │ └── Webabox de l'équipe │ │ │ │ ◀═══ Sélecteur d'organisation (switcher) ═══▶ │ └─────────────────────────────────────────────────────┘

Phase 1 — Architecture et création automatique

La Phase 1 pose les fondations de l'Espace Personnel : le type d'organisation (OrgType), la création automatique à l'inscription, et le sélecteur d'organisation mis à jour.

Modification du schéma de données

Un nouvel enum OrgType a été ajouté au schéma Prisma :

Définition de l'enum dans le schéma : enum OrgType { PERSONAL STANDARD } Champ sur le modèle Organization : orgType OrgType @default(STANDARD) ⚠️ La migration est additive et compatible avec les données existantes. Toutes les organisations créées avant la Phase 1 conservent automatiquement le type STANDARD.

Création automatique de l'Espace Personnel

Lors de l'inscription d'un nouvel utilisateur, le système crée automatiquement :

1. Un compte utilisateur — email, mot de passe, nom
2. Une organisation personnelle — avec orgType = PERSONAL
3. Un membership — rôle OWNER, liant l'utilisateur à son espace personnel Règles de nommage de l'organisation personnelle :

Traitement des utilisateurs existants

Pour les utilisateurs qui existaient avant la Phase 1, un script de migration a été exécuté pour créer rétroactivement un Espace Personnel pour chacun d'entre eux. Utilisateurs concernés lors du déploiement initial :

Sélecteur d'organisation (Org Switcher)

Le sélecteur d'organisation dans la barre latérale a été mis à jour pour afficher deux sections distinctes :

Comportement du sélecteur :

1. Clique sur le sélecteur d'organisation dans la barre latérale gauche
2. La liste déroulante s'affiche avec deux sections séparées
3. La section 🏠 (Espace Personnel) apparaît en premier
4. La section 🏢 (Organisations) affiche tes organisations professionnelles
5. Clique sur une organisation pour y basculer
6. L'interface se met à jour instantanément pour refléter l'organisation sélectionnée 💡 Le sélecteur affiche un séparateur visuel entre les deux sections pour une distinction claire. ✅ Le sélecteur d'organisation est fonctionnel et déployé en production.

Fichiers modifiés — Phase 1

Phase 2 — Composition cross-org et onglets Contacts

La Phase 2 introduit deux fonctionnalités clés : la possibilité de composer des emails depuis n'importe quelle organisation, et le filtrage des contacts par organisation.

Composition cross-organisation

Avant la Phase 2, un utilisateur ne pouvait envoyer des emails qu'avec les comptes email de l'organisation active. Avec la Phase 2, le modal de composition affiche tous les comptes email de toutes les organisations de l'utilisateur, regroupés par organisation. Fonctionnement :

1. Clique sur « Composer » dans la Webabox
2. Le modal de composition s'ouvre
3. Dans le sélecteur « De » (expéditeur), les comptes sont regroupés par organisation
4. Chaque groupe affiche le nom de l'organisation avec son icône (🏠 ou 🏢)
5. Sélectionne le compte email depuis lequel tu veux envoyer
6. Rédige ton email normalement
7. Clique sur « Envoyer » Exemple de regroupement dans le sélecteur « De » :

Nouvel endpoint API — Comptes cross-org

Un nouvel endpoint API a été créé pour récupérer les comptes email de toutes les organisations de l'utilisateur :

Structure de la réponse : { "accounts": [ { "id": "...", "emailAddress": "[email protected]", "displayName": "Alain Bessette", "type": "PERSONAL_EMAIL", "status": "active", "isDefault": true, "organizationId": "...", "organizationName": "Alain Bessette", "orgType": "PERSONAL" } ] }

Onglets de filtrage — Module Contacts

Le module Contacts a été enrichi avec des onglets permettant de filtrer les contacts par organisation :

Fonctionnement des onglets :

1. Ouvre le module Contacts depuis le menu latéral
2. Les onglets de filtrage apparaissent au-dessus de la liste de contacts
3. Par défaut, l'onglet « Toutes les organisations » est sélectionné
4. Clique sur « Organisation courante » pour filtrer par l'organisation active
5. La liste de contacts se met à jour instantanément
6. Le compteur de contacts reflète le filtre actif 💡 Les onglets de contacts sont particulièrement utiles quand tu as beaucoup de contacts répartis entre ton espace personnel et tes organisations professionnelles.

Fichiers modifiés — Phase 2

Phase 3 — Agrégation Webabox cross-org

La Phase 3 est la plus impactante : elle permet à la Webabox (boîte de réception unifiée) d'afficher les messages de toutes les organisations de l'utilisateur simultanément, avec un système d'onglets pour filtrer par organisation.

Concept — Vue unifiée multi-organisation

Avant la Phase 3, la Webabox n'affichait que les messages de l'organisation active. L'utilisateur devait changer d'organisation pour voir ses autres messages. Avec la Phase 3, un système de « scope » permet d'afficher :

Onglets de la Webabox

La Webabox affiche maintenant une barre d'onglets au-dessus de la liste des messages : Exemple pour un utilisateur avec 3 organisations :

Comportement des onglets :

1. Par défaut, l'onglet « Toutes » est sélectionné (scope=all)
2. Clique sur un onglet pour filtrer les messages de cette organisation
3. Les messages, les compteurs et les statistiques se mettent à jour en temps réel
4. Le scope est transmis à tous les appels API (threads, snapshot, recherche)
5. Le changement d'onglet ne change PAS l'organisation active — il filtre uniquement la vue ⚠️ Le changement d'onglet dans la Webabox n'est PAS la même chose que le changement d'organisation dans le sélecteur. L'onglet filtre la vue, tandis que le sélecteur change le contexte global de l'application.

Fonction resolveOrgIds — Résolution du scope

Une nouvelle fonction utilitaire resolveOrgIds a été ajoutée aux endpoints API de la Webabox. Elle résout le paramètre scope en une liste d'identifiants d'organisation : Logique de résolution :

Endpoints API modifiés — Phase 3

Deux endpoints existants ont été modifiés pour supporter le paramètre scope :

Exemple d'appel API avec scope : GET /api/inbox/threads?tab=inbox&scope=all&page=1&limit=20 GET /api/inbox/snapshot?scope=all

Composants UI modifiés — Phase 3

Plusieurs composants de la Webabox ont été modifiés pour supporter l'agrégation cross-org :

Fichiers modifiés — Phase 3

Impact sur les modules existants

L'introduction de l'Espace Personnel modifie le comportement de plusieurs modules documentés dans la Bible des Opérations. Voici le détail des impacts par module :

Module 02 — Contacts & CRM

Impact : MODÉRÉ

• Ajout d'onglets de filtrage « Toutes les organisations » et « Organisation courante »
• Les contacts sont maintenant cloisonnés par organisation
• Un contact créé dans l'Espace Personnel est privé et invisible pour les organisations professionnelles
• La recherche de contacts peut couvrir toutes les organisations (onglet « Toutes ») Section du module 02 à mettre à jour :
• Section 3 (Interface) — Mentionner les onglets de filtrage
• Section 4 (Fonctionnalités) — Ajouter le comportement cross-org

Module 03 — Webabox / Boîte de Réception

Impact : MAJEUR

• La Webabox affiche maintenant des onglets d'organisation au-dessus de la liste des messages
• Le scope (all, current, orgId) est transmis à tous les appels API
• La composition d'email utilise un sélecteur d'expéditeur regroupé par organisation
• Les compteurs (badge de messages non lus) reflètent le scope actif Sections du module 03 à mettre à jour :
• Section 3 (Interface) — Ajouter les onglets d'organisation
• Section 4.1 (Composer un email) — Documenter le sélecteur cross-org
• Section 5 (Cas d'utilisation) — Ajouter le cas multi-organisation

Module 00 — Périmètre fonctionnel

Impact : MINEUR

• Ajouter l'Espace Personnel à la liste des modules/fonctionnalités
• Mettre à jour le schéma d'architecture pour inclure le type PERSONAL

Module 20 — Administration système

Impact : MINEUR

• Documenter le nouveau type d'organisation PERSONAL
• Les administrateurs système voient les deux types dans le panneau d'administration
• Les organisations personnelles ne peuvent pas être supprimées par l'administrateur

Modules NON impactés

Les modules suivants ne sont pas impactés par l'Espace Personnel :

Référence technique complète

Modifications du schéma de données

Nouveaux endpoints API

Endpoints modifiés

Fichiers créés

Fichiers modifiés

Dépendances ajoutées

Clés de traduction (i18n)

Les clés de traduction suivantes ont été ajoutées pour supporter l'Espace Personnel dans les trois langues de GoWeBa :

Clés — Phase 1 (Espace Personnel)

Clés — Phase 2 (Cross-org + Contacts)

Guide de dépannage

Voici les problèmes les plus fréquents liés à l'Espace Personnel et leurs solutions :

Historique des versions

Prochaines mises à jour prévues :

• Intégration des fonctionnalités de téléphonie avancée
• Améliorations du pipeline de ventes
• Nouvelles automatisations basées sur l'IA

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

GoWeBa — Bible des Opérations — Addendum 01 Espace Personnel — Phases 1, 2 et 3