Bayyin — بيّن
Scanner halal & santé. L'essentiel gratuit, sans publicité, sans pistage.
« Le halal est clair (bayyin) et le haram est clair, et entre les deux se trouvent des
choses douteuses. » — hadith rapporté par al-Bukhari (52) et Muslim (1599)
Bayyin signifie « clair » en arabe : les trois statuts de l'app (halal, douteux, haram)
viennent de ce hadith. L'icône reprend la lettre ب, initiale du mot.
Application iOS et Android (et version web) qui scanne le code-barres d'un produit alimentaire et indique :
- son statut halal : certifié, probable, douteux ou haram, avec l'ingrédient en cause ;
- une note santé sur 100 (Nutri-Score, additifs à risque, bio), avec défauts et qualités nutritionnels ;
- les additifs à surveiller, les allergènes et le niveau de transformation (NOVA) ;
- des alternatives halal mieux notées dans la même catégorie.
Ce qui la distingue :
- aliments, cosmétiques et médicaments : savons, crèmes et parfums via Open Beauty Facts
(porc, gélatine, suif, carmin, alcool) ; médicaments vendus en France via la Base de données
publique des médicaments (gélule = gélatine, lien vers la notice) ;
- profil personnel : régime (végétarien, végan) et allergies ; alerte en tête de fiche et
alternatives filtrées ;
- verdict selon votre école (hanafite, malékite, chaféite, hanbalite, prudent, ou point par point) pour les sujets débattus : insectes (carmin), présure, vinaigre de vin, alcool, etc. ;
- photo de la liste d'ingrédients (OCR dans le navigateur) quand le produit n'est pas dans la base : texte corrigeable, analyse immédiate, mémorisée pour ce code-barres ;
- quatre langues : français, anglais, arabe (de droite à gauche) et turc, avec détection des ingrédients sensibles dans ces langues ;
- sources citées : chaque additif à risque, chaque interdit halal et la note santé renvoient vers leur source officielle (EFSA, ANSES, CIRC, JECFA, règlements européens, Nutri-Score, FSA, Coran) ; page « Nos sources » dans Réglages ;
- vie privée : aucun compte, aucune publicité, aucun pistage ; tout reste sur le téléphone, seul le code-barres part vers Open Food Facts ;
- tous les additifs du produit listés avec leur statut halal et santé, et un signalement d'erreur prérempli pour chaque produit ;
- hors connexion : l'app et les fiches déjà vues restent disponibles sans réseau, plus un pack des 500 produits les plus scannés en France.
- rappels de produits (RappelConso, mis à jour chaque nuit) : alerte sur la fiche d'un produit rappelé et
bandeau quand un produit déjà scanné vient d'être rappelé ;
- organismes de certification : fiches neutres (AVS, Achahada, mosquées habilitées, HMC…) et choix des
labels que l'on suit, appliqué au verdict ;
- fiche produit en onglets (Halal · Santé · Composition), illustrations par catégorie pour les produits sans photo,
chargements en squelette, vibration différente selon le verdict ;
- classements : les meilleurs produits halal de 30 rayons (alimentation et cosmétiques), triés par note santé et
recalculés avec les réglages de chacun ; 3 rayons gratuits par onglet, les autres avec Premium ;
- certification vérifiée : le label AVS, Achahada ou HMC est comparé chaque semaine à la liste publiée par
l'organisme (estampille sanitaire de l'emballage, puis marque) — « Certification vérifiée » ou « pas retrouvé dans la liste » ;
- recherche multilingue et triée par pertinence (une recherche en arabe, turc ou anglais est aussi lancée en français) ;
- visite guidée au premier lancement, relançable depuis les réglages ;
- mode rayon (plusieurs codes-barres d'un coup), mode courses, comparaison, carte des commerces halal
(OpenStreetMap) et profils de la famille.
Bayyin Premium (abonnement facultatif, 14,99 €/an ou 2,49 €/mois) réserve le confort : mode rayon, mode courses,
comparaison, famille, hors connexion et historique complet. Le verdict halal, les notes, les rappels et les
alertes allergies restent gratuits. Mise en vente : voir docs/abonnement.md.
Les données produits viennent d'Open Food Facts
(base collaborative, gratuite, plus de 3 millions de produits).
L'app est 100 % statique : le dossier public/ suffit. Le navigateur
interroge directement Open Food Facts et applique les règles lui-même, donc
aucun serveur n'est nécessaire en production.
Application mobile (iOS et Android)
Le dossier mobile/ contient la vraie application native, écrite avec React Native + Expo.
Elle reprend le même moteur que la version web (public/lib : règles halal, note santé,
traductions, sources), donc une règle corrigée profite aux deux.
Différences avec la version web : lecture des codes-barres par la caméra native du téléphone,
retour haptique, lampe, partage natif, données gardées sur l'appareil (AsyncStorage).
Android
À chaque modification, le workflow .github/workflows/mobile.yml compile un APK et le publie :
https://github.com/agozel5/bayyin/releases/download/android-latest/Bayyin.apk
Sur le téléphone : télécharger le fichier, l'ouvrir, autoriser « installer depuis cette source ».
iPhone
Apple n'autorise pas l'installation d'un fichier comme sur Android. Deux possibilités :
- Pour tester (gratuit) : installer l'app Expo Go depuis l'App Store, puis sur un ordinateur
avec Node.js 20 ou plus :
git clone https://github.com/agozel5/bayyin && cd bayyin/mobile
npm run setup # installe Expo et les modules natifs aux bonnes versions
npm run tunnel # affiche un QR code
Scanner le QR code avec l'appareil photo de l'iPhone : l'app s'ouvre dans Expo Go.
- Pour publier : un compte Apple Developer (99 $/an), puis
npx eas build --platform ios
et npx eas submit (TestFlight, puis App Store). Pour le Play Store : compte Google Play (25 $),
npx eas build --platform android --profile production.
Le workflow vérifie aussi à chaque modification que l'app iOS compile.
Version web (GitHub Pages, gratuit, HTTPS)
Adresse : https://agozel5.github.io/bayyin/
La caméra du téléphone n'est autorisée qu'en HTTPS, d'où l'hébergement sur
GitHub Pages. Le workflow .github/workflows/pages.yml lance les tests puis
publie le dossier public/ à chaque push sur main.
Réglage à faire une seule fois : Settings → Pages → Source : GitHub Actions,
puis relancer le workflow depuis l'onglet Actions (ou pousser un commit).
Sur le téléphone : ouvrir l'adresse, autoriser la caméra, puis
« Ajouter à l'écran d'accueil » pour l'avoir comme une application.
Mode démo sans internet : ajouter ?demo à la fin de l'adresse.
Développer en local
Prérequis : Node.js 18 ou plus récent. Aucune dépendance à installer.
npm start # http://localhost:3000 (sert public/ + une API JSON)
npm test # tests des règles halal, de la note santé et de l'API
Sur ordinateur, la caméra fonctionne sur localhost.
Architecture
mobile/ l'app native iOS / Android (Expo)
src/App.js onglets + pile d'écrans (caméra, fiche, lecture d'étiquette)
src/screens/ Scanner, Recherche, Historique, Additifs, Réglages
src/components/ fiche produit, caméra, OCR (Tesseract dans une WebView), icônes
src/core.js réexporte le moteur de public/lib
public/ la version web (à héberger telle quelle)
index.html
app.js onglets Scanner, Recherche, Historique, Additifs, Infos + fiche produit
style.css thème clair, barre d'onglets en bas
lib/camera.js caméra plein écran + décodage (BarcodeDetector natif ou ZXing WebAssembly)
lib/barcode.js validation des codes EAN/UPC
lib/health.js note santé, seuils nutritionnels, risque des additifs, allergènes, NOVA
lib/settings.js réglages (langue, école, avis par sujet), gardés sur l'appareil
lib/i18n.js traductions ; dictionnaires dans lib/i18n/{fr,en,ar,tr}.js
lib/ocr.js lecture d'étiquette (Tesseract.js chargé à la demande)
lib/sources.js sources officielles et correspondance avec chaque explication
sw.js service worker : mode hors connexion
lib/store.js historique et favoris (localStorage, consultables hors connexion)
lib/rules.js moteur de classification halal
lib/off.js appels à Open Food Facts depuis le navigateur
lib/fixtures.js produits d'exemple (tests + mode démo)
lib/beauty.js règles halal des cosmétiques (ingrédients INCI)
lib/medicine.js médicaments : code CIP13, verdict selon la forme
lib/profile.js profil allergies / régime comparé à chaque produit
data/med/NN.json base des médicaments découpée en 100 fichiers (workflow medicaments.yml, chaque lundi)
lib/cosmetic.js note des cosmétiques (danger × exposition) et base CosIng (data/cosing.json, chaque mois)
lib/search.js recherche : pertinence, fautes de frappe, traduction des mots courants (ar/tr/en → fr)
lib/recalls.js rappels de produits ; data/rappels/NN.json construit chaque nuit (workflow rappels.yml)
lib/certifiers.js fiches des organismes de certification halal
lib/places.js commerces halal autour de soi (OpenStreetMap / Overpass)
lib/aisle.js mode rayon : plusieurs codes-barres dans la même image
lib/premium.js Bayyin Premium : clé de licence Lemon Squeezy (réglages : premium-config.js)
scripts/build-medicaments.mjs construit data/med depuis la base publique
src/server.js serveur local optionnel : sert public/ + API JSON
test/ tests node:test
API du serveur local (optionnelle)
Utile pour un futur client mobile natif ; l'app web ne s'en sert pas.
| Route | Rôle |
|---|
GET /api/product/:code | Fiche + verdict pour un code-barres (8 à 14 chiffres) |
GET /api/search?q=nutella | Recherche par nom, 12 résultats max avec verdict |
GET /api/health | État du serveur, mode hors-ligne ou non |
Exemple de réponse (abrégée) :
{
"found": true,
"product": {
"code": "4001686301029",
"name": "Dragibus",
"brand": "Haribo",
"verdict": {
"status": "mashbouh",
"statusLabel": "Douteux",
"certification": null,
"flags": [
{ "id": "gelatine", "severity": "mashbouh", "label": "Gélatine", "reason": "…", "source": "gelatine" },
{ "id": "e120", "severity": "mashbouh", "label": "E120 (carmin)", "reason": "…", "source": "E120" }
],
"notes": []
}
}
}
Comment le verdict est calculé (public/lib/rules.js)
- Texte des ingrédients, découpé en segments pour que les exceptions
s'appliquent localement (« vinaigre de vin », « jambon de dinde »,
« bière sans alcool », « orange sanguine »…).
- Additifs : codes E lus dans
additives_tags d'Open Food Facts et dans le
texte. Les dérivés d'acides gras (E471, E472…, E481…) passent en simple
information si l'étiquette précise une origine végétale ou si le produit est
végétalien.
- Certification : label « halal » sur la fiche, avec reconnaissance des
organismes (AVS, Achahada, Mosquée de Paris, Mosquée de Lyon, HMC, HFA…).
- Décision : haram > certifié > douteux > halal probable > non déterminé.
Un ingrédient haram l'emporte même sur un label (la fiche peut être fausse).
Chaque signalement a une sévérité : haram, mashbouh (douteux) ou info
(point d'attention qui ne change pas le verdict, ex. vinaigre de vin).
Pour ajouter une règle (public/lib/rules.js) : une entrée dans TEXT_RULES ou ADDITIVES, puis un
test dans test/rules.test.js.
Limites connues
- Le verdict dépend de la qualité de la fiche Open Food Facts : liste
d'ingrédients absente, ancienne ou mal transcrite = verdict incertain.
- Les labels de certification ne sont pas vérifiés auprès des organismes.
Une prochaine étape serait d'importer leurs listes publiques de produits.
- Les positions retenues pour les cas débattus (E120, présure, vinaigre de vin…)
sont des choix à valider ; l'idéal serait un réglage « école / niveau de
prudence » dans l'app.
Lecture des codes-barres (public/lib/camera.js)
La caméra est pilotée directement (getUserMedia), sans bibliothèque de scan. Plusieurs fois
par seconde, la zone du cadre est copiée dans un canvas et décodée :
- par l'API
BarcodeDetector du navigateur quand elle existe (Chrome sur Android) ;
- sinon par ZXing compilé en WebAssembly, via le paquet
barcode-detector chargé depuis jsDelivr (iPhone, Firefox).
Une analyse sur quatre porte sur l'image entière, pour les caméras dont l'image est rognée à
l'écran. Secours : photo du code-barres ou saisie des chiffres.
Note santé (public/lib/health.js)
| Composante | Points |
|---|
| Nutri-Score A / B / C / D / E | 60 / 45 / 30 / 15 / 0 |
| Additifs (30 au départ) | −30 risque élevé, −10 modéré, −4 limité ; un risque élevé plafonne la note à 49 |
| Label bio | +10 |
Sans Nutri-Score sur la fiche, aucune note n'est affichée. Les seuils sucre, sel, graisses
saturées et calories suivent les feux tricolores de la Food Standards Agency (aliments et
boissons séparés). Les niveaux de risque des additifs résument des avis EFSA, ANSES et CIRC.
Écoles et sujets débattus (public/lib/rules.js)
Chaque point débattu est un « sujet ». Pour chacun, l'utilisateur choisit permis (simple information),
douteux ou interdit, directement ou via un préréglage d'école (SCHOOLS). Les préréglages s'appuient sur
une recherche documentée et sourcée : docs/avis-des-ecoles.md.
Les sujets sont de deux natures, que le moteur distingue :
- origine inconnue (
gelatine, viande, extraits_animaux, derives, presure, arome_alcool,
traces_alcool) : un label halal lève le doute ;
- divergences entre écoles (
insectes, vinaigre, fruits_de_mer, crevettes, insectes_alimentaires,
grenouille, escargot, cheval, boissons_desalcoolisees, alcool_cosmetique, graisse_cosmetique) :
un label ne les tranche pas ; le produit certifié reçoit alors la note « interdit ou débattu selon votre école ».
Un médicament n'est jamais classé « haram » : toutes les instances consultées l'autorisent en cas de nécessité.
Traductions
lib/i18n/fr.js est la référence. Un test vérifie que en, ar et tr ont exactement
les mêmes clés et les mêmes variables {x}. Pour ajouter une langue : un nouveau fichier,
puis l'ajouter à DICTS (lib/i18n.js) et à LANGS (lib/settings.js).
Stores
Icônes, écrans de démarrage, captures et textes des stores : docs/store/ (regénérés par scripts/store-assets.py).
