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

• Carrefour Tunisie — prix (API GraphQL) et images
• Géant Drive Tunisie — prix et images
• Prix signalés par les visiteurs (Google Forms d'Ahmed)
• Office du Thermalisme via Babnet — composition des eaux
• Wikipédia — Eaux minérales en Tunisie — liste des marques

Idées pour la suite

Nouveaux services (liste du 29/09/2026, par ordre conseillé)

1. « 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.
2. ✅ 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.
3. Calculateur de budget : taille du foyer → stikas par mois, coût et économie par marque.
4. Comparer 2 eaux côte à côte : prix + composition.
5. Livraison de bonbonnes 19 L (maisons/bureaux) : livreurs par ville, abonnement, consigne — prolonge la fonction de commande.
6. ✅ 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.
7. Carte des magasins : où trouver chaque marque.
8. Commande groupée de quartier : atteindre le minimum de livraison, meilleur prix.
9. 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).