Acteurs
Les 3 types d'acteurs qui interagissent avec Reciprok
Le système distingue 3 acteurs, chacun avec son contexte d'usage et ses droits.
1. L'utilisateur interne (équipe Reciprok)
Qui : le fondateur et ses collaborateurs.
Contexte : connecté à l'application en permanence, c'est l'opérateur principal.
Actions :
- Reçoit les demandes d'événements (manuelles, par email, par vocal)
- Qualifie et enrichit chaque demande
- Cherche les meilleurs membres
- Compose des catalogues personnalisés
- Envoie emails et messages WhatsApp
- Suit l'avancement de chaque deal
- Facture les commissions
- Interagit en permanence avec l'assistant IA
Authentification : Better Auth (email/password). Sessions persistantes.
Droits : accès complet à toutes les ressources.
2. L'organisateur (le client)
Qui : la personne ou l'entreprise qui cherche un lieu pour son événement.
Contexte : pas connecté à l'app. Interagit via :
- Email entrant (parsé par l'IA)
- Liens magic temporaires (consulter un catalogue, répondre à une requalification)
- Messages vocaux uploadés via lien dédié
Actions :
- Envoie sa demande (email, téléphone retranscrit, formulaire)
- Reçoit le catalogue
- Répond aux requalifications (par email ou par audio)
- Consulte les disponibilités proposées
Authentification : aucune connexion classique. Tokens d'accès signés (JWT court ou tokens DB) liés à une demande spécifique.
Création : automatique à la création d'une demande si l'email n'existe pas en base.
Notion de récurrence : un organisateur peut être nouveau ou récurrent. Impact direct sur le calcul de commission.
3. Le membre
Qui : établissement, restaurant, lieu événementiel, ou prestataire inscrit dans la base.
Contexte : pas connecté à l'app principale. Accès à un dashboard dédié via lien sécurisé personnel.
Actions :
- Met à jour ses informations (fiche, photos, capacités)
- Enregistre des audios de présentation (général + par espace)
- Met à jour ses disponibilités en temps réel (audio ou texte)
- Confirme/infirme des demandes de disponibilité
- Consulte les demandes le concernant
- Voit ses commissions
- Reçoit des notifications par email
Authentification : pas de mot de passe. Lien magique persistant (token DB) reçu par email à l'onboarding et accessible aussi via l'équipe Reciprok.
Particularité : un membre peut appartenir à un groupe (chaîne, holding). Le groupe a son propre dashboard agrégé.
Tableau récapitulatif
| Acteur | Auth | Surface | Fréquence d'usage |
|---|---|---|---|
| Équipe Reciprok | Better Auth | App complète | Quotidien |
| Organisateur | Tokens magic / email | Liens dédiés | Ponctuel |
| Membre | Lien magic persistant | Dashboard membre | Hebdomadaire |
L'IA comme "acteur système"
L'IA Claude n'est pas un acteur distinct au sens authentification, mais elle est tracée comme telle dans la timeline. Tout événement initié par l'IA porte actor: "ai" pour la traçabilité.
L'IA agit toujours pour le compte de l'utilisateur interne connecté. Elle hérite de ses droits, ses actions sont auditables, et elle ne peut faire que ce que l'utilisateur peut faire (principe du moindre privilège).