Merge pull request 'Fixed footers' (#4) from wip into main

Reviewed-on: #4

LICENSE

@@ -0,0 +1,24 @@
+Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0)
+
+Copyright (c) 2025 Djeex
+
+This work is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License.
+
+You are free to:
+
+Share — copy, distribute, and transmit the material in any medium or format
+
+Adapt — remix, transform, and build upon the material
+
+Under the following terms:
+
+Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
+
+NonCommercial — You may not use the material for commercial purposes.
+
+No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
+
+You can review the full license here:
+https://creativecommons.org/licenses/by-nc/4.0/
+
+DISCLAIMER: This text does not constitute legal advice. For any legal questions, please consult a professional.

README.md

@@ -1,69 +1,50 @@
-# Nvidia Stock Bot
-Par KevOut & Djeex
+<h1 align="center"> Nvidia Stock Bot</h1>
+<div align="center">
+    <a href="https://discord.gg/gxffg3GA96">
+        <img src="https://img.shields.io/badge/JV%20hardware-rejoindre-green?style=flat-square&logo=discord&logoColor=%23fff" alt="JV Hardware">
+    <a href="https://creativecommons.org/licenses/by-nc/4.0/" target="_blank">
+        <img src="https://img.shields.io/badge/License-CC%20BY--NC%204.0-8E44AD?style=flat-square" alt="License: CC BY-NC 4.0">
+    </a>
 
-[![](https://img.shields.io/badge/JV%20hardware-rejoindre-green?style=flat-square&logo=discord&logoColor=%23fff&label=JV%20hardware&link=https%3A%2F%2Fdiscord.gg%2Fgxffg3GA96)](https://discord.gg/gxffg3GA96)
+</div>
+<div align="center" >
+    <img src="https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/nvidia-stock-bot-logo.png" alt="Nvidia Stock Bot" width="300">
+</div>
 
+**Nvidia Stock Bot** - Un robot qui permet d'être alerté en temps réel des stocks de cartes graphiques **Nvidia RTX FE** grâce à des notifications Discord.
 
-Ce robot :
-- Appelle l'API de Nvidia listant le produit (par défaut toutes les 60s)
-- Récupère le SKU du produit concerné
-- Appelle le stock lié à ce SKU
-- Si du stock est trouvé, envoie une notification discord via le webhook paramétré
-- Si le produit était déjà en stock, il n'envoie plus de notification
-- Si le produit était en stock mais ne l'est plus, envoie une notification discord signifiant la fin du stock
+*Le code a été en partie rédigé et structuré à l'aide d'une IA générative.*
 
-<img src="https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/nvbot.png" align="center">
+## Sommaire
 
-Trois modes d'installation :
-- [Avec le dépot Git et Docker](https://git.djeex.fr/Djeex/nvidia-stock-bot/#installation-avec-le-d%C3%A9pot)
-- [Sans le dépot Git et avec notre image docker fournie](https://git.djeex.fr/Djeex/nvidia-stock-bot/#installation-sans-le-d%C3%A9pot-avec-docker-compose)
-- [Avec python (développeurs)](https://git.djeex.fr/Djeex/nvidia-stock-bot/#installation-sans-le-d%C3%A9pot-avec-docker-compose)
+- [Fonctionnalités](#fonctionnalit%C3%A9s)
+- [Installation docker sans le dépot (rapide)](#installation-sans-le-d%C3%A9pot-avec-docker-compose)
+- [Installation docker avec le dépot (développeur)](#installation-avec-le-d%C3%A9pot)
+- [Installation avec Python (développeur)](#installation-avec-python)
+- [Captures d'écran](#captures-d%C3%A9cran)
+- [Contributeurs](#contributeurs)
 
-## Installation avec le dépot
+## Fonctionnalités
 
-Vous trouverez-ci dessous les instructions pour installer le dépot, compiler l'image docker, et lancer le conteneur. Avec cette solution, votre bot tournera tout seul tant que le conteneur est actif.
+- Notification Discord `@everyone` en cas de changement du SKU (potentiel drop imminent)
+- Notification Discord `@everyone` en cas de stock détecté avec modèle, prix, et lien
+- Notification Discord silencieuse en cas d'absence de stock détécté
+- Choix de la fréquence de la vérification
+- Choix du modèle à surveiller
 
-### Pré-requis
-- Git
-- Docker
-
-### Cloner et paramétrer
-
-Clonez le repo :
-```sh
-git clone https://git.djeex.fr/Djeex/nvidia-stock-bot.git
-```
-
-Rendez vous dans le dossier `nvidia-stock-bot` et compilez l'image docker :
-```sh
-docker build -t nvidia-stock-bot .
-```
-
-Rendez-vous dans le dossier `nvidia-stock-bot/docker` et éditez le fichier `.env` avec :
-- l'url de votre webhook discord
-- la fréquence de consultation des stock (par défaut 60s, attention à ne pas trop descendre sous peine de blocage de votre adresse IP par nVidia)
-
-### Lancer l'image
-
-Rendez-vous dans le dossier `nvidia-stock-bot/docker` et lancez le conteneur :
-```sh
-docker compose up -d
-```
-
-### Voir les logs pour vérifier le bon fonctionnement
-
-```sh
-docker logs -f nvidia-stock-bot
-```
+<img src="https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/nvbot_schematics.png" align="center">
 
 ## Installation sans le dépot avec docker compose
 
 Vous trouverez-ci dessous les instructions pour configurer le conteneur avec notre image pré-compilée. Avec cette solution, votre bot tournera tout seul tant que le conteneur est actif.
 
-### Pré-requis
-- Docker
+**Pré-requis**
+- [Docker](https://docs.docker.com/engine/install/)
 
-### Configuration
+**Configuration**
+
+- Créez un dossier `nvidia-stock-bot`
+- Créez le fichier `compose.yaml` dans ce dossier avec la configuration ci-dessous :
 
 ```yaml
 version: "3.8"
@@ -71,27 +52,80 @@ services:
   nvidia-stock-bot:
     image: git.djeex.fr/djeex/nvidia-stock-bot:latest
     container_name: nvidia-stock-bot
-    restart: always # Le conteneur redémarrera automatiquement en cas d'échec
+    restart: always
     environment:
       - DISCORD_WEBHOOK_URL= # URL de votre webhook Discord
       - REFRESH_TIME=        # Durée de rafraichissement du script en secondes
       - API_URL_SKU=         # API listant le produit par exemple https://api.nvidia.partners/edge/product/search?page=1&limit=100&locale=fr-fr&Manufacturer=Nvidia&gpu=RTX%205090
       - API_URL_STOCK=       # API appelant le stock sans préciser la valeur du sku, par exemple https://api.store.nvidia.com/partner/v1/feinventory?locale=fr-fr&skus=
-      - TEST_MODE=  #true pour tester les notifications discord. false par défaut.
+      - PRODUCT_URL=         # URL d'achat du GPU
+      - PRODUCT_NAME=        # Le nom du GPU qui s'affiche dans les notifications
+      - TEST_MODE=           # true pour tester les notifications discord. false par défaut.
       - PYTHONUNBUFFERED=1   # Permet d'afficher les logs en temps réel
     command: python nvidia-stock-bot.py # Lance le script Python au démarrage du conteneur
 ```
 
+**Lancer l'image**
+
+Rendez-vous dans le dossier `nvidia-stock-bot` et lancez le conteneur :
+```sh
+docker compose up -d
+```
+
+**Voir les logs pour vérifier le bon fonctionnement**
+
+```sh
+docker logs -f nvidia-stock-bot
+```
+
+## Installation avec le dépot
+
+Vous trouverez-ci dessous les instructions pour installer le dépot, compiler l'image docker, et lancer le conteneur. Avec cette solution, votre bot tournera tout seul tant que le conteneur est actif.
+
+**Pré-requis**
+- [Git](https://git-scm.com/docs)
+- [Docker](https://docs.docker.com/engine/install/)
+
+**Cloner et paramétrer**
+
+- Clonez le repo :
+```sh
+git clone https://git.djeex.fr/Djeex/nvidia-stock-bot.git
+```
+
+- Rendez vous dans le dossier `nvidia-stock-bot` et compilez l'image docker :
+```sh
+docker build -t nvidia-stock-bot .
+```
+
+- Puis rendez-vous dans le dossier `nvidia-stock-bot/docker` et éditez le fichier `.env` avec :
+  - l'url de votre webhook discord
+  - les différents liens API et produits
+  - la fréquence de consultation des stock (par défaut 60s, attention à ne pas trop descendre sous peine de blocage de votre adresse IP par nVidia)
+
+**Lancer l'image**
+
+Rendez-vous dans le dossier `nvidia-stock-bot/docker` et lancez le conteneur :
+```sh
+docker compose up -d
+```
+
+**Voir les logs pour vérifier le bon fonctionnement**
+
+```sh
+docker logs -f nvidia-stock-bot
+```
+
 ## Installation avec Python
 
 Vous trouverez ci-dessous comment exécuter directement le script Python. Avec cette solution, le bot s'arretera si vous fermez votre terminal.
 
-### Pré-requis
+**Pré-requis**
 
 - Python 3.11 ou plus
 - requests : `pip install requests`
 
-### Configuration
+**Configuration**
 
 - Créez un environnement virtuel (exemple : `python3 -m venv nom_de_l_environnement` )
 - Créez un dossier et aller dedans
@@ -105,8 +139,10 @@ Vous trouverez ci-dessous comment exécuter directement le script Python. Avec c
   ```sh
   export DISCORD_WEBHOOK_URL="https://votre_url_discord"
   export REFRESH_TIME="60"
-  export API_URL_SKU="https://api.nvidia.partners/edge/product/search?page=1&limit=100&locale=fr-fr&Manufacturer=Nvidia&gpu=RTX%205090"
+  export API_URL_SKU="https://api.nvidia.partners/edge/product/search?page=1&limit=100&locale=fr-fr&Manufacturer=Nvidia&gpu=RTX%205080"
   export API_URL_STOCK="https://api.store.nvidia.com/partner/v1/feinventory?locale=fr-fr&skus="
+  export PRODUCT_URL= "https://marketplace.nvidia.com/fr-fr/consumer/graphics-cards/?locale=fr-fr&page=1&limit=12&gpu=RTX%205080&manufacturer=NVIDIA"
+  export PRODUCT_NAME="RTX 5080"
   export TEST_MODE=false
   ```
 - Lancez le script
@@ -114,3 +150,17 @@ Vous trouverez ci-dessous comment exécuter directement le script Python. Avec c
   ```sh
   python nvidia-stock-bot.py
   ```
+
+## Captures d'écran
+
+  <div align="center" >
+    <img src="https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/nvidia-stock-bot-discord.png" alt="Nvidia Stock Bot - captures">
+</div>
+
+## Contributeurs
+
+On remercie pour leurs contributions :
+
+- Djeex
+- KevOut
+- Extreme2pac

docker/.env

@@ -2,3 +2,5 @@ DS_HOOK= #votre url du webhook Discord
 FREQ=           #frequence de rafraichissement en secondes
 API_URL_SKU=    # API listant le produit par exemple https://api.nvidia.partners/edge/product/search?page=1&limit=100&locale=fr-fr&Manufacturer=Nvidia&gpu=RTX%205090
 API_URL_STOCK=  # API appelant le stock sans préciser la valeur du sku, par exemple https://api.store.nvidia.com/partner/v1/feinventory?locale=fr-fr&skus=
+PRODUCT_URL=    # URL d'achat du GPU
+PRODUCT_NAME=   #Le nom du GPU qui s'affiche dans les notifications

nvidia-stock-bot.py

@@ -19,6 +19,8 @@ try:
     API_URL_STOCK = os.environ['API_URL_STOCK']
     REFRESH_TIME = int(os.environ['REFRESH_TIME'])  # Convertir en entier
     TEST_MODE = os.environ.get('TEST_MODE', 'False').lower() == 'true'
+    PRODUCT_URL = os.environ['PRODUCT_URL']
+    PRODUCT_NAME = os.environ['PRODUCT_NAME']
     
     # Regex pour extraire l'ID et le token
     match = re.search(r'/(\d+)/(.*)', DISCORD_WEBHOOK_URL)
@@ -43,12 +45,15 @@ except ValueError:
     exit(1)
 
 # Affichage des URLs et configurations
+logging.info(f"GPU: {PRODUCT_NAME}")
 logging.info(f"URL Webhook Discord: {wh_masked_url}")
 logging.info(f"URL API SKU: {API_URL_SKU}")
 logging.info(f"URL API Stock: {API_URL_STOCK}")
+logging.info(f"URL produit: {PRODUCT_URL}")
 logging.info(f"Temps d'actualisation: {REFRESH_TIME} secondes")
 logging.info(f"Mode Test: {TEST_MODE}")
 
+
 # Entêtes HTTP
 HEADERS = {
     "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) "
@@ -76,19 +81,26 @@ session.mount('https://', HTTPAdapter(max_retries=retries))
 # Stockage de l'état des stocks
 global_stock_status = {}
 
+# Stocke le dernier SKU connu
+last_sku = None
+first_run = True  # Before calling check_rtx_50_founders
+
 # Notifications Discord
 def send_discord_notification(gpu_name: str, product_link: str, products_price: str):
+    
+    # Récupérer le timestamp UNIX actuel
+    timestamp_unix = int(time.time())
+
     if TEST_MODE:
         logging.info(f"[TEST MODE] Notification Discord: {gpu_name} disponible !")
         return
     
     embed = {
-        "title": f"🚀 {gpu_name} EN STOCK !",
+        "title": f"🚀 {PRODUCT_NAME} EN STOCK !",
         "color": 3066993,
         "thumbnail": {
             "url": "https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/RTX5000.jpg"
         },
-        "timestamp": time.strftime("%Y-%m-%dT%H:%M:%S", time.gmtime()),
         "author": {
             "name": "Nvidia Founder Editions"
         },
@@ -96,16 +108,23 @@ def send_discord_notification(gpu_name: str, product_link: str, products_price:
         "fields": [
             {
             "name": "Prix",
-            "value": f"`{products_price} €`",
+            "value": f"`{products_price}€`",
             "inline": True
-            }
+            },
+
+            {
+            "name": "Heure",
+            "value": f"<t:{timestamp_unix}:d> <t:{timestamp_unix}:T>",
+            "inline": True
+            },
         ],
-        "description": "**:point_right: [Acheter maintenant](https://marketplace.nvidia.com/fr-fr/consumer/graphics-cards/?locale=fr-fr&page=1&limit=12&gpu=RTX%205090,RTX%205080)**",
+        "description": f"**:point_right: [Acheter maintenant]({product_link})**",
         "footer": {
-            "text": "Par KevOut & Djeex"
+            "text": "NviBot • JV Hardware 2.0",
+            "icon_url": "https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/ds_wh_pp.jpg"
         }
     }
-    payload = {"content": "@everyone", "username": "NviBot", "avatar_url": "https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/RTX5000_pp.jpg", "embeds": [embed]}
+    payload = {"content": "@everyone", "username": "NviBot", "avatar_url": "https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/ds_wh_pp.jpg", "embeds": [embed]}
     try:
         response = requests.post(DISCORD_WEBHOOK_URL, json=payload)
         if response.status_code == 204:
@@ -116,27 +135,39 @@ def send_discord_notification(gpu_name: str, product_link: str, products_price:
         logging.error(f"🚨 Erreur lors de l'envoi du webhook : {e}")
 
 def send_out_of_stock_notification(gpu_name: str, product_link: str, products_price: str):
+    
+    # Récupérer le timestamp UNIX actuel
+    timestamp_unix = int(time.time())
+
     if TEST_MODE:
         logging.info(f"[TEST MODE] Notification Discord: {gpu_name} hors stock !")
         return
     
     embed = {
-        "title": f"❌ {gpu_name} n'est plus en stock",
-        "description": f":disappointed_relieved:",
+        "title": f"❌ {PRODUCT_NAME} n'est plus en stock",
         "color": 15158332,  # Rouge pour hors stock
-        "timestamp": time.strftime("%Y-%m-%dT%H:%M:%S", time.gmtime()),
         "thumbnail": {
             "url": "https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/RTX5000.jpg"
         },
-        "url": "https://marketplace.nvidia.com/fr-fr/consumer/graphics-cards/?locale=fr-fr&page=1&limit=12&gpu=RTX%205090,RTX%205080",
+        "url": f"{product_link}",
         "author": {
             "name": "Nvidia Founder Editions"
         },
+        
         "footer": {
-            "text": "Par KevOut & Djeex"
+            "text": "NviBot • JV Hardware 2.0",
+            "icon_url": "https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/ds_wh_pp.jpg"
+        },
+
+        "fields": [
+            {
+            "name": "Heure",
+            "value": f"<t:{timestamp_unix}:d> <t:{timestamp_unix}:T>",
+            "inline": True
             }
+        ]
     }
-    payload = {"username": "NviBot", "avatar_url": "https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/RTX5000_pp.jpg", "embeds": [embed]}
+    payload = {"username": "NviBot", "avatar_url": "https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/ds_wh_pp.jpg", "embeds": [embed]}
     try:
         response = requests.post(DISCORD_WEBHOOK_URL, json=payload)
         if response.status_code == 204:
@@ -146,20 +177,80 @@ def send_out_of_stock_notification(gpu_name: str, product_link: str, products_pr
     except Exception as e:
         logging.error(f"🚨 Erreur lors de l'envoi du webhook : {e}")
 
+def send_sku_change_notification(old_sku: str, new_sku: str, product_link: str):
+    
+    # Récupérer le timestamp UNIX actuel
+    timestamp_unix = int(time.time())
+
+    if TEST_MODE:
+        logging.info(f"[TEST MODE] Changement de SKU détecté : {old_sku} → {new_sku}")
+        return
+
+    embed = {
+        "title": f"🔄 {PRODUCT_NAME} Changement de SKU détecté",
+        "url": f"{product_link}",
+        "description": f"**Ancien SKU** : `{old_sku}`\n**Nouveau SKU** : `{new_sku}`",
+        "color": 16776960,  # Jaune
+
+        "footer": {
+            "text": "NviBot • JV Hardware 2.0",
+            "icon_url": "https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/ds_wh_pp.jpg"
+        },
+
+        "fields": [
+            {
+            "name": "Heure",
+            "value": f"<t:{timestamp_unix}:d> <t:{timestamp_unix}:T>",
+            "inline": True
+            }
+        ]
+    }
+    
+    payload = {
+        "content": "@everyone ⚠️ Potentiel drop imminent !",
+        "username": "NviBot",
+        "avatar_url": "https://git.djeex.fr/Djeex/nvidia-stock-bot/raw/branch/main/assets/img/ds_wh_pp.jpg",
+        "embeds": [embed]
+    }
+    
+    try:
+        response = requests.post(DISCORD_WEBHOOK_URL, json=payload)
+        if response.status_code == 204:
+            logging.info("✅ Notification de changement de SKU envoyée sur Discord.")
+        else:
+            logging.error(f"❌ Erreur Webhook : {response.status_code} - {response.text}")
+    except Exception as e:
+        logging.error(f"🚨 Erreur lors de l'envoi du webhook : {e}")
+
 # Recherche du stock
 def check_rtx_50_founders():
-    global global_stock_status
+    global global_stock_status, last_sku, first_run
 
     # Appel vers l'API produit pour récupérer le sku et l'upc
+
     try:
         response = session.get(API_URL_SKU, headers=HEADERS, timeout=10)
-        logging.info(f"Réponse de l'API : {response.status_code}")
+        logging.info(f"Réponse de l'API SKU : {response.status_code}")
         response.raise_for_status()
         data = response.json()
     except requests.exceptions.RequestException as e:
         logging.error(f"Erreur API SKU : {e}")
         return
 
+    product_details = data['searchedProducts']['productDetails'][0]
+    product_sku = product_details['productSKU']
+
+    # Vérifier si c'est la première exécution
+    if last_sku is not None and product_sku != last_sku:
+        if not first_run:  # Évite d'envoyer une notification au premier appel
+            product_link = PRODUCT_URL
+            logging.warning(f"⚠️ SKU modifié : {last_sku} → {product_sku}")
+            send_sku_change_notification(last_sku, product_sku, product_link)
+
+    # Mettre à jour le SKU stocké
+    last_sku = product_sku
+    first_run = False  # Désactive la protection après la première exécution
+
     product_details = data['searchedProducts']['productDetails'][0]
     product_sku = product_details['productSKU']
     product_upc = product_details.get('productUPC', "")
@@ -207,12 +298,12 @@ def check_rtx_50_founders():
         previously_in_stock = global_stock_status.get(gpu_upper, False)
         
         if currently_in_stock and not previously_in_stock:
-            product_link = "https://marketplace.nvidia.com/fr-fr/consumer/graphics-cards/?locale=fr-fr&page=1&limit=12&gpu=RTX%205090,RTX%205080"
+            product_link = PRODUCT_URL
             send_discord_notification(gpu_upper, product_link, products_price)
             global_stock_status[gpu_upper] = True
             logging.info(f"{gpu} est maintenant en stock!")
         elif not currently_in_stock and previously_in_stock:
-            product_link = "https://marketplace.nvidia.com/fr-fr/consumer/graphics-cards/?locale=fr-fr&page=1&limit=12&gpu=RTX%205090,RTX%205080"
+            product_link = PRODUCT_URL
             send_out_of_stock_notification(gpu_upper, product_link, products_price)
             global_stock_status[gpu_upper] = False
             logging.info(f"{gpu} n'est plus en stock.")