Refine public documentation and code comments

app/Controllers/AnimalsController.php

@@ -426,7 +426,7 @@ final class AnimalsController
             throw $e;
         }
 
-        // Historique (optionnel)
+        // Historique associé à la modification.
         if (method_exists(__CLASS__, 'logHistory')) {
             self::logHistory(
                 $animalId,
@@ -486,7 +486,7 @@ final class AnimalsController
             try {
                 $svc->refreshByChip($id, $chipId);
             } catch (Throwable $e) {
-                // on laisse le cache en "error"
+                // Le cache conserve l'état d'erreur fourni par le service.
             }
             $cached = $svc->getCachedByAnimal($id);
             $stale = $svc->isStale($cached, 86400);