Refine public documentation and code comments

app/Views/_animal_show_identity.php

@@ -360,7 +360,7 @@ $data['owner'] ??
 $data['detenteur'] ??
 null;
 
-                // Si ton parse aplatit au lieu d'imbriquer :
+                // Prend également en charge une réponse aplatie.
                 if (!$holder && (
                     isset($data['holder_name']) || isset($data['holder_phone']) || isset($data['holder_email'])
                 )) {

app/Views/_animal_show_modals.php

@@ -769,7 +769,7 @@ $today = date('Y-m-d');
                 return true;
             }
 
-            // 2) Fallback “manuel” (au cas où)
+            // 2) Activation manuelle si l'API Bootstrap n'est pas disponible.
             tabLinks.forEach(a => a.classList.remove('active'));
             document.querySelectorAll('.tab-pane').forEach(p => p.classList.remove('active', 'show'));
 
@@ -794,7 +794,7 @@ $today = date('Y-m-d');
                 history.replaceState(null, '', href);
             });
 
-            // Si jamais "shown.bs.tab" ne déclenche pas (rare), on sauvegarde au click aussi
+            // Le clic maintient le fragment même si l'événement Bootstrap n'est pas émis.
             a.addEventListener('click', () => {
                 const href = a.getAttribute('href');
                 if (!href) return;
@@ -805,7 +805,7 @@ $today = date('Y-m-d');
         // Un hash explicite est respecté ; sinon Identité est systématique.
         const target = window.location.hash || '#tab-ident';
 
-        // Si bootstrap n'est pas prêt à l'instant T, on retente un peu (Tabler peut charger en bas)
+        // Tabler peut initialiser Bootstrap après ce script : une courte nouvelle tentative suffit.
         let tries = 0;
         (function retry() {
             tries++;

app/Views/animal_form.php

@@ -3,7 +3,7 @@
 /** @var array $statuses */
 /** @var array $speciesOptions */
 
-// Liste races (tu pourras l’externaliser plus tard en table ref)
+// Races proposées par défaut dans le formulaire.
 $breeds = [
     'Chat Européen',
 'Abyssin','Bengal','British Shorthair','Chartreux','Maine Coon','Norvégien',

app/Views/animal_pdf_v2.php

@@ -49,7 +49,7 @@ function labelStatus(string $s): string
 
 function fivFelvText(array $a): string
 {
-    // adapte selon tes colonnes réelles (chez toi ça marche déjà côté liste)
+    // Les photos publiques sont privilégiées pour le document imprimable.
     $fiv = (string)($a['fiv'] ?? '');
     $felv = (string)($a['felv'] ?? '');
     if ($fiv === '' && $felv === '') {
@@ -67,7 +67,7 @@ function fivFelvText(array $a): string
     if ($felv === '1') {
         return 'FELV+';
     }
-    // fallback : si tu stockes déjà du texte
+    // Accepte également une valeur déjà enregistrée sous forme de texte.
     return trim($fiv . ' ' . $felv);
 }
 

app/Views/evolutions.php

@@ -34,8 +34,7 @@
                 <span class="badge bg-blue-lt mb-2">1.0.0-rc.3</span>
                 <h3>Stabilisation avant la 1.0</h3>
                 <p class="text-muted">Découpage des fichiers volumineux, recherche universelle, correction de
-                    l’installation vierge, anonymisation du dépôt, fiche Twix fictive complète et harmonisation des
-                    sources PHP.</p>
+                    l’installation vierge, jeu de démonstration enrichi et harmonisation de la présentation.</p>
             </div>
         </section>
     </div>