Prix des Eaux de Tunisie
Site web (et base d'une future app) qui compare les prix des marques d'eau minérale vendues
en Tunisie (bouteille et stika), relevés automatiquement chaque nuit par GitHub chez Carrefour (magasin par
magasin) et Géant Drive, complétés par les prix signalés par les visiteurs. Le site est autonome : rien sur le PC,
rien à la main. (Aziza retiré le 30/09/2026 ; Otrity et Monoprix retirés le 23/10/2026 : ils ne se lisaient pas depuis
GitHub, voir « Mettre à jour les prix ».)
Site public : https://prix-eau.clicvia.com/
© 2026 — Tous droits réservés (voir LICENSE). Ce dépôt est public uniquement pour l'hébergement
gratuit du site : aucune réutilisation du code ou des données sans autorisation écrite.
Dépôt GitHub : https://github.com/Ah6259/prix-eaux-tunisie
(Ancienne version privée Claude : https://claude.ai/artifact/N4YgHUrDQegTPn69Z77DCv)
Contenu actuel (05/10/2026)
05/10 : design pro, photo neutre, photos libres des marques sans magasin, sécurité (CSP, noai, anti-copie),
site installable (manifeste + service worker), Votre avis, GoatCounter, aperçu WhatsApp léger. Détails : CLAUDE.md.
- 35 marques (26 avec prix), prix relevés chaque jour (Carrefour, Géant)
- Carte « 💧 La moins chère aujourd'hui » (« Stika (6 × 1,5 L) – Géant ») + petit bouton « Partager »
(WhatsApp) sous le prix, top 5, classement complet ; recherche
- Menu fixe en haut : 3 boutons sur une ligne qui ouvrent chacun un panneau — Stika/Bouteille
(stika = 6 × bouteille, 12 pour ≤ 0,75 L), Type d'eau (minérale / source / traitée / gazeuse,
plusieurs choix), Format (plusieurs choix) ; le tri est au-dessus de la liste des marques
- Composition minéralogique de 32 eaux (Office du Thermalisme,
data/composition.js)
- Historique des prix, pages par marque (
marque/<slug>/), FAQ, SEO, PWA
- Page « Comment fonctionne le site ? » (
a-propos/, 25/10/2026, règle commune § 44) : fabriquée chaque nuit par
page_a_propos() de tools/build_guides.py, liée depuis l'accueil et tous les pieds de page ; à tenir à jour à chaque
modification visible (test FONCTIONS de tools/test_site.mjs)
- Alertes : baisses de prix ≥ 1 % publiées chaque nuit sur le canal Telegram
https://t.me/prixeautunisie + bandeau « Baisses de prix aujourd'hui »
- Prix signalés par les visiteurs (Google Forms → robot toutes les 2 h → site + Telegram)
- Commande : panier et formulaire présents mais fermés (pas encore de fournisseur) —
formulaire grisé + tampon « En cours de développement ». Pour rouvrir : retirer
disabled du fieldset.order-fields et le bloc div.tampon dans index.html,
et remettre le texte de la barre panier dans app.js
- Gagnant du match (fenêtre) : par le prix (stika 1,5 L la moins chère) et par le vote des clients
(un vote par navigateur via le Google Forms, décompte automatique toutes les 2 h →
data/votes.js)
- Votre avis (Formspree), « الماء في القرآن الكريم والحديث النبوي » (fenêtre : 5 versets + 4 hadiths sur l'eau, en arabe), statistiques privées GoatCounter
Plan de continuité — si Ahmed n'est plus disponible
Le site tourne seul sur les serveurs de GitHub, gratuitement, sans nom de domaine à
renouveler. Ce qui se passe en cas de problème (simulé par python tools/test_pannes.py,
16 scénarios) :
| Risque | Ce que fait le système tout seul | À faire par un humain |
|---|
| Un magasin change son site / tombe en panne | Garde ses derniers prix 7 jours au plus (mention « Prix Géant du … » dès 2 jours), puis les retire | Demander à Claude : « lis le README et répare la collecte des prix de » |
| Un site renvoie des prix absurdes (millimes, produits manquants, marques inconnues) | Détecté (« incohérent » / « suspect ») : traité comme une panne | Idem |
| Toutes les sources en panne | Bandeau ⚠️ « prix non mis à jour depuis le … » dès 3 jours ; plus aucun prix après 7 jours | Idem, ou chercher de nouvelles sources |
| Robots GitHub arrêtés | Le site compare la date des prix à la date du visiteur : ⚠️ affiché quand même. Un « battement de cœur » mensuel empêche GitHub de mettre les robots en pause (60 jours sans activité) | Onglet Actions du dépôt → réactiver les workflows |
| PC d'Ahmed éteint, volé ou en panne | Rien ne change : depuis le 23/10/2026 aucun prix ne dépend du PC | En cas de vol : changer le mot de passe GitHub et révoquer les sessions (github.com → Settings → Sessions / Applications), fermer les sessions Telegram et Google de l'appareil volé |
| Compte Google inactif (supprimé après 2 ans) | Les prix signalés ne sont plus lus ; les anciens disparaissent après 30 jours ; rien ne casse | Gestionnaire de compte inactif Google → personne de confiance |
| Compte Telegram inactif | Les alertes s'arrêtent si le canal perd son robot | Telegram → Confidentialité → « Supprimer mon compte si absent » : durée maximale ; ajouter un 2ᵉ administrateur |
| Telegram en panne | Prix publiés quand même ; annonce retentée au passage suivant, sans doublon | — |
| Un téléphone garde une vieille version du site | sw.js (service worker) est en réseau d'abord pour les pages et les prix : le cache ne sert que hors connexion | Changer CACHE_VERSION dans sw.js (vide le cache de tous les téléphones) |
Données privées : la liste des fournisseurs, livreurs et grossistes (et leurs robots) est dans un dépôt
GitHub privé séparé (dispatch-eau-prive), jamais dans ce dépôt public.
Successeur : ajouter une personne de confiance comme collaboratrice du dépôt GitHub
(Settings → Collaborators), administratrice du canal Telegram et éditrice du Google Forms
« Prix signalés ». Pour toute réparation, ouvrir une session Claude Code dans ce dossier
et lui demander de lire ce README.
Structure
| Chemin | Rôle |
|---|
index.html | La page (structure et textes) — changer les ?v= de style.css / app.js à chaque modification (cache des téléphones) |
style.css | Tout le style (thème clair/sombre) |
app.js | Rendu, filtres, avertissement de fraîcheur, prix signalés, panier |
data/eaux.js / eaux.json | Prix (généré — ne pas éditer), avec statut_sources |
data/signalements*.js/json, data/votes.js | Prix signalés et votes (générés) ; signalements_manuels.json = ajouts à la main |
data/baisses.*, historique.*, composition.js | Baisses du jour, historique, composition |
tools/collect_prices.py | Collecte des prix (Carrefour, Géant) + garde-fous |
tools/price_drops.py | Baisses de prix → site + Telegram |
tools/signalements.py | Décision automatique sur les prix signalés → site + Telegram |
tools/test_pannes.py | Simulateur de pannes (23 scénarios) — à relancer après toute modification du robot |
tools/build_history.py, tools/build_pages.py | Historique, pages par marque, sitemap |
Robots (GitHub Actions)
| Workflow | Quand | Rôle |
|---|
maj-prix.yml | chaque nuit ≈ 1h07 (Tunis) | collecte → baisses/Telegram → historique → pages → publication |
signalements.yml | toutes les 2 h, 8h05–22h05 | prix signalés → site + Telegram ; décompte des votes ; commit seulement si un signalement change (10/10/2026) |
battement-de-coeur.yml | le 1er du mois | empêche GitHub de mettre les robots en pause (60 j) |
instagram.yml | chaque lundi 9h05 | image « 5 stikas les moins chères » + texte → canal Telegram (pour Instagram) |
telegram-bienvenue.yml | à la main | message de présentation sur le canal |
tests.yml | à chaque envoi (push) | YAML des robots + test_site.mjs + test_sw.mjs + test_pannes.py + visiteur simulé (visiteur_simule.py : le site vu comme un visiteur sur téléphone) (e-mail de GitHub si échec) |
Mettre à jour les prix
Automatique : le workflow GitHub Actions (.github/workflows/maj-prix.yml) tourne
chaque nuit vers 1h du matin (heure de Tunis) sur les serveurs GitHub — PC éteint ou pas —
et publie directement sur le site. Lancement immédiat :
gh workflow run maj-prix.yml -R Ah6259/prix-eaux-tunisie.
Manuel (copie locale uniquement) : double-clic sur tools/update_prix.bat, ou :
python tools/collect_prices.py
Notes :
- Sources : Carrefour en direct (API GraphQL, chaque magasin), Géant Drive en direct. Monoprix et Otrity ne sont plus
suivis (23/10/2026, décision d'Ahmed : le site doit être autonome) : Otrity n'était lisible que depuis le PC d'Ahmed
(Cloudflare bloque GitHub, API wp-json comprise) et Monoprix n'était relevé qu'à la main (courses.monoprix.tn bloqué par
Cloudflare même depuis le PC). Pas de contournement. Leurs anciennes pages
prix-eau-monoprix/ et prix-eau-otrity/
disent « n'est plus suivi » (noindex, hors du plan du site). Aziza n'est plus suivi (30/09/2026) : barka.tn ne donne que les
prix de l'ancienne boutique en ligne d'Aziza, fermée (prix périmés, signalés par un client) ;
le site actuel d'Aziza ne publie que des catalogues promo et son API de prix est privée.
Jumia exige une vérification « humain » : on ne contourne pas (demander l'autorisation, ou prix signalés).
- Source en panne : ses derniers prix sont gardés 7 jours au plus, puis retirés ; un résultat
incohérent (prix en millimes, marques inconnues, trop peu de produits) compte comme une panne.
- Garde-fous : marques d'eau connues uniquement (
MARQUES_EAU), packs/fardeaux écartés
(la stika est affichée comme 6 × la bouteille), prix hors 0,25–2,5 DT/L ou supérieurs
au double de l'offre la moins chère écartés.
- Les métadonnées des marques (source, société, notes) sont dans
META en tête de
tools/collect_prices.py.
- L'ancien script
geant_scrape.py est conservé pour référence mais n'est plus utilisé (barka_scrape.py et
build_data.py, qui lisaient encore Monoprix, supprimés le 23/10/2026 ; ils restent dans l'historique git).
Déploiement (GitHub Pages)
Site statique servi par GitHub Pages (branche main, racine) : chaque commit des robots
redéploie le site en ~1 minute. Le dépôt doit rester public (Pages gratuit).
Le dépôt Ah6259/prix-eau-tunisie n'est qu'une redirection vers ce site : à garder.
Sources
Idées pour la suite
Nouveaux services (liste du 29/09/2026, par ordre conseillé)
- « Quelle eau pour moi ? » (priorité) : questionnaire (bébé, peu de sodium, sportif,
calculs rénaux…) qui recommande des eaux d'après
data/composition.js — bon pour le SEO.
- ✅ Alerte prix / promo — FAIT le 29/09/2026 : bandeau « Baisses de prix aujourd'hui »
sur le site + publication automatique sur le canal Telegram https://t.me/prixeautunisie
(
tools/price_drops.py, secret GitHub TELEGRAM_BOT_TOKEN). Plus tard : alerte email
par marque, recopie éventuelle sur une chaîne WhatsApp.
- Calculateur de budget : taille du foyer → stikas par mois, coût et économie par marque.
- Comparer 2 eaux côte à côte : prix + composition.
- Livraison de bonbonnes 19 L (maisons/bureaux) : livreurs par ville, abonnement,
consigne — prolonge la fonction de commande.
- ✅ Prix signalés par les visiteurs — FAIT le 30/09/2026 : bouton « 📍 Signaler un prix »
sur chaque carte → Google Forms d'Ahmed (tableau Google Sheets publié en CSV) → robot
tools/signalements.py toutes les 2 h de 8h à 22h (workflow signalements.yml) qui décide seul
(vraisemblance, écart aux prix connus, doublons = « confirmé ») → affiché 30 jours sur la
carte (hors calcul du moins cher) + annoncé sur le canal Telegram. Tout est automatique.
Plus tard (pas urgent, ~15 min avec Ahmed) : publication quasi immédiate (2-3 min) —
script Google Apps Script attaché au formulaire, déclencheur « à l'envoi », qui lance le
workflow signalements.yml via l'API GitHub (workflow_dispatch) avec une clé GitHub
limitée (fine-grained token, Actions : write sur ce seul dépôt) rangée dans le script.
Garder alors un passage de secours toutes les 2 h.
- Carte des magasins : où trouver chaque marque.
- Commande groupée de quartier : atteindre le minimum de livraison, meilleur prix.
- Espace marques / distributeurs : promos mises à jour par les marques (lien avec la publicité).
Projet futur : comparateur pour d'autres produits (idée du 29/09/2026, à reprendre)
Réutiliser toute la recette du site de l'eau (scrapers Carrefour/Géant/barka, page,
filtres, MAJ de nuit, historique, alertes Telegram, SEO, GoatCounter) pour d'autres produits.
- Garder le site de l'eau tel quel (il marche) ; créer un 2ᵉ site « Prix des courses en
Tunisie », une page par catégorie, avec des liens croisés.
- Candidats : 🍼 lait infantile + couches (1er choix), ☕ café, 🫒 huile d'olive,
🐟 thon / tomate concentrée / harissa, 🧴 lessive et ménager.
- À éviter : produits subventionnés ou à prix fixé (lait demi-écrémé, sucre, farine,
semoule, pain, huile subventionnée) : même prix partout.
- Méthode : un seul produit pilote, mesurer 2-3 semaines sur GoatCounter, puis étendre.
Fonction phare plus tard : comparateur de couffin (liste de courses → magasin le moins cher).
- Difficultés : prix à l'unité ou au kg (tailles et paquets variables), filtrage des faux
produits trouvés par les scrapers.
- Première action à la reprise : vérifier (sans rien créer) combien de produits
Carrefour et Géant ont en ligne pour le produit pilote choisi.
Autres idées
- Bannière publicitaire si une marque d'eau le demande : encart image + lien,
clairement marqué « Publicité », sans jamais toucher aux prix ni au classement
(la neutralité du comparateur est toute la valeur du site). Argument de vente :
les statistiques GoatCounter. Prévoir un statut pour facturer.
- Nom de domaine + hébergement pro — décision d'Ahmed (29/09/2026) : achat
différé jusqu'au premier annonceur (pas de dépense avant). Le jour venu :
un seul domaine suffit (prix-eau.tn en priorité, prix-eaux.tn en protection ;
vérifiés disponibles au registre ATI le 29/09/2026, ~30-60 DT/an chez un
registrar agréé type Oxahost — attention à ne pas confondre avec leurs packs
d'hébergement facturés au mois, inutiles ici). Héberger sur
Cloudflare Pages ou Netlify (gratuits, publicité autorisée). Migration SANS perte :
l'ancien site GitHub Pages redirige page par page vers le nouveau domaine (comme
fait pour le doublon prix-eau-tunisie) + outil « Changement d'adresse » de Search
Console. Les liens déjà partagés (Facebook, WhatsApp…) continuent de fonctionner —
rien à repartager.
- Listes privées fournisseurs / livreurs + suivi des commandes (Google Sheets pour commencer)
- Une page par marque (
/safia/…) pour le référencement Google
- Vrais logos des marques (sites officiels / pages Facebook) à la place des photos de bouteilles
- Historique des prix (relevés datés, courbes d'évolution)
- Prix au litre affiché sur chaque produit
- Marques manquantes : Hayet, Jannet (autres formats), Aïn Mizeb, Bulla Régia…
- Version PWA installable sur téléphone (manifest + service worker impossible en artifact,
mais possible une fois hébergé, ex. GitHub Pages)
Nouveautés
- 18/10/2026 : rapports du mois (image d'aperçu par article, partage) ; visiteur simulé sur tous les sites (règle générale) : il a trouvé le tableau du rapport trop large sur téléphone (corrigé).
- 18/10/2026 (soir) : test « chaque image d'un autre site est autorisée par la CSP » (VS.9) ; règle commune « même chiffre, même verdict partout » : après chaque amélioration d'un calcul, revérifier toutes les pages qui l'affichent.
- 18/10/2026 (nuit) : règle commune « un lieu vague n'est jamais un lieu précis » (une seule vérification pour toutes les sources, garde quotidien). Et : une seule règle des champs pour tous les formulaires (un champ caché est vidé). Et : une ligne par élément dans les résultats au téléphone. Et : règle commune des Pass (case du code toujours visible) + robot commun qui les contrôle chaque jour.
- 15/10/2026 (nuit) : rien de changé sur ce site ; autres sites d'Ahmed : Pass Propriétaire de l'immobilier enrichi (voir CLAUDE.md) ; nouvelle règle commune : un calcul fait à deux endroits (robot et page) est vérifié par un test croisé.
- 20/10/2026 (suite) : rien de changé sur ce site ; règles communes : mesurer ce que la source montre et pas nous, une limite est dite tout de suite avec les solutions.
- 20/10/2026 : recherche de marque : le nom exact tapé passe en premier (vérifié pour les 35 marques) ; un prix ne se sépare plus de son unité en fin de ligne (« 4,500 DT », « 10 % », « 6 × 1,5 L ») ; versions 20261020a.
- 19/10/2026 (suite) : rien de changé sur ce site ; le portail clicvia.com a maintenant son CLAUDE.md, comme tous les sites.
- 19/10/2026 : contrôle des espaces du visiteur simulé (règle commune § 29) ; « Voir le classement complet » recentré (20 px dessus et dessous) ; versions 20261019a.
- 18/10/2026 (fin) : rien de changé sur ce site ; règle commune des cartes complétée (§ 28.6 : aucun élément ne disparaît quand on zoome).
- 18/10/2026 (dernière mise à jour de la nuit) : la case « Chercher une marque » cherche « au son » (Maroua = Marwa, Saffia = Safia, lettres doublées ou triplées) avec l'outil commun
assets/son.js ; carte isolée et menus des filtres au-dessus (règle commune § 28) ; tests ajoutés. Règles communes § 27 (recherche au son) et § 28 (cartes).
- 18/10/2026 (fin de nuit) : rien de changé sur ce site ; règles communes : vérifier contre une référence indépendante (contrôle L3 de l'immobilier) ; motif du paiement des Pass = code personnel.
- 18/10/2026 (nuit) : rien de changé sur ce site ; règles communes : code Pass (robot commun, 10 pages) et lieux (une « délégation » affichée est toujours officielle ; Djerba et les villes partagées = groupes ; la carte suit le filtre).
