Documentation

Présentation du projet

Secret Santa est une application web simple et sécurisée pour organiser des échanges de cadeaux entre amis, famille ou collÚgues. L'application permet de créer un projet, d'inviter des participants, de définir des contraintes (pour éviter que certaines personnes se tirent entre elles), puis d'effectuer un tirage au sort aléatoire et équitable.

Chaque participant peut ensuite se connecter de maniÚre privée pour découvrir à qui il doit offrir un cadeau, sans que personne d'autre ne puisse voir cette information.

Comment ça marche ?

  1. Créer un projet : L'organisateur crée un nouveau projet en lui donnant un nom. Il peut optionnellement définir un mot de passe administrateur pour sécuriser le projet.
  2. Partager le lien : Un lien unique est généré pour le projet. L'organisateur le partage avec tous les participants.
  3. Inscription des participants : Chaque participant accÚde au lien, entre son nom et définit un mot de passe personnel. Il peut aussi ajouter un indice pour aider son Secret Santa (par exemple : "J'aime les livres de science-fiction").
  4. Définir des contraintes (optionnel) : L'organisateur peut définir des contraintes pour éviter que certaines personnes se tirent entre elles (par exemple, les couples).
  5. Effectuer le tirage : Une fois tous les participants inscrits, l'organisateur lance le tirage au sort. Les attributions sont alors générées et verrouillées.
  6. Consulter les résultats : Chaque participant revient sur le lien du projet et se connecte avec son mot de passe personnel pour découvrir à qui il doit offrir un cadeau.

Pourquoi revenir sur le site ? Pourquoi pas d'email ?

L'application a été conçue pour privilégier la simplicité technique et le respect de votre vie privée :

  • Pas d'adresse email requise : Vous n'avez pas besoin de fournir votre email, ce qui limite les donnĂ©es personnelles collectĂ©es et rĂ©duit les risques pour votre vie privĂ©e.
  • SimplicitĂ© technique : L'envoi d'emails est complexe et nĂ©cessite une infrastructure supplĂ©mentaire. En demandant aux participants de revenir sur le site, l'application reste simple, lĂ©gĂšre et facile Ă  maintenir.
  • SĂ©curitĂ© : Les rĂ©sultats sont protĂ©gĂ©s par le mot de passe personnel de chaque participant. Cela garantit que seule la personne concernĂ©e peut voir son attribution.

Mot de passe administrateur : avec ou sans ?

Lors de la création d'un projet, vous pouvez choisir de définir ou non un mot de passe administrateur. Voici les différences :

Avec mot de passe administrateur

  • Protection du tirage : Seul l'organisateur (qui connaĂźt le mot de passe) peut effectuer le tirage au sort et gĂ©rer les contraintes.
  • RĂ©initialisation des mots de passe : Si un participant oublie son mot de passe personnel, l'administrateur peut le rĂ©initialiser en utilisant le mot de passe administrateur. C'est l'avantage principal !
  • SĂ©curitĂ© renforcĂ©e : EmpĂȘche qu'une personne malveillante lance le tirage prĂ©maturĂ©ment ou modifie les contraintes.

Sans mot de passe administrateur

  • SimplicitĂ© : Pas besoin de retenir un mot de passe supplĂ©mentaire. N'importe qui ayant accĂšs au lien du projet peut lancer le tirage.
  • Confiance : Convient pour les groupes de confiance oĂč personne ne lancera le tirage de maniĂšre prĂ©maturĂ©e.
  • Limitation : Impossible de rĂ©initialiser les mots de passe des participants en cas d'oubli.

⚠ J'ai perdu mon mot de passe !

Si vous avez oublié votre mot de passe personnel, voici les solutions disponibles :

Si le projet a un mot de passe administrateur

Contactez l'organisateur du projet. En utilisant le mot de passe administrateur, il peut accéder à la page de gestion de votre profil participant et réinitialiser votre mot de passe personnel.

Si le projet n'a pas de mot de passe administrateur

Malheureusement, il n'est pas possible de récupérer votre mot de passe automatiquement. Dans ce cas, envoyez un email à contact@etienne.tech en précisant :

  • Le nom du projet
  • Le lien du projet
  • Votre nom de participant

Une assistance manuelle sera fournie pour résoudre le problÚme.

Sécurité et confidentialité

Votre vie privée et la sécurité de vos données sont importantes :

  • Chiffrement des mots de passe : Tous les mots de passe sont chiffrĂ©s avec bcrypt avant d'ĂȘtre stockĂ©s. MĂȘme l'administrateur du site ne peut pas les lire.
  • Pas d'email requis : Aucune adresse email n'est collectĂ©e, limitant ainsi les donnĂ©es personnelles.
  • RĂ©sultats privĂ©s : Seul le participant concernĂ© peut voir Ă  qui il doit offrir un cadeau.
  • Code source ouvert : Le code est disponible sur GitHub, vous pouvez vĂ©rifier par vous-mĂȘme comment l'application fonctionne.

Questions fréquentes

Puis-je modifier les participants aprĂšs le tirage ?

Non, une fois le tirage effectué, la liste des participants est verrouillée. Cela garantit l'intégrité du tirage et évite toute tricherie.

Peut-on refaire le tirage ?

Non, pour garantir l'Ă©quitĂ© et Ă©viter toute manipulation, le tirage ne peut ĂȘtre effectuĂ© qu'une seule fois. Si nĂ©cessaire, vous devrez crĂ©er un nouveau projet.

Les contraintes sont-elles garanties ?

L'algorithme de tirage tient compte de toutes les contraintes définies. Si aucune solution n'est possible avec les contraintes actuelles, le tirage échouera et vous devrez ajuster les contraintes.

Combien de temps les données sont-elles conservées ?

Les données des projets sont conservées indéfiniment dans la base de données. Si vous souhaitez supprimer un projet, contactez contact@etienne.tech.

Besoin d'aide ?

Si vous avez d'autres questions ou rencontrez un problÚme, n'hésitez pas à contacter :contact@etienne.tech