.. Tiko documentation master file, created by
   sphinx-quickstart on Fri Jul 18 09:31:23 2025.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Tiko documentation
==================

1. Contexte du projet
Ce projet a été conçu pour faciliter la gestion d’événements de taille modeste (jusqu’à 200 participants). 
Il permet d’automatiser la génération et l’envoi de tickets numériques suite à 
une inscription et un paiement validé.

L’idée est de remplacer une gestion manuelle par un système léger, combinant un 
formulaire, un paiement mobile, et un envoi automatique de 
tickets avec QR Code. L'originalité du projet tient dans l'absence de base de 
données et une gestion efficace du nombre de ticket.

2. Fonctionnalités principales

* Lecture des inscriptions

* Génération automatique de tickets au format PDF avec QR Code

* Attribution d’un numéro de ticket unique

* Envoi automatique du ticket par e-mail après validation du paiement

* Vérification sécurisée des paiements 

* Suivi des paiements et de l’envoi dans Google Sheets

* Protection contre les doublons (transaction déjà traitée)

3. Étapes de travail

Voici les différentes étapes du fonctionnement global du projet :

- Inscription : L’utilisateur remplit un formulaire dont les réponses sont stockées automatiquement.

- Récupération des données 

- Envoi du lien de paiement : À chaque nouvelle soumission, un lien de paiement est généré et envoyé par e-mail.

- Paiement : L’utilisateur effectue le paiement via un moyen de paiement en ligne.

- Identification : Grâce aux informations transmises (nom, prénom, e-mail), le système retrouve la bonne personne.

- Génération du ticket : Le ticket est généré avec un identifiant unique.

- Envoi du ticket : Le ticket est envoyé automatiquement par e-mail.


4. Détails techniques
.. code-block:: text
   
   Environnement : Python

   Authentification API Google Sheets 

   Envoi d’e-mails : SMTP 

   QR Code : Généré avec qrcode

   PDF : Généré avec fpdf

   

   
.. NOTE :: Risques et limitations 
   Pas de base de données réelle : ce qui 
   limite les performances si le nombre de lignes augmente fortement.
   Capacité : Conçu pour des événements de 200 participants maximum.
   Gestion des doublons : Fiable si les identifiants (e-mail et transaction) 
   sont uniques.
   E-mails : Risques de limitations ou blocage si les quotas SMTP de 
   Gmail sont dépassés.
   Sécurité : Toute faille dans la configuration des clés secrètes ou des 
   variables d’environnement peut exposer l'application.
   Aucune interface utilisateur : Tout se fait en arrière-plan, sans tableau de 
   bord de suivi ou d’administration.


.. toctree::
   :maxdepth: 2
   :caption: Sommaire: