Traduction française complète + courriel de divulgation responsable

- README, PROTOCOL, FINDINGS, endpoints, rapport et outils traduits en français
- docs/DISCLOSURE.md : courriel prêt à envoyer à hello@boti.education
  (compte démo codé en dur, transmission en clair, logging de production)
- extract_endpoints.py vérifié après traduction (100 points d'accès toujours extraits)

tools/extract_endpoints.py

@@ -1,11 +1,11 @@
 #!/usr/bin/env python3
-"""Extract the Boti Education app API endpoints from decompiled Capacitor JS chunks.
+"""Extrait les points d'accès de l'API des apps Boti Education depuis les chunks JS décompilés.
 
-Usage: python3 extract_endpoints.py <dir-with-chunks> [--markdown]
+Usage : python3 extract_endpoints.py <dossier-avec-chunks> [--markdown]
 
-Scans *.js for the Angular ApiService call signature:
+Cherche dans les *.js la signature d'appel de l'ApiService Angular :
     <http>.post(<payload>, "endpoint")     /     <http>.get(<payload>, "endpoint")
-and emits a deduplicated endpoint -> methods table.
+et produit une table endpoint -> méthodes dédupliquée.
 """
 import re
 import sys
@@ -13,51 +13,51 @@ import glob
 import os
 import argparse
 
-CALL = re.compile(
+APPEL = re.compile(
     r'\.(post|get|getBlob)\(\s*'
     r'(?:"[^"]*"|`[^`]*`|[A-Za-z_$][\w$]*(?:\s*\.\s*[\w$]+)*(?:\([^()]*\))?|\{[^{}]*\})'
     r'\s*,\s*"([^"]*)"'
 )
 
 
-def scan(directory):
-    found = {}  # endpoint -> {method: [chunks]}
-    for path in sorted(glob.glob(os.path.join(directory, '*.js'))):
-        chunk = os.path.basename(path)
-        src = open(path, encoding='utf8', errors='replace').read()
-        for m in CALL.finditer(src):
-            method, ep = m.group(1), m.group(2)
-            d = found.setdefault(ep, {})
-            d.setdefault(method, []).append(chunk)
-    return found
+def scanner(dossier):
+    trouves = {}  # endpoint -> {méthode: [chunks]}
+    for chemin in sorted(glob.glob(os.path.join(dossier, '*.js'))):
+        chunk = os.path.basename(chemin)
+        src = open(chemin, encoding='utf8', errors='replace').read()
+        for m in APPEL.finditer(src):
+            methode, ep = m.group(1), m.group(2)
+            d = trouves.setdefault(ep, {})
+            d.setdefault(methode, []).append(chunk)
+    return trouves
 
 
-def main():
+def principal():
     ap = argparse.ArgumentParser()
-    ap.add_argument('directory')
+    ap.add_argument('dossier')
     ap.add_argument('--markdown', action='store_true')
     args = ap.parse_args()
 
-    found = scan(args.directory)
-    if not found:
-        sys.exit('no endpoints found, wrong directory?')
+    trouves = scanner(args.dossier)
+    if not trouves:
+        sys.exit('aucun point d\'accès trouvé, mauvais dossier ?')
 
     if args.markdown:
-        print(f'# API endpoints extracted from {os.path.basename(args.directory)}')
+        print(f'# Points d\'accès extraits de {os.path.basename(args.dossier)}')
         print()
-        print(f'{len(found)} unique endpoints.')
+        print(f'{len(trouves)} points d\'accès uniques (non filtrés, voir docs/endpoints.md pour la liste nettoyée).')
         print()
-        print('| endpoint | methods | seen in chunk(s) |')
+        print('| endpoint | méthodes | chunk(s) |')
         print('|---|---|---|')
-        for ep in sorted(found):
-            methods = ', '.join(sorted(found[ep]))
-            chunks = ', '.join(sorted({c for ms in found[ep].values() for c in ms})[:3])
-            print(f'| {ep} | {methods} | {chunks} |')
+        for ep in sorted(trouves):
+            methodes = ', '.join(sorted(trouves[ep]))
+            chunks = ', '.join(sorted({c for ms in trouves[ep].values() for c in ms})[:3])
+            print(f'| {ep} | {methodes} | {chunks} |')
     else:
-        for ep in sorted(found):
-            print(ep, sorted(found[ep]))
-        print(f'TOTAL endpoints: {len(found)}', file=sys.stderr)
+        for ep in sorted(trouves):
+            print(ep, sorted(trouves[ep]))
+        print(f'TOTAL points d\'accès : {len(trouves)}', file=sys.stderr)
 
 
 if __name__ == '__main__':
-    main()
+    principal()