Courtier de l'annuaire et reprise

Le déroulé

flowchart TD
  subgraph P["Prospect"]
    a["Entrée par un lien courtier<br/>courtier verrouillé, pas de choix"]
    b["Étape 2 : choix du courtier<br/>facultatif, dans l'annuaire"]
    i["Clic sur<br/>Demander l'avis d'un courtier<br/>une seule fois"]
  end
  subgraph S["Système"]
    c["Courtier partenaire<br/>compte Inqase lié"]
    d["Courtier non partenaire<br/>aucun email à son choix"]
    e["Aucun courtier"]
    f["Offre calculée<br/>première fois"]
    n["Offre toujours payable<br/>pendant la reprise"]
    g["EMAIL : Nouveau prospect<br/>À : utilisateurs du cabinet lié, boîte de reprise en copie<br/>Type : notification portail"]
    h["SLACK : Demande créée<br/>À : canal Slack principal<br/>Type : avertissement"]
    j["EMAIL : Offre à suivre<br/>À : cabinet du partenaire, boîte de reprise en copie<br/>Type : notification portail"]
    k["EMAIL : Invitation à rejoindre Inqase<br/>À : courtier de l'annuaire<br/>Type : transactionnel"]
    l["EMAIL : Transmission à assigner<br/>À : boîte de reprise Inqase<br/>Type : transactionnel"]
  end
  subgraph T["Équipe Inqase"]
    m["Admin depuis le pipeline<br/>assigner, prévenir ou inviter"]
  end
  a -->|lie| c
  b -->|entrée avec compte| c
  b -->|entrée sans compte| d
  b -->|rien choisi| e
  c --> f
  d --> f
  e --> f
  f -->|courtier lié| g
  f -->|toujours| h
  f -.-> n
  f -->|le prospect peut demander| i
  i -->|1. partenaire joignable| j
  i -->|2. sinon annuaire| k
  i -->|3. sinon| l
  m -->|assigne ou prévient| j
  m -->|invite| k
  classDef action fill:#ffe86d,stroke:#a28e26,color:#574900
  classDef status fill:#9ce6ff,stroke:#2c97bb,color:#1c4657
  classDef done fill:#b3e65f,stroke:#6f9a24,color:#2c4300
  classDef email fill:#b8acfb,stroke:#8a7be0,color:#231266
  classDef external fill:#e5e7eb,stroke:#9ca3af,color:#374151
  class a,b,i,m action
  class c,d,e,f status
  class n done
  class g,j,k,l email
  class h external

Trois situations (partenaire, non partenaire, aucun) convergent vers le même calcul de l’offre, puis la reprise choisit un seul destinataire selon l’ordre 1, 2, 3.

Étapes

Le prospect entre par le lien d’un courtier (courtier verrouillé) ou choisit un courtier dans l’annuaire à l’étape 2.
Selon le choix, il est lié à un courtier partenaire, à un courtier non partenaire (sans email envoyé à ce stade) ou à aucun.
Au premier calcul de l’offre, le cabinet lié reçoit « Nouveau prospect » et l’équipe une alerte Slack.
Le prospect clique sur « Demander l’avis d’un courtier » (une fois, offre calculée).
Inqase envoie un seul email : « Offre à suivre » au partenaire, sinon l’invitation à l’annuaire, sinon « Transmission à assigner » à la boîte de reprise.
Un administrateur peut assigner un courtier, prévenir le partenaire ou inviter le courtier de l’annuaire depuis le pipeline.

À valider en équipe

Choisir un courtier de l’annuaire à l’étape 2 n’envoie rien : faut-il prévenir ce courtier plus tôt, ou est-ce voulu ?
Si le partenaire n’a aucun utilisateur ou si l’offre est clôturée, la reprise saute au courtier de l’annuaire puis à la boîte : l’équipe veut-elle en être informée ?
L’invitation à l’annuaire n’est envoyée qu’une fois par demande : que fait-on si l’adresse du courtier est fausse ?
Aucun suivi automatique si personne ne reprend l’offre dans la boîte de reprise : quel délai de relance accepte-t-on ?
Le prospect ne peut demander l’avis qu’une fois : faut-il autoriser un second essai après un échec d’envoi ?

Règles et détails

Les règles de rattachement, d’envoi et de reprise sont dans Inscription et reprise des courtiers. La revue manuelle est dans Cycle de vie de l’offre.

Où dans le code

app/Actions/Quote/HandOffToBroker.php
app/Actions/Broker/NotifyBrokerOfOffer.php, app/Actions/Broker/NotifyDirectoryBroker.php
app/Listeners/Broker/NotifyBrokerOfNewLead.php
app/Http/Controllers/Admin/Pipeline/ActionController.php