Refine public documentation and code comments

This commit is contained in:
Alexandre NOEL 2026-09-04 13:37:22 +02:00
commit 0a482afe9d
16 changed files with 195 additions and 628 deletions

View file

@ -204,7 +204,7 @@ trait AnimalRecordActions
'free_cat_captured_at' => '',
'free_cat_released_at' => '',
'free_cat_tracking_status' => 'present',
// adapte si tu as fiv/felv en colonnes
// Normalise les statuts FIV et FeLV enregistrés sur la fiche.
'fiv' => '',
'felv' => '',
];
@ -486,7 +486,7 @@ trait AnimalRecordActions
$birth_estimated_months = null;
}
// FIV/FELV (selon ton stockage actuel)
// Statuts FIV et FeLV enregistrés sur la fiche.
$fiv = array_key_exists('fiv', $_POST) ? (isset($_POST['fiv']) ? 1 : 0) : null;
$felv = array_key_exists('felv', $_POST) ? (isset($_POST['felv']) ? 1 : 0) : null;
@ -514,7 +514,7 @@ trait AnimalRecordActions
$birth_date = $birth_date === '' ? null : $birth_date;
$intake_date = $intake_date === '' ? null : $intake_date;
// Code interne : auto si vide (et idéalement readonly en edit)
// Génère le code interne lorsqu'il est absent.
$internal_code = trim((string) ($_POST['internal_code'] ?? ''));
if ($internal_code === '') {
$internal_code = self::nextInternalCode($name);
@ -528,7 +528,7 @@ trait AnimalRecordActions
$quarantine_until = date('Y-m-d', $ts + AppSettings::int('quarantine_days', 1, 90) * 86400);
}
} else {
// si pas en quarantaine, on vide la sortie (optionnel, mais logique)
// La date de sortie n'a de sens que pour un animal en quarantaine.
$quarantine_until = null;
}
@ -575,7 +575,7 @@ trait AnimalRecordActions
);
$depositorId = $depositor ? (int) $depositor['id'] : null;
// Pour l’instant, tu bloques le lieu actuel
// Le lieu actuel est conservé lorsque la fiche archivée est corrigée.
if ($isArchivedCorrection) {
$currentAddress = (string) ($old['current_address'] ?? '');
}
@ -758,9 +758,7 @@ trait AnimalRecordActions
}
if ($old) {
// Les nouvelles valeurs “connues” (ce que tu viens de sauver)
// Astuce: tu mets TOUT ce que tu passes à l’UPDATE ici, mais sans maintenance lourde :
// si tu ajoutes un champ au formulaire + UPDATE, tu l’ajoutes déjà ici de toute façon.
// Valeurs persistées à comparer avec l'état précédent de la fiche.
$new = [
'name' => $name,
'internal_code' => $internal_code,
@ -801,8 +799,7 @@ trait AnimalRecordActions
'quarantine_until' => $quarantine_until,
'fiv' => $fiv,
'felv' => $felv,
// ajoute ici uniquement les champs que tu SAUVEGARDES dans UPDATE
// (si demain tu ajoutes 3 champs au form, tu les ajouteras déjà à l’UPDATE -> copie/colle aussi ici)
// Cette liste doit rester alignée sur les champs écrits par la requête UPDATE.
];
// Champs à ignorer (bruit)