feat: first commit

Author: tuturd

.dockerignore

@@ -0,0 +1,7 @@
+**/__pycache__
+
+.mypy_cache
+.venv
+
+config/config.json
+.env

.env.example

@@ -0,0 +1,19 @@
+# Configuration Zammad
+ZAMMAD_API_URL=
+ZAMMAD_API_TOKEN=
+
+# Configuration authentification webhook
+WEBHOOK_USERNAME=
+WEBHOOK_PASSWORD=
+
+# Paramètres Flask
+FLASK_DEBUG=
+FLASK_PORT=
+
+# Paramètres Email
+MAIL_FROM=
+SMTP_HOST=
+SMTP_PORT=
+SMTP_USERNAME=
+SMTP_PASSWORD=
+SMTP_RECIPIENTS=

.gitignore

@@ -0,0 +1,7 @@
+**/__pycache__
+
+.mypy_cache
+.venv
+
+config/config.json
+.env

Dockerfile

@@ -0,0 +1,12 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+COPY requirements.txt ./
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+EXPOSE 8080
+
+CMD ["gunicorn", "--workers", "2", "--bind", "0.0.0.0:8080", "wsgi:application"]

README.md

@@ -0,0 +1,113 @@
+# BDE Tickets to PDF
+
+Webhook Flask pour générer automatiquement des PDFs à partir des tickets Zammad du BDE.
+
+## Structure du projet
+
+```
+bde-tickets-to-pdf/
+├── server.py                      # Point d'entrée Flask (endpoints, auth)
+├── wsgi.py                        # Entrée WSGI (exporte `application`) pour gunicorn/uWSGI
+├── config.py                      # Chargement/validation des variables d'environnement
+├── auth.py                        # Décorateur @requires_auth pour le webhook
+├── services/
+│   ├── pdf.py                     # Génération des PDFs (ReportLab)
+│   ├── zammad.py                  # Interaction avec l'API Zammad
+│   └── email.py                   # Envoi d'emails avec pièce jointe PDF (SMTP)
+├── requirements.txt               # Dépendances Python
+├── docker-compose.yaml            # Exemple de configuration Docker Compose
+├── .env.example                   # Exemple de variables d'environnement
+└── README.md                      # Documentation (ce fichier)
+```
+
+## Configuration
+
+1. Copiez `.env.example` vers `.env` :
+   ```bash
+   cp .env.example .env
+   ```
+
+2. Modifiez le fichier `.env` avec vos valeurs :
+   ```env
+   ZAMMAD_API_URL=https://votre-instance.zammad.com/api/v1/ticket_articles
+   ZAMMAD_API_TOKEN=votre_token_api_zammad
+   WEBHOOK_USERNAME=votre_nom_utilisateur
+   WEBHOOK_PASSWORD=votre_mot_de_passe_securise
+   FLASK_DEBUG=false
+   FLASK_PORT=5000
+   SMTP_HOST=smtp.example.com
+   SMTP_PORT=587
+   SMTP_USERNAME=...
+   SMTP_PASSWORD=...
+   MAIL_FROM=webhook@example.com
+   ```
+
+## Installation
+
+```bash
+pip install -r requirements.txt
+```
+
+## Utilisation
+
+```bash
+python server.py
+```
+
+Le serveur démarre sur `http://localhost:5000` (ou le port configuré).
+
+### En production (WSGI)
+
+Ne pas utiliser le serveur de développement Flask en production. Utilisez un serveur WSGI comme gunicorn ou waitress.
+
+Exemple avec gunicorn :
+
+```bash
+# depuis le répertoire du projet
+pip install gunicorn
+# lancer 4 workers et écouter sur le port 8080
+gunicorn --workers 4 --bind 0.0.0.0:8080 wsgi:application
+```
+
+Exemple avec waitress (Windows / simplicité) :
+
+```bash
+pip install waitress
+python -m waitress --port=8080 wsgi:application
+```
+
+Remarques :
+- Assurez-vous que FLASK_DEBUG=false dans vos variables d'environnement pour la production.
+- Vérifiez la configuration des variables d'environnement (voir .env.example) avant de démarrer.
+- Pour déploiements robustes, utilisez un process manager (systemd, supervisor) et configurez la rotation des logs et la supervision.
+
+## Endpoint
+
+- **POST** `/webhook` - Reçoit les données de ticket Zammad et génère un PDF
+
+### Authentification
+
+L'endpoint nécessite une authentification HTTP Basic avec les identifiants configurés dans le fichier `.env`.
+
+### Exemple de requête
+
+Le webhook attend un JSON avec la structure :
+```json
+{
+  "ticket": {
+    "id": 123,
+    "number": "32087",
+    "title": "Titre du ticket",
+    "owner": {
+      "firstname": "Jean",
+      "lastname": "Dupont"
+    },
+    // ... autres champs BDE
+  },
+  "article": {
+    "body": "Contenu de l'article",
+    "from": "user@example.com",
+    "created_at": "2025-09-25T10:30:00Z"
+  }
+}
+```

__init__.py

@@ -0,0 +1,2 @@
+# Package bde-tickets-to-pdf
+# Webhook pour générer des PDFs de tickets Zammad

auth.py

@@ -0,0 +1,26 @@
+from flask import request, jsonify
+from functools import wraps
+from config import Config
+
+
+def check_auth(username, password):
+    """Vérifie les identifiants d'authentification"""
+    return username == Config.WEBHOOK_USERNAME and password == Config.WEBHOOK_PASSWORD
+
+
+def authenticate():
+    """Renvoie une réponse 401 demandant l'authentification"""
+    return jsonify({"error": "Authentication required"}), 401
+
+
+def requires_auth(f):
+    """Décorateur pour vérifier l'authentification HTTP Basic"""
+
+    @wraps(f)
+    def decorated(*args, **kwargs):
+        auth = request.authorization
+        if not auth or not check_auth(auth.username, auth.password):
+            return authenticate()
+        return f(*args, **kwargs)
+
+    return decorated

config.py

@@ -0,0 +1,58 @@
+import os
+from dotenv import load_dotenv
+
+# Charger les variables d'environnement
+load_dotenv()
+
+
+class Config:
+    """Configuration centralisée de l'application"""
+
+    # Configuration Zammad
+    ZAMMAD_API_URL = os.getenv("ZAMMAD_API_URL", "")
+    ZAMMAD_API_TOKEN = os.getenv("ZAMMAD_API_TOKEN", "")
+
+    # Configuration authentification webhook
+    WEBHOOK_USERNAME = os.getenv("WEBHOOK_USERNAME", "")
+    WEBHOOK_PASSWORD = os.getenv("WEBHOOK_PASSWORD", "")
+
+    # Configuration Flask
+    DEBUG = os.getenv("FLASK_DEBUG", "False").lower() == "true"
+    PORT = int(os.getenv("FLASK_PORT", "5000"))
+
+    # Configuration Mails (correction et paramètres SMTP)
+    MAIL_FROM = os.getenv("MAIL_FROM", "")
+    SMTP_HOST = os.getenv("SMTP_HOST", "")
+    SMTP_PORT = int(os.getenv("SMTP_PORT", "587"))
+    SMTP_USERNAME = os.getenv("SMTP_USERNAME", "")
+    SMTP_PASSWORD = os.getenv("SMTP_PASSWORD", "")
+    SMTP_RECIPIENTS = os.getenv("SMTP_RECIPIENTS", "").split(",")
+    SMTP_USE_TLS = os.getenv("SMTP_USE_TLS", "True").lower() == "true"
+
+    @classmethod
+    def validate(cls):
+        """Valide que toutes les configurations obligatoires sont présentes"""
+        required_vars = [
+            ("ZAMMAD_API_URL", cls.ZAMMAD_API_URL),
+            ("ZAMMAD_API_TOKEN", cls.ZAMMAD_API_TOKEN),
+            ("WEBHOOK_USERNAME", cls.WEBHOOK_USERNAME),
+            ("WEBHOOK_PASSWORD", cls.WEBHOOK_PASSWORD),
+            ("MAIL_FROM", cls.MAIL_FROM),
+            ("SMTP_HOST", cls.SMTP_HOST),
+            ("SMTP_PORT", cls.SMTP_PORT),
+            ("SMTP_USERNAME", cls.SMTP_USERNAME),
+            ("SMTP_PASSWORD", cls.SMTP_PASSWORD),
+            ("SMTP_RECIPIENTS", cls.SMTP_RECIPIENTS),
+        ]
+
+        missing_vars = []
+        for var_name, var_value in required_vars:
+            if not var_value:
+                missing_vars.append(var_name)
+
+        if missing_vars:
+            raise ValueError(
+                f"Variables d'environnement manquantes: {', '.join(missing_vars)}"
+            )
+
+        return True

docker-compose.yaml

@@ -0,0 +1,9 @@
+services:
+  zammad-workflows:
+    image: zammad-workflows
+    ports:
+      - "8080:8080"
+    restart: unless-stopped
+    build: .
+    env_file:
+      - .env

requirements.txt

@@ -0,0 +1,21 @@
+beautifulsoup4==4.13.5
+blinker==1.9.0
+bs4==0.0.2
+certifi==2025.8.3
+charset-normalizer==3.4.3
+click==8.3.0
+Flask==3.1.2
+gunicorn==23.0.0
+idna==3.10
+itsdangerous==2.2.0
+Jinja2==3.1.6
+MarkupSafe==3.0.2
+packaging==25.0
+pillow==11.3.0
+python-dotenv==1.1.1
+reportlab==4.4.4
+requests==2.32.5
+soupsieve==2.8
+typing_extensions==4.15.0
+urllib3==2.5.0
+Werkzeug==3.1.3