CARIA-AUTOMOTIVE/docs/audit-initial.md

Audit initial — 12 septembre 2026

Périmètre

Inventaire de tous les fichiers de travail de CARIA-AUTOMOTIVE, examen du serveur, des interfaces, des scripts de lancement, des modules et scénarios Python et des dépendances. WebControl/ contient 53 fichiers, environ 2,33 Mo. Le projet comporte aussi .gitignore, un README initial minimal et les métadonnées Git. Les binaires, polices, bibliothèques JavaScript/CSS tierces et journaux ont été inventoriés ; ils ne font pas l’objet d’un audit exhaustif de leur contenu. Les certificats n’ont pas été reproduits dans le rapport.

L’application matérielle n’a pas été exécutée : elle initialise les GPIO et le port série et certains scripts commandent les moteurs. Aucune connexion au véhicule n’a été tentée.

Organisation trouvée

Dossier / fichier	Rôle
WebControl/main.py	Serveur Bottle, commandes robot, pages, résultats d’accès et commandes système
WebControl/MainCLIControl.py	Menu CLI de lancement des scénarios/tests
WebControl/templates/	Administration, accès, page de tests presque vide
WebControl/js/ et css/	jQuery, Bootstrap et compteur de vitesse bitmap
WebControl/images/ et fonts/	Fond du compteur, aiguille, police LED et Glyphicons
WebControl/modules/AlphaBot.py	GPIO, moteurs PWM, servo, lidar série, obstacles et journalisation
WebControl/modules/*MFRC522*	Lecteur RFID et accès SPI
WebControl/apps/	RFID, scénario de porte, itinéraires, lidar et évitement d’obstacles
WebControl/tests/	Essais physiques, pas une suite de tests unitaires
WebControl/logs/	Journaux d’exécution, résultats et trajets JSON
WebControl/install/	Liste figée de nombreux paquets du poste Raspberry Pi
WebControl/fixs/, webcontrol-launch.sh, NOTE.txt	Redémarrage, Motion, RFID, crontab et sudo
WebControl/sendMyIP.py	Exemple d’envoi d’adresse IP vers un endpoint fictif
WebControl/ssl/	Certificat et clé présents dans le dépôt historique

Constats qui déterminent la nouvelle architecture

1. Couplage matériel au démarrage : main.py instancie AlphaBot, qui ouvre /dev/ttyAMA0 et initialise les GPIO. L’interface ne peut donc pas être simplement transférée sur un PC ou ODroid sans le matériel et ces bibliothèques.
2. Chemins et adresses figés : /home/christian/WebControl, adresses 192.168.253.194, commandes sudo, dépendance à Motion. Le nouveau cockpit utilise des URL relatives et une configuration Docker.
3. Vitesse non mesurée : le curseur historique pilote un rapport cyclique PWM ; ce n’est pas une vitesse réelle en km/h. Le nouveau compteur est alimenté par des valeurs explicitement simulées. Son mapping d’aiguille couvre directement -130° à +130°.
4. Distribution des fichiers trop large : la route générique de Bottle sert depuis ./, avec en plus des routes vers modules, scripts et templates. Avec le répertoire de lancement prévu, les sources et fichiers SSL peuvent être demandés via HTTP. La nouvelle image web ne copie que ses fichiers publics ; l’ancien dossier est exclu du contexte Docker.
5. Commandes système et robot accessibles par HTTP sans authentification apparente : reboot, Motion, scripts et moteurs sont mélangés à l’administration. Ces fonctions ne font pas partie du nouveau cockpit, qui fournit une API en lecture seule.
6. Dépendances non portables : le fichier d’installation ressemble à un export complet du système scolaire, incluant GPIO, bureau et paquets anciens. La nouvelle version n’en dépend pas.
7. Licence globale absente : certains modules tiers contiennent des notices propres (MFRC522 notamment). Il faudra clarifier les licences avant diffusion publique du dépôt complet.

Anomalies historiques repérées (non corrigées dans ce lot)

• js/script.js associe tous les boutons à /cmd, y compris ceux sans lien avec la conduite, et lie plusieurs événements aux curseurs.
• js/test_status.js appelle /test_status, sans route correspondante dans le serveur lu.
• Le template utilise testRFIDCarDoor, alors que le serveur attend appRFIDCarDoor.
• modules/joyit_mfrc522/__init__.py importe .SimpleMFRC522, absent de ce sous-dossier ; un fichier homonyme est au niveau supérieur.
• itineraire_suivre_emergency_speed.py attend sur Ab.vitesse_queue.get() avant de démarrer le producteur. execute_maneuver y a deux paramètres mais plusieurs appels en passent trois.
• AlphaBot.monitor_obstacle utilise une variable globale du module, distincte de celle des scénarios ; sa boucle d’attente d’un obstacle ne consulte pas l’événement d’arrêt.
• AlphaBot.monitor_vitesse peut boucler sans pause lorsqu’aucune trame n’est disponible.
• Le scénario RFID attribue scenario successful puis compare le statut final à movement successful.

Ces éléments justifient de conserver le projet scolaire comme référence et de développer l’interface multimédia dans des dossiers dédiés. Ils ne constituent pas une certification du fonctionnement des autres chemins du robot.

Références DEMO-Interfaces

Inventaire du launcher Python/Tkinter NUC (raccourcis Windows, applications, images, arrière-plans), de sa capture Interface GUI 2025/interface.png et des projets Tasker auto/moto (XML, APK et images). Le launcher repose sur des chemins Windows et des exécutables locaux. Inspiration retenue : applications clairement identifiables, grands boutons et thème sombre. La nouvelle interface réinterprète ces principes avec quatre accès latéraux et un accueil central ; les exécutables/APK n’ont pas été lancés et les assets tiers n’ont pas été copiés.

Livraison de cette étape

ui/ fournit les vues multimédia et conduite ; server/ fournit les données de démonstration ; compose.yaml sépare les deux services. Le code historique reste inchangé. Voir le README pour les validations exécutées et les limites matérielles restantes.